TikTok Dönüşüm API'si Kurulum ve Takip Kılavuzu
TikTok Dönüşüm API'sinin nasıl çalıştığını, Pixel ile Olaylar API'sinin nasıl kurulacağını, yinelenen olayların nasıl önleneceğini, eşleşmenin nasıl iyileştirileceğini ve dönüşüm takibinin nasıl test edileceğini öğrenin.

Yazan:
Kinnari Ashar
Okuma süresi: 15 dk

TikTok kampanyanız yüzeyde karlı görünebilirken, en değerli dönüşümlerinden bazıları raporda hiçbir zaman yer almayabilir. Bir müşteri bir ürünü görüntüleyebilir, sepetine ekleyebilir, ödemeyi tamamlayabilir veya bir potansiyel müşteri formu gönderebilir; ancak bu eylemin arkasındaki yol eksik kalabilir.
Bu eksik veriler raporlamadan daha fazlasını etkiler. TikTok'un hangi reklamlara öncelik vereceğini, bütçeyi nereye ayıracağınızı ve kampanya performansını ne kadar güvenle değerlendireceğinizi etkileyebilir.
Resmi olarak Events API olarak bilinen TikTok Conversion API, bu resmi daha net hale getirmek için tasarlanmıştır. Ancak bundan yararlı veriler elde etmek, onu nasıl kurduğunuza, TikTok Pixel ile nasıl bağladığınıza ve çakışan etkinlikleri nasıl yönettiğinize bağlıdır.
Aşağıdaki bölümler, süreci teknik bir labirente dönüştürmeden önemli olan kısımları açıklamaktadır.
TikTok Conversion API Nedir?
Resmi adı TikTok Events API olan TikTok Conversion API, web sitenizden, e-ticaret platformunuzdan, uygulamanızdan, CRM'inizden, sunucunuzdan veya çevrimdışı sisteminizden doğrudan TikTok'a pazarlama ve dönüşüm etkinlikleri gönderen sunucudan sunucuya (server-to-server) bir bağlantıdır.
İşletmenize ve kurulumunuza bağlı olarak şu gibi eylemleri bildirebilirsiniz:
Ürün görüntülemeleri ve aramaları
Sepete eklemeler ve ödeme başlatmaları
Satın alımlar ve çevrimdışı satışlar
Kayıtlar ve form gönderimleri
Abonelikler ve nitelikli potansiyel müşteriler
TikTok, dönüşümleri ölçmek, sonuçları reklamlara atfetmek, dağıtımı optimize etmek, kitleler oluşturmak ve yeniden hedeflemeyi desteklemek için uygun etkinlik verilerini kullanabilir. Bu sonuçların kalitesi; sağladığınız bilgilerin doğruluğuna, eksiksizliğine, eşleşen ayrıntılarına ve izin durumuna bağlıdır.
Events API, TikTok'un diğer geliştirici ürünlerine göre daha dar bir amaca sahiptir. Marketing API reklam işlevlerini yönetir, TikTok Shop API'leri ticaret operasyonlarını destekler ve Research API, onaylanmış araştırmacılara seçilen herkese açık platform verilerine erişim sağlar. Events API ise pazarlama etkinlikleri göndermeye odaklanır.
TikTok Conversion API Nasıl Çalışır?
TikTok Conversion API, kaydedilen bir müşteri eylemini iş sistemlerinizden TikTok'a aktarır; burada uygun bir reklam etkileşimiyle eşleştirilebilir ve ölçüm için kullanılabilir.
Süreç genellikle şu sırayı takip eder:
Bir müşteri TikTok reklamınızı görüntüler veya tıklar ve web sitenizi ya da mağazanızı ziyaret eder.
Ürün görüntüleme, sepete ürün ekleme, form gönderme veya sipariş verme gibi bir eylemi tamamlar.
Web siteniz, e-ticaret platformunuz, ödeme sisteminiz veya CRM'iniz bu eylemi kaydeder.
Sunucunuz veya entegrasyonunuz etkinlik adı, saat, sipariş değeri, ürün bilgisi ve mevcut eşleme verileri gibi ayrıntıları içeren bir etkinlik oluşturur.
Etkinlik, TikTok Events API'ye gönderilir.
TikTok, eylemi bir TikTok kullanıcısı veya reklam etkileşimiyle bağlamak için tıklama verileri, iletişim bilgileri, tarayıcı bilgileri veya diğer uygun eşleme alanları gibi tanımlayıcıları kullanır.
Eşleşen etkinlikler; raporlamaya, ilişkilendirmeye, kampanya optimizasyonuna, yeniden hedeflemeye ve kitle oluşturmaya katkıda bulunabilir.
Web takibi için aynı eylem TikTok'a Pixel aracılığıyla da ulaşabilir:
TikTok reklamı → Web sitesi ziyareti → Müşteri eylemi → Pixel etkinliği ve sunucu etkinliği → Tekilleştirme (Deduplication) → TikTok Ads Manager
Pixel engellendiğinde, onay sayfası yüklenmediğinde, ödeme başka bir yerde gerçekleştiğinde veya bağlantı çok çabuk sonlandığında tarayıcı isteği başarısız olsa bile, sunucu etkinliği onaylanmış bir sonucu bildirebilir.
Bununla birlikte, etkinliğin alınması TikTok ilişkilendirmesini garanti etmez. TikTok'un bu dönüşümü uygun bir reklam etkileşimiyle ilişkilendirebilmesi için hâlâ yeterli geçerli eşleme ve ilişkilendirme verisine ihtiyacı vardır.
TikTok Pixel ve TikTok Conversion API Karşılaştırması
TikTok Pixel ve Events API, dönüşüm verilerini farklı yollardan toplar. Pixel, etkinliği müşterinin tarayıcısında kaydederken Events API, etkinlikleri sunucunuzdan veya bağlı başka bir sistemden gönderir.
TikTok, mümkün olduğunda web dönüşüm takibi için her ikisinin de kullanılmasını önerir.
Özellik | TikTok Pixel | TikTok Conversion API |
Veri kaynağı | Müşterinin tarayıcısı | Sunucu, platform, uygulama, CRM veya çevrimdışı sistem |
İzleme yöntemi | Tarayıcı tabanlı | Sunucudan sunucuya |
Kurulum | Web sitesi kodu, Event Builder veya etiket yöneticisi | İş ortağı entegrasyonu, Events API Gateway, sunucu kapsayıcısı veya doğrudan API |
Tarayıcı kısıtlamaları | Daha çok etkilenir | Tarayıcı yürütmesine daha az bağımlıdır |
En uygun kullanım alanı | Sayfa görüntülemeleri ve site içi eylemler | Onaylanmış web sitesi, arka uç, CRM ve çevrimdışı sonuçlar |
CRM ve çevrimdışı etkinlikler | Sınırlı | Desteklenir |
Teknik zorluk | Genellikle daha düşük | Orta düzeyden ileri düzeye kadar değişir |
Tekilleştirme (Deduplication) | Yalnızca tek başına kullanıldığında gerekmez | Pixel aynı etkinliği gönderdiğinde gereklidir |
Pixel, site içi anlık davranışlar için daha uygundur; Events API ise onaylanan ödemeler veya nitelikli CRM potansiyel müşterileri gibi tarayıcı etkileşiminden sonra kaydedilen sonuçları doğrulayabilir.
Her ikisi de tek bir dönüşümü bildirdiğinde, TikTok, Ads Manager'ın bunu bir kez sayması için tekilleştirme gerektirir.
TikTok Events API Aracılığıyla Hangi Etkinlikleri ve Verileri Gönderebilirsiniz?
1. Standart Dönüşüm Etkinlikleri
TikTok, yaygın e-ticaret ve potansiyel müşteri yaratma eylemleri için standart etkinlik adları sağlar. Bu önceden tanımlanmış etkinlikler raporlamayı, dönüşüm optimizasyonunu ve kitle oluşturmayı destekleyebilir.
Yaygın etkinlikler şunları içerir:
ViewContent: Ziyaretçi bir ürün sayfasını veya başka bir önemli sayfayı açar.
Search: Bir kullanıcı web sitenizde bir ürün, kategori veya terim arar.
AddToWishlist: Bir alışverişçi bir ürünü daha sonra kullanmak üzere kaydeder.
AddToCart: Bir ürün sepete başarıyla eklenir.
InitiateCheckout: Müşteri ödeme adımlarını başlatır.
AddPaymentInfo: Ödeme sırasında ödeme bilgileri gönderilir.
Purchase: Tamamlanmış bir satın alma kaydedilir.
SubmitForm: Ziyaretçi bir potansiyel müşteri veya talep formunu başarıyla gönderir.
CompleteRegistration: Kullanıcı bir hesap oluşturmayı veya kaydolmayı tamamlar.
Subscribe: Müşteri bir abonelik işlemini tamamlar.
StartTrial: Kullanıcı bir deneme süresi başlatır.
Yalnızca etkinlik adı yeterli değildir. Her bir etkinliğin tam olarak ne zaman tetikleneceğine de karar vermeniz gerekir.
Örneğin Purchase, bir siparişin oluşturulmasını, ödemenin yetkilendirilmesini, ödemenin tahsil edilmesini veya siparişin karşılanmasını ifade edebilir. Bir tetikleyici seçin ve bunu web sitenizde, arka uçta ve raporlama sistemlerinizde tutarlı şekilde uygulayın.
Parametreler daha sonra etkinliğe bağlam katar. Eyleme bağlı olarak bunlar değer, para birimi, miktar, içerik kimlikleri ve ürün bilgilerini içerebilir. TikTok bazı parametreleri zorunlu olarak işaretlerken, etkinlik kalitesini ve kampanya performansını artırabilecekleri için diğerlerini önerir.
Aynı etkinliği farklı aşamalarda göndermek dönüşümlerin ve gelirin mükerrer görünmesine yol açabilir. Ads Manager'ın her müşteri eyleminin tek ve tutarlı bir versiyonunu alması için yayına girmeden önce tetikleyiciyi ve parametreleri standartlaştırın.
2. Etkinlik Parametreleri
Etkinlik tetikleyicisi netleştikten sonra parametreler ne olduğunu açıklar ve TikTok'a bunu doğru yorumlaması için gereken bilgileri sağlar.
Bir etkinlik şunları içerebilir:
Etkinlik adı: Bildirilen eylem (örneğin
AddToCartveyaPurchase).Etkinlik zamanı: Eylemin gerçekleştiği zaman.
Etkinlik Kimliği (Event ID): Aynı etkinliği Pixel ve Events API genelinde tanımak için kullanılan benzersiz bir tanımlayıcı.
Etkinlik kaynak URL'si: Eylemin gerçekleştiği sayfa.
Para birimi: İşlem için kullanılan para birimi.
Dönüşüm değeri: Etkinliğe bağlı toplam parasal değer.
Ürün veya içerik kimlikleri: İlgili ürünlerin tanımlayıcıları.
İçerik türü: Bildirilen içeriğin kategorisi.
Miktar: Eyleme dahil edilen birim sayısı.
Sipariş ayrıntıları: Ürün düzeyindeki içerik verileri gibi desteklenen satın alma bilgileri.
Ürün tanımlayıcıları, bağlı TikTok kataloğunuzda kullanılan biçimle aynı olmalıdır. Etkinlikleri eşlemeden önce kataloğun ürün kimliklerini, varyant kimliklerini, SKU'ları veya platforma özgü başka bir tanımlayıcıyı depolayıp depolamadığını kontrol edin.
Para birimi ve değer de tutarlı bir biçimlendirmeye ihtiyaç duyar. Eksik, statik veya yanlış eşlenmiş değerler, satın alma etkinliklerini kullanılabilir gelir verilerinden yoksun bırakabilir ve reklam harcaması getirisi (ROAS) raporlamasını zayıflatabilir.
3. Müşteri Eşleştirme Bilgileri
TikTok bir etkinliği aldıktan sonra, bu eylemi bir müşteriyle veya uygun bir reklam etkileşimiyle ilişkilendirmek için yeterli bilgiye ihtiyaç duyar.
Yaygın eşleme tanımlayıcıları şunları içerir:
TikTok tıklama kimliği (Click ID): Bir TikTok reklamı tıklamasına eklenen
ttcliddeğeri.Karma e-posta adresi (Hashed email): SHA-256 kullanılarak dönüştürülmüş standartlaştırılmış bir e-posta adresi.
Karma telefon numarası (Hashed phone): SHA-256 kullanılarak dönüştürülmüş, tutarlı şekilde biçimlendirilmiş bir telefon numarası.
Karma harici müşteri kimliği: TikTok'un teknik özelliklerine göre hazırlanmış kendi müşteri tanımlayıcınız.
Müşteri IP adresi: Web sitesi eylemi gerçekleştiğinde kaydedilen IP.
Tarayıcı kullanıcı aracısı (User agent): Müşterinin tarayıcısı ve cihazı hakkında bilgi.
TikTok birinci taraf tanımlayıcısı: Mevcut olduğunda desteklenen
_ttpçerez değeri.
Bir etkinlik Events API tarafından kabul edilse bile, bu alanlar eksikse, geçersizse veya yanlış biçimlendirilmişse yine de zayıf bir eşleşme üretebilir. Daha güçlü eşleştirme, yalnızca daha büyük bir veri paketi göndermeye değil, yasal olarak toplayabileceğiniz tanımlayıcıları göndermeye bağlıdır.
E-posta adresleri, telefon numaraları ve harici kimlikler tam olarak TikTok'un gerektirdiği şekilde standartlaştırılmalı ve karma (hash) haline getirilmelidir. Tıklama kimlikleri, IP adresleri, kullanıcı aracıları ve desteklenen çerez tanımlayıcıları kendi biçimlendirme kurallarına tabidir.
Kurulumunuz ayrıca onay tercihlerine, gizlilik bildirimlerine ve her pazarda geçerli olan veri koruma gereksinimlerine de uymalıdır.
TikTok Etkinlik Eşleştirme ve Tekilleştirme Nasıl Çalışır?
Etkinlik Eşleştirme
TikTok, bildirilen bir dönüşümü daha önce bir reklamla etkileşime girmiş bir kişiyle bağlamak için eşleme anahtarlarını kullanır. Yararlı anahtarlardan biri, bir reklam tıklamasından sonra açılış sayfası URL'sine eklenebilen TikTok tıklama kimliği veya ttclid'dir.
Ziyaretçi satın alma yolculuğunda ilerledikçe web siteniz bu değeri korumalıdır. Bunu nihai sipariş veya potansiyel müşteri kaydı ile birlikte saklamak, TikTok'un sonucu orijinal etkileşime geri bağlama şansını artırır.
Tıklama kimliği şu durumlarda kaybolabilir:
Yönlendirmenin URL parametrelerini kaldırması
Ödeme adımının başka bir etki alanına (domain) taşınması
Ödeme sağlayıcısının ayrı bir oturum başlatması
Takip değerlerinin URL'den temizlenmesi
Orijinal oturumun süresinin dolması
İletişim bilgileri ve harici müşteri kimlikleri de eşleştirmeyi destekleyebilir, ancak karma işleminden önce standartlaştırılmalıdır. Müşterinin gerçek IP adresini ve tarayıcı kullanıcı aracısını da kullanın.
Yer tutucu veri, sunucu IP'si veya arka uç kullanıcı aracısı göndermek, TikTok'a alıcı yerine sisteminiz hakkında bilgi verir.
Etkinlik Tekilleştirme (Deduplication)
Pixel ve Events API aynı dönüşümü gönderdiğinde TikTok'un bu iki kaydın tek bir müşteri eylemini tanımladığını tanıması gerekir. Tekilleştirme, bir satın alma işleminin, potansiyel müşterinin veya kaydın iki kez sayılmasını önler.
Her iki kopya da aynı etkinlik adını ve aynı benzersiz etkinlik kimliğini (Event ID) kullanmalıdır.
Örneğin:
Pixel
Purchase:order_84739Server
Purchase:order_84739
TikTok, çakışan etkinlikleri tanımlamak için bu alanları karşılaştırır. Raporlamanın tutarlı kalması için değer, para birimi ve ürün ayrıntıları da eşleşmelidir.
Bir sipariş kimliği, işlem kimliği, ödeme tamamlama kimliği veya sunucu tarafından oluşturulmuş kararlı bir UUID, her biri tek bir dönüşüme atıfta bulunduğu için iyi çalışabilir.
Ürün kimliklerinden, müşteri kimliklerinden, yeniden kullanılan oturum kimliklerinden veya tarayıcı ile sunucu tarafından ayrı ayrı oluşturulan rastgele kimliklerden kaçının.
API yeniden denemeleri orijinal etkinlik kimliğini tekrar kullanmalıdır. Yeni bir kimlik, yeniden denemenin başka bir dönüşüm gibi görünmesine neden olabilir.
TikTok Conversion API Nasıl Kurulur?
1. Adım: Bir Entegrasyon Yöntemi Seçin
İlk kararınız, etkinlik verilerinin iş sistemlerinizden TikTok'a nasıl aktarılacağıdır. En iyi yol; mevcut platformunuza, erişilebilir teknik desteğe ve etkinlik eşleme ile veri kalitesi üzerinde ne kadar kontrole ihtiyacınız olduğuna bağlıdır.
Her yöntem farklı bir karmaşıklık düzeyini ele alır; bu nedenle seçenekleri mağazanızın dönüşümleri kaydetme yöntemiyle karşılaştırın.
Ticaret platformu entegrasyonu: Desteklenen Shopify veya WooCommerce mağazaları için genellikle en basit yoldur. Platform; bağlantının, etkinlik eşlemenin ve katalog kurulumunun büyük kısmını yönetir.
Veri veya izleme iş ortağı: Halihazırda bir müşteri veri platformu (CDP), CRM, etiket yöneticisi veya sunucu izleme sağlayıcısı kullandığınız durumlar için uygundur. İş ortağının hangi etkinlikleri, tanımlayıcıları ve onay kontrollerini desteklediğini doğrulayın.
Doğrudan API entegrasyonu: Özel web siteleri, tescilli ödeme sistemleri, pazar yerleri, abonelik platformları veya sıra dışı dönüşüm mantıkları için daha iyidir. Daha fazla kontrol sunar ancak geliştirme, test etme, izleme ve bakım gerektirir.
Sunucu tarafı Google Tag Manager: Zaten bir sunucu kapsayıcısı çalıştıran ve etiketleri, tetikleyicileri, değişkenleri, GA4'ü ve bulut barındırmayı anlayan ekipler için pratik bir seçenektir. TikTok ayrıca bu yöntem için etkileşimli bir kurulum akışı da sağlar.
Bağlılık göstermeden önce gerekli etkinliklerinizi, teknik kaynaklarınızı, katalog yapınızı, etkinlik günlüklerine erişiminizi, mağaza sayınızı, onay kurulumunuzu ve lansmandan sonra bağlantıyı kimin sürdüreceğini değerlendirin.
2. Adım: Bir Etkinlik İzleme Planı Oluşturun
Entegrasyonu yapılandırmadan önce, her müşteri eylemine üzerinde anlaşmaya varılmış tek bir tanım veren bir izleme planı oluşturun. Bu, geliştiricilerin, pazarlamacıların ve analitik ekiplerinin aynı kurallarla çalışmasını sağlar.
Her etkinlik için aşağıdakileri kaydedin:
TikTok etkinlik adı
Eylemin işletmeniz için ne anlama geldiği
Bunu tetikleyen kesin koşul
Tarayıcıdan mı, sunucudan mı yoksa her ikisinden mi geldiği
Ona eşlik etmesi gereken veri alanları
Mevcut eşleştirme bilgileri
Benzersiz etkinlik kimliğinin kaynağı
Geçerli onay koşulları
Örnek olarak Purchase etkinliğini ele alalım. Mağaza bir sipariş oluşturduğunda mı yoksa yalnızca ödeme başarılı olduktan sonra mı tetiklenmesi gerektiğine karar verin. Çoğu mağaza için onaylanmış ödeme, tamamlanan gelir konusunda daha güvenilir bir görünüm sağlar çünkü ödenmemiş ve başarısız siparişler hariç tutulur.
Bu kuralı plana yazın, ardından ödeme adımlarınızda, arka uçta, Pixel ve Events API kurulumunuzda uygulayın. TikTok her iki izleme rotasında da standart etkinlikleri destekler, bu nedenle tek bir ortak tanım daha sonra çelişkili raporların oluşmasını engeller.
3. Adım: Doğru TikTok Veri Kaynağını Bağlayın
Ardından, kampanyaları yürütecek reklamveren hesabından Olay Yöneticisi'ni (Events Manager) açın.
Araçlar'a gidin, Olay Yöneticisi'ni seçin, Veri Kaynağını Bağla'yı seçin ve ardından Web'i seçin. Yeni bir web sitesi veri bağlantısı oluşturun veya doğru siteyle ilişkili mevcut olanı açın.
Kurulumu tamamlamadan önce web sitesi URL'sini, Pixel kodunu, reklamveren hesabını ve kullanıcı izinlerini onaylayın. Bu kontrol, özellikle bir İş Merkezi (Business Center) içinde birden fazla mağaza veya müşteri hesabı bulunduğunda çok önemli hale gelir.
Pixel ve Events API aynı web sitesindeki etkinliği bildirdiğinde, her ikisini de hedeflenen web sitesi veri bağlantısına bağlayın. Yanlış hedefin kullanılması, geçerli etkinlikleri ilgisiz bir hesaba gönderebilir ve asıl kampanyaları ihtiyaç duydukları verilerden mahrum bırakabilir.
4. Adım: Erişim Belirtecini (Access Token) Oluşturun ve Güvene Alın
Doğrudan bir Events API entegrasyonu oluşturuyorsanız isteklerin kimliğini doğrulamak için kullanılan erişim belirtecini oluşturun. İş ortağı entegrasyonları, kimlik doğrulamasını kendi bağlantı süreçleri aracılığıyla yönetebilir.
Belirteci korumalı bir sunucu ortamında, gizli dizi yöneticisinde (secrets manager) veya şifrelenmiş yapılandırma dosyasında saklayın. Yalnızca entegrasyondan sorumlu sistemler ve kişiler erişime sahip olmalıdır.
Belirteci asla şuralarda açığa çıkarmayın:
Web sitesi kaynak kodu
Tarayıcı betikleri
Herkese açık havuzlar (public repositories)
Paylaşılan ekran görüntüleri
Korumasız günlükler (logs)
İstemci tarafı koduna yerleştirilen bir belirteç, tarayıcı araçları aracılığıyla görüntülenebilir. Birisi herkese açık hale gelirse derhal değiştirin ve beklenmeyen istekler için etkinlik trafiğinizi inceleyin.
Etkinlik iletimini kesintiye uğratmadan kimlik bilgisinin nasıl yenilenebileceğini (rotate) belgeleyin.
5. Adım: Etkinlik Verilerini Yakalayın ve Hazırlayın
Bağlantı kurulduktan sonra TikTok'un her etkinlikle birlikte alacağı bilgileri hazırlayın.
Açılış sayfasındaki ttclid değerini koruyun ve bunu yönlendirmeler, ödeme adımları boyunca taşıyın. Mümkün olduğunda bunu nihai sipariş veya potansiyel müşteri ile birlikte kaydedin.
Ardından, yalnızca onay kurulumunuzun izin verdiği müşteri tanımlayıcılarını toplayın. Tutarsız ham değerleri karma hale getirmek yerine, gerekli karma yöntemini uygulamadan önce e-posta adreslerini ve telefon numaralarını standartlaştırın.
Etkinlik, izin verildiğinde müşterinin gerçek IP adresini ve tarayıcı kullanıcı aracısını da içermelidir. Barındırma sunucunuzdan veya arka uç sisteminizden ayrıntıları bunların yerine koymayın.
Son olarak, her eylem için kararlı tek bir etkinlik kimliği oluşturun. TikTok'un bunları tek bir dönüşüm olarak tanıyabilmesi için Pixel ve sunucu kopyasında aynı değeri kullanın.
6. Adım: Pixel ve Sunucu Etkinliklerini Gönderin
Etkinlik verileri hazırlandıktan sonra, aynı TikTok etkinlik adını ve etkinlik kimliğini kullanarak tarayıcı ve sunucu kopyalarını gönderin. Bu paylaşılan kimlik, TikTok'un çakışan kayıtları tanımasına ve eylemi bir kez saymasına olanak tanır.
Nihai satın alma değeri, para birimi, sipariş kimliği ve ürün ayrıntıları için arka uç verilerini kullanın; çünkü onaylanmış işlem kaydını mağazanız veya ödeme sisteminiz tutar.
Purchase etkinliği yalnızca izleme planınızda tanımlanan noktada tetiklenmelidir. Örneğin, müşteri yalnızca ödeme adımına girdiğinde veya ara bir ödeme sayfasına ulaştığında değil; ödeme başarılı olduktan veya geçerli bir sipariş onaylandıktan sonra gönderin.
Lansmandan önce, etkinliğin her iki kopyasını da karşılaştırın ve adlarının, kimliklerinin, değerlerinin ve sipariş bilgilerinin uyuştuğunu onaylayın.
7. Adım: TikTok Olay Yöneticisi'nde Etkinlikleri Test Edin
Kampanyaları başlatmadan önce Olay Yöneticisi'ndeki test araçlarını açın ve izleme planınızda listelenen eylemleri tamamlayın.
Bir ürün görüntüleme, sepete ekleme, ödeme başlatma ve test satın alma işlemi gerçekleştirin. Ardından şunları doğrulayın:
Tarayıcı ve sunucu etkinlikleri hedeflenen web sitesi veri bağlantısına ulaşıyor mu
Etkinlik adları ve zaman damgaları gerçekleştirilen eylemlerle eşleşiyor mu
Satın alma değeri ve para birimi test siparişini yansıtıyor mu
Ürün kimlikleri bağlı katalog biçimine uyuyor mu
Mevcut eşleme tanımlayıcıları doğru şekilde görünüyor mu
Çakışan etkinlikler aynı etkinlik adını ve etkinlik kimliğini taşıyor mu
Geçici test ayarları lansmandan önce kaldırıldı mı
Tanılama (Diagnostics) bölümünü de inceleyin. Bir etkinlik başarıyla ulaşabilir ancak yine de eksik, geçersiz veya yanlış biçimlendirilmiş bilgiler taşıyor olabilir.
Testten sonra, eşleşen tarayıcı ve sunucu kayıtları için tekilleştirme ayrıntılarını kontrol edin. Olay Yöneticisi raporlaması canlı test görünümünün dışında hemen güncellenmeyebilir, bu nedenle eksik bir etkinliği başarısız bir istek olarak değerlendirmeden önce işleme süresine izin verin.
Yaygın TikTok Conversion API Sorunları ve Çözümleri
Alınan bir etkinlik yine de yanlış değerler, zayıf eşleme bilgileri veya yinelenen kayıtlar içerebilir. Tüm entegrasyonu değiştirmeden önce nedeni bulmak için aşağıdaki kontrolleri kullanın.
Sorun | Olası neden | Kontrol edilecekler |
Satın alımlar iki kez görünüyor | Tarayıcı ve sunucu etkinlikleri farklı kimlikler kullanıyor | Her iki kopyadaki etkinlik adını ve etkinlik kimliğini karşılaştırın |
Sunucu etkinlikleri görünmüyor | Yanlış veri kaynağı, belirteç, reklamveren hesabı veya ortam | Bağlı veri kaynağını, erişim belirtecini, hesabı ve üretim (canlı ortam) yapılandırmasını onaylayın |
TikTok çok az etkinliği eşleştiriyor | Tıklama kimliği veya müşteri tanımlayıcıları eksik | Hangi eşleme anahtarlarının yakalanıp gönderildiğini inceleyin |
Tüm etkinlikler aynı IP adresini gösteriyor | Barındırma sunucusunun IP'si iletiliyor | İzin verilen durumlarda orijinal ziyaretçi IP'sini iletin |
Kullanıcı aracısı (user agent) eksik | Tarayıcı bilgileri saklanmadı | Oturum sırasında ziyaretçi kullanıcı aracısını yakalayın |
Satın alma geliri sıfır | Değer veya para birimi eksik ya da yanlış biçimlendirilmiş | Değer ve para birimi parametrelerini inceleyin |
Ürünler katalogla eşleşmiyor | İçerik kimlikleri farklı bir tanımlayıcı biçimi kullanıyor | Etkinlik kimliklerini katalogdaki ürün, varyant veya SKU biçimiyle karşılaştırın |
Siparişler ödemeden önce gönderiliyor | Purchase tetikleyicisi çok erken devreye giriyor | Etkinliği etkinleştiren ödeme veya sipariş durumunu kontrol edin |
Yeniden deneme istekleri ekstra satın almalar oluşturuyor | Her deneme yeni bir etkinlik kimliği alıyor | Her yeniden deneme için orijinal etkinlik kimliğini tekrar kullanın |
Etkinlikler geç ulaşıyor | Bir kuyruk, toplu işlem (batch) veya iş ortağı iletimi geciktiriyor | Daha sonraki işleme zamanı yerine orijinal eylem zamanını gönderin |
TikTok'ta daha düşük bir satın alma sayısı olması otomatik olarak bir başarısızlık anlamına gelmez. Mağazanız her siparişi kaydederken Ads Manager, TikTok'un seçilen ayarları kapsamında ilişkilendirilen satın alımları bildirir.
Farkı tespit etmek için arka uç satın alımlarını, Pixel etkinliklerini, sunucu etkinliklerini, tekilleştirilmiş kayıtları ve ilişkilendirilen satın alımları karşılaştırın.
Her TikTok Testini Daha Bilinçli Hale Getirin
Resmi adıyla TikTok Events API olan TikTok Conversion API, müşterilerin reklamlarınızla etkileşime girdikten sonra ne yaptıklarına dair daha net bir görünüm sağlayabilir. Web sitesi kampanyaları için TikTok, tarayıcı ve sunucu etkinliklerinin aynı ölçüm kurulumunu destekleyebilmesi adına bunu Pixel ile birlikte kullanmanızı önerir.
Faydalı raporlama yine de gönderdiğiniz etkinliklerin kalitesine bağlıdır. Satın alma tetikleyicileri gerçek siparişleri yansıtmalı, gelir değerleri doğru olmalı, katalog kimlikleri eşleşmeli ve çakışan tarayıcı ile sunucu etkinlikleri tutarlı kimliklere sahip olmalıdır.
Bu kontroller kampanyalarınızın nasıl performans gösterdiğini size söyler. WinningHunter ise lansmandan önce gelen kararlarda yardımcı olur. Hangi fikirlerin test edilmeye değer olduğuna karar vermek için aktif TikTok reklamlarını, rakip faaliyetlerini, ürün sinyallerini, kreatif biçimlerini ve mağaza verilerini inceleyebilirsiniz.
Birlikte kullanıldığında araştırma, daha iyi testler seçmenize yardımcı olurken doğru dönüşüm verileri de bu testlerden hangilerinin gerçek sonuçlar ürettiğini gösterir.
Sıkça Sorulan Sorular
TikTok Conversion API, Events API ile aynı şey midir?
Evet. Events API, TikTok'un resmi ürün adıdır. Reklamverenler ve izleme sağlayıcıları buna genellikle TikTok Conversion API, Conversions API veya TikTok CAPI derler. Bu resmi olmayan terimler genellikle web sitesi, uygulama, CRM ve çevrimdışı pazarlama etkinliklerini doğrudan TikTok'a göndermek için kullanılan aynı sunucu bağlantısını ifade eder.
Events API kullanırken yine de TikTok Pixel'e ihtiyacım var mı?
TikTok, web dönüşüm takibi için Pixel ve Events API'nin birlikte kullanılmasını önerir. Pixel, etkinliği tarayıcıdan gönderirken Events API, kayıtları bir sunucudan veya bağlı bir platformdan gönderir. Her iki bağlantı da aynı müşteri eylemini bildirdiğinde, TikTok'un kopyaları kaldırabilmesi için aynı etkinlik adını ve etkinlik kimliğini paylaşmaları gerekir.
TikTok'ta etkinlik tekilleştirme (deduplication) nedir?
Etkinlik tekilleştirme, Pixel ve Events API'nin her ikisi de bildirdiğinde tek bir dönüşümün iki kez sayılmasını önler. TikTok, her kopyadaki etkinlik adını ve etkinlik kimliğini karşılaştırır. Bu alanlar eşleştiğinde TikTok, her iki kaydın da aynı satın alma, kayıt, potansiyel müşteri veya diğer müşteri eylemini tanımladığını tanıyabilir.
TikTok etkinlik kimliği (Event ID) olarak ne kullanmalıyım?
Sipariş kimliği, işlem kimliği, kararlı ödeme tamamlama kimliği veya sunucu tarafından oluşturulmuş bir UUID gibi belirli bir dönüşüme bağlı bir tanımlayıcı kullanın. Pixel ve Events API, çakışan etkinlikler için aynı değeri almalıdır. Sunucu isteğinin herhangi bir yeniden denemesi de başka bir kimlik oluşturmak yerine bu orijinal kimliği tekrar kullanmalıdır.
Shopify'da TikTok Events API kurabilir miyim?
Evet. Shopify satıcıları, desteklenen ticaret entegrasyonu veya uyumlu başka bir izleme sağlayıcısı aracılığıyla TikTok'a bağlanabilir. Kullanılabilirlik ve yetenekler pazara ve kuruluma göre değişiklik gösterebilir. Bir entegrasyona güvenmeden önce mağazanızdan TikTok'a hangi etkinlikleri, müşteri tanımlayıcılarını, onay sinyallerini, gelir alanlarını ve ürün kimliklerini gönderdiğini kontrol edin.
TikTok neden Shopify'dan daha az satın alma bildiriyor?
Shopify, her edinim kaynağında verilen siparişleri kaydederken TikTok, seçilen ilişkilendirme ayarları kapsamında TikTok reklamcılığına atfedilen satın almaları bildirir. Farklılıklar ayrıca ilişkilendirme pencerelerinden, eksik eşleme anahtarlarından, onay tercihlerinden, etkinlik teslim hatalarından, işleme gecikmelerinden veya tekilleştirmeden de kaynaklanabilir. Bağlantının kopuk olduğunu varsaymadan önce alınan etkinlikleri karşılaştırın.
TikTok Events API reklam engelleyicileri (ad blockers) atlatır mı?
Etkinlik bir sunucudan veya bağlı bir platformdan gönderildiği için Events API tarayıcı betiklerine daha az bağımlıdır. Bununla birlikte reklam engelleyicilerden, tarayıcı denetimlerinden, onay tercihlerinden veya gizlilik kısıtlamalarından tamamen etkilenmediği düşünülmemelidir. Müşteri verilerini yine de yasalara uygun olarak toplamalı, iletmeli ve TikTok'un gereksinimlerine uymalısınız.
TikTok Events API'nin çalışıp çalışmadığını nasıl kontrol edebilirim?
TikTok Olay Yöneticisi'ni açın ve alınan sunucu etkinliklerini, parametreleri, eşleme bilgilerini, tanılamaları ve tekilleştirme ayrıntılarını inceleyin. Satın almalar gibi önemli eylemleri test edin ve bildirilen değeri, para birimini, ürün kimliklerini ve etkinlik kimliklerini mağaza ve ödeme kayıtlarınızla karşılaştırın. Geciken bir etkinliği eksik olarak değerlendirmeden önce işleme süresine izin verin.











