--- title: "Meta Ads конектор" description: "Пълно ръководство за интеграция с Meta Ads за синхронизация на Facebook и Instagram рекламни audiences, конверсии и данни за кампании с Brevo през Tajo." url: https://tajo.io/bg/docs/connectors/marketing/meta-ads/ markdown: https://tajo.io/bg/docs/connectors/marketing/meta-ads.md lang: bg-BG robots: noindex --- Заявете ранен достъп Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo. # Meta Ads конектор Статус на конектора: Планиран Все още не е изграден. Tajo не изпълнява този конектор днес. | Поле източник | Целево поле | Примерна стойност | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Свържи Meta Ads (Facebook & Instagram) с Brevo през Tajo, за да синхронизираш Custom Audiences, да импортираш събития за конверсии през Conversions API и да свържеш paid social рекламите с lifecycle маркетингова автоматизация. ## Преглед | Свойство | Стойност | | --- | --- | | **Платформа** | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) | | **Категория** | Маркетинг | | **Сложност на настройка** | Напреднала | | **Официална интеграция** | Не | | **Синхронизирани данни** | Audiences, конверсии, кампании, leads | | **Налични скилове** | 8 | | **Версия на API** | v25.0 (Graph API) | ## Функции - **Синхронизация на Custom Audience** – Качвай Brevo списъци с контакти като Meta Custom Audiences - **Conversions API (CAPI)** – Изпращай server-side събития за конверсии за точна атрибуция - **Синхронизация на lead form** – Импортирай изпращания на Facebook Lead Ads директно в Brevo контакти - **Campaign insights** – Извличай метрики за performance на реклами в Tajo dashboards - **Lookalike audiences** – Създавай Lookalike Audiences от синхронизирани Brevo сегменти - **Синхронизация на каталог** – Синхронизирай продуктови каталози за динамични продуктови реклами - **Мулти-платформа** – Една интеграция покрива Facebook, Instagram, Messenger и WhatsApp реклами ## Предварителни условия Преди да започнеш, увери се, че имаш: 1. Акаунт в Meta Business Manager 2. Facebook App с достъп до Marketing API 3. System User с подходящи разрешения 4. Access Token с разрешения `ads_management` и `ads_read` 5. Акаунт в Brevo с API достъп 6. Акаунт в Tajo с API credentials ## Автентикация ### System User Access Token Meta препоръчва използване на System User tokens за server-to-server интеграции. Тези токени не изтичат. ```bash # Required permissions for System User ads_management ads_read business_management leads_retrieval pages_read_engagement catalog_management ``` ### Автентикация на ниво приложение ```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" ``` ## Конфигурация ### Основна настройка ```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" ``` ### Конфигурация на Custom Audience Синхронизирай Brevo списъци към 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" ``` ### Конфигурация на 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 крайни точки | Метод | Крайна точка | Описание | | --- | --- | --- | | `POST` | `/v25.0/act_{id}/customaudiences` | Създаване на Custom Audience | | `POST` | `/v25.0/{audience_id}/users` | Добавяне на потребители в Custom Audience | | `DELETE` | `/v25.0/{audience_id}/users` | Премахване на потребители от Custom Audience | | `POST` | `/v25.0/{pixel_id}/events` | Изпращане на Conversions API събития | | `GET` | `/v25.0/act_{id}/campaigns` | Списък с кампании | | `GET` | `/v25.0/act_{id}/insights` | Получаване на campaign insights | | `GET` | `/v25.0/{form_id}/leads` | Извличане на изпращания на lead form | | `POST` | `/v25.0/act_{id}/adcreatives` | Създаване на ad creatives | | `GET` | `/v25.0/{catalog_id}/products` | Списък с продукти от каталог | ## Примери с код ### Инициализация на 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' }); ``` ### Изпращане на 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 }) } ); ``` ### Синхронизация на Custom Audience от 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' }); ``` ### Извличане на campaign insights ```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' }); ``` ## Ограничения на заявките | Ресурс | Лимит | Детайли | | --- | --- | --- | | **Marketing API** | На база ниво | На базата на ниво на достъп до приложението и разход | | **Custom Audience качвания** | 700 заявки/час | На ad акаунт | | **Conversions API** | 2 000 събития/сек | На pixel | | **Insights API** | 200 извиквания/час | На ad акаунт | | **Извличане на lead** | 200 извиквания/час | На страница | | **Пакетни заявки** | 50 заявки/пакет | На batch извикване | Изисква се Business верификация Пълен достъп до Marketing API изисква верификация на бизнеса в Meta Business Manager. Неверифицираните приложения са ограничени до development режим с ограничени rate limits. ## Отстраняване на проблеми | Проблем | Причина | Решение | | --- | --- | --- | | `OAuthException` | Token изтекъл или невалиден | Регенерирай System User access token | | Нисък match rate на Custom Audience | Лошо качество на данните | Хеширай всички PII със SHA-256, включи множество match ключове | | Конверсиите не са атрибутирани | Липсват параметри `fbc`/`fbp` | Предавай Facebook Click ID и Browser ID от cookie-тата | | `RATE_LIMIT_REACHED` | Твърде много API извиквания | Внедри exponential backoff, провери нивото на API достъп | | Lead форми не се синхронизират | Липсващо разрешение `leads_retrieval` | Добави разрешението към System User | | Събития в тестов режим | `test_event_code` все още зададен | Премахни test event code за production | ## Добри практики 1. **Използвай System User tokens** – System Users предоставят стабилни, неизтичащи токени за server интеграции 2. **Хеширай всички PII** – SHA-256 хеширай всяка лична идентифицируема информация преди изпращане към Meta 3. **Изпращай и CAPI, и Pixel** – Използвай и Conversions API, и Meta Pixel за редундантно проследяване с dedup 4. **Включвай event IDs** – Задавай `event_id` и на CAPI, и на Pixel събитията, за да активираш дедупликация 5. **Предавай `fbc` и `fbp`** – Включвай Facebook Click ID и Browser ID за максимална атрибуция на конверсии 6. **Верифицирай своя бизнес** – Завърши Business Verification за пълен достъп до API и по-високи rate limits 7. **Използвай `test_event_code`** – Тествай Conversions API събития в Events Manager преди преминаване в production ## Сигурност - **System User tokens** – Не-лични, business-scoped автентикационни токени - **SHA-256 хеширане** – Всички PII се хешират преди пренос към Meta сървърите - **App Secret Proof** – Опционален допълнителен слой на сигурност на автентикацията - **Business scoping** – Разрешенията са scoped до конкретни ad акаунти и страници - **Meta съвместимост** – Подлежи на Meta Platform Terms и рекламните политики - **Data Processing Terms** – Meta Data Processing Terms важат за EU данни ## Свързани ресурси - [Google Ads конектор](https://tajo.io/bg/docs/connectors/marketing/google-ads) - [Klaviyo конектор](https://tajo.io/bg/docs/connectors/marketing/klaviyo) - [Brevo конектор](https://tajo.io/bg/docs/connectors/marketing/brevo) - [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)