TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber
TikTok Events API (CAPI) kurulum rehberi: server-side event akışı, deduplication, event match quality, GA4 ve CRM mutabakatı — e-ticaret şirketleri için ölçüm altyapısı.
TikTok Ads Events API (CAPI) kurulumu, panelde 4,2 ROAS görünürken CRM'de yeni müşteri artışının %6 olduğu hesaplarda ilk müdahaledir — browser pixel tek başına iOS kısıtları, ad blocker ve cookie süresi nedeniyle dönüşümün %25-40'ını kaçırabilir. Aylık 85.000 TL TikTok harcaması olan bir moda markasında pixel-only ölçümde CompletePayment 420 görünürken CAPI devreye alındıktan sonra deduplicate edilmiş toplam 510 event ve Event Match Quality skoru 6,8'e çıktığında algoritma optimizasyonu 10-14 günde CPA'yı 168 TL'den 152 TL bandına indirebilir. CAPI kurulumu teknik görev değil; CRM truth, blended ROAS ve CFO raporlaması için zorunlu ölçüm katmanıdır. Bu rehber, şirketlerin TikTok Events API'yi ticari performans zekâsı perspektifiyle kurması için B2B çerçeve sunar.
Stratejik Çıkarımlar
Pixel + CAPI birlikte çalışmalı; deduplication event_id ile zorunludur.
Event Match Quality 6,0 altında CAPI değeri sınırlıdır; PII hash kalitesi önceliklidir.
Purchase event CRM gross revenue ile mutabık değilse optimizasyon yanlış sinyale gider.
CAPI kurulumu GA4 ve CRM mutabakat tablosunun TikTok satırını güvenilir kılar.
Ölçüm
Events API'nin Ticari Rolü: Neden Server-Side?
TikTok Events API, dönüşüm sinyalini tarayıcıdan bağımsız sunucu katmanından TikTok'a iletir. Performans pazarlama ekibi için anlamı: algoritma daha fazla gerçek satın alma sinyali görür, prospecting CPA daha stabil öğrenir, view-through ile click-through ayrımı yönetilebilir hale gelir.
420 TL AOV, %47 brüt marj ve hedef CPA 155 TL olan bir hesapta eksik purchase event, algoritmanın yüksek değerli kullanıcıları yanlış dışarıda bırakmasına yol açar. CAPI ile purchase recovery %15-25 bandında iyileşme sık görülür.
CFO perspektifinden CAPI yatırımı ölçüm güveni yatırımıdır. CRM-panel sapması %20'den %12'ye indiğinde TikTok bütçe talepleri finans onayına daha kolay girer.
Ölçüm
Kurulum Öncesi Audit: Pixel ve Veri Katmanı
CAPI kurulumundan önce TikTok Pixel event'leri doğrulanmalıdır: ViewContent, AddToCart, InitiateCheckout, CompletePayment. Eksik funnel event CAPI'de de boşluk yaratır.
GTM veya doğrudan site dataLayer'da event parametreleri: value, currency, content_id, content_type. 380 TL sepet ortalaması olan hesapta value parametresi boşsa ROAS optimizasyonu anlamsızdır.
CRM ve Shopify/WooCommerce order ID formatı netleştirilmeli. event_id olarak order_id kullanımı deduplication için standarttır.
Ölçüm
Mimari Seçenekler: GTM Server, Cloud Function, Doğrudan API
Orta ölçek e-ticaret için GTM Server-Side Container + TikTok Events API tag yaygın yoldur. Aylık 50.000+ session trafiğinde hosting maliyeti 800-2.500 TL/ay bandında planlanmalıdır.
Yüksek hacimli markalarda (aylık 15.000+ sipariş) doğrudan backend entegrasyonu (Node/PHP webhook → TikTok API) daha düşük latency ve daha yüksek match rate sağlar.
Üçüncü parti araçlar (Segment, Elevar, Stape) hız kazandırır; fakat CRM gross revenue eşlemesi yine iç ekip sorumluluğundadır.
Ölçüm
Event Eşlemesi ve Deduplication
Her CompletePayment hem pixel hem CAPI'den gönderilir; event_id aynı order_id olmalıdır. TikTok duplicate event'leri birleştirir; farklı ID çift sayım üretir.
CompletePayment value = CRM gross order value (KDV dahil politika şirket standardına göre sabit). İade öncesi brüt mi net mi — tüm kanallarda aynı kural.
ViewContent ve AddToCart server-side opsiyoneldir; öncelik Purchase ve InitiateCheckout. İlk fazda 4 event yeterlidir.
Ölçüm
PII Hashing ve Event Match Quality
EMQ (Event Match Quality) 6,0+ hedeflenmelidir. email, phone, external_id (müşteri ID) SHA-256 hash ile gönderilir. Guest checkout'ta phone/email capture oranı düşükse EMQ 4,5-5,5 kalır.
Login kullanıcıda external_id CRM customer_id ile eşleşmelidir. %60+ login oranı olan hesapta EMQ 7,0+ ulaşılabilir.
Haftalık EMQ trendi TikTok Events Manager'da izlenir. 2 hafta düşüş → hash alanları ve checkout form audit.
Ölçüm
GA4 ve CRM ile Mutabakat
CAPI sonrası haftalık tablo: TikTok panel purchase | GA4 tiktok / cpc purchase | CRM TikTok-attributed first order. Sapma %15 altı hedef.
GA4'te TikTok trafiği session source/medium = tiktok / cpc veya paid_social politikasına göre sabitlenmelidir. UTM kopukluğu %30 sapma üretebilir.
CRM'de first-touch veya last-touch TikTok source alanı yoksa CAPI kurulumu ölçek kararını hâlâ zayıflatır.
Ölçüm
Test, Doğrulama ve Canlıya Alma
TikTok Events Manager Test Events ile staging siparişi. Pixel + CAPI aynı event_id ile tek purchase görünmeli.
48-72 saat canary: günlük 200-300 TL harcama ile CAPI aktif kampanya. CPA ve EMQ günlük log.
14 gün A/B: %50 trafik CAPI+pixel, karşılaştırma döneminde algoritma öğrenmesi için kampanya yapısı sabit tutulur.
Ölçüm
90 Günlük CAPI Olgunlaştırma Planı
Ay 1: pixel audit, GTM server kurulum, Purchase dedup, EMQ baseline. Hedef EMQ 6,0+.
Ay 2: funnel event genişletme, CRM mutabakat otomasyonu, haftalık sapma raporu. Sapma %15 altı.
Ay 3: backend event zenginleştirme (LTV segment, new vs returning), TikTok value optimization test. Başarı: CPA tavan bandında stabilizasyon.
Başarısız senaryo: EMQ 5,0 altında kalıyor → checkout PII capture ve CRM external_id projesi öncelik; medya ölçek durdurulur.
Ölçüm
Ölçüm Konusunda Yönetim Ekibinin Bakması Gereken Çerçeve
TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber konusu, şirket içinde yalnızca pazarlama ekibinin operasyonel gündemi gibi ele alınmamalıdır. Bu başlık doğrudan büyüme hedefi, medya bütçesi, satış kapasitesi, ölçüm kalitesi ve kârlılık beklentisiyle bağlantılıdır. Bu nedenle değerlendirme yapılırken sadece kampanya metriklerine değil, kararın şirketin ticari modeline nasıl etki ettiğine bakılmalıdır.
Yönetim ekibi bu konuyu değerlendirirken üç soruya net cevap aramalıdır: Bu çalışma hangi büyüme problemini çözüyor, hangi veriye dayanarak karar alıyoruz ve başarıyı hangi finansal sonuçla ölçeceğiz? Bu üç soru cevaplanmadan yapılan reklam, ajans veya bütçe kararları genellikle kısa vadeli aksiyon üretir ama sürdürülebilir büyüme sistemi kurmaz.
Özellikle şirket ölçeğinde pazarlama kararları, tek bir kanalın performansı üzerinden verilmemelidir. Google Ads, Meta Ads, TikTok Ads, SEO, CRM, ürün sayfası deneyimi ve satış ekibi aynı müşteri yolculuğunun farklı parçalarıdır. Bu parçalar birlikte okunmadığında iyi çalışan bir kanal gereksiz yere kapatılabilir veya zayıf çalışan bir süreç reklam bütçesiyle maskelenebilir.
Ölçüm
Uygulama Planı: İlk 30, 60 ve 90 Gün
İlk 30 günde amaç hızlıca büyük değişiklikler yapmak değil, mevcut durumu doğru teşhis etmektir. Bu aşamada kampanya yapısı, ölçüm altyapısı, landing page deneyimi, kreatif üretim ritmi, bütçe dağılımı ve raporlama kalitesi incelenmelidir. Şirketler çoğu zaman çözümü bütçe artırmakta arar; fakat veri ve yapı temiz değilse bütçe artışı yalnızca problemi büyütür.
31-60 gün aralığında öncelik, teşhisten çıkan problemleri kontrollü şekilde çözmektir. Ölçüm hataları giderilir, kampanya rolleri netleştirilir, kreatif test sistemi kurulur, landing page darboğazları belirlenir ve rapor formatı yönetim kararına uygun hale getirilir. Bu dönemde her aksiyonun bir hipotezi olmalıdır; yalnızca “deneyelim” yaklaşımı yeterli değildir.
61-90 gün aralığında artık kazanan sinyaller ölçeklenmeye başlanır. Hangi kanalın hangi görevde iyi çalıştığı, hangi ürün veya hizmet grubunun daha kârlı büyüdüğü ve hangi kreatif/mesaj yapısının daha güçlü sonuç verdiği görülmeye başlanır. Bu aşamada şirketin hedefi daha fazla kampanya açmak değil, daha doğru bütçe dağıtımı ve daha güvenilir büyüme ritmi kurmaktır.
Ölçüm
Başarı Metrikleri Nasıl Belirlenmeli?
TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber için başarı metriği tek bir sayıdan ibaret olmamalıdır. ROAS, CPA veya CTR gibi metrikler operasyonel sinyal verir; ancak şirket yönetimi için yeterli değildir. Karar verici ekip, bu metriklerin kârlılık, yeni müşteri kazanımı, satış kalitesi, tekrar satın alma ve marka talebi üzerindeki etkisini de görmelidir.
Örneğin bir kampanya düşük ROAS gösterse bile yüksek kaliteli yeni müşteri getiriyor olabilir. Başka bir kampanya yüksek ROAS üretirken yalnızca mevcut marka talebini topluyor olabilir. Bu iki sonucu aynı başarı kriteriyle değerlendirmek yanlış olur. Bu yüzden raporlama sisteminde kanal rolü, funnel aşaması ve ticari hedef birlikte belirtilmelidir.
Sağlıklı bir metrik seti hem pazarlama ekibinin günlük optimizasyon ihtiyacını hem de yönetim ekibinin stratejik karar ihtiyacını karşılamalıdır. Günlük ekip kampanya, kreatif ve landing page seviyesinde sinyal görürken; yönetim ekibi bütçe, kârlılık, büyüme ve risk perspektifini görmelidir.
Ölçüm
Ajans ve Şirket Ekibi Birlikte Nasıl Çalışmalı?
Bu başlıkta başarı için ajansın tek başına çalışması yeterli değildir. Şirket tarafında ürün, satış, finans, operasyon ve pazarlama ekiplerinden doğru bilgi akışı gelmelidir. Ajans reklam hesabında optimizasyon yapabilir; fakat ürün marjını, stok durumunu, satış ekibinin lead kalitesini veya iade sebeplerini bilmeden tam resim üzerinden karar alamaz.
En verimli çalışma modeli haftalık operasyon toplantısı ve aylık strateji toplantısını ayırır. Haftalık toplantıda kampanya, kreatif, bütçe ve teknik sorunlar konuşulur. Aylık toplantıda ise kanal dağılımı, kârlılık, öğrenimler, yeni testler ve büyüme öncelikleri ele alınır. Böylece ajans rapor sunan bir dış ekip değil, şirketin karar sürecine katkı veren bir büyüme partneri haline gelir.
Şirket tarafında da net sahiplik gerekir. Her aksiyonun bir sorumlusu, bir son tarihi ve bir başarı ölçütü olmalıdır. Landing page sorunu varsa kimin çözeceği, feed hatası varsa kimin düzelteceği, kreatif gerekiyorsa kimin brief vereceği net değilse pazarlama sistemi yavaşlar.
Ölçüm
Bu İçeriği Nasıl Kullanmalısınız?
Bu rehber tek seferlik okunacak bir blog yazısı olarak değil, şirket içi değerlendirme dokümanı gibi kullanılmalıdır. İlgili başlıkları mevcut ajansınızla, pazarlama ekibinizle veya yönetim toplantınızda kontrol listesi olarak ele alabilirsiniz. Amaç bir anda tüm sistemi değiştirmek değil, hangi alanın büyümeyi sınırladığını doğru tespit etmektir.
En doğru yaklaşım, bu konuyu mevcut verinizle birlikte değerlendirmektir. Kampanya raporları, GA4 verisi, CRM çıktıları, satış sonuçları, ürün marjları ve kreatif performansı yan yana konduğunda gerçek problem daha net görünür. Bu sayede pazarlama kararı tahmine değil, sistematik teşhise dayanır.
Ölçüm
CAPI Go-Live Kontrol Listesi
event_id deduplication çalışıyor mu?
Event Match Quality 6,0+ mı?
Purchase value CRM gross ile mutabık mı?
Ölçüm
TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber İçin Yönetim Karar Tablosu
Şirketler TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber başlığını değerlendirirken kararı tek bir metrik, tek bir toplantı veya tek bir ajans önerisi üzerinden vermemelidir. Konu doğrudan bütçe, ekip kapasitesi, veri güvenilirliği, satış kalitesi ve kârlılık hedefiyle bağlantılıdır. Bu nedenle karar tablosunda hem pazarlama çıktısı hem finansal beklenti hem de operasyonel uygulanabilirlik birlikte yer almalıdır.
İyi bir karar tablosu, mevcut durumun ne olduğunu, hedef durumun ne olması gerektiğini, aradaki farkın hangi aksiyonlarla kapatılacağını ve başarı eşiğinin nasıl ölçüleceğini gösterir. Bu yapı kurulmadığında ekipler çoğu zaman iyi niyetli ama dağınık aksiyonlar alır. Bir ekip kampanya tarafını, başka bir ekip landing page'i, başka bir ekip raporlamayı konuşur; fakat karar bütünsel bir büyüme planına dönüşmez.
Bu yüzden yönetim ekibi her ay bu başlık için kısa bir karar özeti istemelidir: ne öğrendik, hangi risk devam ediyor, hangi aksiyon tamamlandı, hangi metrik değişti ve bir sonraki ay hangi karar alınacak? Bu disiplin, pazarlama çalışmasını faaliyet raporundan çıkarıp yönetilebilir bir büyüme sistemine dönüştürür.
Ölçüm
Sık Yapılan Hatalar ve Riskler
Bu konuda en sık yapılan hata, problemi tek bir kanal veya tek bir metrik üzerinden açıklamaktır. Oysa şirket ölçeğinde pazarlama performansı çoğu zaman kanal, teklif, ölçüm, kreatif, satış süreci, ürün deneyimi ve finansal hedeflerin birleşiminden oluşur. Tek noktaya odaklanmak hızlı görünür; fakat gerçek darboğazı kaçırabilir.
İkinci hata, kısa vadeli performans dalgalanmalarını stratejik sonuç gibi yorumlamaktır. Bir haftalık ROAS artışı, kalıcı büyüme anlamına gelmeyebilir; benzer şekilde kısa vadeli düşüş de kanalın tamamen başarısız olduğunu göstermez. Sezonsallık, kampanya dönemi, rekabet, kreatif yorgunluğu, stok ve ölçüm değişiklikleri performansı etkileyebilir.
Üçüncü hata, şirket içi sorumlulukları netleştirmemektir. Ajans veya pazarlama ekibi öneri sunsa bile teknik kurulum, ürün sayfası, fiyatlandırma, stok, CRM, satış geri bildirimi ve finansal eşikler şirket içinde sahiplenilmelidir. Sahiplik net değilse iyi strateji uygulamaya dönüşmez.
Ölçüm
Bir Sonraki Adım Nasıl Planlanmalı?
TikTok Ads Events API (CAPI) Kurulumu: Şirketler İçin Rehber için en sağlıklı sonraki adım, büyük bir dönüşüm projesi başlatmak değil, ölçülebilir küçük bir uygulama planı çıkarmaktır. İlk aşamada mevcut raporlar, reklam hesapları, landing page verileri, satış sonuçları ve finansal metrikler yan yana getirilmelidir. Bu çalışma çoğu zaman problemin teknik mi, stratejik mi, kreatif mi yoksa ticari mi olduğunu daha net gösterir.
Ardından 30 günlük bir test planı hazırlanmalıdır. Bu planda tek seferde çok fazla değişiklik yapılmamalı; en yüksek etkili 2-3 aksiyon seçilmelidir. Örneğin ölçüm hatası varsa önce veri doğruluğu, kreatif yorgunluğu varsa yeni kreatif hipotezleri, kârlılık sorunu varsa ürün grubu bazlı raporlama önceliklendirilmelidir.
Planın sonunda sonuç yalnızca “performans arttı mı?” sorusuyla değil, “hangi varsayım doğrulandı, hangi karar değişti ve hangi alan ölçeklenebilir hale geldi?” sorularıyla değerlendirilmelidir. Bu bakış açısı şirketin her ay daha iyi karar almasını sağlar.
İlgili Okumalar ve Hizmetler
İlgili Kaynaklar ve Rehberler
Sık Sorulan Sorular
TikTok CAPI olmadan ölçeklenebilir mi?
Kısa vadede hacim artırılabilir; fakat ölçüm kaybı %20+ ise marjinal CPA yanıltıcı olur. Aylık 40.000 TL+ TikTok harcamasında CAPI öncelikli olmalıdır.
Event Match Quality kaç olmalı?
6,0+ hedeflenmeli. 5,0 altında önce email, phone ve external_id capture iyileştirilmeli; medya optimizasyonu ikinci sıra.
Pixel kaldırılmalı mı?
Hayır. Pixel + CAPI birlikte; deduplication ile çift sayım önlenir. Yalnız CAPI browser funnel sinyalini zayıflatır.
Purchase value brüt mü net mi olmalı?
Şirket standardı sabit olmalı ve Meta/Google ile aynı. Çoğu e-ticaret hesabında KDV dahil brüt order value kullanılır; iade adjustment raporlama katmanında.
CAPI kurulumu ne kadar sürer?
GTM Server ile 2-4 hafta, backend entegrasyon ile 4-8 hafta. CRM mutabakat ve EMQ olgunlaştırma 60-90 gün sürebilir.
Ücretsiz Growth Intelligence Audit
30 dakikada ölçüm sağlığınızı, blended ROAS yapınızı ve büyüme fırsatlarınızı analiz ediyoruz.
Audit Talep Et