Snapchat CAPI açıklaması ve tam kurulum kılavuzu

Ira Holubovska

Ira Holubovska

Yazar
Güncellendi
Sep 3, 2026

Bu yazıda Snapchat Conversions API'yi ve iki farklı yolla nasıl kurulacağını ele alacağız:

Snapchat Conversions API: genel bakış

Snap Conversions API, web, uygulama ve çevrimdışı etkinlikleri sunucunuzdan Snap sunucularına iletmenizi sağlar. Resmi dokümantasyona göre Snap CAPI, dönüşüm takibini ve hedeflemeyi iyileştirerek eylem başına maliyeti düşürmeye yardımcı olur.

Snapchat CAPI, web piksellerle aynı etkinlikleri ve etkinlik parametrelerini destekler. Snap CAPI'yi uygulamanın iki temel yolu vardır: doğrudan entegrasyon (sunucunuzdan Snap sunucularına doğrudan sunucu tarafı bilgisi göndermek) veya sunucu Google Tag Manager dahil ortak entegrasyonlar. Önce Snap CAPI özelliklerinden bahsedelim.

Snapchat etkinlik tekilleştirme

Facebook ve TikTok gibi Snapchat da etkinlik tekilleştirmeyi destekler; bu sayede tarayıcı ve sunucu takibini eş zamanlı kullanabilirsiniz. Yinelenen etkinlikleri kaldırmak için etkinlik tekilleştirme kullanmanızı öneririz.

Birincil tekilleştirme anahtarları şunlardır: 48 saatlik tekilleştirme penceresi sunan Client_dedup_id ve 30 günlük tekilleştirme penceresi sunan Transaction_id.

Web Google Tag Manager için Snap etiketi event_id'yi desteklemediğinden, etkinlik tekilleştirmeyi ayarlamak için web GTM'de Özel HTML etiketi kullanmanız gerekir.

Snapchat CAPI etkinlikleri

CAPI, Snap web pikseli için mevcut tüm standart etkinlik adlarını ve özel etkinlik adlarını destekler.

Etkinlik parametreleri

Snapchat'in CAPI'nin desteklediği etkinlik parametrelerini açıklayan ayrıntılı bir dokümantasyonu bulunmaktadır. Tüm kullanıcı parametreleri (düz metin e-posta, mobil tanımlayıcı, IP adresi ve telefon numarası) normalleştirilmeli ve ardından küçük harfli onaltılık SHA256 formatıyla hash'lenmelidir. Stape Snap CAPI etiketi bu dönüşümlerin tamamını otomatik olarak gerçekleştirir.

Sunucu etkinliği testi

Snapchat'in piksel tanılama sayfasını kullanarak piksel etkinliklerini test etmek için mükemmel bir işlevi olmasına rağmen, ne yazık ki şu an için Snapchat'in, FB'nin test kimliğine benzer şekilde sunucu etkinliklerini gerçek zamanlı olarak test etme işlevi mevcut değildir. Her kurulumun ardından yapılandırmanızı nasıl test edeceğinizi göstereceğiz.

Snap'in sunucu verilerini doğru şekilde alıp işlediğini doğrulamanın tek yolu, Snap etkinlik yöneticisindeki Conversions API verilerini kontrol etmektir.

Hangi takip yöntemini seçmelisiniz?

Karşılaştırma tablosu

sGTM üzerinden Snap CAPISnap CAPI Gateway
Kurulum karmaşıklığıDaha karmaşık yapılandırmalar; web ve sunucu GTM kapsayıcılarına ihtiyaç duyarsınızKurulumu daha kolaydır; yalnızca bir web GTM kapsayıcısına sahip olmanız yeterlidir
Diğer platformlar için sunucu tarafı takibi kurma imkânıDaha esnektir; çeşitli platformlar için kuruluma olanak tanırKurulum yalnızca Snapchat için mümkündür
Fiyatİstek sayısına bağlıdır; web siteniz için fiyatı görmek amacıyla hesap makinesine bakınızHer Piksel için aylık 10 $, 100 Piksel için aylık 100 $

Snap Conversions API etiketi en çok şunlara uygundur:

  • Kurum içi teknik uzmanlığa veya özel destek ekiplerine sahip işletmeler.
  • Takip kurulumları üzerinde tam kontrol isteyen ileri düzey kullanıcılar.

Snap Conversions API Gateway en çok şunlara uygundur:

  • Sunucu tarafı takibini hızlı ve verimli bir şekilde etkinleştirmek isteyen küçük ve orta ölçekli işletmeler veya reklamverenler.
  • Derin teknik bilgi gerektirmeyen hazır bir çözüm isteyen kullanıcılar.
Takibi bir sunucu GTM kapsayıcısıyla da kurabilirsiniz. Blog makalemizde sGTM kapsayıcısı ile gateway kurulumu arasındaki farka göz atın.

sGTM üzerinden Snapchat Conversions API'nin avantajları

Gizlilik

Sunucudan sunucuya takip, özünde gizlilik politikası gözetilerek oluşturulmuş bir teknolojidir. Web piksel takibinin aksine, sunucudan sunucuya takiple hangi verileri hangi ağa göndereceğinizi kesinlikle kontrol edebilirsiniz. Bu ağlar yalnızca sunucu isteklerinde yapılandırılan verileri alır.

Daha iyi reklam optimizasyonu

CAPI, daha fazla kullanıcı verisi toplanmasına yardımcı olarak Snap reklam algoritmalarını daha verimli kılar. Snapchat, resmi dokümantasyonunda CAPI'yi uygulamanın eylem başına maliyeti düşürmeye yardımcı olacağını belirtmektedir.

Daha kaliteli kitle

CAPI, Snapchat'e kullanıcılarınız hakkında daha fazla veri göndereceğinden yeniden pazarlama ve benzer kitle kampanyalarını iyileştirecektir. Etkinlik sayısı da artacaktır. Kullanıcılar uygulama veya sitelerin kendilerini takip etmesine izin vermediğinde bile CAPI etkinlik gönderebilir.

İyileştirilmiş dönüşüm takibi

Sunucu etkinlikleri çoğu durumda engellenemediğinden, kullanıcılar tarafından oluşturulan tüm etkinliklerin takip edilmesi mümkün olacaktır.

Fiyatlandırma

Stape ile sunucu Google Tag Manager üzerinden Snapchat CAPI'yi kurmak için önce bir Stape hesabına ihtiyacınız vardır. Ücretsiz olarak oluşturabilir ve Ücretsiz planla başlayabilirsiniz.

Stape ile sGTM üzerinden Snapchat CAPI'nin toplam fiyatı, GA4 istek sayısına bağlıdır; web siteniz için fiyatı görmek amacıyla hesap makinesine bakınız.

Sunucu Google Tag Manager kullanarak Snapchat Conversions API nasıl kurulur

2. Sunucu GTM kapsayıcısına veri gönderin. Bunu sunucu tarafı Google Analytics 4 kurarak veya Data Tag/Data Client kullanarak yapabilirsiniz.

3. GTM Şablon Galerisinden etiketi eklemek için sGTM şablon Galerisine gidin → Sunucu Google Tag Manager kapsayıcısında Templates bölümünü açın → Etiket Şablonları bölümünde Search Gallery'e tıklayın → Stape'ten Snapchat Conversions API'yi arayın → Add to workspace'e tıklayın.

Snapchat Conversions API from Stape

4. Etiketi içe aktarmak için (etiketi GitHub'dan indirdiyseniz) sağ üst köşedeki üç noktaya tıklayın → Import'a tıklayın → GitHub'dan indirdiğiniz Snapchat etiket şablonunu seçin → Save'e tıklayın.

Click "Save"

5. sGTM kapsayıcısında bir Snap etiketi oluşturun → Etkinlik adını seçin.

Standard — standart adlardan birini seçin.

Inherit from the client — bu durumda etiket, sGTM etkinlik adlarını ayrıştırmaya ve bunları Snap standart etkinlikleriyle eşleştirmeye çalışır.

Custom — özel bir ad kullanın.

6. Snap Piksel Kimliği'ni ekleyin → Conversions API Token'ı ekleyin. Conversions API Token'ları oluşturmak için İş Ayarları'na gidin ve Conversions API Tokens bölümünde Generate Token'a tıklayın.

Conversions API Tokens section

7. Kullanıcı ve etkinlik verilerini ekleyin.

Add user and events data

8. Snap için hibrit yöntem (web + sunucu) takibi kullanmak istiyorsanız, web ve sunucu Snap etiketlerine etkinlik kimliği eklediğinizden emin olun. Web Snap etiketi event_id'yi desteklemediğinden, Snap web etiketlerini kurmak için özel HTML kullanın.

Add event ID to web and server Snap tags

Kurulumu test etme

Web ve sunucu GTM hata ayıklama araçlarını açın ve Snap etiketlerinin doğru şekilde tetiklendiğini doğrulayın.

Test that Snap tags are triggered correctly

Ne yazık ki Snap'in sunucu etkinliklerini sorun gidermek için gerçek zamanlı bir aracı yoktur. Snap'in sunucu etkinliklerini aldığını doğrulamanın tek yolu, bunların Snap Events Manager'da görünmesini beklemektir.

Snapchat CAPI Gateway: Snapchat CAPI kurmanın en hızlı yolu

Snapchat CAPI Gateway

Snapchat Conversions API Gateway, Snap Conversions API'yi uygulamaya yönelik en güncel çözümdür ve en basit kurulum sürecini sunar.

Snap CAPI Gateway ile etkinlik tekilleştirme yapılandırmanıza veya etiketleme için saatlerce uğraşmanıza gerek yoktur. Kullanıcı parametrelerini ve etkinlikleri doğrudan bir sunucudan göndermenizi sağlar. Üstelik hesaplarını farklı Business Manager'ların yönettiği durumlarda bile tek bir örnekte birden fazla Pikseli destekler.

Snapchat Conversions API Gateway'e genel bakış

Ortam, Snapchat CAPI Gateway'in kritik bir özelliğidir. Her Snapchat Conversions API Gateway örneği, Snapchat Pikseli ile Conversions API arasındaki tüm iletişimi yöneten bir bulut sunucusunda çalışır.

Snap Pikseli Conversions API Gateway ortamına bağlandıktan sonra sunucudan veri takibi için web etkinliklerini kullanır. Snapchat Conversions API Gateway'i uygulamadan önce web etkinliklerinin doğru olduğundan ve gerekli tüm kullanıcı ve ürün bilgilerini içerdiğinden emin olmak son derece önemlidir.

Sunucu tarafı takip önemli avantajlar sunarken, Snap Conversions API'yi kurmak zaman alabilir ve çoğunlukla teknik uzmanlık gerektirir; bu da bazı reklamverenler için zorlayıcı olabilir. Ancak! Snapchat Conversions API Gateway, özel beceriler gerektirmeksizin Snapchat sunucu tarafı takibini uygulamak için en hızlı çözümü sunarak bu sorunu giderir.

Fiyatlandırma

Snapchat CAPI Gateway'i ödeme bilgisi girmeden 7 gün ücretsiz deneyebilirsiniz.

İki plan mevcuttur:

  • Kullandıkça öde. Her Piksel için aylık 10 $.
  • Ultimate. 100 Piksel için aylık 100 $.

Snapchat CAPI Gateway avantajları

Düşük fiyat

Stape'in Snapchat CAPI Gateway'i, Snap CAPI'yi kurmanın ve barındırmanın en basit ve en uygun maliyetli yoludur. Ücretsiz planla başlayın ve ardından yalnızca Piksel başına aylık 10 $ ile devam edin!

Kolay kurulum

Snapchat CAPI Gateway'i kurmak için geliştirici veya takip uzmanı kiralamanıza gerek yoktur. Kurulum süreci, standart Conversions API uygulamasından çok daha basittir.

Bakım gerektirmez

Güncellemeler otomatik olarak gerçekleşir; bu nedenle ayarlarda veya sunucularda manuel düzenleme yapmanıza gerek kalmaz. Yeni bir etkinlik eklerken yalnızca web takibini kurun; Conversions API Gateway sunucudan takibi otomatik olarak başlatacaktır.

Snapchat Conversions API Gateway nasıl kurulur

Başlamadan önce, Snapchat web takibinin sitenizde yapılandırılmış olduğundan emin olun: bir GTM kapsayıcısı aracılığıyla, doğrudan web sitesi koduna yerleştirilerek veya bir eklenti üzerinden entegre edilerek. Bu kurulum, mevcut web etkinliklerini kullanmanıza olanak tanır.

1. Stape'te Snap CAPI Gateway oluşturun

1.1. Stape'e hesap oluşturun veya giriş yapın. Snapchat bölümünde Create Gateway'e tıklayın.

Click "Create Gateway"

1.2. Alanlara bilgileri girin:

  • Gateway adı. Rastgele bir ad oluşturabilirsiniz.
  • Yönetici e-postası. Bu e-posta, Snap Conversions API Gateway'inizi yönetecek olup Stape hesap e-postanızdan farklı olabilir. Her Gateway için benzersiz olması gerekir.
  • Sunucu konumu. Web sitesi ziyaretçilerinize daha yakın bir konum seçin.

Create Snapchat CAPI Gateway'e tıklayın.

Click "Create Snapchat CAPI Gateway"

1.3. Abonelik planı seçin. Stape şunları sunar:

  • 7 günlük ücretsiz deneme.
  • Kullandıkça öde planı — Piksel başına aylık 10 $.
  • Ultimate planı — 100 Piksel için aylık 100 $.
Pricing plans

1.4. Gateway'inizin durumu Running olana kadar bekleyin.

Status 'Running" in Snap Gateway

2. Pikselinizi bağlayın

2.1. Finish Snapchat Gateway setup'a tıklayın.

Snapchat Gateway giriş arayüzüne yönlendirileceksiniz.

Click "Finish Snapchat Gateway setup"
Log in with Snapchat

2.2. Conversions API Gateway merkezinde solda Add data source'a tıklayın.

Click "Add data source"

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

Choose the account and the Pixels you want to connect

2.4. Eklenen Pikseli kontrol panelinizde göreceksiniz.

Added Pixel in the dashboard

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

3.1. Sol menüde Data Routing'e tıklayın.

Click "Data Routing"

3.2. Add Subdomain'e tıklayın. Özel alan adınızı girin.

Click "Add Subdomain"
Subdomain setup for Conversions API Gateway

3.3. DNS sağlayıcınızda oturum açın ve kayıtları ayarlayın (Cloudflare kullanıyorsanız, ayarlar ekran görüntüsündeki gibi görünmelidir).

Set DNS records

3.4. İşte bu kadar! Alt alan adınızı başarıyla kurdunuz.

Subdomain set up successfully

4. [Önerilen] Snap js dosyasını alt alan adınızdan yükleyin

Bu, etkinliklerinizin reklam engelleyicilere karşı korunmasını artırmanıza yardımcı olacaktır.

Veri yönlendirme alan adınızı doğruladıktan sonra, sitenizde Snap js'yi indirmek için kullanabileceğiniz bir bağlantı göreceksiniz:

Pixel code

Bunu sitenizin koduna ekleyebilir veya varsayılan Snap js snippet'inde değiştirebilirsiniz:

Add to your site's code or change it in the default Snap js snippet

5. [İsteğe bağlı] Yeni Pikseller ekleyin

Birden fazla Snapchat Pikseli kurmak için tek bir Snapchat CAPI Gateway kullanabilirsiniz. Ayrıca tüm Piksellere yönetici erişiminiz olması koşuluyla farklı Snapchat İşletme Hesaplarına ait Pikseller aynı CAPI Gateway'e bağlanabilir.

Süreç basittir: Snapchat CAPI Gateway'inizi yapılandırın, ardından merkez arayüzü üzerinden yeni Pikseller ekleyin. Yalnızca Add data source'a tıklamanız yeterlidir.

Click "Add data source"

6. Kurulumu test edin

Daha önce belirtildiği gibi, Snap CAPI Gateway sunucudan veri takibi için web etkinliklerini kullanır.

6.1. Pikselinizi Snap CAPIG merkezine bağladıktan sonra 30 dakika içinde etkinlik sayısının artık sıfır olmadığını ve alınan etkinliklerin adlarını da görebileceğinizi fark edeceksiniz.

Test Snapchat pixel

6.2. Etkinliklerin Snap CAPIG merkezine doğru şekilde gönderildiğini web sitesi konsolu üzerinden de doğrulayabilirsiniz:

  1. Sitenizde tarayıcı geliştirici araçlarının ağ sekmesini açın.
  2. Etkinliklerin Conversions API Gateway URL'nize gönderildiğini doğrulayın (aşağıdaki ekran görüntüsüne bakın).
Check that events were sent to your Conversions API Gateway URL

Sonuç

Bu kılavuzun Snapchat takibini ve reklam performansınızı iyileştirmek için mevcut seçenekleri anlamanıza yardımcı olduğunu umuyoruz. Tam kontrol ve özelleştirme için Google Tag Manager üzerinden daha gelişmiş Snapchat Conversions API (CAPI) kullanmayı tercih edin ya da daha hızlı ve basit bir yol olarak Snap CAPI Gateway'i seçin; her iki yöntemin de güçlü yönleri vardır.

Snapchat CAPI, kullanıcı davranışına ilişkin daha derin içgörüler, daha iyi reklam optimizasyonu ve daha doğru dönüşüm takibi sunar. Daha fazla esneklik istiyorsanız ve teknik kuruluma hâkimseniz Google Tag Manager, son derece özelleştirilmiş bir takip deneyimi sunar. Öte yandan, minimum kurulumla hızlı ve kolay bir şey arıyorsanız Snap CAPI Gateway, teknik uzman olmaya gerek kalmadan akıcı bir çözüm sunar.

Seçtiğiniz yol ne olursa olsun, işinizi kolaylaştırmak için buradayız. Sorularınız varsa veya kurulum konusunda yardıma ihtiyaç duyuyorsanız bize ulaşmaktan çekinmeyin; her zaman yardımcı olmaktan mutluluk duyarız. Snap CAPI Gateway'i test etmeye hazırsanız, uygulamayı ve etkinlikleri takip etmenin ne kadar kolay olduğunu görmek için 7 günlük ücretsiz denemeyle başlayabilirsiniz.

Reklamlarınızı etkili bir şekilde takip etmenin daha iyi sonuçlar elde etmek ve kampanyalarınızı geliştirmek için kritik öneme sahip olduğunu unutmayın. Bu nedenle her iki seçeneği de incelemek için zaman ayırın ve yol boyunca rehberliğe ihtiyaç duyarsanız bize ulaşın. Yardımcı olmak için buradayız!

Sunucu tarafında başlamak ister misiniz? Hemen kaydolun! Ücretsiz deneyin — e-posta adresinizi girin

Sunucu tarafında başlamak ister misiniz? 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