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.
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_idatar 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ı veutm_*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.
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
- Adapty Attribution’da Meta Ads, TikTok veya Google Ads kampanya yapılandırmanızı açın.
- 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.
- 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.
Onayı yönetme
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'
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.