--- title: "Meta Ads Konektor" description: "Kompletan vodič za integraciju Meta Adsa za sinkronizaciju Facebook i Instagram reklamnih publika, konverzija i podataka o kampanjama s Brevom putem Taja." url: https://tajo.io/hr/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/hr/docs/connectors/marketing/meta-ads.md lang: hr-HR robots: noindex --- Zatražite rani pristup Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju. # Meta Ads Konektor Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor. | Izvorno polje | Odredišno polje | Primjer vrijednosti | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Povežite Meta Ads (Facebook i Instagram) s Brevom putem Taja kako biste sinkronizirali Custom Audiences, uvezli konverzijske događaje putem Conversions API-ja i premostili plaćeno socijalno oglašavanje s marketinškom automatizacijom životnog ciklusa. ## Pregled | Svojstvo | Vrijednost | | --- | --- | | **Platforma** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategorija** | Marketing | | **Složenost postavljanja** | Napredno | | **Službena integracija** | Ne | | **Sinkronizirani podaci** | Publike, Konverzije, Kampanje, Potencijalni klijenti | | **Dostupne vještine** | 8 | | **Verzija API-ja** | v25.0 (Graph API) | ## Značajke - **Sinkronizacija Custom Audience** - Učitajte Brevo popise kontakata kao Meta Custom Audiences - **Conversions API (CAPI)** - Slanje konverzijskih događaja na strani servera za točnu atribuciju - **Sinkronizacija obrazaca za potencijalne klijente** - Uvezite Facebook Lead Ads prijave izravno u Brevo kontakte - **Uvidi o kampanjama** - Povucite metrike performansi oglasa u Tajo dashboardove - **Lookalike publike** - Kreirajte Lookalike Audiences iz sinkroniziranih Brevo segmenata - **Sinkronizacija kataloga** - Sinkronizacija kataloga proizvoda za dinamične reklamne oglase - **Više platformi** - Jedna integracija pokriva Facebook, Instagram, Messenger i WhatsApp oglase ## Preduvjeti Prije nego što počnete, osigurajte da imate: 1. Meta Business Manager račun 2. Facebook aplikaciju s pristupom Marketing API-ju 3. Sistemskog korisnika s odgovarajućim dozvolama 4. Pristupni token s dozvolama `ads_management` i `ads_read` 5. Brevo račun s API pristupom 6. Tajo račun s API vjerodajnicama ## Autentifikacija ### Token pristupa sistemskog korisnika Meta preporučuje korištenje tokena sistemskog korisnika za server-to-server integracije. Ovi tokeni ne istječu. ```bash # Potrebne dozvole za sistemskog korisnika ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Autentifikacija na razini 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 konfiguracija ```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" # Opcije sinkronizacije podataka sync: custom_audiences: true conversions_api: true lead_forms: true campaign_insights: true # Verzija API-ja api_version: "v25.0" ``` ### Konfiguracija Custom Audience Sinkronizacija Brevo popisa na 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" # Polja za podudaranje match_keys: - EMAIL - PHONE - FN # Ime - LN # Prezime - CT # Grad - ST # Država - ZIP - COUNTRY schedule: "daily" sync_mode: "mirror" ``` ### Konfiguracija Conversions API-ja ```yaml conversions_api: enabled: true pixel_id: "111222333444" test_event_code: "" # Postavite za testiranje, obrišite za produkciju 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 krajnje točke | Metoda | Krajnja točka | Opis | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Kreiraj Custom Audience | | `POST` | `/v25.0/{audience_id}/users` | Dodaj korisnike u Custom Audience | | `DELETE` | `/v25.0/{audience_id}/users` | Ukloni korisnike iz Custom Audience | | `POST` | `/v25.0/{pixel_id}/events` | Pošalji Conversions API događaje | | `GET` | `/v25.0/act_{id}/campaigns` | Popis kampanja | | `GET` | `/v25.0/act_{id}/insights` | Dohvati uvide o kampanjama | | `GET` | `/v25.0/{form_id}/leads` | Dohvati prijave obrazaca za potencijalne klijente | | `POST` | `/v25.0/act_{id}/adcreatives` | Kreiraj reklamne kreative | | `GET` | `/v25.0/{catalog_id}/products` | Popis proizvoda kataloga | ## Primjeri koda ### Inicijalizacija Meta Ads konektora ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Povežite Meta Ads račun 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' }); ``` ### Slanje Conversions API događaja ```javascript // Slanje purchase događaja putem Conversions API-ja 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 }) } ); ``` ### Sinkronizacija Custom Audience iz Brevo popisa ```javascript // Učitajte Brevo popis kontakata kao Meta Custom Audience await tajo.connectors.syncAudience('meta-ads', { brevoListId: 5, audienceName: 'High Value Customers', matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'], syncMode: 'mirror' }); ``` ### Povlačenje uvida o kampanjama ```javascript // Dohvatite metrike performansi kampanje 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' }); ``` ## Ograničenja brzine | Resurs | Ograničenje | Detalji | | --- | --- | --- | | **Marketing API** | Na temelju razine | Na temelju razine pristupa aplikacije i potrošnje | | **Custom Audience učitavanja** | 700 zahtjeva/sat | Po reklamnom računu | | **Conversions API** | 2.000 događaja/sek | Po pixelu | | **Insights API** | 200 poziva/sat | Po reklamnom računu | | **Dohvaćanje potencijalnih klijenata** | 200 poziva/sat | Po stranici | | **Skupni zahtjevi** | 50 zahtjeva/serija | Po skupnom pozivu | Potrebna verificirani poslovni subjekt Pun pristup Marketing API-ju zahtijeva verificirani poslovni subjekt u Meta Business Manageru. Neverficirane aplikacije ograničene su na razvojni način rada sa smanjenim ograničenjima brzine. ## Rješavanje problema | Problem | Uzrok | Rješenje | | --- | --- | --- | | `OAuthException` | Token istekao ili nevažeći | Regenerirajte token pristupa sistemskog korisnika | | Niska stopa podudaranja Custom Audience | Loša kvaliteta podataka | Hashirajte sve PII s SHA-256, uključite više ključeva za podudaranje | | Konverzije se ne pripisuju | Nedostaju parametri `fbc`/`fbp` | Proslijedite Facebook Click ID i Browser ID iz kolačića | | `RATE_LIMIT_REACHED` | Previše API poziva | Implementirajte eksponencijalni povratak, provjerite razinu pristupa API-ju | | Obrasci za potencijalne klijente se ne sinkroniziraju | Nedostaje dozvola `leads_retrieval` | Dodajte dozvolu sistemskom korisniku | | Događaji u testnom načinu rada | `test_event_code` još postavljen | Uklonite kod testnog događaja za produkciju | ## Preporučene prakse 1. **Koristite tokene sistemskog korisnika** - Sistemski korisnici pružaju stabilne, ne-istječuće tokene za serverske integracije 2. **Hashirajte sve PII** - SHA-256 hashirajte sve osobno prepoznatljive informacije prije slanja Meti 3. **Šaljite i CAPI i Pixel** - Koristite i Conversions API i Meta Pixel za redundantno praćenje s deduplikacijom 4. **Uključite ID-ove događaja** - Postavite `event_id` i na CAPI i na Pixel događajima za omogućavanje deduplikacije 5. **Proslijedite `fbc` i `fbp`** - Uključite Facebook Click ID i Browser ID za maksimalnu atribuciju konverzija 6. **Verificirajte vaš poslovni subjekt** - Dovršite Business Verification za puni API pristup i viša ograničenja brzine 7. **Koristite `test_event_code`** - Testirajte Conversions API događaje u Events Manageru prije pokretanja u živo ## Sigurnost - **Tokeni sistemskog korisnika** - Ne-osobni, poslovni tokeni za autentifikaciju - **SHA-256 hashiranje** - Svi PII hashirani prije prijenosa na Meta servere - **App Secret Proof** - Opcionalni dodatni sloj sigurnosti autentifikacije - **Poslovni opseg** - Dozvole opsežene na specifične reklamne račune i stranice - **Meta usklađenost** - Podložno Meta Platform uvjetima i pravilima oglašavanja - **Uvjeti obrade podataka** - Meti uvjeti obrade podataka primjenjuju se za EU podatke ## Povezani resursi - [Google Ads Konektor](https://tajo.io/hr/docs/connectors/marketing/google-ads) - [Klaviyo Konektor](https://tajo.io/hr/docs/connectors/marketing/klaviyo) - [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo) - [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)