sGTM ile Meta Conversions API
Server-Side Google Tag Manager kullanarak Meta Conversions API (CAPI) kurulumu için kapsamlı bir rehber
Genel Bakış
Meta Conversions API (CAPI), serverınız ile Meta sistemleri arasında doğrudan bir bağlantı oluşturarak reklam hedeflemeyi optimize etmeye, eylem başına maliyeti düşürmeye ve ölçüm doğruluğunu artırmaya yardımcı olur. CAPI’yi Server-Side Google Tag Manager (sGTM) aracılığıyla uygulayarak veri gizliliğini ve kontrolünü koruyabilirsiniz.
Hardal ile Meta CAPI’yi sGTM ile Meta CAPI kurmadan önce uygulamanızı şiddetle tavsiye ederiz.
Ön Koşullar
Bu entegrasyona geçmeden önce şunlara sahip olduğunuzdan emin olun:
- Yönetici erişimine sahip bir Google Tag Manager hesabı
- Düzgün yapılandırılmış Google Analytics 4 (GA4)
- Bir Pixel ID’si olan Meta Business Manager hesabı
Sisteminiz GA4’ten daha eski bir sürüm kullanıyorsa, bu entegrasyona geçmeden önce mevcut tag manager kurulumunuzu GA4 kullanacak şekilde güncellemeniz gerekecektir.
Adım Adım Uygulama
sGTM Kurulumu
- Hardal ile sGTM Kurulumu’nu tamamladığınızdan emin olun
Meta Browser ID ve Click ID'yi Yapılandırın
Doğru tracking ve çift kayıt engelleme sağlamak için, Meta’nın browser ID ve click ID’sini serverınıza iletmeniz gerekecek:
- Web container’ınızda iki User-Defined Variables oluşturun
- Meta Browser ID:
- Değişken Tipi: 1st-Party Cookie
- Cookie Adı:
_fbp
- Meta Click ID:
- Değişken Tipi: 1st-Party Cookie
- Cookie Adı:
_fbc
- GA4 Configuration tag’inizde (Google Tag), şu alanları ekleyin:
- Alan Adı:
x-fb-ck-fbp
Değer: Meta Browser ID değişkeniniz - Alan Adı:
x-fb-ck-fbc
Değer: Meta Click ID değişkeniniz
- Alan Adı:
Server container’ınız için custom domain kurduysanız, bu ID’ler otomatik olarak iletilebilir. Ancak, doğru tracking sağlamak için bunları açıkça yapılandırmanız yine de önerilir.
Kullanıcı Veri Parametrelerini Ayarlayın
İlk olarak, izlemek istediğiniz her kullanıcı veri parametresi için Google Tag Manager web container’ınızda değişkenler oluşturmanız gerekecek:
- GTM web container dashboard’unuza gidin
- Sol kenar çubuğundaki Variables’a gidin
- “User-Defined Variables” altında New’e tıklayın
- Değişken tipi olarak Data Layer Variable’ı seçin
- Data Layer Variable Name’i eşleştirme tablosuna göre ayarlayın (aşağıya bakın)
- Değişken için uygun bir isim belirleyin (örn. “User Email”)
- Değişkeni kaydedin
Parametre Eşleştirme Yapısını Takip Edin
Değişkenlerinizi doğru kurmak için bu eşleştirme yapısını kullanın:
Meta Parametresi | GA4 Alan Adı | Data Layer Değişken Adı |
---|---|---|
email (em) | user_data.email_address | eventModel.user_data.email_address |
phone (ph) | user_data.phone_number | eventModel.user_data.phone_number |
external_id | x-fb-ud-external_id | Yok |
first_name (fn) | user_data.address.first_name | eventModel.user_data.address.first_name |
last_name (ln) | user_data.address.last_name | eventModel.user_data.address.last_name |
city (ct) | user_data.address.city | eventModel.user_data.address.city |
state (st) | user_data.address.region | eventModel.user_data.address.region |
zip (zp) | user_data.address.postal_code | eventModel.user_data.address.postal_code |
country (country) | user_data.address.country | eventModel.user_data.address.country |
Web container’ınıza tüm Data Layer Variables ekledikten sonra, Variables bölümü şu şekilde görünmelidir:
Önce yüksek öncelikli parametreleri uygulamaya odaklanın: email, telefon numarası ve external ID, Meta sistemleri için en iyi eşleşme oranlarını sağlar.
Değişkenleri Google Tag Yapılandırmanıza Ekleyin
Bu değişkenleri oluşturduktan sonra, bunları Google Tag’inize eklemeniz gerekir:
- Google Tag’inizi açın
- Configuration settings altında, Add parameter’a tıklayın
- Her parametre için, tablodaki GA4 Alan Adı’nı Configuration Parameter olarak girin
- Değer olarak oluşturduğunuz ilgili değişkeni ayarlayın
Websitenizde Veri Toplama Uygulayın
Websitenizin bu verileri toplayıp data layer’a iletmesini sağlamanız gerekecek. Örneğin:
Önemli Gizlilik Gereksinimlerini Dikkate Alın
Kullanıcı verilerini her zaman GDPR, CCPA ve diğer gizlilik düzenlemelerine uygun olarak dikkatli bir şekilde işleyin.
Kullanıcı veri parametrelerini uygularken:
- Her zaman kişisel olarak tanımlanabilir bilgileri (PII) Meta’ya göndermeden önce hash’leyin
- GA4 ve Meta Conversions API tag’i bu verileri otomatik olarak hash’leyecek olsa da, en iyi uygulama bunu data layer’a göndermeden önce kendiniz hash’lemektir
- Gizlilik düzenlemelerine uymak için uygun izin yönetimi uygulayın
- Yalnızca reklam amaçlı kullanım izni olan verileri toplayıp gönderin
Bu kullanıcı veri parametreleri, atfetme ve kitle hedefleme için daha iyi veriler sağlayarak Meta reklam kampanyalarınızın etkinliğini önemli ölçüde artıracaktır.
GA4 Event Tag'leri Oluşturun
Belirli kullanıcı eylemlerini izlemek için GA4 Event tag’leri kurun:
- Web container’ınızda yeni bir GA4 Event tag’i oluşturun
- GA4 Event tag’inizi seçin
- Event Name’i Meta’nın standart event’lerinden biriyle eşleşecek şekilde ayarlayın:
Meta Event Adı | GA4 Event Adı |
---|---|
PageView | page_view |
AddToCart | add_to_cart |
AddPaymentInfo | add_payment_info |
AddToWishlist | add_to_wishlist |
CompleteRegistration | sign_up |
InitiateCheckout | begin_checkout |
Lead | generate_lead |
Purchase | purchase |
Search | search |
ViewContent | view_item |
- Tracking ihtiyaçlarınıza göre event parametreleri ekleyin
- Çift kayıt engelleme için event_id parametresini yapılandırın (aşağıya bakın)
- Her event için uygun trigger’lar ayarlayın
- Tag’lerinizi kaydedin ve yayınlayın
Çift Kayıt Engelleme Kurun
Hem Pixel hem de CAPI kullanırken çift event’leri önlemek için event_id çift kayıt engelleme uygulayın:
- Benzersiz ID’ler oluşturmak için özel bir JavaScript değişkeni oluşturun:
- Data Layer Variable Name’i
eventModel.event_id
olan bir Data Layer Variable (örn. FBEventIdVar) oluşturun - Meta Pixel tag’inizde:
- GA4 Event tag’inizde bir event parametresi ekleyin:
- Parametre Adı:
event_id
- Değer: Event ID değişkeniniz
- Parametre Adı:
Tutarlı tetikleme ve doğru çift kayıt engelleme sağlamak için hem Meta Pixel tag’iniz hem de GA4 Event tag’iniz için aynı trigger’ı kullanın.
Server Container'daki GA4 Client'ı Yapılandırın
Server container’ınızda, GA4 Client’ın doğru kurulduğundan emin olun:
- Server container’ınıza gidin
- “Clients”a gidin
- “GA4” client’ını düzenleyin (veya yoksa oluşturun)
- “Default GA4 paths”i etkinleştirin
- “Default gtag.js paths”i etkinleştirin ve GA4 Measurement ID’lerinizi ekleyin
- Client yapılandırmasını kaydedin
GA4 Client, web container’ınızdan gelen verileri işlemek ve diğer server-side tag’lerin kullanabileceği bir formata dönüştürmekten sorumludur.
Meta Conversions API Tag'i Yükleyin
Son adım Meta Conversions API Tag’ini kurmaktır:
- Server container’ınızda “Tags”e gidin
- “New”e tıklayın ve “Discover More”a gidin. “Conversions API Tag by facebookincubator”ı arayın
- Meta Access Token Oluşturun
- Meta Business Manager’ınıza giriş yapın
- Events Manager’a gidin
- Pixel’inizi seçin
- Settings sekmesine gidin
- Dataset ID’yi kopyalayın ve kaydedin (3. adım olarak işaretli)
- “Conversions API” bölümünü bulun
- “Generate access token”a tıklayın
- Oluşturulan token’ı kopyalayın
- GA4 Client’tan gelen event’lerde tetiklenen bir trigger oluşturun
- Tag’i kaydedin ve yayınlayın
Access token’ınızı güvende tutun. Meta hesabınıza doğrudan erişim sağlar ve asla client-side kodda açığa çıkarılmamalıdır.
Uygulamanızı Test Etme
- Web container’ınızda Önizleme modunu etkinleştirin
- Server container’ınızda Önizleme modunu etkinleştirin
- Websitenize gidin ve event’leri tetiklemesi gereken eylemler gerçekleştirin
- Şunları doğrulayın:
- GA4 event’leri web container’da tetikleniyor
- Event’ler server container tarafından alınıyor
- Meta Conversions API tag’i server container’da tetikleniyor
- Web container’ınızda Önizleme modunu etkinleştirin
- Server container’ınızda Önizleme modunu etkinleştirin
- Websitenize gidin ve event’leri tetiklemesi gereken eylemler gerçekleştirin
- Şunları doğrulayın:
- GA4 event’leri web container’da tetikleniyor
- Event’ler server container tarafından alınıyor
- Meta Conversions API tag’i server container’da tetikleniyor
- Meta Events Manager > Data Sources > Pixel’iniz > Test Events’e gidin
- Bir Test Event Kodu oluşturun
- Test sırasında bu kodu Meta Conversions API Tag’inize ekleyin
- Websitenizde test eylemleri gerçekleştirin
- Event’lerin Test Events penceresinde göründüğünü doğrulayın
- Üretime geçmeden önce test kodunu kaldırın
Event’ler düzgün görünmüyorsa:
- Tag Tetiklenmiyor: Trigger yapılandırmalarınızı kontrol edin ve GA4 Event’lerin web container’da tetiklendiğini doğrulayın
- Tag Tetiklendi ama Başarısız Oldu: Server-side hata ayıklayıcıda, hata mesajları için Response Body’yi kontrol edin
- Çift Event’ler: Event_id uygulamanızı doğrulayın ve çift kayıt engellemenin çalıştığından emin olun
- Eksik Parametreler: Data layer ve değişken yapılandırmalarınızı kontrol edin
Custom Veri Parametreleri
Meta’ya ek event verileri göndermek için GA4 Event tag’lerinizde bu parametre eşleştirmelerini kullanın:
Meta Parametresi | GA4 Parametresi |
---|---|
value | value |
currency | currency |
search_string | search_term |
order_id | transaction_id |
content_ids | x-fb-cd-content_ids |
content_type | x-fb-cd-content_type |
content_name | x-fb-cd-content_name |
content_category | x-fb-cd-content_category |
contents | items VEYA x-fb-cd-contents |
num_items | x-fb-cd-num_items |
predicted_ltv | x-fb-cd-predicted_ltv |
status | x-fb-cd-status |
delivery_category | x-fb-cd-delivery_category |
contents
ve custom_properties
gibi dizi veya nesne parametreleri için, göndermeden önce JSON.stringify kullanmayı unutmayın.
Örnek Event Uygulaması
İşte tüm önerilen parametrelerle bir satın alma event’i örneği: