--- title: "Meta Ads konnektor" description: "Teljes Meta Ads integrációs útmutató Facebook és Instagram hirdetési közönségek, konverziók és kampányadatok Brevóval való szinkronizációjához a Tajo segítségével." url: https://tajo.io/hu/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/hu/docs/connectors/marketing/meta-ads.md lang: hu-HU robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # Meta Ads konnektor Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort. | Forrásmező | Célmező | Mintaérték | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Csatlakoztasd a Meta Adst (Facebook & Instagram) a Brevóhoz a Tajo segítségével az Egyéni Közönségek szinkronizálásához, konverziós események importálásához a Conversions API-n keresztül, és a fizetett közösségi média hirdetések összekötéséhez az életciklus-marketing automatizálással. ## Áttekintés | Tulajdonság | Érték | | --- | --- | | **Platform** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Kategória** | Marketing | | **Telepítés bonyolultsága** | Haladó | | **Hivatalos integráció** | Nem | | **Szinkronizált adatok** | Közönségek, Konverziók, Kampányok, Leadek | | **Elérhető Skillek** | 8 | | **API verzió** | v25.0 (Graph API) | ## Funkciók - **Egyéni közönség szinkronizáció** – Brevo kapcsolatlisták feltöltése Meta Egyéni Közönségekként - **Conversions API (CAPI)** – Szerver oldali konverziós események küldése a pontos attribúcióért - **Lead form szinkronizáció** – Facebook Lead Ads beküldések importálása közvetlenül Brevo kapcsolatokba - **Kampány-betekintések** – Hirdetési teljesítménymutatók lekérése Tajo dashboardokba - **Hasonló közönségek** – Lookalike Audiences létrehozása szinkronizált Brevo szegmensekből - **Katalógus-szinkronizáció** – Termékkatalógusok szinkronizálása dinamikus termékhirdetésekhez - **Többplatformos** – Egyetlen integráció fedi le a Facebook, Instagram, Messenger és WhatsApp hirdetéseket ## Előfeltételek Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel: 1. Egy Meta Business Manager fiókkal 2. Egy Facebook alkalmazással Marketing API hozzáféréssel 3. Egy Rendszer-felhasználóval megfelelő jogosultságokkal 4. Egy Access Tokennel `ads_management` és `ads_read` jogosultságokkal 5. Egy Brevo fiókkal API-hozzáféréssel 6. Egy Tajo fiókkal API hitelesítő adatokkal ## Hitelesítés ### Rendszer-felhasználói Access Token A Meta szerver-szerver integrációkhoz Rendszer-felhasználói tokeneket ajánl. Ezek a tokenek nem járnak le. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Alkalmazásszintű hitelesítés ```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áció ### Alapbeállítás ```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" ``` ### Egyéni közönség konfiguráció Brevo listák szinkronizálása Meta Egyéni Közönségekként: ```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" ``` ### Conversions API konfiguráció ```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 végpontok | Módszer | Végpont | Leírás | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Egyéni közönség létrehozása | | `POST` | `/v25.0/{audience_id}/users` | Felhasználók hozzáadása egyéni közönséghez | | `DELETE` | `/v25.0/{audience_id}/users` | Felhasználók eltávolítása egyéni közönségből | | `POST` | `/v25.0/{pixel_id}/events` | Conversions API események küldése | | `GET` | `/v25.0/act_{id}/campaigns` | Kampányok listázása | | `GET` | `/v25.0/act_{id}/insights` | Kampány-betekintések lekérése | | `GET` | `/v25.0/{form_id}/leads` | Lead form beküldések lekérése | | `POST` | `/v25.0/act_{id}/adcreatives` | Hirdetési kreatívok létrehozása | | `GET` | `/v25.0/{catalog_id}/products` | Katalógustermékek listázása | ## Kódpéldák ### A Meta Ads konnektor inicializálása ```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' }); ``` ### Conversions API események küldése ```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 }) } ); ``` ### Egyéni közönség szinkronizálása Brevo listából ```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' }); ``` ### Kampány-betekintések lekérése ```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' }); ``` ## Ráta-korlátok | Erőforrás | Korlát | Részletek | | --- | --- | --- | | **Marketing API** | Szint alapú | Alkalmazás hozzáférési szint és költés alapján | | **Egyéni közönség feltöltések** | 700 kérés/óra | Hirdetési fiókonként | | **Conversions API** | 2 000 esemény/mp | Pixelenként | | **Insights API** | 200 hívás/óra | Hirdetési fiókonként | | **Lead lekérés** | 200 hívás/óra | Oldalanként | | **Batch kérések** | 50 kérés/batch | Batch hívásonként | Üzleti ellenőrzés szükséges A teljes Marketing API hozzáféréshez üzleti ellenőrzés szükséges a Meta Business Managerben. Az ellenőrizetlen alkalmazások fejlesztői módra korlátozódnak csökkentett ráta-korlátokkal. ## Hibaelhárítás | Probléma | Ok | Megoldás | | --- | --- | --- | | `OAuthException` | Token lejárt vagy érvénytelen | Generáld újra a Rendszer-felhasználói access tokent | | Alacsony egyéni közönség egyezési arány | Gyenge adatminőség | Hash-elj minden személyes adatot SHA-256-tal, adj meg több egyezési kulcsot | | Konverziók nem attribuálódnak | Hiányzó `fbc`/`fbp` paraméterek | Adj meg Facebook Kattintás-azonosítót és Böngésző-azonosítót cookie-kból | | `RATE_LIMIT_REACHED` | Túl sok API hívás | Implementálj exponenciális visszalépést, ellenőrizd az API hozzáférési szintet | | Lead formok nem szinkronizálódnak | Hiányzó `leads_retrieval` jogosultság | Adj hozzá jogosultságot a Rendszer-felhasználóhoz | | Teszt módban lévő események | `test_event_code` még be van állítva | Távolítsd el a teszt esemény kódot az éles üzemhez | ## Legjobb gyakorlatok 1. **Használj Rendszer-felhasználói tokeneket** – A Rendszer-felhasználók stabil, le nem járó tokeneket biztosítanak szerver integrációkhoz 2. **Hash-elj minden személyes adatot** – SHA-256 hash-elj minden személyazonosító adatot a Metának való küldés előtt 3. **Használj egyszerre CAPI-t és Pixelt** – Használj mindkét Conversions API-t és Meta Pixelt redundáns követéshez deduplikálással 4. **Szerepeltesd az esemény azonosítókat** – Állíts be `event_id`-t mind a CAPI-n, mind a Pixel eseményeken a deduplikálás engedélyezéséhez 5. **Adj meg `fbc`-t és `fbp`-t** – Szerepeltesd a Facebook Kattintás-azonosítót és Böngésző-azonosítót a maximális konverzió-attribúcióhoz 6. **Ellenőriztesd vállalkozásodat** – Végezd el az Üzleti Ellenőrzést a teljes API hozzáférésért és magasabb ráta-korlátokért 7. **Használd a `test_event_code`-ot** – Tesztelj Conversions API eseményeket az Events Managerben, mielőtt élesre állítanál ## Biztonság - **Rendszer-felhasználói tokenek** – Nem személyes, üzleti hatókörű hitelesítési tokenek - **SHA-256 hash-elés** – Minden személyes adat hash-elve az átvitel előtt a Meta szerverekre - **App Secret Proof** – Opcionális hitelesítési biztonság extra rétege - **Üzleti hatókör** – Jogosultságok adott hirdetési fiókokra és oldalakra korlátozva - **Meta megfelelőség** – A Meta Platform feltételeire és hirdetési irányelvekre vonatkozik - **Adatfeldolgozási feltételek** – A Meta Adatfeldolgozási Feltételei az EU-s adatokra vonatkoznak ## Kapcsolódó források - [Google Ads konnektor](https://tajo.io/hu/docs/connectors/marketing/google-ads) - [Klaviyo konnektor](https://tajo.io/hu/docs/connectors/marketing/klaviyo) - [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo) - [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)