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

1

sGTM Kurulumu

2

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:

  1. 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

  1. 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

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.

3

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:

  1. GTM web container dashboard’unuza gidin
  2. Sol kenar çubuğundaki Variables’a gidin
  3. “User-Defined Variables” altında New’e tıklayın
  4. Değişken tipi olarak Data Layer Variable’ı seçin
  5. Data Layer Variable Name’i eşleştirme tablosuna göre ayarlayın (aşağıya bakın)
  6. Değişken için uygun bir isim belirleyin (örn. “User Email”)
  7. Değişkeni kaydedin

4

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 ParametresiGA4 Alan AdıData Layer Değişken Adı
email (em)user_data.email_addresseventModel.user_data.email_address
phone (ph)user_data.phone_numbereventModel.user_data.phone_number
external_idx-fb-ud-external_idYok
first_name (fn)user_data.address.first_nameeventModel.user_data.address.first_name
last_name (ln)user_data.address.last_nameeventModel.user_data.address.last_name
city (ct)user_data.address.cityeventModel.user_data.address.city
state (st)user_data.address.regioneventModel.user_data.address.region
zip (zp)user_data.address.postal_codeeventModel.user_data.address.postal_code
country (country)user_data.address.countryeventModel.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.

5

Değişkenleri Google Tag Yapılandırmanıza Ekleyin

Bu değişkenleri oluşturduktan sonra, bunları Google Tag’inize eklemeniz gerekir:

  1. Google Tag’inizi açın
  2. Configuration settings altında, Add parameter’a tıklayın
  3. Her parametre için, tablodaki GA4 Alan Adı’nı Configuration Parameter olarak girin
  4. Değer olarak oluşturduğunuz ilgili değişkeni ayarlayın

6

Websitenizde Veri Toplama Uygulayın

Websitenizin bu verileri toplayıp data layer’a iletmesini sağlamanız gerekecek. Örneğin:

// Kullanıcı bilgilerini toplarken (örn. checkout sırasında)
dataLayer.push({
  'event': 'user_data_collected',
  'user_data': {
    'email_address': 'example@domain.com', // Bu üretimde hash'lenmelidir
    'phone_number': '+15551234567', // Bu üretimde hash'lenmelidir
    'address': {
      'first_name': 'John', // Bu üretimde hash'lenmelidir
      'last_name': 'Doe', // Bu üretimde hash'lenmelidir
      'city': 'New York', // Bu üretimde hash'lenmelidir
      'region': 'NY', // Bu üretimde hash'lenmelidir
      'postal_code': '10001', // Bu üretimde hash'lenmelidir
      'country': 'US' // Bu üretimde hash'lenmelidir
    }
  }
});
7

Ö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.

8

GA4 Event Tag'leri Oluşturun

Belirli kullanıcı eylemlerini izlemek için GA4 Event tag’leri kurun:

  1. Web container’ınızda yeni bir GA4 Event tag’i oluşturun
  2. GA4 Event tag’inizi seçin
  3. Event Name’i Meta’nın standart event’lerinden biriyle eşleşecek şekilde ayarlayın:
Meta Event AdıGA4 Event Adı
PageViewpage_view
AddToCartadd_to_cart
AddPaymentInfoadd_payment_info
AddToWishlistadd_to_wishlist
CompleteRegistrationsign_up
InitiateCheckoutbegin_checkout
Leadgenerate_lead
Purchasepurchase
Searchsearch
ViewContentview_item
  1. Tracking ihtiyaçlarınıza göre event parametreleri ekleyin
  2. Çift kayıt engelleme için event_id parametresini yapılandırın (aşağıya bakın)
  3. Her event için uygun trigger’lar ayarlayın
  4. Tag’lerinizi kaydedin ve yayınlayın
9

Ç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:

  1. Benzersiz ID’ler oluşturmak için özel bir JavaScript değişkeni oluşturun:
function() {
  var gtmData = window.google_tag_manager[{{Container ID}}].dataLayer.get('gtm');
  return gtmData.start + '.' + gtmData.uniqueEventId;
}
  1. Data Layer Variable Name’i eventModel.event_id olan bir Data Layer Variable (örn. FBEventIdVar) oluşturun
  2. Meta Pixel tag’inizde:
fbq('track', 'Purchase', {/* parameters */}, {eventID: {{FBEventIdVar}} });
  1. GA4 Event tag’inizde bir event parametresi ekleyin:
    • Parametre Adı: event_id
    • Değer: Event ID değişkeniniz

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.

10

Server Container'daki GA4 Client'ı Yapılandırın

Server container’ınızda, GA4 Client’ın doğru kurulduğundan emin olun:

  1. Server container’ınıza gidin
  2. “Clients”a gidin
  3. “GA4” client’ını düzenleyin (veya yoksa oluşturun)
  4. “Default GA4 paths”i etkinleştirin
  5. “Default gtag.js paths”i etkinleştirin ve GA4 Measurement ID’lerinizi ekleyin

  1. 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.

11

Meta Conversions API Tag'i Yükleyin

Son adım Meta Conversions API Tag’ini kurmaktır:

  1. Server container’ınızda “Tags”e gidin
  2. “New”e tıklayın ve “Discover More”a gidin. “Conversions API Tag by facebookincubator”ı arayın

  1. 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

  1. GA4 Client’tan gelen event’lerde tetiklenen bir trigger oluşturun

  1. 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

  1. Web container’ınızda Önizleme modunu etkinleştirin
  2. Server container’ınızda Önizleme modunu etkinleştirin
  3. Websitenize gidin ve event’leri tetiklemesi gereken eylemler gerçekleştirin
  4. Ş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

Custom Veri Parametreleri

Meta’ya ek event verileri göndermek için GA4 Event tag’lerinizde bu parametre eşleştirmelerini kullanın:

Meta ParametresiGA4 Parametresi
valuevalue
currencycurrency
search_stringsearch_term
order_idtransaction_id
content_idsx-fb-cd-content_ids
content_typex-fb-cd-content_type
content_namex-fb-cd-content_name
content_categoryx-fb-cd-content_category
contentsitems VEYA x-fb-cd-contents
num_itemsx-fb-cd-num_items
predicted_ltvx-fb-cd-predicted_ltv
statusx-fb-cd-status
delivery_categoryx-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:

gtag('event', 'purchase', {
  'event_id': generateEventId(),
  'transaction_id': 'ORDER_12345',
  'currency': 'USD',
  'value': 125.99,
  'user_data': {
    'email_address': '<HASHED_EMAIL>',
    'phone_number': '<HASHED_PHONE>',
    'address': {
      'first_name': '<HASHED_FIRST_NAME>',
      'last_name': '<HASHED_LAST_NAME>',
      'city': '<HASHED_CITY>',
      'region': '<HASHED_STATE>',
      'postal_code': '<HASHED_ZIP>',
      'country': '<HASHED_COUNTRY>'
    }
  },
  'items': [
    {
      'item_id': 'SKU_12345',
      'item_name': 'Premium Blue Jeans',
      'item_category': 'Apparel',
      'price': 70.99,
      'quantity': 1
    },
    {
      'item_id': 'SKU_67890',
      'item_name': 'Casual White T-Shirt',
      'item_category': 'Apparel',
      'price': 25.99,
      'quantity': 2
    }
  ]
});

Sıkça Sorulan Sorular