Adapty web pikselini kurma

Kullanıcıları bir web funnel’ı veya açılış sayfası üzerinden kazanıyorsanız, Adapty web pikseli her ziyareti o ziyareti getiren reklamla ilişkilendirir. Piksel, her ziyaretçiye bir tıklama kimliği (click ID) atar. Ziyaretçi ödeme yaptığında bu tıklama kimliğini işlemle birlikte iletirsiniz; Adapty Attribution da satın almayı tam olarak ilgili kampanya, reklam seti ve reklama eşler.

Meta Ads, TikTok for Business ve Google Ads kampanyaları için piksel kullanılabilir. Google Ads’de, Uygulama kampanyaları için değil, Diğer kampanyalar için kullanılabilir.

Note

Funnel’ınız FunnelFox üzerinde çalışıyorsa piksele ihtiyacınız yoktur. Bkz. FunnelFox’u Adapty Attribution ile Entegre Etme.

Nasıl çalışır

Sayfa yüklendiğinde, piksel:

  • Ziyaretçiye bir click_id atar ve bunu 7 gün boyunca tarayıcıda saklar.
  • Sayfa URL’sinden reklam sinyallerini yakalar: Meta (fbclid), TikTok (ttclid) ve Google (gclid, gbraid, wbraid) tıklama ID’leri, kampanya, reklam seti ve reklam tanımlayıcıları ile adları ve utm_* parametreleri.
  • click_id’yi ve yakalanan sinyalleri arka planda Adapty’e gönderir.

Ödeme sırasında, işleme yalnızca click_id’yi eklersiniz. Adapty bunu pikselin daha önce gönderdiği sinyallerle eşleştirir ve reklam kanalını otomatik olarak belirler.

Tip

Pixel yalnızca reklam ziyaretlerini eşleştirir. Satın almaların kendisini Adapty Attribution’a getirmek için Stripe veya Paddle bağlayın.

Başlamadan önce

Meta Ads, TikTok for Business veya Google Ads bağlantısını Adapty Attribution’a yapın ve bir kampanya yapılandırması ekleyin. Adapty, piksel kodunu kampanya yapılandırması başına oluşturduğundan, kodu kopyalamak için bir yapılandırmaya ihtiyacınız vardır.

Piksel, reklam verilerini açılış sayfası URL’nizden okuduğundan reklamlarınızın Adapty’nin izleme parametrelerini taşıması gerekir. Bu parametreler olmadan Adapty, satın almayı ağa bağlayabilir ancak kampanyaya, reklam setine veya reklama bağlayamaz. Bkz. Web hunileri için reklam URL’lerinizi etiketleme.

Pikseli yükle

  1. Adapty Attribution’da Meta Ads, TikTok veya Google Ads kampanya yapılandırmanızı açın.
  2. Web funnel bölümünü genişletin ve Pixel snippet alan değerini kopyalayın. Meta Ads ve TikTok yapılandırmalarında bu bölüm General sekmesindedir.
Adapty Attribution'da bir kampanya yapılandırmasının Web funnel bölümündeki Pixel snippet alanı
  1. Snippet’i dönüşüm huninizdeki her sayfanın <head> etiketine yapıştırın:
<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

data-code değeri uygulamanızı ve kampanyanızı tanımlar. Bu, gizli bir bilgi değil, herkese açık bir tanımlayıcıdır.

Piksel, sayfa yüklenirken birinci taraf çerezi ve localStorage girişi yazar; ayrıca reklam tıklama kimliklerini okur. Huninin veri sorumlusu sizsiniz ve bu veriler için yasal dayanağa sahip olmanız gerekmektedir.

Varsayılan olarak piksel, sayfa yüklendiğinde çalışır. Onay mekanizmasına bağlamak istiyorsanız snippet’e data-consent="denied" ekleyin — piksel, çerez bannerınızdan onay verene kadar hiçbir şey depolamaz veya göndermez:

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'
Warning

AB/AEA trafiği için piksel kullanımını izne bağlayın. ePrivacy kuralları, tarayıcı depolaması için önceden onay alınmasını zorunlu kılmaktadır; birinci taraf attribution pikseli bu zorunluluktan muaf değildir.

Kod parçacığı asenkron olarak yüklendiğinden, window.adaptyPixel <script> etiketinin hemen ardından gelen satırda mevcut olmaz. Rıza API’sini, onay banner’ınızın callback’inden çağırın ya da erken bir çağrıyı if (window.adaptyPixel) { ... } ile koruma altına alın.

Kullanım notları

  • Tek sayfalık funnel’lar: İstemci tarafı navigasyon aynı click_id’yi korur, bu nedenle tek sayfalık uygulama olarak oluşturulan bir funnel ekstra kurulum gerektirmez.
  • Click ID kararlılığı: click_id’yi sayfa yüklenirken veya ödeme sırasında okumak aynı değeri döndürür. Ziyaretçi yeni bir reklamdan funnel’a yeniden girerse, en son reklam tıklaması geçerli olur.
  • Yenilemeler: click_id’yi yalnızca ilk işleme ekleyin. Adapty, deneme dönüşümlerini ve abonelik yenilemelerini aboneliğin kendisi aracılığıyla ilişkilendirir.