--- title: "Meta Ads Connector" description: "Popoln vodnik za integracijo Meta Ads za sinhronizacijo Facebook in Instagram oglaševalskih občinstev, konverzij in podatkov kampanj z Brevo prek Tajo." url: https://tajo.io/sl/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/sl/docs/connectors/marketing/meta-ads.md lang: sl-SI robots: noindex --- Zaprosite za zgodnji dostop Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja. # Meta Ads Connector Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja. | Izvorno polje | Ciljno polje | Vzorčna vrednost | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Poveži Meta Ads (Facebook in Instagram) z Brevo prek Tajo za sinhronizacijo Custom Audiences, uvoz konverzijskih dogodkov prek Conversions API in premostitev plačanega socialnega oglaševanja z avtomatizacijo marketinškega življenjskega cikla. ## Pregled | Lastnost | Vrednost | | --- | --- | | **Platforma** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategorija** | Marketing | | **Zahtevnost nastavitve** | Napredna | | **Uradna integracija** | Ne | | **Sinhronizirani podatki** | Občinstva, konverzije, kampanje, potencialne stranke | | **Razpoložljivi Skills** | 8 | | **Različica API** | v25.0 (Graph API) | ## Funkcionalnosti - **Sinhronizacija Custom Audience** – naloži sezname stikov Brevo kot Meta Custom Audiences - **Conversions API (CAPI)** – pošlji konverzijske dogodke na strani strežnika za natančno pripisovanje - **Sinhronizacija obrazcev za potencialne stranke** – uvozi oddaje Facebook Lead Ads neposredno v stike Brevo - **Vpogledi v kampanje** – pridobi metrike uspešnosti oglasov v nadzorne plošče Tajo - **Lookalike audiences** – ustvari Lookalike Audiences iz sinhroniziranih segmentov Brevo - **Sinhronizacija kataloga** – sinhroniziraj kataloge izdelkov za dinamične oglase izdelkov - **Večplatformnost** – ena integracija pokriva oglase Facebook, Instagram, Messenger in WhatsApp ## Predpogoji Preden začneš, se prepričaj, da imaš: 1. Račun Meta Business Manager 2. Aplikacijo Facebook z dostopom do Marketing API 3. Sistemskega uporabnika z ustreznimi dovoljenji 4. Dostopni žeton z dovoljenji `ads_management` in `ads_read` 5. Brevo račun z dostopom do API 6. Tajo račun s poverilnicami API ## Avtentikacija ### Dostopni žeton sistemskega uporabnika Meta za integracije med strežniki priporoča žetone sistemskih uporabnikov. Ti žetoni ne potečejo. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Avtentikacija na ravni aplikacije ```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" ``` ## Konfiguracija ### Osnovna nastavitev ```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" ``` ### Konfiguracija Custom Audience Sinhroniziraj sezname Brevo v Meta Custom Audiences: ```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" ``` ### Konfiguracija 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" ``` ## Končne točke API | Metoda | Končna točka | Opis | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Ustvarjanje Custom Audience | | `POST` | `/v25.0/{audience_id}/users` | Dodaj uporabnike v Custom Audience | | `DELETE` | `/v25.0/{audience_id}/users` | Odstrani uporabnike iz Custom Audience | | `POST` | `/v25.0/{pixel_id}/events` | Pošlji dogodke Conversions API | | `GET` | `/v25.0/act_{id}/campaigns` | Seznam kampanj | | `GET` | `/v25.0/act_{id}/insights` | Pridobi vpoglede kampanj | | `GET` | `/v25.0/{form_id}/leads` | Pridobi oddaje obrazcev za potencialne stranke | | `POST` | `/v25.0/act_{id}/adcreatives` | Ustvarjanje oglasnih kreativ | | `GET` | `/v25.0/{catalog_id}/products` | Seznam izdelkov kataloga | ## Primeri kode ### Inicializacija konektorja 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' }); ``` ### Pošiljanje dogodkov 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 }) } ); ``` ### Sinhronizacija Custom Audience iz seznama 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' }); ``` ### Pridobivanje vpogledov kampanj ```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' }); ``` ## Omejitve hitrosti | Vir | Omejitev | Podrobnosti | | --- | --- | --- | | **Marketing API** | Nivojsko | Glede na raven dostopa aplikacije in porabo | | **Nalaganja Custom Audience** | 700 zahtevkov/uro | Na oglaševalski račun | | **Conversions API** | 2.000 dogodkov/s | Na piksel | | **Insights API** | 200 klicev/uro | Na oglaševalski račun | | **Pridobivanje potencialnih strank** | 200 klicev/uro | Na stran | | **Paketni zahtevki** | 50 zahtevkov/paket | Na paketni klic | Zahtevana poslovna verifikacija Polni dostop do Marketing API zahteva poslovno verifikacijo v Meta Business Manager. Nepreverene aplikacije so omejene na razvojni način z omejenimi omejitvami hitrosti. ## Odpravljanje težav | Težava | Vzrok | Rešitev | | --- | --- | --- | | `OAuthException` | Potekel ali neveljaven žeton | Znova ustvari dostopni žeton sistemskega uporabnika | | Nizka stopnja ujemanja Custom Audience | Slaba kakovost podatkov | Zgoščuj vse OI z SHA-256, vključi več ujemajočih ključev | | Konverzije niso pripisane | Manjkajoča parametra `fbc`/`fbp` | Posreduj Facebook Click ID in Browser ID iz piškotkov | | `RATE_LIMIT_REACHED` | Preveč klicev API | Implementiraj eksponentni odlog, preveri nivo dostopa API | | Obrazci za potencialne stranke se ne sinhronizirajo | Manjkajoče dovoljenje `leads_retrieval` | Dodaj dovoljenje sistemskemu uporabniku | | Dogodki v testnem načinu | `test_event_code` je še nastavljen | Za produkcijo odstrani kodo testnega dogodka | ## Najboljše prakse 1. **Uporabi žetone sistemskih uporabnikov** – sistemski uporabniki zagotavljajo stabilne, netekuče žetone za strežniške integracije 2. **Zgoščuj vse OI** – pred pošiljanjem v Meta z SHA-256 zgoščuj vse osebno identificirajoče informacije 3. **Pošlji tako CAPI kot Pixel** – za redundantno sledenje z deduplikacijo uporabi tako Conversions API kot Meta Pixel 4. **Vključi ID-je dogodkov** – nastavi `event_id` na eventos obeh CAPI in Pixel za omogočanje deduplikacije 5. **Posreduj `fbc` in `fbp`** – za maksimalno pripisovanje konverzij vključi Facebook Click ID in Browser ID 6. **Preveri podjetje** – za polni dostop do API in višje omejitve hitrosti zaključi poslovno verifikacijo 7. **Uporabi `test_event_code`** – pred prehodom v produkcijo preizkusi dogodke Conversions API v Events Manager ## Varnost - **Žetoni sistemskih uporabnikov** – nepersonalni, poslovno obsegani avtentikacijski žetoni - **Zgoščevanje SHA-256** – vse OI so zgoščene pred prenosom na strežnike Meta - **App Secret Proof** – neobvezna dodatna plast varnosti avtentikacije - **Poslovno obseganje** – dovoljenja obsegana na specifične oglaševalske račune in strani - **Skladnost z Meta** – podrejenost Pogodbi o platformi Meta in oglaševalskim politikam - **Pogoji obdelave podatkov** – Pogoji obdelave podatkov Meta veljajo za podatke EU ## Povezani viri - [Google Ads Connector](https://tajo.io/sl/docs/connectors/marketing/google-ads) - [Klaviyo Connector](https://tajo.io/sl/docs/connectors/marketing/klaviyo) - [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo) - [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)