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.

Kinnari Ashar

Yazan:

Kinnari Ashar

Okuma süresi: 15 dk

TikTok Dönüşüm API'si (CAPI) kurulum ve izleme rehberi

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:

  1. Bir müşteri TikTok reklamınızı görüntüler veya tıklar ve web sitenizi ya da mağazanızı ziyaret eder.

  2. Ürün görüntüleme, sepete ürün ekleme, form gönderme veya sipariş verme gibi bir eylemi tamamlar.

  3. Web siteniz, e-ticaret platformunuz, ödeme sisteminiz veya CRM'iniz bu eylemi kaydeder.

  4. 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.

  5. Etkinlik, TikTok Events API'ye gönderilir.

  6. 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.

  7. 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 AddToCart veya Purchase).

  • 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 ttclid değ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_84739

  • Server 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.



Şuraya atla

Kinnari Ashar

Yazar

Yazar

Kinnari Ashar

Kinnari Ashar

Kinnari Ashar; güzellik, yaşam tarzı ve teknoloji alanlarında on yılı aşkın deneyime sahip bir içerik stratejistidir. Hedef kitlede yankı uyandıran ve gerçek bir etkileşim sağlayan içerikler üretme konusunda uzmanlaşmıştır. Kinnari ayrıca, başarılı kampanyaları tespit edip kârlı bir şekilde büyütmek için reklam stratejisi ve kreatif araştırmalara odaklanarak dropshipping projeleri yürütme konusunda da pratik deneyim sunmaktadır.

Kinnari Ashar; güzellik, yaşam tarzı ve teknoloji alanlarında on yılı aşkın deneyime sahip bir içerik stratejistidir. Hedef kitlede yankı uyandıran ve gerçek bir etkileşim sağlayan içerikler üretme konusunda uzmanlaşmıştır. Kinnari ayrıca, başarılı kampanyaları tespit edip kârlı bir şekilde büyütmek için reklam stratejisi ve kreatif araştırmalara odaklanarak dropshipping projeleri yürütme konusunda da pratik deneyim sunmaktadır.

Benzer makaleleri okuyun

Günde 100 bin dolar ciro yapan bir sonraki mağazayı kurmaya hazır mısınız?

Herhangi bir markanın reklamlarını, mağazalarını ve ürünlerini araştırmak için marka arama çubuğuna sahip WinningHunter ana ekranı

Günde 100 bin dolar ciro yapan bir sonraki mağazayı kurmaya hazır mısınız?

Herhangi bir markanın reklamlarını, mağazalarını ve ürünlerini araştırmak için marka arama çubuğuna sahip WinningHunter ana ekranı

Günde 100 bin dolar ciro yapan bir sonraki mağazayı kurmaya hazır mısınız?

Herhangi bir markanın reklamlarını, mağazalarını ve ürünlerini araştırmak için marka arama çubuğuna sahip WinningHunter ana ekranı