English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

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 ve TikTok for Business kampanyaları için piksel 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 pixel şunları yapar:

  • Ziyaretçiye bir click_id atar ve bunu tarayıcıda 7 gün boyunca saklar.
  • Sayfa URL’sinden reklam sinyallerini yakalar: Meta (fbclid) ve TikTok (ttclid) 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’ye gönderir.

Ödeme sırasında yalnızca click_id’yi işleme eklersiniz. Adapty bunu, pixel’in 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 veya TikTok for Business bağlantısını Adapty Attribution’a ekleyin ve bir kampanya yapılandırması oluşturun. Adapty, piksel snippet’ini kampanya yapılandırması başına oluşturur, bu nedenle snippet’i kopyalamak için bir yapılandırmaya ihtiyacınız vardır.

Piksel, reklam verilerini açılış sayfası URL’nizden okur; bu nedenle reklamlarınızın Adapty’nin izleme parametrelerini taşıması gerekir. Bu parametreler olmadan Adapty, satın almayı ağa atfeder; ancak kampanya, reklam seti veya reklama atfetmez. Bkz. Web hunileri için reklam URL’lerinizi etiketleyin.

Pikseli yükleyin

  1. Adapty Attribution’da Meta Ads veya TikTok kampanya yapılandırmanızı açın.
  2. General sekmesinde Web funnel bölümünü genişletin ve Pixel snippet alanının değerini kopyalayın.
Adapty Attribution'daki bir kampanya yapılandırmasının Web funnel bölümündeki Pixel snippet alanı
  1. Snippet’i huninizdeki her sayfanın <head> bölümüne 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.