TikTok Events API, sitenizdeki satın alma, sepete ekleme ve form gibi olayları ziyaretçinin tarayıcısı yerine sizin sunucunuzdan TikTok'a gönderen sunucu taraflı ölçüm bağlantısıdır. Pixel'in yerine geçmez. Pixel ile paralel çalışır, aynı olayı aynı event_id ile göndererek tekilleştirildiğinde tarayıcıda kaybolan dönüşümleri geri kazandırır, tekilleştirme kurulmazsa satışları iki kez saydırır.
Sahada gördüğüm Events API kurulumlarının önemli bir kısmı açık ama işe yaramıyor. Ya sunucu olayı müşteri bilgisi taşımadığı için hiçbir reklamla eşleşmiyor, ya event_id iki tarafta farklı üretildiği için satın almalar ikiye katlanıyor ya da kurulum onay vermemiş ziyaretçinin verisini de gönderiyor. Sunucu taraflı bağlantı, bütün ölçüm düzeninin yalnızca bir katmanı. Düzenin geri kalanını dönüşüm takibi ve ölçümleme rehberinde anlattım. Aşağıda Events API'yi hangi işletmenin gerçekten kurması gerektiğinden tekilleştirme ve teste kadar sahada uyguladığım haliyle anlatıyorum.
TikTok Events API nedir, pixel'in yerini alır mı?
TikTok Events API, dönüşüm olaylarını sunucudan sunucuya TikTok'a ileten ve Meta'daki Conversions API'nin TikTok tarafındaki karşılığı olan bir bağlantıdır. Pixel'in yerini almaz. Tarayıcının engellediği ya da kaçırdığı olayları tamamlar ve pixel'in hiç göremeyeceği olayları, örneğin sonradan onaylanan siparişleri, TikTok'a taşır.
Tarayıcıda çalışan TikTok Pixel, reklam engelleyici, tarayıcı izleme kısıtları, yavaş yüklenen teşekkür sayfası ve çerez reddi yüzünden olayların bir kısmını kaybeder. Sunucu olayı bunların çoğundan etkilenmez, çünkü istek sizin sunucunuzdan çıkar. Buna karşılık sunucu, tarayıcının doğal olarak bildiği çerez ve tıklama kimliği gibi bilgileri kendiliğinden bilmez. O bilgileri siz taşımazsanız olay TikTok'a ulaşır ama kimseyle eşleşmez. İki katmanı birlikte kullanmamın nedeni budur. Kavramın kısa tanımı Events API sözlük maddesinde, reklam performansına etkisi TikTok'ta CPA ve ROAS nasıl yorumlanır yazısında var.
Events API hangi işletmeye gerçekten gerekir?
Satın almaya optimize edilen TikTok kampanyası yürüten, iOS trafiği yüksek, ödeme adımı farklı bir alan adında ya da sipariş onayı sonradan gelen her e-ticaret sitesi için Events API gerekir. TikTok'u yalnızca erişim ve video görüntüleme için kullanan ya da ayda bir avuç dönüşüm alan bir hesap için önce pixel'i düzeltmek daha önceliklidir.
Karar verirken baktığım dört işaret var. Birincisi, TikTok panelindeki satın alma sayısının sipariş sisteminizdeki TikTok kaynaklı siparişlerin belirgin biçimde altında kalması. İkincisi, ödemenin banka ya da ödeme kuruluşu sayfasında tamamlanıp teşekkür sayfasına dönüşün bazen gerçekleşmemesi. Üçüncüsü, havale ve kapıda ödeme gibi onayı sonradan gelen siparişlerin payının yüksek olması. Dördüncüsü, form ya da talep toplayan bir işletmede asıl değerli olayın satış ekibinin CRM'de işaretlediği nitelikli talep olması. Son durumda Events API, sunucudan ya da CRM'den çevrimdışı olay göndermenin yoludur. Mantığını lead kampanyalarında dönüşüm takibi yazısında açtım.
TikTok Events API hangi yöntemle kurulur?
Events API bağlantısı partner platform entegrasyonu, sunucu taraflı Google Tag Manager, doğrudan API bağlantısı ya da sunucu taraflı etiketlemeyi hizmet olarak sunan barındırılan çözümlerle kurulur. Shopify ve WooCommerce gibi resmi entegrasyonu olan altyapıda entegrasyon, Meta ve Google için de sunucu tarafı kuracak işletmede sunucu taraflı GTM en mantıklı yoldur.
| Yöntem | Kime uygun | Avantajı | Dikkat edilecek yer |
|---|---|---|---|
| Partner entegrasyonu | Resmi TikTok entegrasyonu olan altyapılar | Olaylar, event_id ve müşteri bilgileri hazır gelir | Ayrıca elle eklenen pixel ya da GTM etiketiyle çift sayım |
| Sunucu taraflı GTM | Meta CAPI, GA4 ve Google Ads için de sunucu tarafı kurulacaksa | Tüm platformlar tek sunucu kapsayıcısından beslenir | Barındırma maliyeti ve teknik bakım |
| Doğrudan API | Kendi yazılım ekibi olan, sipariş sistemine erişen markalar | Sonradan onaylanan sipariş ve CRM olayları için en esnek yol | event_id ve tıklama kimliğini web tarafından taşımak gerekir |
| Barındırılan sunucu çözümleri | Sunucu yönetmek istemeyen orta ölçekli mağazalar | Kurulum hızlı, bakım yükü düşük | Aylık abonelik, verinin üçüncü taraftan geçmesi |
Kendi deneyimimde en çok sorun çıkaran şey, yöntemlerin üst üste binmesi. Altyapının TikTok uygulaması hem pixel'i hem Events API'yi açmışken bir de sunucu taraflı GTM'den satın alma göndermek, aynı siparişi üç kanaldan yollamak demek. Önce hangi olayın hangi kanaldan gittiğini bir tabloya yazarım, sonra fazlasını kapatırım.
Sunucu taraflı GTM ile TikTok Events API kurulumu hangi sırayla yapılır?
Sunucu taraflı GTM ile TikTok Events API kurulumu, web kapsayıcısından sunucu kapsayıcısına veri akışını kurmak, sunucu kapsayıcısına TikTok'un Events API etiketini eklemek ve web tarafında üretilen event_id ile müşteri bilgilerini bu etikete taşımak sırasıyla yapılır. Test, yayından önce Events Manager'ın verdiği test koduyla yapılır.
- Kapsayıcıyı kendi alt alan adınızda (örneğin ölçüm için ayrılmış bir alt alan adı) çalıştırın. Birinci taraf bağlam, çerezlerin ömrünü ve eşleşmeyi doğrudan etkiler.
- Web kapsayıcısındaki GA4 akışını sunucu kapsayıcısına yönlendirin. E-ticaret olayları sunucuya bu akışla ulaşır.
- Pixel ayarlarından, Events Manager üzerinden Events API için erişim belirteci (access token) üretin ve bir sabit değişkende saklayın.
- Şablon galerisinden TikTok Events API etiketini sunucu kapsayıcısına ekleyin, pixel ID ve erişim belirtecini girin.
- view_item, add_to_cart, begin_checkout ve purchase olaylarını TikTok'un ViewContent, AddToCart, InitiateCheckout ve Purchase adlarına eşleyin.
- event_id, e-posta, telefon, müşteri kimliği, ttclid ve _ttp çerez değerini web tarafından sunucuya parametre olarak geçirin.
- Test koduyla birkaç sipariş akışı gönderin, olayların Test Events ekranında Pixel ve Events API kaynağıyla ayrı ayrı göründüğünü kontrol edin, sonra yayınlayın.
Meta Conversions API'yi aynı kapsayıcıyla kurduysanız TikTok etiketi birkaç saatlik iştir. Altyapı zaten hazırdır, yalnızca olay eşlemesi ve kimlik alanları değişir. Meta tarafındaki kurulumu Meta Conversions API kurulumu yazısında, sunucu kapsayıcısının kendisini ve barındırma kararını server-side tracking ne zaman gerekir yazısında anlattım.
Pixel ve Events API olayları nasıl tekilleştirilir?
Pixel ve Events API olayları, aynı olay için iki tarafta da aynı olay adı ve aynı event_id gönderilerek tekilleştirilir. TikTok'un belgesine göre aynı ada ve aynı event_id'ye sahip olaylar ilk olaydan sonraki 48 saat içinde tekilleştiriliyor. İlk ulaşan olay tutuluyor ve sonradan gelenin bilgileriyle zenginleştiriliyor.
Aynı belgeye göre tekilleştirme yalnızca pixel ile sunucu arasında değil, yalnızca pixel'den ya da yalnızca sunucudan gelen tekrarlarda da çalışıyor. Teşekkür sayfası yenilendiğinde aynı event_id ile giden ikinci Purchase olayı da bu sayede sayılmıyor. Farklı olayları farklı kanaldan gönderiyorsanız, örneğin sepete eklemeyi yalnızca pixel'den, satın almayı yalnızca sunucudan, tekilleştirmeye gerek kalmıyor.
Tekilleştirme kurulmazsa ne olacağını varsayımsal bir örnekle düşünün. Diyelim ki ayda 500 sipariş alıyorsunuz, pixel bunların 400'ünü, sunucu 480'ini görüyor. event_id yoksa panel 880 satın alma gösterir, satın alma başı maliyet neredeyse yarıya iner ve TikTok'un raporladığı ROAS gerçeğin iki katına yaklaşır. Bu şişkinliği fark etmeden bütçe artırılırsa, kâr tablosu ay sonunda paneli yalanlar. Platformun raporladığı ROAS'ı nasıl yorumladığımı TikTok'ta CPA ve ROAS nasıl yorumlanır yazısında anlattım.
event_id hangi değerden üretilmeli?
Satın alma olayında event_id, sipariş numarasından üretilmeli. Ürün görüntüleme ve sepete ekleme gibi diğer olaylarda ise tarayıcıda olay anında üretilen benzersiz bir kimlik kullanılmalı ve aynı kimlik hem pixel'e hem sunucuya iletilmelidir. Pixel ve sunucu event_id'yi birbirinden bağımsız üretirse iki kimlik asla eşleşmez.
Sipariş numarasını kullanmanın bir yan faydası da var. Sipariş onayı sonradan geldiğinde, örneğin havale onaylandığında, sunucu olayını aynı sipariş numarasıyla gönderebilirsiniz ve teşekkür sayfasında pixel'in gönderdiği olayla çakışmaz. Bir şartla. Olay adı iki tarafta da Purchase olmalı. Bir tarafta eski CompletePayment, diğer tarafta Purchase kullanılıyorsa TikTok bunları iki ayrı olay olarak görür.
Sunucu olayında hangi müşteri bilgileri gönderilmeli?
Onay alınmış olması koşuluyla, TikTok Events API olayında SHA-256 ile karma değere çevrilmiş e-posta ve telefon, müşteri kimliği (external_id), IP adresi, tarayıcı bilgisi (user agent), reklam tıklamasından gelen ttclid ve pixel'in _ttp çerez değeri gönderilmelidir. Bu alanlar ne kadar eksiksizse sunucu olayı o kadar çok reklam tıklamasıyla eşleşir.
| Alan | Nereden alınır | Sahada sık gördüğüm hata |
|---|---|---|
| E-posta | Sipariş ya da üyelik kaydı | Küçük harfe çevrilmeden ve boşluk temizlenmeden karma değere çevrilmesi |
| Telefon | Sipariş formu | Ülke kodu eklenmemesi, başında 0 kalması |
| external_id | Müşteri ya da üye numarası | Pixel'de ve sunucuda farklı kimliklerin kullanılması |
| ttclid | Reklamdan gelen ilk sayfanın URL'si | Ödeme adımına kadar saklanmadığı için satın alma anında boş gitmesi |
| _ttp çerezi | Pixel'in birinci taraf çerezi | Sunucuya hiç taşınmaması |
| IP ve user agent | Ziyaretçinin isteği | Sunucunun kendi IP'sinin ya da sipariş sistemindeki boş değerin gönderilmesi |
Tablodaki en pahalı hata ttclid ile ilgili. Ziyaretçi reklama tıklayıp ürün sayfasına iniyor, üç sayfa gezip ödemeye geçiyor. Satın alma anında URL'de artık tıklama kimliği yok. Kimliği ilk sayfada yakalayıp birinci taraf bir çerezde ya da oturumda saklamazsanız, sunucu olayı reklamla en güçlü bağını kaybeder. Doğrudan API ile sipariş sisteminden olay gönderiyorsanız ttclid'i siparişin kaydına yazmak gerekir.
Events API kurulumu doğru çalışıyor mu, nasıl test edilir?
Events API kurulumu, Events Manager'daki Test Events ekranının verdiği test koduyla olay gönderilerek, ardından canlıda pixel ve sunucu olay sayıları ile sipariş sistemindeki sipariş sayısı kıyaslanarak test edilir. Testin amacı yalnızca olayın ulaştığını görmek değil, aynı siparişin bir kez sayıldığını ve doğru tutarla geldiğini doğrulamaktır.
Test kodu, olayların canlı rapora karışmadan görünmesini sağlar. Testi bitirdikten sonra kodu etiketten kaldırmayı unutan kurulumlar gördüm, o durumda canlı olaylar da test olarak kalıyor. Canlıya aldıktan sonra bir hafta boyunca günlük üç sayıyı yan yana koyarım. Sipariş sistemindeki sipariş sayısı, Events Manager'da pixel kaynaklı Purchase sayısı ve sunucu kaynaklı Purchase sayısı. Sunucudan gelen sayı sipariş sayısına yakın, pixel sayısı onun altında ve panelde raporlanan satın alma toplamı sipariş sayısını aşmıyorsa kurulum sağlıklıdır. Panel toplamı sipariş sayısını geçiyorsa tekilleştirme çalışmıyordur.
Haftalık kontrolde Events Manager'ın tanılama ekranına da bakarım. Eksik parametre, geçersiz para birimi ve tekilleştirme sorunları orada uyarı olarak görünüyor. Satın alma olayını gerçek siparişle nasıl uçtan uca test ettiğimi purchase event test adımları yazısında, Events API'nin pixel tarafındaki ön koşullarını TikTok Pixel kurulumu yazısında topladım.
Sunucu taraflı kurulumda çerez onayı ve KVKK nasıl gözetilir?
Events API, çerez onayını aşmanın yolu değildir. Pazarlama çerezlerine onay vermeyen ziyaretçinin olayı sunucudan da TikTok'a kişisel veriyle gönderilmemelidir. Sunucu kapsayıcısı web tarafındaki onay durumunu her olayla birlikte almalı ve TikTok etiketini yalnızca onay varsa çalıştırmalıdır.
"Sunucudan gidiyor, tarayıcı engelleyemiyor" düşüncesiyle onaysız veriyi gönderen kurulumlarla karşılaşıyorum. Bu hem KVKK hem platform politikaları açısından risklidir ve denetimde bütün kurulumun geri alınmasına yol açar. Aydınlatma metninde TikTok'a sunucu üzerinden aktarımın yazılı olması, karma değere çevirmenin veriyi anonim yapmadığının bilinmesi gerekir. Onay durumunun ölçüme etkisini Consent Mode reklam ölçümünü nasıl etkiler yazısında, panelle analitik arasındaki farkların kaynağını reklam paneli ve GA4 verileri neden farklı yazısında anlattım. Hukuki sınırı kendi hukuk danışmanınızla netleştirin.
TikTok Events API kurulumunu kim yapmalı, maliyeti neye göre değişir?
Resmi TikTok entegrasyonu olan bir altyapıda Events API'yi mağaza sahibi kendisi açabilir. Sunucu taraflı GTM, doğrudan API ya da CRM bağlantısı gerekiyorsa kurulumu ölçüm altyapısını bütün platformlarla birlikte ele alan bir uzman yapmalıdır. Maliyet, kullanılan yöntem, sunucu barındırma ihtiyacı, ödeme akışının karmaşıklığı ve kaç platformun aynı altyapıya bağlanacağına göre değişir.
Benim tercihim, TikTok için ayrı bir sunucu projesi açmak yerine Meta, Google Ads ve GA4 ile aynı kapsayıcıyı paylaşmak. Bir kez kurulan altyapıya her yeni platform düşük maliyetle eklenir ve olay tanımları tek yerde kalır. Satışlar zaten düşükse önce sorunun ölçümde mi kampanyada mı olduğunu ayırın. Kampanya tarafındaki teşhisi TikTok reklamlarında satış gelmiyorsa yazısında anlattım. Kurulumu sizin için yapmamı isterseniz kapsamı dönüşüm takibi ve ölçümleme kurulumu sayfasında bulabilirsiniz.
Denedim, tutmadı
- Yalnızca sunucudan gönderip pixel'i kapatmak. Olay sayısı tuttu ama eşleşme zayıfladı. Tarayıcı tarafındaki çerez ve tıklama bilgisi gidince kampanyalar daha az dönüşüm raporladı.
- event_id'yi sunucuda yeniden üretmek. Pixel ve sunucu iki ayrı kimlik gönderdi, tekilleştirme hiç çalışmadı ve satın almalar ikiye katlandı.
- Müşteri bilgisi olmadan sunucu olayı. Olaylar Events Manager'a ulaştı ama reklamlarla neredeyse hiç eşleşmedi, kurulum kâğıt üzerinde çalışıyordu.
Sık sorulan sorular
TikTok Events API kullanmak ücretli mi?
Events API'yi kullanmak TikTok tarafında ücretsizdir. Maliyet, sunucu taraflı GTM için barındırma, barındırılan bir çözümün aylık aboneliği ya da kurulumu yapan geliştirici ve danışman ücretinden doğar.
Pixel kapatılıp yalnızca Events API kullanılabilir mi?
Teknik olarak yalnızca Events API ile olay göndermek mümkündür, ama önermem. Pixel'in tarayıcıdan topladığı çerez ve tıklama bilgisi olmadan sunucu olaylarının eşleşmesi zayıflar. Sağlıklı kurulum, aynı olayları iki kanaldan aynı event_id ile göndermektir.
Shopify'da TikTok Events API için ayrıca kurulum gerekir mi?
Shopify'da TikTok uygulaması kurulup veri paylaşımı en geniş seviyede açıldığında Events API bağlantısı genellikle uygulama üzerinden sağlanır, ayrıca sunucu kurulumu gerekmez. Temaya elle eklenmiş eski bir TikTok kodu ya da GTM etiketi varsa onu kaldırmak gerekir, yoksa çift sayım başlar.
TikTok Events API ROAS'ı artırır mı?
Sunucu taraflı bağlantı gerçek satışları artırmaz, TikTok'un gördüğü satış oranını artırır. Raporlanan ROAS bu yüzden yükselir. Kampanyanın daha eksiksiz veriyle öğrenmesi zamanla gerçek verimi de iyileştirebilir, ama kurulumdan hemen sonraki artışı kampanya başarısı sanmayın.
Kapıda ödeme ve havale siparişleri Events API ile gönderilebilir mi?
Kapıda ödeme ve havale siparişleri, onaylandıkları anda sipariş sisteminden Events API ile gönderilebilir. Bunun için siparişin kaydında ttclid ve müşteri bilgileri saklanmalı, event_id sipariş numarasından üretilmeli ve teşekkür sayfasındaki pixel olayıyla aynı kimlik kullanılmalıdır.
Kaynaklar
Reklamların satış getirmiyor mu?
Reklam hesabını birlikte inceleyelim, nerede bütçe kaybettiğini netçe görelim.
Ücretsiz Ön Görüşme