--- title: "Meta Ads konektor" description: "Kompletný sprievodca integráciou Meta Ads na synchronizáciu publík Facebook a Instagram, konverzií a dát kampaní s Brevo cez Tajo." url: https://tajo.io/sk/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/sk/docs/connectors/marketing/meta-ads.md lang: sk-SK robots: noindex --- Požiadajte o skorý prístup Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo. # Meta Ads konektor Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje. | Zdrojové pole | Cieľové pole | Ukážková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Prepoj Meta Ads (Facebook & Instagram) s Brevo cez Tajo na synchronizáciu Custom Audiences, import konverzných udalostí cez Conversions API a prepojenie platenej sociálnej reklamy s marketingovou automatizáciou životného cyklu. ## Prehľad | Vlastnosť | Hodnota | | --- | --- | | **Platforma** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategória** | Marketing | | **Zložitosť nastavenia** | Pokročilé | | **Oficiálna integrácia** | Nie | | **Synchronizované dáta** | Publiká, Konverzie, Kampane, Leady | | **Dostupné skilly** | 8 | | **Verzia API** | v25.0 (Graph API) | ## Funkcie - **Synchronizácia Custom Audience** - Nahrávaj zoznamy kontaktov Brevo ako Meta Custom Audiences - **Conversions API (CAPI)** - Odosielaj serverové konverzné udalosti pre presné priradenie - **Synchronizácia leadových formulárov** - Importuj odovzdania Facebook Lead Ads priamo do kontaktov Brevo - **Prehľady kampaní** - Sťahuj metriky výkonu reklám do dashboardov Tajo - **Lookalike audiences** - Vytváraj Lookalike Audiences zo synchronizovaných segmentov Brevo - **Synchronizácia katalógu** - Synchronizuj katalógy produktov pre dynamické produktové reklamy - **Viacplatformová podpora** - Jedna integrácia pokrýva reklamy na Facebook, Instagram, Messenger a WhatsApp ## Predpoklady Predtým, než začneš, uisti sa, že máš: 1. Účet Meta Business Manager 2. Facebook aplikáciu s prístupom k Marketing API 3. Systémového používateľa s príslušnými oprávneniami 4. Prístupový token s oprávneniami `ads_management` a `ads_read` 5. Brevo účet s API prístupom 6. Tajo účet s API prihlasovacími údajmi ## Autentifikácia ### Prístupový token systémového používateľa Meta odporúča používať tokeny systémových používateľov pre integrácie server-to-server. Tieto tokeny nevypršia. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Autentifikácia na úrovni aplikácie ```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" ``` ## Konfigurácia ### Základné nastavenie ```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" ``` ### Konfigurácia Custom Audience Synchronizuj zoznamy Brevo do 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" ``` ### Konfigurácia 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" ``` ## API endpointy | Metóda | Endpoint | Popis | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Vytvorenie Custom Audience | | `POST` | `/v25.0/{audience_id}/users` | Pridanie používateľov do Custom Audience | | `DELETE` | `/v25.0/{audience_id}/users` | Odstránenie používateľov z Custom Audience | | `POST` | `/v25.0/{pixel_id}/events` | Odoslanie udalostí Conversions API | | `GET` | `/v25.0/act_{id}/campaigns` | Zoznam kampaní | | `GET` | `/v25.0/act_{id}/insights` | Získanie prehľadov kampaní | | `GET` | `/v25.0/{form_id}/leads` | Načítanie odovzdaní leadových formulárov | | `POST` | `/v25.0/act_{id}/adcreatives` | Vytvorenie reklamných kreatív | | `GET` | `/v25.0/{catalog_id}/products` | Zoznam produktov katalógu | ## Ukážky kódu ### Inicializácia 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 }); // 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' }); ``` ### Odoslanie udalostí 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 }) } ); ``` ### Synchronizácia Custom Audience zo zoznamu 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' }); ``` ### Načítanie prehľadov kampaní ```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' }); ``` ## Obmedzenia rýchlosti | Zdroj | Limit | Detaily | | --- | --- | --- | | **Marketing API** | Na základe úrovne | Závisí od úrovne prístupu aplikácie a výdavkov | | **Nahrávky Custom Audience** | 700 požiadaviek/hodinu | Na reklamný účet | | **Conversions API** | 2 000 udalostí/sek | Na pixel | | **Insights API** | 200 volaní/hodinu | Na reklamný účet | | **Načítanie leadov** | 200 volaní/hodinu | Na stránku | | **Dávkové požiadavky** | 50 požiadaviek/dávku | Na dávkové volanie | Vyžaduje sa overenie firmy Plný prístup k Marketing API vyžaduje overenie firmy v Meta Business Manager. Neoverené aplikácie sú obmedzené na vývojový režim so zníženými limitmi rýchlosti. ## Riešenie problémov | Problém | Príčina | Riešenie | | --- | --- | --- | | `OAuthException` | Token vypršal alebo je neplatný | Regeneruj prístupový token systémového používateľa | | Nízka miera zhody Custom Audience | Slabá kvalita dát | Hashuj všetky PII pomocou SHA-256, zahrň viacero zhodovacie kľúče | | Konverzie nie sú priradené | Chýbajúce parametre `fbc`/`fbp` | Predaj Facebook Click ID a Browser ID z cookies | | `RATE_LIMIT_REACHED` | Príliš veľa API volaní | Implementuj exponenciálny backoff, skontroluj úroveň prístupu k API | | Leadové formuláre sa nesynchronizujú | Chýba oprávnenie `leads_retrieval` | Pridaj oprávnenie systémovému používateľovi | | Udalosti v testovom režime | `test_event_code` je stále nastavený | Odstráň testový kód udalostí pre produkciu | ## Odporúčané postupy 1. **Použi tokeny systémových používateľov** - Systémoví používatelia poskytujú stabilné, nevypršiavajúce tokeny pre serverové integrácie 2. **Hashuj všetky PII** - Hashuj všetky osobne identifikovateľné informácie SHA-256 pred odoslaním do Meta 3. **Odosielaj CAPI aj Pixel** - Použi Conversions API aj Meta Pixel pre redundantné sledovanie s deduplikáciou 4. **Zahrň ID udalostí** - Nastav `event_id` na udalostiach CAPI aj Pixel na umožnenie deduplikácie 5. **Predávaj `fbc` a `fbp`** - Zahrň Facebook Click ID a Browser ID pre maximálne priradenie konverzií 6. **Overuj svoju firmu** - Dokonči overenie firmy pre plný prístup k API a vyššie limity rýchlosti 7. **Použi `test_event_code`** - Testuj udalosti Conversions API v Events Manager pred spustením ## Bezpečnosť - **Tokeny systémových používateľov** - Neosobné, firemne ohraničené autentifikačné tokeny - **Hashovanie SHA-256** - Všetky PII hashované pred prenosom na servery Meta - **App Secret Proof** - Voliteľná dodatočná vrstva bezpečnosti autentifikácie - **Firemné ohraničenie** - Oprávnenia ohraničené na konkrétne reklamné účty a stránky - **Súlad s Meta** - Podlieha Podmienkam platformy Meta a reklamným pravidlám - **Podmienky spracovania dát** - Podmienky spracovania dát Meta platia pre dáta EÚ ## Súvisiace zdroje - [Google Ads konektor](https://tajo.io/sk/docs/connectors/marketing/google-ads) - [Klaviyo konektor](https://tajo.io/sk/docs/connectors/marketing/klaviyo) - [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo) - [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)