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.
Sorun Giderme
Event'ler TikTok Events Manager'da Görünmüyor
Event'ler TikTok Events Manager'da Görünmüyor
Event’ler TikTok’ta görünmüyorsa:
- Pixel ID ve Access Token’ınızın doğru olduğunu doğrulayın
- Trigger koşullarınızın karşılandığını kontrol edin
- GA4 event’inizin veriyi server’a göndermek için düzgün yapılandırıldığından emin olun
- Server container’ın event’leri aldığını doğrulayın (Önizleme modunu kontrol edin)
- Tag’in server container’da tetiklendiğinden emin olun
GTM Konsolunda Hata Mesajları
GTM Konsolunda Hata Mesajları
Yaygın hata mesajları ve çözümleri:
- Invalid Pixel ID: Pixel ID’nizi iki kez kontrol edin ve tam olarak eşleştiğinden emin olun
- Invalid Access Token: TikTok Events Manager’da yeni bir Access Token oluşturun
- Missing Required Fields: Gerekli tüm parametrelerin doğru yapılandırıldığından emin olun
- Invalid Event Name: Event adının TikTok’un desteklediği event tiplerinden biri olduğunu doğrulayın
Tekrarlanan Event'ler
Tekrarlanan Event'ler
TikTok Events Manager’da tekrarlanan event’ler görüyorsanız:
- Çift kayıt engelleme kurulumunuzun doğru yapılandırıldığını kontrol edin
- Hem client-side hem de server-side uygulamaların aynı event_id’yi kullandığından emin olun
- Event_id oluşturmanın event’ler arasında tutarlı olduğunu doğrulayın
Website Performans Sorunları
Website Performans Sorunları
Performans düşüşü fark ederseniz:
- Hem client-side hem de server-side tag’lerin doğru tetiklendiğini kontrol edin
- Yüksek hacimli event’ler için bir örnekleme stratejisi uygulamayı düşünün
- GTM container’ınızı performans için optimize edin
Sıkça Sorulan Sorular
Server-side GTM işletmem için doğru çözüm mü?
Server-side GTM işletmem için doğru çözüm mü?
Cevap mevcut kurulumunuza bağlıdır:
Durum | Öneri |
---|---|
TikTok pixel’i olan ancak Events API olmayan GTM kullanıcıları | GTM Server Side şablonu aracılığıyla Events API eklemenizi şiddetle tavsiye ederiz |
TikTok pixel’i veya Events API olmayan GTM kullanıcıları | Maksimum kapsama için GTM şablonları aracılığıyla hem Pixel hem de Events API kurun |
Events API olan ancak TikTok pixel’i olmayan GTM kullanıcıları | Çift kanallı kurulum ve en iyi reklam performansı için TikTok pixel ekleyin |
GTM kullanmayan kullanıcılar | Önce Google Tag Manager faydalarını değerlendirin |
Events API için mevcut bir tagging server kullanabilir miyim?
Events API için mevcut bir tagging server kullanabilir miyim?
Evet, TikTok Events API entegrasyonu için mevcut tagging serverınızı yeniden kullanabilirsiniz. GTM Web container’ınızda halihazırda tagging server’a işaret eden server_container_url içeren bir Google Tag varsa, bunu kullanmaya devam edebilirsiniz.
Sadece server container’ınızda TikTok Events API tag’ini doğru şekilde yapılandırdığınızdan emin olun.
Gerekirse nasıl yeni bir access token oluşturabilirim?
Gerekirse nasıl yeni bir access token oluşturabilirim?
Yeni bir token oluşturmanız gerekirse (örneğin, farklı bir Pixel ID’ye geçerken):
- TikTok Events Manager’daki pixel ayarlarınıza gidin
- Access Token bölümüne kaydırın
- “Generate Access Token”a tıklayın
- Yeni token’ı kopyalayın
- TikTok Events API tag’inizdeki Access Token değerini güncelleyin
Çift kayıt engelleme için event_id kurmam gerekiyor mu?
Çift kayıt engelleme için event_id kurmam gerekiyor mu?
Evet, hem TikTok Pixel (client-side) hem de Events API (server-side) kullanıyorsanız, uygun çift kayıt engelleme için event_id kurmanız gerekir. Bu, TikTok’un her iki kaynaktan gelen event’leri eşleştirmesini ve dönüşümlerin çift sayılmasını önlemesini sağlar.
Event_id şöyle olmalıdır:
- Her event oluşumu için benzersiz
- Aynı event için Pixel ve Events API arasında tutarlı
- Her iki uygulamaya da aynı formatta iletilmeli