Meta Ads Bağlayıcısı

Custom Audiences senkronize etmek, Conversions API üzerinden dönüşüm olaylarını içe aktarmak ve ücretli sosyal reklamcılığı yaşam döngüsü pazarlama otomasyonuyla birleştirmek için Meta Ads’i (Facebook ve Instagram) Tajo aracılığıyla Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Custom Audience senkronizasyonu - Brevo kişi listelerini Meta Custom Audiences olarak yükleyin
• Conversions API (CAPI) - Doğru atıf için sunucu tarafı dönüşüm olayları gönderin
• Aday formu senkronizasyonu - Facebook Lead Ads gönderimlerini doğrudan Brevo kişilerine içe aktarın
• Kampanya içgörüleri - Reklam performans metriklerini Tajo panolarına çekin
• Lookalike kitleleri - Senkronize edilmiş Brevo segmentlerinden Lookalike Audiences oluşturun
• Katalog senkronizasyonu - Dinamik ürün reklamları için ürün kataloglarını senkronize edin
• Çoklu platform - Tek entegrasyon Facebook, Instagram, Messenger ve WhatsApp reklamlarını kapsar

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir Meta Business Manager hesabı
2. Marketing API erişimi olan bir Facebook App
3. Uygun izinlere sahip bir System User
4. ads_management ve ads_read izinleriyle bir Access Token
5. API erişimi olan bir Brevo hesabı
6. API kimlik bilgilerine sahip bir Tajo hesabı

Kimlik Doğrulama

System User Access Token

Meta, sunucu-sunucu entegrasyonları için System User belirteçlerinin kullanılmasını önerir. Bu belirteçlerin süresi dolmaz.

# Required permissions for System User
ads_management
ads_read
business_management
leads_retrieval
pages_read_engagement
catalog_management

Uygulama Seviyesi Kimlik Doğrulama

curl -G "https://graph.facebook.com/v25.0/act_AD_ACCOUNT_ID/campaigns" \
  -d "access_token=SYSTEM_USER_ACCESS_TOKEN" \
  -d "fields=name,status,objective"

Yapılandırma

Temel Kurulum

connectors:
  meta_ads:
    enabled: true
    app_id: "your-facebook-app-id"
    app_secret: "your-facebook-app-secret"
    access_token: "your-system-user-access-token"
    ad_account_id: "act_123456789"
    business_id: "987654321"
    pixel_id: "111222333444"

    # Data sync options
    sync:
      custom_audiences: true
      conversions_api: true
      lead_forms: true
      campaign_insights: true

    # API version
    api_version: "v25.0"

Custom Audience Yapılandırması

Brevo listelerini Meta Custom Audiences’a senkronize edin:

custom_audiences:
  enabled: true
  lists:
    - brevo_list_id: 5
      audience_name: "All Customers"
      subtype: "CUSTOM"
    - brevo_list_id: 6
      audience_name: "High LTV Customers"
      subtype: "CUSTOM"
    - brevo_list_id: 7
      audience_name: "Recent Purchasers"
      subtype: "CUSTOM"

  # Matching fields
  match_keys:
    - EMAIL
    - PHONE
    - FN     # First name
    - LN     # Last name
    - CT     # City
    - ST     # State
    - ZIP
    - COUNTRY

  schedule: "daily"
  sync_mode: "mirror"

Conversions API Yapılandırması

conversions_api:
  enabled: true
  pixel_id: "111222333444"
  test_event_code: ""  # Set for testing, clear for production

  events:
    - brevo_event: "order_completed"
      meta_event: "Purchase"
      value_field: "revenue"
      currency_field: "currency"
    - brevo_event: "cart_updated"
      meta_event: "AddToCart"
    - brevo_event: "customer_created"
      meta_event: "Lead"
    - brevo_event: "page_viewed"
      meta_event: "ViewContent"

API Uç Noktaları

Kod Örnekleri

Meta Ads Bağlayıcısını Başlat

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Meta Ads account
await tajo.connectors.connect('meta-ads', {
  appId: process.env.META_APP_ID,
  appSecret: process.env.META_APP_SECRET,
  accessToken: process.env.META_ACCESS_TOKEN,
  adAccountId: 'act_123456789',
  pixelId: '111222333444'
});

Conversions API Olayları Gönder

// Send a purchase event via Conversions API
const response = await fetch(
  `https://graph.facebook.com/v25.0/${PIXEL_ID}/events`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      data: [{
        event_name: 'Purchase',
        event_time: Math.floor(Date.now() / 1000),
        action_source: 'website',
        user_data: {
          em: [hashSHA256('[email protected]')],
          ph: [hashSHA256('+15551234567')],
          fn: [hashSHA256('jane')],
          ln: [hashSHA256('kim')],
          client_ip_address: '192.168.1.1',
          client_user_agent: 'Mozilla/5.0...',
          fbc: 'fb.1.1234567890.AbCdEfG',  // Click ID
          fbp: 'fb.1.1234567890.987654321'  // Browser ID
        },
        custom_data: {
          value: 89.99,
          currency: 'USD',
          content_ids: ['SKU-001'],
          content_type: 'product'
        }
      }],
      access_token: process.env.META_ACCESS_TOKEN
    })
  }
);

Brevo Listesinden Custom Audience Senkronize Et

// Upload a Brevo contact list as a Meta Custom Audience
await tajo.connectors.syncAudience('meta-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'],
  syncMode: 'mirror'
});

Kampanya İçgörülerini Çek

// Get campaign performance metrics
const insights = await tajo.connectors.query('meta-ads', {
  resource: 'campaigns',
  fields: ['campaign_name', 'impressions', 'clicks', 'spend',
           'actions', 'cost_per_action_type'],
  dateRange: { since: '2024-01-01', until: '2024-01-31' },
  level: 'campaign'
});

Hız Limitleri

Sorun Giderme

En İyi Uygulamalar

1. System User belirteçlerini kullanın - System Users sunucu entegrasyonları için sabit, süresi dolmayan belirteçler sağlar
2. Tüm PII’yi hashleyin - Meta’ya göndermeden önce kişisel olarak tanımlanabilir tüm bilgileri SHA-256 ile hashleyin
3. Hem CAPI hem de Pixel gönderin - Tekilleştirme ile yedekli takip için hem Conversions API hem de Meta Pixel’i kullanın
4. Olay kimliklerini ekleyin - Tekilleştirmeyi etkinleştirmek için hem CAPI hem de Pixel olaylarına event_id ayarlayın
5. fbc ve fbp iletin - Maksimum dönüşüm atfı için Facebook Click ID ve Browser ID dahil edin
6. İşletmenizi doğrulayın - Tam API erişimi ve daha yüksek hız limitleri için İşletme Doğrulamasını tamamlayın
7. test_event_code kullanın - Yayına almadan önce Conversions API olaylarını Events Manager’da test edin

Güvenlik

• System User belirteçleri - Kişisel olmayan, işletme kapsamlı kimlik doğrulama belirteçleri
• SHA-256 hashleme - Tüm PII Meta sunucularına iletilmeden önce hashlenir
• App Secret Proof - İsteğe bağlı ek kimlik doğrulama güvenlik katmanı
• İşletme kapsamlandırması - İzinler belirli reklam hesapları ve sayfalarla kapsamlandırılır
• Meta uyumluluğu - Meta Platform Şartlarına ve reklamcılık politikalarına tabidir
• Veri İşleme Şartları - AB verileri için Meta’nın Veri İşleme Şartları geçerlidir

İlgili Kaynaklar

• Google Ads Bağlayıcısı
• Klaviyo Bağlayıcısı
• Brevo Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği