--- title: "Konektor Meta Ads" description: "Kompletní průvodce integrací Meta Ads pro synchronizaci publik Facebook a Instagram reklam, konverzí a dat kampaní s Brevo přes Tajo." url: https://tajo.io/cz/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/cz/docs/connectors/marketing/meta-ads.md lang: cs-CZ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # Konektor Meta Ads Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje. | Zdrojové pole | Cílové pole | Ukázková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Propojte Meta Ads (Facebook a Instagram) s Brevo přes Tajo pro synchronizaci vlastních publik, import konverzních událostí přes Conversions API a propojení placené sociální reklamy s automatizací marketingového životního cyklu. ## Přehled | Vlastnost | Hodnota | | --- | --- | | **Platforma** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategorie** | Marketing | | **Složitost nastavení** | Pokročilá | | **Oficiální integrace** | Ne | | **Synchronizovaná data** | Publika, Konverze, Kampaně, Potenciální zákazníci | | **Dostupné dovednosti** | 8 | | **Verze API** | v25.0 (Graph API) | ## Funkce - **Synchronizace vlastního publika** – Nahrávejte seznamy kontaktů Brevo jako vlastní publika Meta - **Conversions API (CAPI)** – Odesílejte konverzní události na straně serveru pro přesnou atribuci - **Synchronizace formulářů potenciálních zákazníků** – Importujte odeslané formuláře Facebook Lead Ads přímo do kontaktů Brevo - **Přehledy kampaní** – Stahujte metriky výkonu reklam do řídicích panelů Tajo - **Lookalike publika** – Vytvářejte podobná publika ze synchronizovaných segmentů Brevo - **Synchronizace katalogu** – Synchronizujte produktové katalogy pro dynamické reklamy na produkty - **Více platforem** – Jedna integrace pokrývá reklamy na Facebook, Instagram, Messenger a WhatsApp ## Předpoklady Než začnete, ujistěte se, že máte: 1. Účet Meta Business Manager 2. Aplikaci Facebook s přístupem k Marketing API 3. Systémového uživatele s příslušnými oprávněními 4. Přístupový token s oprávněními `ads_management` a `ads_read` 5. Účet Brevo s přístupem k API 6. Účet Tajo s API přihlašovacími údaji ## Ověření ### Přístupový token systémového uživatele Meta doporučuje používat tokeny systémového uživatele pro server-to-server integrace. Tyto tokeny nevyprší. ```bash # Požadovaná oprávnění pro systémového uživatele ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Ověřování na úrovni aplikace ```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" ``` ## Konfigurace ### Základní nastavení ```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" # Možnosti synchronizace dat sync: custom_audiences: true conversions_api: true lead_forms: true campaign_insights: true # Verze API api_version: "v25.0" ``` ### Konfigurace vlastního publika Synchronizujte seznamy Brevo do vlastních publik 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" # Pole pro párování match_keys: - EMAIL - PHONE - FN # Křestní jméno - LN # Příjmení - CT # Město - ST # Kraj - ZIP - COUNTRY schedule: "daily" sync_mode: "mirror" ``` ### Konfigurace Conversions API ```yaml conversions_api: enabled: true pixel_id: "111222333444" test_event_code: "" # Nastavte pro testování, vyprázdněte pro produkci 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" ``` ## Koncové body API | Metoda | Koncový bod | Popis | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Vytvoření vlastního publika | | `POST` | `/v25.0/{audience_id}/users` | Přidání uživatelů do vlastního publika | | `DELETE` | `/v25.0/{audience_id}/users` | Odebrání uživatelů z vlastního publika | | `POST` | `/v25.0/{pixel_id}/events` | Odeslání událostí Conversions API | | `GET` | `/v25.0/act_{id}/campaigns` | Výpis kampaní | | `GET` | `/v25.0/act_{id}/insights` | Přehledy kampaní | | `GET` | `/v25.0/{form_id}/leads` | Načtení odeslaných formulářů potenciálních zákazníků | | `POST` | `/v25.0/act_{id}/adcreatives` | Vytvoření reklamních kreativ | | `GET` | `/v25.0/{catalog_id}/products` | Výpis produktů katalogu | ## Příklady kódu ### Inicializace konektoru Meta Ads ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Připojení účtu Meta Ads 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' }); ``` ### Odeslání událostí Conversions API ```javascript // Odeslání události nákupu přes 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 }) } ); ``` ### Synchronizace vlastního publika ze seznamu Brevo ```javascript // Nahrání seznamu kontaktů Brevo jako vlastního publika Meta await tajo.connectors.syncAudience('meta-ads', { brevoListId: 5, audienceName: 'High Value Customers', matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'], syncMode: 'mirror' }); ``` ### Stahování přehledů kampaní ```javascript // Načtení metrik výkonu kampaní 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' }); ``` ## Omezení rychlosti | Zdroj | Limit | Podrobnosti | | --- | --- | --- | | **Marketing API** | Úrovňové | Na základě úrovně přístupu aplikace a výdajů | | **Nahrávání vlastního publika** | 700 požadavků/hodinu | Na reklamní účet | | **Conversions API** | 2 000 událostí/s | Na pixel | | **Insights API** | 200 volání/hodinu | Na reklamní účet | | **Načítání potenciálních zákazníků** | 200 volání/hodinu | Na stránku | | **Dávkové požadavky** | 50 požadavků/dávku | Na dávkové volání | Vyžadováno ověření firmy Plný přístup k Marketing API vyžaduje ověření firmy v Meta Business Manager. Neověřené aplikace jsou omezeny na vývojový režim s omezenými limity rychlosti. ## Řešení problémů | Problém | Příčina | Řešení | | --- | --- | --- | | `OAuthException` | Token vypršel nebo je neplatný | Znovu vygenerujte přístupový token systémového uživatele | | Nízká míra shody vlastního publika | Špatná kvalita dat | Hashujte všechna PII pomocí SHA-256, zahrňte více klíčů pro párování | | Konverze nejsou přiřazeny | Chybějící parametry `fbc`/`fbp` | Předávejte Facebook Click ID a Browser ID z cookies | | `RATE_LIMIT_REACHED` | Příliš mnoho volání API | Implementujte exponenciální zpětné odběrání, zkontrolujte úroveň přístupu API | | Formuláře potenciálních zákazníků se nesynchronizují | Chybějící oprávnění `leads_retrieval` | Přidejte oprávnění systémovému uživateli | | Události v testovacím režimu | `test_event_code` stále nastaven | Odstraňte kód testovací události pro produkci | ## Osvědčené postupy 1. **Používejte tokeny systémového uživatele** – Systémoví uživatelé poskytují stabilní, nevypršitelné tokeny pro serverové integrace 2. **Hashujte všechna PII** – SHA-256 hashujte všechny osobně identifikovatelné informace před odesláním do Meta 3. **Odesílejte CAPI i Pixel** – Používejte Conversions API i Meta Pixel pro redundantní sledování s deduplikací 4. **Zahrňte ID událostí** – Nastavte `event_id` na události CAPI i Pixel pro povolení deduplikace 5. **Předávejte `fbc` a `fbp`** – Zahrňte Facebook Click ID a Browser ID pro maximální atribuci konverzí 6. **Ověřte svou firmu** – Dokončete ověření firmy pro plný přístup k API a vyšší limity rychlosti 7. **Používejte `test_event_code`** – Testujte události Conversions API v Events Manager před spuštěním ## Zabezpečení - **Tokeny systémového uživatele** – Neosob ní, firemně vymezené autentizační tokeny - **Hashování SHA-256** – Všechna PII hashována před přenosem na servery Meta - **App Secret Proof** – Volitelná další vrstva bezpečnosti ověřování - **Firemní vymezení** – Oprávnění vymezena na konkrétní reklamní účty a stránky - **Soulad s Meta** – Podléhá Podmínkám platformy Meta a reklamním zásadám - **Podmínky zpracování dat** – Podmínky zpracování dat Meta platí pro data EU ## Související zdroje - [Konektor Google Ads](https://tajo.io/cz/docs/connectors/marketing/google-ads) - [Konektor Klaviyo](https://tajo.io/cz/docs/connectors/marketing/klaviyo) - [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo) - [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)