sGTM ile TikTok Events
Gelişmiş dönüşüm takibi ve iyileştirilmiş reklam performansı için server-side Google Tag Manager üzerinden TikTok Events API kurulum rehberi
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:
TikTok Ads Manager'a Erişin
TikTok Ads Manager’a gidin ve hesabınıza giriş yapın.
Events Manager'a Gidin
Navigasyon çubuğundaki “Tools” üzerine gelin, “Management” bulun ve “Events”e tıklayın.
Web Events'i Kurun
- “Web Events” altındaki “Manage” butonuna tıklayın
- “Setup Web Events”e tıklayın
- Bir pixel adı girin
- Uygulama yöntemi olarak “Events API”yi seçin
- “Next”e tıklayın
Entegrasyon Yöntemini Seçin
- “Automatically Set Up Web Events via Partner Platforms”ı seçin
- “Next”e tıklayın
- “Google Tag Manager Server-side”ı seçin
- “Next”e tıklayın
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:
Pixel Ayarlarına Erişin
TikTok Ads Manager’da Tools > Events > Web Events’e gidin, pixel’inizi seçin ve Settings sekmesine gidin.
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.
Access Token Oluşturun
- “Access Token” bölümünü bulmak için aşağı kaydırın
- “Generate Access Token”a tıklayın
- 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
TikTok Şablonunu Yükleyin
- GTM server container’ınızda, Tags’e gidin
- Yeni bir tag oluşturmak için “New”e tıklayın
- Tag tipi seçmek için tag yapılandırma alanına tıklayın
- Community Template Gallery’de “TikTok Events API (Official)“ı arayın
- 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.
Event Ayarlarını Yapılandırın
- 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.
- Bu tag’in izleyeceği Event tipini seçin
- Event, bu tag ile ilişkilendireceğiniz trigger ile eşleşmelidir
- Mevcut event tipleri için TikTok’un Desteklenen Pixel event’leri’ne bakın
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:
- GTM değişkenlerini kullanarak Email, Phone ve External ID alanlarını yapılandırın
- 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
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:
- “Use Google Analytics Ecommerce Data Layer”ı seçin
- Bu otomatik olarak GA4 ecommerce uygulamanızdan ürün verilerini yakalar
- Websitenizin ecommerce verilerini data layer’a düzgün bir şekilde gönderdiğinden emin olun
- “Use Google Analytics Ecommerce Data Layer”ı seçin
- Bu otomatik olarak GA4 ecommerce uygulamanızdan ürün verilerini yakalar
- Websitenizin ecommerce verilerini data layer’a düzgün bir şekilde gönderdiğinden emin olun
İhtiyaçlarınıza göre aşağıdaki seçeneklerden birini seçin:
Tek İçerik: Tek bir ürünle ilişkili event’ler için
- Değişkenler kullanarak bireysel alanları yapılandırın
- Fiyat, content_id, content_name vb. ürün detaylarını dahil edin
Çoklu İçerikler: Birden çok ürün içeren event’ler için (sepet veya satın alma event’leri gibi)
- JSON kodlu bir ürünler dizisi sağlayın
- Format, TikTok’un gerekli şemasını izlemelidir
Sadece Sipariş Bilgisi: Temel satın alma takibi için
- Yalnızca değer ve para birimi alanlarını yapılandırın
- Detaylı ürün bilgileri mevcut olmadığında bunu kullanın
Ç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:
- Uygun event_id değişkenini seçin
- 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.
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.
Trigger Ayarlayın
- Bir trigger seçmek veya oluşturmak için Triggering alanına tıklayın
- Uygun event alındığında tetiklenen bir trigger yapılandırın
- Ö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
- Tag kurulumunu tamamlamak için “Save”e tıklayın
Test ve Doğrulama
Önizleme Modunu Kullanın
- Server container’ınızda “Preview”e tıklayın
- Websitenizden test event’leri tetikleyin
- Events API çağrılarını doğrulamak için önizleme konsolunu izleyin
- Başarıyı onaylamak için
{"code": 0, "message": "OK"}
içeren bir yanıt arayın
TikTok Test Events Aracını Kullanın
- TikTok Events Manager’da pixel’inizi seçin
- “Test Events” sekmesine gidin
- Test Server Events bölümünün 2. Adımından test event kodunu kopyalayın
- Bu kodu “Test Event Code” alanındaki TikTok Events API tag’inize ekleyin
- Değişiklikleri kaydedin ve test event’leri tetikleyin
- 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.