TikTok Pixel + Events API

Kısa Özet: Zeisoft TikTok Pixel + Events API kurulum hizmeti, TikTok’un client-side Pixel’ini ve server-side Events API’sini çift kurulumla entegre eder; deduplication, Advanced Matching ve Catalog Ads (DPA muadili) yapılandırması dahildir. Pixel kullanıcının tarayıcısında JavaScript ile event yakalarken Events API event’leri sunucudan TikTok’a HTTP üzerinden iletir — Apple ATT, Safari ITP ve ad blocker engellemelerinden bağımsız. iOS kullanıcılarında client-side veri kayıpları (Apple’ın 2022 ATT raporlarında belgelenmiş eğilim) Events API ile telafi edilir. Üç kurulum mekanizması vardır: GTM Server Container (Meta CAPI ile aynı altyapı), e-ticaret platform eklentisi (Shopify, WooCommerce için resmi TikTok entegrasyonu), custom backend entegrasyonu. Öncelikli event’ler — CompletePayment, AddToCart, InitiateCheckout, Subscribe, SubmitForm — Events API ile gönderilir. Advanced Matching parametreleri SHA-256 ile hashlenir, clear text olarak TikTok’a iletilmez; KVKK/GDPR uyumludur. Catalog Ads için ürün katalog feed kalitesi (title, image, price, availability güncelliği) başarının çoğunluğunu belirler.

TikTok’ta Tracking de Server-Side Olmak Zorunda

TikTok kullanıcılarının önemli bir kısmı iOS kullanıyor; Apple ATT (App Tracking Transparency) nedeniyle bu kullanıcıların reklam tracking’i tarayıcı seviyesinde engelleniyor. Sadece TikTok Pixel ile çalışan kampanyalarda attribution verisinin önemli bir kısmı kaybolur — kayıp oranı sektöre, audience profiline ve iOS/Android dağılımına göre değişir, müşteri analytics raporlarında somut olarak görülür.

TikTok Events API, Meta CAPI ile aynı mantıkta çalışır: event’ler sitenizden veya backend’inizden TikTok’a HTTP üzerinden direkt iletilir, tarayıcı engellemelerinden bağımsız. TikTok Pixel + Events API çift kurulum + deduplication = güvenilir veri akışı + reklam algoritmasının doğru optimizasyonu.

Pixel + Events API Çift Kurulum

İkisi aynı event’i göndermeli — deduplication ile TikTok tarafında eşleştirilir.

Kurulum Mekanizmaları

1. GTM Server Container

GTM Server Container zaten kuruluysa TikTok Events API tag’i de aynı altyapı üzerinden çalıştırılabilir. Meta CAPI ile aynı Server Container’da yönetilir; bakım kolaylığı.

2. E-Ticaret Platform Eklentisi

Shopify ve WooCommerce için resmi TikTok entegrasyonları + 3. taraf eklentiler Events API desteği sunar. Standart kurulum için en hızlı yol.

3. Custom Backend

Kendi backend’iniz varsa TikTok’un Events API endpoint’ine HTTP POST ile event gönderebilirsiniz. En düşük gecikme, en yüksek kontrol; bakım gerektirir.

Advanced Matching ile EMQ Yüksek Tutun

Meta CAPI’deki EMQ skoruna benzer şekilde TikTok da event verilerinin kullanıcıyla eşleştirilebilme kalitesini değerlendirir. Advanced Matching parametreleri (hashed email, telefon, IP, user agent ve TikTok’un click ID’si olan ttclid) ne kadar zengin gönderilirse match rate o kadar yükselir; düşük match rate, reklam algoritmasının audience optimize etme gücünü doğrudan zayıflatır.

Gizlilik açısından: tüm hassas veriler SHA-256 ile hashlenir, TikTok’a clear text olarak gitmez. KVKK/GDPR uyumlu kurulum.

Catalog Ads Entegrasyonu

TikTok Catalog Ads (DPA muadili) için ek bileşenler:

• Ürün katalog feed — TikTok Business Center’a yüklenir (CSV, XML veya doğrudan Shopify/WooCommerce eklentisi ile)
• Event-katalog eşleştirme — Pixel/Events API event’leri item_id ile katalog feed’ine bağlanır
• Dinamik retargeting — Kullanıcının görüntülediği ürün TikTok’ta reklam olarak gösterilir

Catalog Ads performansının büyük bölümü feed kalitesinde belirlenir — title, image, price ve availability alanları güncel ve doğru olmalı; eski stok veya yanlış fiyatlı feed, retargeting kampanyalarında hatalı reklam gösterimi üretir.

Hangi Event’leri Events API ile Göndermeli?

Kritik conversion event’leri öncelikli:

• CompletePayment — Satın alma (en kritik)
• AddToCart — Funnel optimizasyonu
• InitiateCheckout — Drop-off analizi
• Subscribe — Bülten/üyelik kayıt
• SubmitForm — B2B lead form
• Custom event’ler — Sektöre özgü dönüşümler (örn. demo_request, free_trial_start)

ViewContent, ClickButton, Scroll gibi yüksek hacimli event’leri sadece Pixel’de tutmak performans açısından mantıklı.

Server-Side CompletePayment Event Örneği

Müşterinin satın alma anında TikTok Events API’ye CompletePayment event’i göndermek için tipik Node.js implementasyonu — Pixel ile aynı event_id deduplikasyon için, hassas kullanıcı verileri SHA-256 ile hash’lenir:

const crypto = require('crypto');

const sha256 = (s) =>
  crypto.createHash('sha256').update(String(s).toLowerCase().trim()).digest('hex');

await fetch('https://business-api.tiktok.com/open_api/v1.3/event/track/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Access-Token': TIKTOK_ACCESS_TOKEN,
  },
  body: JSON.stringify({
    event_source: 'web',
    event_source_id: TIKTOK_PIXEL_CODE, // örn. 'C4XXXXXXXXXXXXXXXXX'
    data: [
      {
        event: 'CompletePayment',
        event_time: Math.floor(Date.now() / 1000),
        event_id: `order-${order.id}`, // Pixel ile aynı event_id (deduplication)
        user: {
          email: sha256(user.email),
          phone: sha256(user.phone),
          external_id: sha256(String(user.id)),
          ttclid: cookies.ttclid, // TikTok click ID — hash'lenmez
          ttp: cookies.ttp, // TikTok browser fingerprint — hash'lenmez
          ip: req.ip,
          user_agent: req.headers['user-agent'],
        },
        properties: {
          currency: 'TRY',
          value: order.total,
          content_id: order.items[0].sku,
          content_type: 'product',
          contents: order.items.map((i) => ({
            content_id: i.sku,
            content_name: i.name,
            quantity: i.qty,
            price: i.price,
          })),
        },
        page: {
          url: order.checkoutUrl,
        },
      },
    ],
  }),
});

TikTok Events Manager → Test Events Tool ile canlıya almadan önce her event doğrulanır; deduplication oranı ve match rate izlenir.

Birlikte Çalıştığımız Hizmetler

• Google Tag Manager Kurulumu — Server Container ile aynı altyapı
• Meta Conversion API — Meta için aynı server-side mantığı
• TikTok Ads Yönetimi — TikTok reklam + tracking tek elden
• Dijital Reklam — Tüm dijital reklam kanallarında tracking entegrasyonu

Süreç

1. Ücretsiz TikTok tracking denetimi — Mevcut Pixel, Events API varlığı, deduplication, Advanced Matching durumu
2. Strateji belgesi — Hangi event’ler Events API ile gönderilecek, hangi mekanizma kullanılacak
3. Kurulum — GTM Server Container, eklenti veya custom backend
4. Deduplication yapılandırması — event_id eşleştirme
5. Advanced Matching — Hashed kullanıcı verisi entegrasyonu
6. Catalog feed (gerekirse) — Ürün katalog kurulumu ve event eşleştirme
7. Test ve doğrulama — TikTok Test Events Tool ile her event ayrı ayrı doğrulanır

İlk denetim için iletişim sayfasından görüşme planlayın.