TikTok Events API ile sunucu taraflı TikTok takibini kurma

Ira Holubovska

Ira Holubovska

Yazar
Güncellendi
Sep 3, 2026
Ayrıca mevcut

TikTok, 1 milyardan fazla aylık aktif kullanıcısıyla en popüler sosyal medya uygulamalarından biridir. Bu nedenle çoğu pazarlamacı, TikTok'u reklam stratejilerine dahil etmeye karar verir.

İnsanlar TikTok'u diğer platformlardan daha çok mobil cihazlarında kullanır. Uzun süre boyunca yalnızca Facebook, Apple'ın son gizlilik güncellemeleri hakkında konuşuyordu. Ancak bu kez yeni iOS izleme kısıtlamaları TikTok reklamlarını da etkileyecek. iOS kısıtlamaları nedeniyle TikTok özel hedef kitleleri ve etkinlikleri, iOS 14'te izlemeyi devre dışı bırakan kullanıcıları içermiyor.

TikTok takibini nasıl daha doğru hale getirebilirsiniz? Cevap server-side tracking'dir. Bu makalede, Google Tag Manager kullanarak TikTok Events API'nin nasıl kurulacağını açıklayacağız.

TikTok server-side tracking nedir?

TikTok server-side tracking, tarayıcı tabanlı Pixel takibine güvenmek yerine etkinlik verilerini sunucunuzdan doğrudan TikTok'a gönderme yöntemidir. TikTok Pixel'i kullanıcının tarayıcısında çalıştırmak yerine, sunucunuz etkinlik verilerini toplar ve TikTok Events API'ye iletir. Bu yöntem, takibi daha güvenilir hale getirir ve reklam engelleyicilere, tarayıcı gizlilik kısıtlamalarına ve iOS izleme sınırlamalarına karşı daha dayanıklı olmasını sağlar.

TikTok Events API nedir?

TikTok Events API, web sitesi veya uygulama etkinliklerini sunucunuzdan doğrudan TikTok sunucusuna göndermenizi sağlayan server-side bir entegrasyondur. TikTok Pixel'e benzer şekilde çalışır. TikTok Events API'yi dönüşüm etkinlikleri göndermek, özel hedef kitleler oluşturmak, dinamik ürün reklamları ve kampanya optimizasyonu için kullanabilirsiniz.

TikTok Events API, web sitesi veya uygulama etkinliklerini sunucunuzdan doğrudan TikTok sunucusuna göndermenizi sağlayan server-side bir entegrasyondur. TikTok Pixel'e benzer şekilde çalışır. TikTok Events API'yi dönüşüm etkinlikleri göndermek, özel hedef kitleler oluşturmak, dinamik ürün reklamları ve kampanya optimizasyonu için kullanabilirsiniz.

TikTok server-side tracking'in temel avantajları nelerdir?

TikTok API etkinlikleri aynı avantajlara sahiptir ve diğer platformların server-side tracking çözümlerine oldukça benzerdir. Daha önce hazırladığımız FB Conversions API ve server-side GA4 yazılarına göz atabilirsiniz.

TikTok Events API kullanmanın temel avantajları:

1. Doğru etkinlik takibi. Server-side tracking ile daha fazla etkinlik toplayabilirsiniz. TikTok Events API, reklam engelleyicilere, ITP'lere ve diğer izleme kısıtlamalarına karşı dayanıklıdır. Bu sayede kampanyalarınızın dönüşüm takibinin doğruluğunu artırabilirsiniz. Bu, hangi kampanyaların dönüşüm sağladığını daha iyi anlamanıza ve daha fazla satış elde etmenize yardımcı olur.

2. Daha iyi özel hedef kitle kalitesi. Takip engellenmeyeceği için özel hedef kitleleriniz tüm kullanıcıları içerecektir.

3. Veri güvenliği. Server-side tracking, hangi verilerin gönderileceğini ve nasıl işlendiğini kontrol etmenizi sağlar. Bu, GDPR veya CCPA gibi gizlilik düzenlemelerine uyum sağlamanıza yardımcı olur.

4. Gizlilik kontrolleri. Hangi verileri paylaşacağınızı ve ne zaman paylaşacağınızı belirlemenize olanak tanıyan gelişen gizlilik gereksinimlerine uyum sağlayarak pazarlama çalışmalarınızı sürdürün.

5. Zenginleştirilmiş veriler. Örneğin CRM sisteminizden TikTok'a ek veriler gönderebilirsiniz. Bu verileri kampanya performansını daha iyi anlamak veya özel hedef kitleler oluşturmak için kullanabilirsiniz.

TikTok server-side tagging'in temel dezavantajları nelerdir?

Server-side tracking harika bir yeni teknoloji olsa da bazı dezavantajlara sahiptir.

1. Daha karmaşık entegrasyon. Server-side tracking (SST), tarayıcı tabanlı takipten biraz farklı çalışır. Bu nedenle sitenize entegre edilmesi oldukça zaman alabilir. TikTok Events API veya başka herhangi bir platform için server-side tracking kurmanın en iyi yolu Google Tag Manager server container kullanmaktır. Bu konuda size yardımcı olabiliriz.

2. Bulut sunucusu ve ek maliyet gerektirir. SST kurmak için, farklı veri noktalarına istek göndermek amacıyla kullanacağınız bir bulut sunucusunu yapılandırmanız gerekir.

3. Hâlâ yeni bir teknolojidir. TikTok Events API yeni bir teknolojidir ve bu nedenle gelecekte daha fazla güncelleme beklemeliyiz. Bu nedenle yakında yapılacak değişiklikleri takip etmeniz gerekir.

TikTok Events API ile TikTok server-side tracking nasıl çalışır?

TikTok Events API, Facebook Conversions API'ye benzer şekilde çalışır. TikTok, etkinlikleri TikTok kullanıcılarıyla eşleştirmek için Click ID ve kullanıcı verilerini kullanır. TikTok'a ne kadar fazla kullanıcı verisi gönderirseniz, etkinliklerin kullanıcılarıyla eşleştirilme olasılığı o kadar yüksek olur. TikTok Events API, tarayıcı etkinlikleriyle aynı özelliklere sahiptir. Kitleler oluşturmak, dönüşümleri ölçmek ve TikTok algoritmalarını optimize etmek için kullanılabilir.

28 Şubat 2022'den itibaren TikTok, etkinlik tekilleştirmeyi desteklemektedir. Artık Facebook CAPI'ye benzer şekilde Pixel ve Events API'yi birlikte kullanabilirsiniz. Etkinlikleri hem tarayıcıdan hem de sunucudan göndermek istiyorsanız, event_id eklediğinizden emin olun.

Bir kişi TikTok reklamına her tıkladığında URL'ye bir Click ID (ttclid) eklenir. Bu, 30 gün boyunca geçerli olan benzersiz bir tanımlayıcıdır. TikTok Click ID'yi (ttclid) saklayabilir ve bunu TikTok Events API'ye geri gönderebilirsiniz. Bu, etkinliklerin kampanyalarınızla ilişkilendirilmesine yardımcı olur.

TikTok API etkinliklerinin eşleşme kalitesi puanını artırmak için e-posta, telefon numarası, kullanıcı kimliği, kullanıcı IP adresi ve kullanıcı aracısı gibi kullanıcı verileri gönderebilirsiniz. Tüm kullanıcı bilgileri istemci tarafında küçük harfe dönüştürülmeli ve SHA256 kullanılarak hash'lenmelidir.

Kullanıcı verilerinin yanı sıra özellikler, nesneler ve etkinlik parametreleri gönderebilirsiniz. TikTok, Pixel ve Events API'nin birlikte kullanılmasını önerir. Bu, daha iyi sinyal kalitesi sağlar ve hem tarayıcıdan hem de sunucudan gönderilen etkinliklerin yinelenmesini önleyen tekilleştirmeyi destekler.

TikTok Events API kurulum yöntemleri

TikTok Events API'yi kurmanın iki yolu vardır: Events API Gateway ve server GTM kullanımı. Aşağıdaki bölümde her iki yöntemi ayrıntılı olarak ele alacağız.

TikTok Events API Gateway

Stape'in TikTok Events API Gateway çözümü, TikTok server-side tracking kurmanın en yeni ve en basit yoludur. Etkinlik tekilleştirmesini yapılandırmanın karmaşıklığını atlamanıza ve etiketleme işlemleri için gereğinden fazla zaman harcamamanıza yardımcı olur. Kullanıcı parametrelerini ve etkinlikleri doğrudan sunucudan göndermenizi sağlarken tek bir örnekte, farklı Business Manager hesapları arasında bile birden fazla Pixel'i destekler.

TikTok Events API Gateway

Birkaç dakika içinde çalışır hale gelir — manuel server-side tagging uygulaması yapmanıza gerek kalmadan TikTok Events API'yi kurabilirsiniz. TikTok eAPI Gateway ile dönüşüm takibinin ve ilişkilendirme doğruluğunun geliştirilmesinden hemen yararlanabilirsiniz.

TikTok Events API via sGTM

Stape'in TikTok Events API etiketi, güvenli ve yapılandırılmış bir bağlantı kullanarak web sitesi veya uygulama etkinliklerini bulut sunucunuzdan TikTok Events API'ye göndermenizi sağlar. Özel hedef kitleler toplayabilir, dinamik ürün reklamları oluşturabilir ve kampanyaları optimize edebilirsiniz.

Kurulum ve yapılandırma için teknik bilgi gerekir. Buna sunucu barındırma ve izinler gibi altyapının yönetimi de dahildir.

Stape’s TikTok Events API tag

TikTok Events API etiketi kurulumunun temel özellikleri:

  • Yalnızca TikTok değil, birden fazla server-side etiketi özelleştirme ve entegre etme konusunda tam esneklik sağlar.
  • Farklı kaynaklardan gelen verileri birleştirme ve TikTok'a göndermeden önce etkinlik verilerini zenginleştirme gibi gelişmiş yapılandırmalara olanak tanır.
  • Meta veya Google Ads gibi diğer platformlar için zaten server-side Google Tag Manager kullanan işletmeler için kullanışlıdır.
  • Sürekli bakım ve izleme gerektirir.

TikTok Events API Gateway kurulumunun temel özellikleri:

  • Tamamen Stape tarafından barındırılır ve yönetilir.
  • Server-side dönüşüm takibini ve etkinliklerin TikTok'a gönderilmesini otomatik olarak yönetir.
  • Ayrı bir GTM server container kurulumu yapmadan güvenilirlik ve ölçeklenebilirlik sağlar.
  • TikTok dışındaki özel uygulamalar veya birden fazla etiket ekleme konusunda GTM'e kıyasla daha az esneklik sunar.

Karşılaştırma tablosu

TikTok eAPI etiketiTikTok eAPI Gateway
Kurulum karmaşıklığıDaha karmaşık yapılandırma gerekir, web ve server GTM container'larına ihtiyacınız vardır.
Diğer platformlar için server-side tracking kurabilmeDaha esnektir ve çeşitli platformlar için kurulum yapılmasına olanak tanır.
Fiyatİstek sayısına bağlıdır, web siteniz için fiyatı görmek üzere hesaplayıcıyı kontrol edin.

Hangi takip yöntemini seçmelisiniz?

TikTok Events API etiketi şu kişiler için en uygunudur:

  • Şirket içinde teknik uzmanlığı veya özel destek ekipleri bulunan işletmeler.
  • Takip kurulumları üzerinde tam kontrol sahibi olmak isteyen ileri düzey kullanıcılar.

TikTok Events API Gateway şu kişiler için en uygunudur:

  • TikTok reklamları yayınlayan ve server-side tracking'i hızlı ve verimli bir şekilde etkinleştirmek isteyen küçük ve orta ölçekli işletmeler veya reklamverenler.
  • Derin teknik bilgiye ihtiyaç duymadan kullanıma hazır bir çözüm isteyen kullanıcılar.

TikTok Events API Gateway nasıl kurulur?

Başlamadan önce, TikTok web izleme özelliğinin sitenizde zaten yapılandırıldığından emin olun. Bu kurulum bir GTM container'ı aracılığıyla, doğrudan web sitesi koduna eklenerek veya bir eklenti kullanılarak yapılmış olabilir. Bu yapılandırma, mevcut web etkinliklerini kullanmanıza olanak tanır.

1. Stape üzerinde bir TikTok Events API Gateway oluşturun

1.1. Stape hesabı oluşturun veya giriş yapın. TikTok bölümünde “Create Gateway” seçeneğine tıklayın.

Create an account or log in to Stape

1.2. Alanları doldurun:

  • Gateway adı. Rastgele bir ad oluşturabilirsiniz.
  • Yönetici e-postası. Bu e-posta adresi TikTok Events API Gateway'inizi yönetmek için kullanılacaktır ve Stape hesap e-postanızdan farklı olabilir. Her Gateway için benzersiz olmalıdır.
  • Sunucu konumu. Web sitesi ziyaretçilerinize daha yakın bir konum seçin.

“Create TikTok Events API Gateway” düğmesine tıklayın.

Click “Create TikTok Events API Gateway”.

1.3. Bir abonelik planı seçin. Stape aşağıdaki seçenekleri sunar:

  • 7 günlük ücretsiz deneme.
  • Kullandıkça öde planı - Pixel başına 10$/ay.
  • Ultimate plan - 100 Pixel için 100$/ay.
Choose a subscription plan. Stape offers

1.4. Gateway durumunun “Running” olmasını bekleyin.

Wait till the status of your gateway is “Running”

2. Pixel'inizi bağlayın

2.1. “Finish TikTok Gateway setup” seçeneğine tıklayın. TikTok Gateway giriş arayüzüne yönlendirileceksiniz.

Click on “Finish TikTok Gateway setup”.
Click on “Finish TikTok Gateway setup”.

2.2. Events API Gateway hub içinde “View details” seçeneğine ve ardından “Connect Data Source” seçeneğine tıklayın.

View details in TikTok Events API Gateway hub Tenant list
View details in TikTok Events API Gateway hub Tenant list

2.3. Bağlamak istediğiniz hesabı ve Pixel'leri seçin ve seçimlerinizi onaylayın.

Choose the account and Pixels you’d like to connect and confirm your choices

2.4. Eklenen Pixel'i kontrol panelinizde göreceksiniz.

You will see the added pixel in your dashboard

3. [Önerilir] Özel alan adı ekleyin

TikTok Events API Gateway'inizde özel bir alan adı kullanmak, ölçüm performansını iyileştirebilir. Bu, Pixel'in Events API Gateway ile iletişim kuracağı alt alan adını seçmenize olanak tanır. Bu özel alan adı, TikTok Pixel'in çalıştırıldığı alt alan adıyla aynı olmalıdır.

3.1. Menüden “Settings” seçeneğine tıklayın. “Set up domain” düğmesine basın.

Click “Settings” on the menu. Push the button “Set up domain”.

3.2. Alan adını seçin ve yapılandırmak için DNS kayıtlarını alın.

Choose domain and receive DNS records to configure
Choose domain and receive DNS records to configure

3.3. DNS sağlayıcınıza giriş yapın ve kayıtları ekleyin (Cloudflare kullanıyorsanız, ayarlar ekran görüntüsündeki gibi görünmelidir).

Log in to your DNS provider and set records

 3.4. Hepsi bu kadar! Alt alan adınızı başarıyla yapılandırdınız.

4. [Önerilir] TikTok JS dosyasını alt alan adınızdan yükleyin

Bu, etkinliklerinizin reklam engelleyiciler tarafından engellenmesine karşı korunmanızı artırmanıza yardımcı olur.

Data routing alan adınızı doğruladıktan sonra, TikTok JS dosyasını sitenize indirmek için kullanabileceğiniz bir bağlantı göreceksiniz. “View base code” seçeneğine tıklayın ve kod parçacığını kopyalayın.

Click on “View base code” to download TikTok js snippet
Click on “View base code” to download TikTok js snippet

5. [İsteğe bağlı] Yeni Pixel'ler ekleyin

Tek bir TikTok Events API Gateway kullanarak birden fazla TikTok Pixel yapılandırabilirsiniz. Ayrıca, tüm Pixel'ler için yönetici erişimine sahip olmanız koşuluyla, farklı TikTok Business Account'lara ait Pixel'ler aynı TikTok Events API Gateway'e bağlanabilir.

İşlem basittir: TikTok Events API Gateway'inizi yapılandırın, ardından hub arayüzü üzerinden yeni Pixel'ler ekleyin. Bunun için “Connect data source” seçeneğine tıklamanız yeterlidir.

Connect data source

6. Kurulumunuzu test edin

Daha önce belirtildiği gibi, TikTok Events Gateway web etkinliklerini kullanarak bunları sunucu üzerinden yönlendirir.

6.1. Pixel'inizi TikTok eAPI Gateway hub'a bağladıktan sonraki 30 dakika içinde etkinlik sayısının artık sıfır olmadığını ve alınan etkinliklerin adlarını görmeye başlamanız gerekir.

TikTok Events Gateway

6.2. Ayrıca, web sitesi konsolunu kontrol ederek etkinliklerin TikTok Events API Gateway'e doğru şekilde gönderildiğini doğrulayabilirsiniz:

  1. Web sitenizde tarayıcınızın geliştirici araçlarındaki Network sekmesini açın.
  2. Etkinliklerin Events API Gateway URL'nize gönderildiğini kontrol edin.
Check that events were sent to your Events API Gateway URL (look at the screenshot below)

TikTok events API server GTM üzerinden nasıl kurulur?

!

28 Şubat 2022'den itibaren TikTok, etkinlik tekilleştirmeyi desteklemektedir

TikTok için web ve server tracking'i birlikte kullanabilirsiniz. Bunu yaparsanız, web ve server etiketlerine event_id eklediğinizden emin olun. TikTok Events API etiketimiz tekilleştirmeyi destekler ve event_id değişkeni TikTok'un event_id standardını da destekler. Aşağıdaki kılavuz, Pixel etkinlikleri veya tekilleştirme olmadan yalnızca TikTok Events API kurulumunu açıklar.

2. Gerekli verileri server container'a gönderin. İki yöntemi açıklayan blog yazılarımız bulunmaktadır: server-side GA4 yapılandırmasını kullanarak veri gönderme veya Data Tag kullanımı.

3. Add TikTok events API tag from the GTM template gallery.  

GTM template gallery

4. Access Token oluşturun. Bunun için Assets → Web Events → Open pixel → Settings → “Generate Access Token” adımlarını izleyin.

Generate Access Token

5. Server container içinde bir TikTok etiketi oluşturun. Etkinliği seçin → TikTok API Access Token ekleyin → TikTok Pixel ID ekleyin (her etiket için yalnızca tek bir Pixel ID ekleyebilirsiniz).

6. Server Event Data Override bölümünde etkinlik parametreleri ekleyebilirsiniz. Bu parametreler arasında event ID, referrer, timestamp ve URL bulunur. Etiketimiz etkinlik parametrelerini otomatik olarak ekler, ancak bunları geçersiz kılmayı ve manuel olarak göndermeyi seçebilirsiniz.

7. Kullanıcı verilerini göndermek için user data bölümünü açın. Burada IP adresi, user agent, e-posta, external ID ve ttclid ekleyebilirsiniz. IP adresi, user agent ve ttclid otomatik olarak eklenir.

8. Ürün verilerini göndermek için properties bölümünü kullanın. Content, currency, description, query ve value bilgilerini gönderebilirsiniz.

9. Tetikleyici ekleyin.

TikTok trigger add
TikTok HTTP request details
TikTok ads manager

Sonuç

TikTok Events API, verileri sunucunuzdan TikTok uygulamasına göndermenizi sağlar. Etkinlik takibinin doğruluğunu artırmak ve özel hedef kitlelerinizin boyutunu genişletmek için kullanabilirsiniz.

Events API, tarayıcı tabanlı takip ile aynı yeteneklere sahiptir. Bununla birlikte, istemci tarafı sınırlamalarını aşabilmesi ve kullanıcı davranışları hakkında daha doğru bilgiler sağlaması sayesinde daha iyi gizlilik ve performanstan yararlanabilirsiniz.

Sunucu tarafına geçmeye hazır mısınız? Hemen kaydolun!

Ira Holubovska

Ira Holubovska

Author

Ira’nın 10+ yıl dijital pazarlama deneyimi var, son 5 yılı server-side tracking üzerine. Farklı dijital pazarlama senaryolarında nasıl ve ne zaman işe yaradığını bilir.

Yorumlar

Sunucu tarafıyla ilgili her şey için Stape'i deneyin