Shopify için TikTok Events API: kurulum ve mükerrer kayıt önleme

TikTok Events API, TikTok'un dönüşüm verileri için sunucudan sunucuya bağlantısıdır. Yalnızca alışveriş yapanın tarayıcısındaki TikTok pikseline güvenmek yerine mağazanız ya da ROASaurus gibi bir araç, satın alım gibi olayları doğrudan TikTok'a gönderir. TikTok, Events API'yi pikselin yanında çalıştırmayı ve ikisinde mükerrer kaydı ortak bir event_id ile önlemeyi önerir.

Bu rehber, Events API'nin bir Shopify mağazasından ne gönderdiğini, Purchase ve CompletePayment olay adlarını, TikTok'un eşleştirmede kullandığı tıklama kimliğini ve çerezi, mükerrer kayıt önlemenin nasıl çalıştığını, TikTok Events Manager'da nasıl test edileceğini ve her şeyin ROASaurus'ta nasıl kurulacağını kapsar.

TikTok Events API nedir?

TikTok pikseli mağazanızdaki bir betiktir. Olayları alışveriş yapanın tarayıcısından tetikler, bu yüzden yalnızca betik yüklenip çalışırken olanları sayar. Bir reklam engelleyici, bir betik hatası ya da sipariş onayı yüklenmeden sekmeyi kapatan bir alışveriş yapan, hepsi onu durdurabilir.

Events API aynı türde olayı bir sunucudan gönderir. Shopify'da bir satın alımın en güvenilir kaydı siparişin kendisidir. Shopify, tarayıcı betiği çalışmış olsun olmasın her ödenmiş siparişi webhook ile bildirir. Shopify'da sunucu tarafı takibin ardındaki fikir budur.

İkisi birbirinin alternatifi değildir. TikTok'un tavsiyesi, olayları her iki yoldan da paylaşmanız, alışveriş yolculuğu boyunca tutarlı tutmanız ve mükerrer kayıtları TikTok'un kaldırmasına izin vermenizdir.

ROASaurus TikTok'a hangi olayları gönderir?

Bir Shopify mağazasındaki dört an TikTok'un optimizasyonu için önemlidir: bir ürün görüntüleme, sepete ekleme, ödemenin başlangıcı ve satın alım. ROASaurus dördünü de Events API'ye gönderir ve aynı dördünü aynı olay kimlikleriyle TikTok pikseli üzerinden de tetikler. Sayfa görüntülemeleri yalnızca piksel üzerinden gider.

Piksel ayarlarında göndermek istemediğiniz sunucu olaylarının işaretini kaldırabilir ve bir ülke ya da asgari sipariş değeri gibi filtreler ekleyebilirsiniz.

Purchase mı, CompletePayment mı?

TikTok satın alım olayının adını değiştirdi. Güncel ad Purchase'tır. Eski ad CompletePayment hâlâ çalışır: TikTok eski adları kendi tarafında dönüştürür, raporlamada, kitlelerde ve optimizasyonda yeni adla gösterir ve CompletePayment'ın süresiz destekleneceğini söyler. TikTok yeni piksel kurulumlarından Purchase kullanmalarını ister.

ROASaurus hem pikselde hem Events API'de CompletePayment gönderir. TikTok Events Manager'da ve Ads Manager'da bu olaylar Purchase olarak görünür. Mükerrer kayıt önleme için önemli olan, bir satın alımın iki kopyasının da aynı olay adını kullanmasıdır ve kullanırlar.

TikTok bir olayı bir alışveriş yapanla nasıl eşleştirir?

Bir olay, yalnızca TikTok onu reklamı gören ya da tıklayan kişiyle ilişkilendirebilirse kampanyalarınıza yardımcı olur. TikTok bu tanımlayıcılara eşleştirme anahtarları (match keys) der ve Events API rehberi, eşleşme oranlarını artırmak için ilgili tüm eşleştirme anahtarlarını geri iletmenizi ister. Events Manager sonucu, her eşleştirme anahtarının ne sıklıkla bulunduğunun ağırlıklı ortalaması olan bir Event Match Quality puanı olarak gösterir.

TikTok, pikselin IP adresini ve user agent'ı varsayılan olarak paylaştığını, ama Events API için bunların elle eklenmesi gerektiğini belirtir. ROASaurus bunları alışveriş yapanın ödeme oturumundan, oturum yoksa siparişten alır. Shopify'da iki anahtar daha dikkat gerektirir.

ttclid: TikTok tıklama kimliği

Bir alışveriş yapan bir TikTok reklamına tıkladığında TikTok, açılış sayfası URL'sine ttclid ekler. Mağazanız onu o ilk sayfada kaydetmezse, siparişin geldiği birkaç sayfa sonra kaybolmuştur. ROASaurus ttclid değerini açılış sayfasında okur, ziyaretçi kimliğiyle birlikte saklar, Shopify sepetine yazar ve sipariş geldiğinde sunucu olayına ekler.

_ttp: piksel çerezi

_ttp çerezi, TikTok pikselinin alan adınızda kullandığı birinci taraf bir çerezdir. ROASaurus onu mağazanızda ve ödeme sayfasında okur ve sunucu olayında ttp olarak gönderir. Pikselin Events API'nin yanında çalışmaya devam etmesi için bir neden daha budur.

{
  "event_source": "web",
  "event_source_id": "CXXXXXXXXXXXXXXXXXXX",
  "data": [{
    "event": "CompletePayment",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "user": {
      "email": "a3f1…9c2e",
      "phone": "7b40…11d8",
      "external_id": "e05c…4a7f",
      "ttclid": "E.C.P.v3…",
      "ttp": "2Xb7…",
      "ip": "203.0.113.24",
      "user_agent": "Mozilla/5.0 (iPhone; …)"
    },
    "page": { "url": "https://example-store.com/checkouts/…/thank-you" },
    "properties": {
      "currency": "USD",
      "value": 84,
      "content_type": "product",
      "contents": [{ "content_id": "44123456789", "content_name": "Linen shirt", "quantity": 2, "price": 42 }],
      "order_id": "5512345678901"
    }
  }]
}

Mükerrer kayıt önleme nasıl çalışır?

Piksel ve Events API aynı satın alımı bildirdiğinde TikTok tek sipariş için iki olay alır. Yalnızca birini tutmak için TikTok'un iki kopyada iki değerin özdeş olmasına ihtiyacı vardır: olay adı ve event_id. TikTok bu durumda ölçüm ve raporlama için aldığı ilk kopyayı kaydeder, böylece sipariş bir kez sayılır. Bu, ilk kopyadan itibaren 48 saatlik bir pencere içinde gelen eşleşen kopyalar için çalışır.

ROASaurus bir satın alımın olay kimliğini Shopify sipariş kimliğinden oluşturur. 5512345678901 numaralı siparişin satın alımının olay kimliği, ödeme sayfası pikselinde ve sunucuda order-5512345678901'dir. Ürün görüntüleme ve sepete ekleme gibi mağaza olayları gerçekleştiğinde rastgele bir kimlik alır ve tarayıcı kopyası ile sunucu kopyası onu paylaşır.

Bunun sayılar için ne anlama geldiği şöyle. Bir haftada 200 siparişi olan örnek bir mağaza düşünün. Piksel bunların 150'sinde tetiklenir. Diğer 50 alışveriş yapan bir reklam engelleyici kullanmış, pazarlama çerezlerini reddetmiş ya da onay sayfası yüklenmeden ayrılmıştır. Events API 200'ünün hepsini gönderir.

Endişelenmeniz gereken sayı 350'dir. TikTok'un satın alım sayısını ve ona dayanan ROAS'ı gerçeğin %75 üzerine çıkarır, çünkü 350 ÷ 200 = 1.75. TikTok bu olayları optimizasyon ve hedefleme için de kullanır, bu yüzden teklif verme sistemi gerçekleşmemiş 150 satın alımdan öğrenir.

Shopify'da satın alımlar neden iki kez sayılır?

Çift sayım, TikTok'un eşleştiremediği bir satın alımın iki kopyasını aldığında olur. TikTok satın alımlarındaki bir sıçramaya güvenmeden önce şu nedenleri kontrol edin:

• İki araç aynı pikseli gönderir. Shopify'daki TikTok satış kanalı uygulaması da pikseliniz için olay gönderebilir. Olay kimlikleri ROASaurus'un kullandığı kimliklerle eşleşmez, bu yüzden TikTok her siparişi iki kez sayar. O uygulamadaki pikselin bağlantısını kesin.
• Piksel tema kodunuzda da var. Temaya yapıştırılmış bir piksel kod parçası, sizin olay kimliklerinizi taşımadan kendi olaylarını tetikler. Onu kaldırın ve pikseli tek bir aracın yüklemesine izin verin.
• Bir tarafta event_id yok. event_id'si olmayan ya da yeni rastgele bir kimlik taşıyan bir sunucu satın alımı, piksel kopyasıyla eşleştirilemez.
• Olay adları farklı. TikTok yalnızca özdeş olaylarda mükerrer kaydı önler. Bir satın alımın iki kopyası da aynı olay adını kullanmalıdır.

Çift sayım hakkındaki yardım makalesi, Meta ve diğer platformlar için aynı kontrolleri adım adım anlatır.

Events API, TikTok Events Manager'da nasıl test edilir?

TikTok Events Manager'da hem tarayıcı hem sunucu olayları için bir Test events sekmesi vardır. Verilere güvenmeden önce onu kullanın:

1. Bir test olayı kodu kopyalayın

   TikTok Events Manager'da pikselinizi açın ve Test events bölümüne gidin. Test olayı kodunu kopyalayın.

2. ROASaurus'a yapıştırın

   Tracking & platforms bölümünü açın, TikTok pikselini düzenleyin ve kodu Test event code alanına yapıştırın. Sunucu olayları artık onu taşır.

3. Bir test siparişi verin

   Mağazanızı ziyaret edin, bir ürünü görüntüleyin, sepete ekleyin ve bir sipariş tamamlayın.

4. İki tarafı da kontrol edin

   Test events'te tarayıcı ve sunucu olaylarına göre filtreleyin. Satın alımı ikisinde de görmelisiniz. ROASaurus'ta Event log her sunucu gönderimini gönderildi veya başarısız olarak gösterir.

5. Test kodunu kaldırın

   İşiniz bittiğinde test olayı kodunu silin; böylece canlı sunucu olaylarınız artık test olayı olarak gönderilmez.

TikTok bir isteğe HTTP 200 ile yanıt verip yine de olayı, yanıt gövdesinde bir hata koduyla reddedebilir. ROASaurus bu kodu okur, böylece reddedilen bir olay sessizce geçmek yerine Event log'da başarısız olarak görünür.

Bir günlük canlı trafikten sonra Events Manager'da pikselin genel bakışını açın. Her olayı bağlantı yöntemi, Event Match Quality puanı ve en son ne zaman alındığıyla listeler. Olay ayrıntıları eşleştirme ve mükerrer kayıt önleme bilgilerini içerir ve Diagnostics, kalite sorunlarını nasıl düzelteceğinize dair rehberlikle listeler.

TikTok Events API, ROASaurus ile Shopify'da nasıl kurulur

ROASaurus uygulaması kurulu bir Shopify mağazasına ve TikTok Events Manager erişimine ihtiyacınız var. TikTok entegrasyon sayfası ROASaurus'un gönderdiği her alanı listeler.

1. Shopify mağazanızı bağlayın

   Add a store › Shopify yolunu izleyin, Install app'e tıklayın ve tema düzenleyicide ROASaurus app embed'ini açın. Embed her sayfada ttclid'i ve _ttp çerezini yakalar. Shopify kurulum rehberi her adımı gösterir.

2. Ödeme sayfası pikselini ekleyin

   Shopify admin › Settings › Customer events bölümünde ROASaurus adlı özel bir piksel ekleyin ve Tracking & platforms sayfanızdaki kod parçasını yapıştırın. Bu piksel, satın alımın tarayıcı kopyası dahil TikTok pikselini ödeme sayfasında tetikler.

3. Bir erişim token'ı oluşturun

   TikTok Events Manager'da pikselinizi açın ve ayarlarında bir Events API erişim token'ı oluşturun. Token'ı ve piksel kodunu kopyalayın.

4. ROASaurus'ta TikTok pikselini ekleyin

   Tracking & platforms bölümüne gidin, TikTok kartında Add pixel'e tıklayın ve Pixel code ile Events API access token alanlarını doldurun. Tarayıcı ve sunucu olayları kimlikleri paylaşsın diye Also load the browser pixel (recommended, deduplicated) işaretli kalsın.

5. Harcamayı ekleyin (isteğe bağlı)

   Advertiser ID for spend ve Marketing API token alanlarını doldurun. ROASaurus bu durumda TikTok harcamasını içe aktarır, böylece TikTok kampanyaları diğer kanallarınızın yanında ROAS ve CPA gösterir.

6. Test edin, sonra yayına alın

   Yukarıda anlatıldığı gibi bir test olayı koduyla bir test siparişi gönderin, sonra kodu kaldırın.

Varsayılan olan Respect visitor consent açıkken ROASaurus, alışveriş yapanın Shopify çerez bannerındaki tercihine uyar. Alışveriş yapan pazarlama çerezlerini reddettiğinde ROASaurus onun için TikTok pikselini yüklemez, ziyaretçi kimliği atamaz (böylece tıklamaları kendisiyle ilişkilendirilmez) ve gezinme olaylarını TikTok'a göndermez. Ödenmiş siparişi yine de sunucudan Events API'ye gönderilir; hash'lenmiş sipariş verisi ile siparişin IP adresi ve user agent'ıyla, ancak ttclid veya _ttp olmadan. Rıza ve gizlilik rehberi nelerin saklandığını ve gönderildiğini açıklar.

Harcama senkronize edildiğinde TikTok kampanyaları atıf raporlarında Meta'nın yanında görünür ve kreatif analitiği reklam başına TikTok'un video istatistiklerini ekler. ROASaurus siparişleri kaydettiği reklam tıklamalarına ve UTM'lere atfeder ve görüntüleme sonrası dönüşümleri yalnızca Clicks & views modelinde modellenmiş bir tahmin olarak sayar; bu yüzden toplamları genellikle TikTok Ads Manager'dan farklıdır. Diğer sunucu tarafı platformlar için Pinterest Conversions API rehberine ve Meta Conversions API rehberine bakın.

Kaynaklar

1. TikTok For Business: About Events API
2. TikTok Ads Manager: About Event Deduplication
3. TikTok Ads Manager: How to Adopt TikTok's Updated Standard Events
4. TikTok Ads Manager: How to set up matching events with Events API
5. TikTok Ads Manager: About diagnostic and monitoring tools in TikTok Events Manager

ROASaurus'ta

• TikTok entegrasyonu
• ROASaurus'ta sunucu tarafı takip
• Yardım: çift sayımı önleme
• Yardım: ROASaurus'u Shopify'da kurma

Okumaya devam edin