---
title: "Paddle'ı Adapty Attribution ile Entegre Edin"
description: "Web hunisi satın alımlarını, yenilemeleri, iadeleri ve geri ödemeleri onları yönlendiren reklamlara bağlamak için Paddle hesabınızı Adapty Attribution'a bağlayın."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill && claude plugin install adapty-sdk-integration@adapty` — other tools: `npx skills add adaptyteam/adapty-sdk-integration-skill --all`

Web dönüşüm huninizde yapılan satın almaları, onları yönlendiren reklamlara bağlamak için Paddle hesabınızı Adapty Attribution'a bağlayın. Bağlandıktan sonra, Paddle'dan gelen satın almalar, yenilemeler, iadeler ve geri ödemeler Adapty Attribution analitiğinde görünür; dönüşüm etkinlikleri kampanya optimizasyonu için reklam ağlarına geri gönderilebilir.

## Nasıl çalışır \{#how-it-works\}

1. [Adapty web pixel](ua-web-pixel), her funnel ziyaretçisine bir click ID atar ve reklam verilerini açılış sayfası URL'sinden yakalar.
2. Ödeme sırasında, funnel'ınız click ID'yi Paddle işlemine ekler.
3. Adapty, işlemi Paddle hesabınızda oluşturduğu bir webhook aracılığıyla alır ve reklam tıklamasıyla eşleştirir.

:::note
Web satın alımlarında uygulama yükleme eventi olmadığından Adapty, kohort tarihi olarak aboneliğin ilk ücretlendirme tarihini kullanır.
:::

## Başlamadan önce \{#before-you-start\}

Funnel'ınıza [Adapty web pikselini](ua-web-pixel) kurun. Piksel olmadan bağlanacak bir tıklama kimliği bulunmaz ve işlemler reklamlara bağlanamaz.

## Adım 1. Ödeme sırasında click ID'yi ekleyin \{#step-1-attach-the-click-id-at-checkout\}

Ödeme ekranını açtığınızda veya işlemi oluşturduğunuzda, click ID'yi okuyun ve Paddle `customData`'sına `adpt_click_id` anahtarıyla ekleyin:

```js
const adptClickId = window.adaptyPixel.getClickId();

customData: { adpt_click_id: adptClickId }
```

Click ID'yi yalnızca ilk işleme ekleyin. Paddle, bir aboneliğin özel verilerini yenileme işlemlerine otomatik olarak kopyaladığından, Adapty yenilemeleri, iadeleri ve geri ödemeleri otomatik olarak ilişkilendirir.

`click_id`, kısa bir rastgele tanımlayıcıdır; gizli bir veri değildir ve kişisel veri içermez. Paddle kontrol panelinizde görünür olması beklenen bir durumdur.

## Adım 2. Paddle hesabınızı bağlayın \{#step-2-connect-your-paddle-account\}

Önce Paddle'da anahtar oluşturun. Paddle kontrol panelinizde **Developer Tools → Authentication** bölümüne gidin ve şu izinlere sahip bir API anahtarı oluşturun:

| Kaynak | Erişim |
|---|---|
| Transactions | Read |
| Adjustments | Read |
| Notification settings | Write |

Bildirim ayarlarındaki yazma erişimi, Adapty'nin ödemelerinizi ileten webhook hedefini oluşturmasına olanak tanır; Paddle'da elle yapılandırmanız gereken hiçbir şey yoktur. Bunun dışındaki her şey salt okunur kalır: Adapty ödeme verilerinize hiçbir zaman yazmaz. Gerekli bir izin eksik olan anahtar, bağlantı kurulurken eksik izni belirten bir hatayla reddedilir.

:::warning
Canlı anahtar kullanın. Paddle anahtarları ortama özgüdür ve Adapty sandbox olaylarını geldikçe atar; bu nedenle sandbox anahtarı başarıyla bağlanır ve **Valid** olarak görünür, ancak hiçbir veri gelmez. Entegrasyonu doğrulamak için canlı anahtarı bağlayın ve gerçek bir satın alma yapın.
:::

Ardından anahtarı Adapty'ye ekleyin:

1. Adapty Attribution'da [**Integrations > Paddle**](https://app.adapty.io/ua/integrations/paddle) sayfasına gidin.
2. Anahtarı **API key** alanına yapıştırın. İsteğe bağlı olarak, hesapları birbirinden ayırt etmek için bir **Name** girin — varsayılan olarak Adapty, anahtarın son 4 karakterini kullanır.
3. **Connect**'e tıklayın.

Bağlı hesap, ortamı, anahtar durumu ve webhook durumuyla birlikte tabloda görünür. Bağlantı, yapılandırdığınız uygulama için geçerlidir. Aynı Paddle hesabının ödemelerini başka bir uygulamada da almak için aynı anahtarı oraya ekleyin.

Adapty, hesabı bağladığınız andan itibaren işlemleri içe aktarır. Daha önceki işlemleri de dahil etmek için [support@adapty.io](mailto:support@adapty.io) adresinden bizimle iletişime geçin.

## Entegrasyonu doğrulayın \{#verify-the-integration\}

Funnel'ınız üzerinden gerçek bir satın alma yapın — Adapty, sandbox satın almalarını dikkate almaz. Satın alma, birkaç saat içinde [Adapty Attribution analitiğinde](ua-analytics) görünmelidir. Ziyaretiniz [etiketli URL'ler](ua-web-pixel) içeren bir reklamdan geldiyse, satın alma ilgili kampanyaya, reklam setine ve reklama atfedilir; aksi takdirde organik olarak sayılır.

## Dönüşüm etkinliklerini reklam ağına gönderme \{#send-conversion-events-to-the-ad-network\}

İlişkilendirilmiş web satın alımları, kampanyanın geri kalanıyla aynı etkinlik eşlemesini takip eder: kampanya yapılandırmasının **Events names** bölümünde etkinleştirdiğiniz etkinlikler, kampanyayla ilişkilendirdiğiniz piksele geri gönderilir. Eşleme kurulumu için [Meta Ads](ua-facebook) ve [TikTok for Business](ua-tiktok) sayfalarına bakın.