--- title: "Meta Ads Bağlayıcısı" description: "Tajo aracılığıyla Facebook ve Instagram reklam kitlelerini, dönüşümlerini ve kampanya verilerini Brevo ile senkronize etmek için eksiksiz Meta Ads entegrasyon rehberi." url: https://tajo.io/tr/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/tr/docs/connectors/marketing/meta-ads.md lang: tr-TR robots: noindex --- Erken erişim talep edin Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz. # Meta Ads Bağlayıcısı Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor. | Kaynak alanı | Hedef alanı | Örnek değer | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | 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ış | Özellik | Değer | | --- | --- | | **Platform** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategori** | Pazarlama | | **Kurulum Karmaşıklığı** | Gelişmiş | | **Resmi Entegrasyon** | Hayır | | **Senkronize Edilen Veri** | Kitleler, Dönüşümler, Kampanyalar, Adaylar | | **Mevcut Yetenekler** | 8 | | **API Sürümü** | v25.0 (Graph API) | ## Ö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. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Uygulama Seviyesi Kimlik Doğrulama ```bash 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 ```yaml 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: ```yaml 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ı ```yaml 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ı | Yöntem | Uç Nokta | Açıklama | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Bir Custom Audience oluştur | | `POST` | `/v25.0/{audience_id}/users` | Custom Audience’a kullanıcı ekle | | `DELETE` | `/v25.0/{audience_id}/users` | Custom Audience’tan kullanıcı kaldır | | `POST` | `/v25.0/{pixel_id}/events` | Conversions API olayları gönder | | `GET` | `/v25.0/act_{id}/campaigns` | Kampanyaları listele | | `GET` | `/v25.0/act_{id}/insights` | Kampanya içgörülerini al | | `GET` | `/v25.0/{form_id}/leads` | Aday formu gönderimlerini getir | | `POST` | `/v25.0/act_{id}/adcreatives` | Reklam yaratıcıları oluştur | | `GET` | `/v25.0/{catalog_id}/products` | Katalog ürünlerini listele | ## Kod Örnekleri ### Meta Ads Bağlayıcısını Başlat ```javascript 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 ```javascript // 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('jane@example.com')], 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 ```javascript // 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 ```javascript // 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 | Kaynak | Limit | Detaylar | | --- | --- | --- | | **Marketing API** | Katmana göre | Uygulama erişim seviyesine ve harcamaya göre | | **Custom Audience yüklemeleri** | 700 istek/saat | Reklam hesabı başına | | **Conversions API** | 2.000 olay/saniye | Pixel başına | | **Insights API** | 200 çağrı/saat | Reklam hesabı başına | | **Aday alımı** | 200 çağrı/saat | Sayfa başına | | **Toplu istekler** | Toplu başına 50 istek | Toplu çağrı başına | İşletme Doğrulaması Gerekli Tam Marketing API erişimi, Meta Business Manager’da işletme doğrulaması gerektirir. Doğrulanmamış uygulamalar, kısıtlı hız limitleriyle geliştirme moduyla sınırlıdır. ## Sorun Giderme | Sorun | Neden | Çözüm | | --- | --- | --- | | `OAuthException` | Belirteç süresi doldu veya geçersiz | System User access token’ı yeniden oluşturun | | Düşük Custom Audience eşleşme oranı | Düşük veri kalitesi | Tüm PII’yi SHA-256 ile hashleyin, birden fazla eşleşme anahtarı ekleyin | | Dönüşümler atfedilmiyor | Eksik `fbc`/`fbp` parametreleri | Çerezlerden Facebook Click ID ve Browser ID iletin | | `RATE_LIMIT_REACHED` | Çok fazla API çağrısı | Üstel geri çekilme uygulayın, API erişim katmanını kontrol edin | | Aday formları senkronize edilmiyor | `leads_retrieval` izni eksik | System User’a izin ekleyin | | Olaylar test modunda | `test_event_code` hala ayarlı | Üretim için test event kodunu kaldırın | ## 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ı](https://tajo.io/tr/docs/connectors/marketing/google-ads) - [Klaviyo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/klaviyo) - [Brevo Bağlayıcısı](https://tajo.io/tr/docs/connectors/marketing/brevo) - [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)