--- title: "Conector Meta Ads" description: "Ghid complet de integrare Meta Ads pentru sincronizarea audiențelor de reclame Facebook și Instagram, conversiilor și datelor de campanie cu Brevo prin Tajo." url: https://tajo.io/ro/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/ro/docs/connectors/marketing/meta-ads.md lang: ro-RO robots: noindex --- Solicită acces anticipat Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo. # Conector Meta Ads Starea conectorului: Planificat Încă neconstruit. Tajo nu rulează astăzi acest conector. | Câmp sursă | Câmp destinație | Valoare exemplu | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Conectați Meta Ads (Facebook & Instagram) la Brevo prin Tajo pentru a sincroniza Audiențele personalizate, a importa evenimentele de conversie prin Conversions API și a face legătura dintre publicitatea socială plătită și automatizarea marketingului ciclului de viață. ## Prezentare generală | Proprietate | Valoare | | --- | --- | | **Platformă** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Categorie** | Marketing | | **Complexitate configurare** | Avansată | | **Integrare oficială** | Nu | | **Date sincronizate** | Audiențe, Conversii, Campanii, Lead-uri | | **Skilluri disponibile** | 8 | | **Versiune API** | v25.0 (Graph API) | ## Funcționalități - **Sincronizare Audiențe personalizate** - Încărcați listele de contacte Brevo ca Audiențe personalizate Meta - **Conversions API (CAPI)** - Trimiteți evenimente de conversie server-side pentru atribuire precisă - **Sincronizare formulare lead** - Importați direct trimiterile Facebook Lead Ads în contactele Brevo - **Informații campanii** - Extrageți metricile de performanță ale reclamelor în tablourile de bord Tajo - **Audiențe lookalike** - Creați Audiențe lookalike din segmentele Brevo sincronizate - **Sincronizare catalog** - Sincronizați cataloagele de produse pentru reclame cu produse dinamice - **Multi-platformă** - O singură integrare acoperă reclamele Facebook, Instagram, Messenger și WhatsApp ## Cerințe preliminare Înainte de a începe, asigurați-vă că aveți: 1. Un cont Meta Business Manager 2. O aplicație Facebook cu acces Marketing API 3. Un utilizator sistem cu permisiunile corespunzătoare 4. Un token de acces cu permisiunile `ads_management` și `ads_read` 5. Un cont Brevo cu acces API 6. Un cont Tajo cu credențiale API ## Autentificare ### Token de acces utilizator sistem Meta recomandă utilizarea token-urilor Utilizator sistem pentru integrările server-to-server. Aceste token-uri nu expiră. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Autentificare la nivel de aplicație ```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" ``` ## Configurare ### Configurare de bază ```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" ``` ### Configurare Audiențe personalizate Sincronizați listele Brevo la Audiențele personalizate Meta: ```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" ``` ### Configurare Conversions API ```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" ``` ## Puncte finale API | Metodă | Punct final | Descriere | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Creează o Audiență personalizată | | `POST` | `/v25.0/{audience_id}/users` | Adaugă utilizatori la Audiența personalizată | | `DELETE` | `/v25.0/{audience_id}/users` | Elimină utilizatori din Audiența personalizată | | `POST` | `/v25.0/{pixel_id}/events` | Trimite evenimente Conversions API | | `GET` | `/v25.0/act_{id}/campaigns` | Listează campaniile | | `GET` | `/v25.0/act_{id}/insights` | Obține informații campanie | | `GET` | `/v25.0/{form_id}/leads` | Recuperează trimiterile de formulare lead | | `POST` | `/v25.0/act_{id}/adcreatives` | Creează creativuri de reclame | | `GET` | `/v25.0/{catalog_id}/products` | Listează produsele din catalog | ## Exemple de cod ### Inițializare conector Meta Ads ```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' }); ``` ### Trimitere evenimente Conversions API ```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 }) } ); ``` ### Sincronizare Audiență personalizată din lista Brevo ```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' }); ``` ### Extragere informații campanii ```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' }); ``` ## Limite de rată | Resursă | Limită | Detalii | | --- | --- | --- | | **Marketing API** | Bazat pe niveluri | Bazat pe nivelul de acces al aplicației și cheltuieli | | **Încărcări Audiență personalizată** | 700 cereri/oră | Per cont de publicitate | | **Conversions API** | 2.000 evenimente/sec | Per pixel | | **Insights API** | 200 apeluri/oră | Per cont de publicitate | | **Recuperare lead-uri** | 200 apeluri/oră | Per pagină | | **Cereri batch** | 50 cereri/lot | Per apel batch | Verificare afacere necesară Accesul complet la Marketing API necesită verificarea afacerii în Meta Business Manager. Aplicațiile neverificate sunt limitate la modul de dezvoltare cu limite de rată restricționate. ## Depanare | Problemă | Cauză | Soluție | | --- | --- | --- | | `OAuthException` | Token expirat sau invalid | Regenerați token-ul de acces Utilizator sistem | | Rată de potrivire Audiență personalizată scăzută | Calitate slabă a datelor | Hash-uiți toate PII cu SHA-256, includeți mai multe chei de potrivire | | Conversii neatribuite | Parametrii `fbc`/`fbp` lipsă | Transmiteți Click ID Facebook și Browser ID din cookie-uri | | `RATE_LIMIT_REACHED` | Prea multe apeluri API | Implementați backoff exponențial, verificați nivelul de acces API | | Formulare lead nesincronizate | Permisiunea `leads_retrieval` lipsă | Adăugați permisiunea la Utilizatorul sistem | | Evenimente în modul de test | `test_event_code` încă setat | Eliminați codul evenimentului de test pentru producție | ## Bune practici 1. **Utilizați token-uri Utilizator sistem** - Utilizatorii sistem oferă token-uri stabile, non-expirate pentru integrări server 2. **Hash-uiți toate PII** - Hash SHA-256 toate informațiile de identificare personală înainte de a trimite la Meta 3. **Trimiteți atât CAPI cât și Pixel** - Utilizați atât Conversions API cât și Meta Pixel pentru urmărire redundantă cu deduplicare 4. **Includeți ID-uri de eveniment** - Setați `event_id` atât pe evenimentele CAPI cât și pe Pixel pentru a activa deduplicarea 5. **Transmiteți `fbc` și `fbp`** - Includeți Click ID Facebook și Browser ID pentru atribuire maximă a conversiei 6. **Verificați afacerea** - Completați Verificarea afacerii pentru acces complet API și limite de rată mai mari 7. **Utilizați `test_event_code`** - Testați evenimentele Conversions API în Events Manager înainte de a trece în producție ## Securitate - **Token-uri Utilizator sistem** - Token-uri de autentificare non-personale, cu scope de afaceri - **Hash SHA-256** - Toate PII hash-uite înainte de transmitere la serverele Meta - **App Secret Proof** - Strat opțional suplimentar de securitate autentificare - **Scope afaceri** - Permisiunile limitate la conturi de publicitate și pagini specifice - **Conformitate Meta** - Supus Termenilor Platformei Meta și politicilor de publicitate - **Termeni de procesare date** - Termenii de procesare a datelor Meta se aplică pentru datele EU ## Resurse conexe - [Conector Google Ads](https://tajo.io/ro/docs/connectors/marketing/google-ads) - [Conector Klaviyo](https://tajo.io/ro/docs/connectors/marketing/klaviyo) - [Conector Brevo](https://tajo.io/ro/docs/connectors/marketing/brevo) - [Skill Sincronizare clienți](https://tajo.io/ro/docs/skills/data-sync/customer-sync)