Stripe'ı Adapty Attribution ile Entegre Edin

Web satış huninizdeki satın almaları, onları yönlendiren reklamlara bağlamak için Stripe hesabınızı Adapty Attribution’a bağlayın. Bağlandıktan sonra Stripe’tan gelen satın almalar, yenilemeler, iadeler ve geri ödeme talepleri Adapty Attribution analizlerinde görünür; dönüşüm etkinlikleri ise kampanya optimizasyonu için reklam ağlarına gönderilebilir.

Nasıl Çalışır

1. Adapty web pixel, her funnel ziyaretçisine bir tıklama kimliği atar ve açılış URL’sindeki reklam verilerini yakalar.
2. Ödeme sırasında, funnel’ınız tıklama kimliğini Stripe işlemine ekler.
3. Adapty, Stripe hesabınızda oluşturduğu bir webhook aracılığıyla işlemi alır ve bunu reklam tıklamasıyla eşleştirir.

Başlamadan önce

Funnel’ınızda Adapty web pixel’ini kurun. Pixel olmadan eklenecek tıklama kimliği bulunmaz ve işlemler reklamlara atanamaz.

Adım 1. Ödeme sırasında click ID’yi ekleyin

İşlemi oluştururken click ID’yi okuyun ve adpt_click_id anahtarı altında Stripe metadata’sına ekleyin:

const adptClickId = window.adaptyPixel.getClickId();

Değer, tek seferlik ödemeler için PaymentIntent üzerinde ya da tekrarlayan ödemeler için Subscription üzerinde yer almalıdır; çünkü Adapty bu nesneleri okur. Bunları doğrudan oluşturuyorsanız:

metadata: { adpt_click_id: adptClickId }

Stripe Checkout kullanıyorsanız, metadata’yı iç içe geçmiş nesnelere ekleyin. Checkout Session’ın kendisindeki metadata, PaymentIntent veya Subscription’a kopyalanmaz; dolayısıyla oraya bırakılan bir click ID Adapty’ye hiç ulaşmaz:

stripe.checkout.sessions.create({
  // ...
  payment_intent_data: { metadata: { adpt_click_id: adptClickId } }, // one-off payments
  subscription_data:   { metadata: { adpt_click_id: adptClickId } }, // subscriptions
})

click_id, kısa ve rastgele bir tanımlayıcıdır; gizli bir bilgi ya da kişisel veri değildir. Stripe kontrol panelinizde görünür olması beklenen bir durumdur.

Adım 2. Stripe hesabınızı bağlayın

Önce Stripe’ta anahtarı oluşturun. Stripe kontrol panelinizde Developers → API keys bölümüne gidin ve şu izinlerle kısıtlı bir anahtar oluşturun:

Webhook endpoint’lerinde yazma erişimi, Adapty’nin ödemelerinizi ileten webhook’u oluşturmasına olanak tanır — Stripe’ta elle yapılandırılacak bir şey yoktur. Geri kalan her şey salt okunur kalır: Adapty, ödeme verilerinize hiçbir zaman yazmaz. Gerekli izne sahip olmayan bir anahtar, eksik izni belirten bir hatayla bağlantı sırasında reddedilir.

Ardından, anahtarı Adapty’e ekleyin:

1. Adapty Attribution’da Integrations > Stripe 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 düğmesine tıklayın.

Bağlanan hesap, ortamı, anahtar durumu ve webhook durumuyla birlikte tabloda görünür. Bağlantı, yapılandırdığınız uygulamaya uygulanır. Aynı Stripe hesabının ödemelerini başka bir uygulamada da almak için aynı anahtarı oraya da 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 adresinden bizimle iletişime geçin.

Entegrasyonu doğrulayın

Funnelınız üzerinden gerçek bir satın alma yapın — Adapty test modundaki satın almaları dikkate almaz. Satın alma, birkaç saat içinde Adapty Attribution analitiğinde görünmelidir. Ziyaretiniz etiketli URL’ler içeren bir reklamdan geldiyse, satın alma ilgili kampanyaya, reklam setine ve reklama atfedilir; aksi hâlde organik olarak sayılır.

Dönüşüm etkinliklerini reklam ağına gönderme

İ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 ve TikTok for Business sayfalarına bakın.