Genel Bakış

TikTok Events API için Server-side Google Tag Manager (sGTM) uygulaması, dönüşüm event’lerini doğrudan serverınızdan TikTok Ads’e göndermenize olanak tanır. Bu kurulum, iyileştirilmiş veri güvenilirliği, daha iyi performans ve ad blocker’lardan daha az etkilenme dahil olmak üzere client-side tracking’e göre çeşitli avantajlar sunar.

Bu rehber, pixel oluşturmadan test ve doğrulamaya kadar server-side Google Tag Manager üzerinden TikTok Events API’yi kurma sürecinde size adım adım yol gösterecektir.

Önerilen yaklaşım, TikTok Pixel (client-side) ve Events API (server-side) uygulamalarını eş zamanlı olarak uygulamaktır. Bu çift kanallı uygulama, event kapsamını en üst düzeye çıkarır ve yedeklilik sağlar, böylece bir kanal sorun yaşasa bile kampanya performansınızın korunmasını sağlar.

Ön Koşullar

Bu entegrasyona başlamadan önce, şunlara sahip olduğunuzdan emin olun:

  • Websitenizde kurulu, çalışan bir web & server container
  • GTM hesabınızda oluşturulmuş bir server container
  • Tagging serverınıza event’ler gönderen bir frontend tag (Google Analytics 4)
  • Events Manager’a erişim izinleriyle TikTok Ads Manager’a erişim

Bu uygulama, Google Tag Manager bilgisi ve uygun erişim izinleri gerektirir. İlerlemeden önce gerekli uzmanlığa sahip olduğunuzdan emin olun veya bir geliştirici ile görüşün.

Uygulama Adımları

TikTok Pixel Oluşturma

Halihazırda bir TikTok pixel’iniz varsa, bir sonraki bölüme geçebilirsiniz. Aksi takdirde, yeni bir pixel oluşturmak için şu adımları izleyin:

1

TikTok Ads Manager'a Erişin

TikTok Ads Manager’a gidin ve hesabınıza giriş yapın.

2

Events Manager'a Gidin

Navigasyon çubuğundaki “Tools” üzerine gelin, “Management” bulun ve “Events”e tıklayın.

3

Web Events'i Kurun

  1. “Web Events” altındaki “Manage” butonuna tıklayın
  2. “Setup Web Events”e tıklayın
  3. Bir pixel adı girin
  4. Uygulama yöntemi olarak “Events API”yi seçin
  5. “Next”e tıklayın
4

Entegrasyon Yöntemini Seçin

  1. “Automatically Set Up Web Events via Partner Platforms”ı seçin
  1. “Next”e tıklayın
  2. “Google Tag Manager Server-side”ı seçin
  1. “Next”e tıklayın
5

Pixel Bilgilerini Kaydedin

Yeni pixel’iniz artık oluşturuldu. Ekranda görüntülenen Pixel ID’yi not edin.

Pixel ID ve Events API Access Token Alma

TikTok Events API şablonunu yapılandırmak için Pixel ID’nize ve bir API Access Token’a ihtiyacınız olacak:

1

Pixel Ayarlarına Erişin

TikTok Ads Manager’da Tools > Events > Web Events’e gidin, pixel’inizi seçin ve Settings sekmesine gidin.

2

Pixel ID'yi Kopyalayın

Settings sayfasının üst kısmında Pixel ID’nizi bulacaksınız. Bu değeri kopyalayıp kaydedin.

3

Access Token Oluşturun

  1. “Access Token” bölümünü bulmak için aşağı kaydırın
  1. “Generate Access Token”a tıklayın
  2. Görünen token’ı kopyalayıp kaydedin

Kimlik bilgileriniz şu örneklere benzer olmalıdır:

  • Pixel ID: CIB1R6JC77UCDSLJS0OG
  • Access Token: 00c350fde1xxxxxxxxxxxxxxxxxxxxxxxx1991af

Server-Side Google Tag Manager Kurulumu

1

TikTok Şablonunu Yükleyin

  1. GTM server container’ınızda, Tags’e gidin
  2. Yeni bir tag oluşturmak için “New”e tıklayın
  3. Tag tipi seçmek için tag yapılandırma alanına tıklayın
  1. Community Template Gallery’de “TikTok Events API (Official)“ı arayın
  1. Yüklemek için “Add to workspace”e tıklayın

Şablon yalnızca Server container’a uygulanabilir. İlerlemeden önce container tipinizin “Server” olarak ayarlandığından emin olun.

2

Event Ayarlarını Yapılandırın

  1. Pixel ID’nizi ve Access Token’ınızı ilgili alanlara girin

Pixel ID ve Access Token’ı birden çok tag’de yeniden kullanmak için GTM değişkenleri oluşturabilirsiniz. Her alanın yanındaki ”+” işaretine tıklayarak değişkenler oluşturun veya seçin.

  1. Bu tag’in izleyeceği Event tipini seçin
3

Gelişmiş Eşleştirmeyi Ayarlayın

Gelişmiş eşleştirme, hash’lenmiş kullanıcı tanımlayıcıları göndererek dönüşüm takibi doğruluğunu iyileştirmeye yardımcı olur:

  1. GTM değişkenlerini kullanarak Email, Phone ve External ID alanlarını yapılandırın
  2. Tüm tanımlayıcılar, TikTok’a gönderilmeden önce otomatik olarak SHA256 ile hash’lenir

Kullanıcı yolculuğunun başlarında gelişmiş eşleştirmeyi uygulamak, eşleştirme kalitesini ve kampanya performansını önemli ölçüde iyileştirir.

Kullanıcı bilgilerini iletmek için aşağıdaki seçeneklerden birini seçin:

  • Common Event Schema’dan Çıkar: Değerler GA4 ortak event şemasında mevcut olduğunda bunu kullanın
  • Custom Değişkenler Kullanın: Veriler başka kaynaklardan mevcut olduğunda her alan için belirli değişkenleri seçin
4

E-ticaret Verilerini Yapılandırın

Ürün veya satın alma event’lerini izliyorsanız, e-ticaret veri bölümünü yapılandırın:

  1. “Use Google Analytics Ecommerce Data Layer”ı seçin
  1. Bu otomatik olarak GA4 ecommerce uygulamanızdan ürün verilerini yakalar
  2. Websitenizin ecommerce verilerini data layer’a düzgün bir şekilde gönderdiğinden emin olun
5

Çift Kayıt Engellemeyi Kurun

Hem TikTok Pixel (client-side) hem de Events API (server-side) uyguluyorsanız, event çift kayıt engellemeyi yapılandırın:

  1. Uygun event_id değişkenini seçin
  2. Hem Pixel hem de Events API uygulamalarının aynı event_id’yi kullandığından emin olun

Dönüşümlerin çift sayılmasını önlemek ve doğru kampanya raporlamasını sağlamak için Pixel ve Events API kullanırken çift kayıt engelleme kritik önem taşır.

6

Ek Ayarları Yapılandırın

Şablon, IP adresi ve user agent gibi server bilgilerini otomatik olarak toplar. Belirli alanları geçersiz kılmanız gerekmiyorsa bu bölümü boş bırakabilirsiniz.

7

Trigger Ayarlayın

  1. Bir trigger seçmek veya oluşturmak için Triggering alanına tıklayın
  2. Uygun event alındığında tetiklenen bir trigger yapılandırın
  1. Örneğin, satın alma event’lerini izlemek için, bir satın alma event’i algılandığında etkinleşen bir trigger oluşturun
  2. Tag kurulumunu tamamlamak için “Save”e tıklayın

Test ve Doğrulama

1

Önizleme Modunu Kullanın

  1. Server container’ınızda “Preview”e tıklayın
  2. Websitenizden test event’leri tetikleyin
  3. Events API çağrılarını doğrulamak için önizleme konsolunu izleyin
  4. Başarıyı onaylamak için {"code": 0, "message": "OK"} içeren bir yanıt arayın
2

TikTok Test Events Aracını Kullanın

  1. TikTok Events Manager’da pixel’inizi seçin
  2. “Test Events” sekmesine gidin
  3. Test Server Events bölümünün 2. Adımından test event kodunu kopyalayın
  4. Bu kodu “Test Event Code” alanındaki TikTok Events API tag’inize ekleyin
  5. Değişiklikleri kaydedin ve test event’leri tetikleyin
  6. Event’lerin alındığını doğrulamak için Event Activity bölümünü kontrol edin

Test tamamlandıktan sonra üretime geçmeden önce test event kodunu kaldırmayı unutmayın.

Sorun Giderme

Sıkça Sorulan Sorular