Коннектор Meta Ads

Подключите Meta Ads (Facebook и Instagram) к Brevo через Tajo для синхронизации Custom Audiences, импорта событий конверсий через Conversions API и связывания платной рекламы в социальных сетях с lifecycle-маркетинговой автоматизацией.

Обзор

СвойствоЗначение
ПлатформаMeta Ads (Facebook, Instagram, Messenger, WhatsApp)
КатегорияMarketing
Сложность настройкиРасширенная
Официальная интеграцияНет
Синхронизируемые данныеАудитории, конверсии, кампании, лиды
Доступных скиллов8
Версия APIv25.0 (Graph API)

Возможности

  • Синхронизация Custom Audience, загрузка списков контактов Brevo как Custom Audiences в Meta
  • Conversions API (CAPI), отправка серверных событий конверсий для точной атрибуции
  • Синхронизация лид-форм, импорт заявок из Facebook Lead Ads непосредственно в контакты Brevo
  • Аналитика кампаний, получение метрик эффективности рекламы в дашборды Tajo
  • Похожие аудитории, создание Lookalike Audiences из синхронизированных сегментов Brevo
  • Синхронизация каталога, синхронизация каталогов товаров для рекламы динамических товаров
  • Мультиплатформенность, одна интеграция охватывает рекламу в Facebook, Instagram, Messenger и WhatsApp

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

  1. Аккаунт Meta Business Manager
  2. Приложение Facebook с доступом к Marketing API
  3. System User с необходимыми разрешениями
  4. Access Token с разрешениями ads_management и ads_read
  5. Аккаунт Brevo с доступом к API
  6. Аккаунт Tajo с API-учётными данными

Аутентификация

Токен System User

Meta рекомендует использовать токены System User для серверных интеграций. Эти токены не истекают.

Terminal window
# Необходимые разрешения для System User
ads_management
ads_read
business_management
leads_retrieval
pages_read_engagement
catalog_management

Аутентификация на уровне приложения

Terminal window
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"

Конфигурация

Базовая настройка

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"
# Параметры синхронизации данных
sync:
custom_audiences: true
conversions_api: true
lead_forms: true
campaign_insights: true
# Версия API
api_version: "v25.0"

Конфигурация Custom Audience

Синхронизация списков Brevo с Custom Audiences в Meta:

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"
# Поля для совпадения
match_keys:
- EMAIL
- PHONE
- FN # Имя
- LN # Фамилия
- CT # Город
- ST # Штат/регион
- ZIP
- COUNTRY
schedule: "daily"
sync_mode: "mirror"

Конфигурация Conversions API

conversions_api:
enabled: true
pixel_id: "111222333444"
test_event_code: "" # Установите для тестирования, очистите для продакшна
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Аналитика кампаний
GET/v25.0/{form_id}/leadsПолучение заявок из лид-форм
POST/v25.0/act_{id}/adcreativesСоздание рекламных креативов
GET/v25.0/{catalog_id}/productsСписок товаров каталога

Примеры кода

Инициализация коннектора Meta Ads

import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({
apiKey: process.env.TAJO_API_KEY,
brevoApiKey: process.env.BREVO_API_KEY
});
// Подключение аккаунта 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'
});

Отправка событий через Conversions API

// Отправка события покупки через 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('[email protected]')],
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

// Загрузка списка контактов Brevo как Custom Audience в Meta
await tajo.connectors.syncAudience('meta-ads', {
brevoListId: 5,
audienceName: 'High Value Customers',
matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'],
syncMode: 'mirror'
});

Получение аналитики кампаний

// Получение метрик эффективности кампаний
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 Audience700 запросов/часНа рекламный аккаунт
Conversions API2 000 событий/секНа пиксель
Insights API200 вызовов/часНа рекламный аккаунт
Получение лидов200 вызовов/часНа страницу
Пакетные запросы50 запросов/пакетНа batch-вызов

Требуется верификация бизнеса

Полный доступ к Marketing API требует верификации бизнеса в Meta Business Manager. Неверифицированные приложения ограничены режимом разработки с сниженными лимитами скорости.

Устранение неполадок

ПроблемаПричинаРешение
OAuthExceptionТокен истёк или недействителенПерегенерируйте токен доступа System User
Низкий процент совпадений Custom AudienceПлохое качество данныхХешируйте все PII с SHA-256, включайте несколько ключей совпадения
Конверсии не атрибутируютсяОтсутствуют параметры fbc/fbpПередавайте Facebook Click ID и Browser ID из cookies
RATE_LIMIT_REACHEDСлишком много API-вызововРеализуйте экспоненциальную задержку, проверьте уровень API-доступа
Лид-формы не синхронизируютсяОтсутствует разрешение leads_retrievalДобавьте разрешение System User
События в тестовом режимеtest_event_code ещё установленУдалите тестовый код события для продакшна

Лучшие практики

  1. Используйте токены System User, System Users предоставляют стабильные, не истекающие токены для серверных интеграций
  2. Хешируйте все PII, SHA-256-хешируйте все персональные данные перед отправкой в Meta
  3. Используйте и CAPI, и Pixel, применяйте и Conversions API, и Meta Pixel для дублирующего трекинга с дедупликацией
  4. Включайте event ID, устанавливайте event_id для событий CAPI и Pixel для дедупликации
  5. Передавайте fbc и fbp, включайте Facebook Click ID и Browser ID для максимальной атрибуции конверсий
  6. Верифицируйте бизнес, пройдите верификацию бизнеса для полного доступа к API и более высоких лимитов
  7. Используйте test_event_code, тестируйте события Conversions API в Events Manager перед запуском в продакшн

Безопасность

  • Токены System User, неличные, бизнес-ограниченные токены аутентификации
  • SHA-256-хеширование, все PII хешируются перед передачей на серверы Meta
  • App Secret Proof, опциональный дополнительный уровень защиты аутентификации
  • Бизнес-ограничение, разрешения ограничены конкретными рекламными аккаунтами и страницами
  • Соответствие Meta, соблюдение Meta Platform Terms и политик рекламы
  • Условия обработки данных, Data Processing Terms Meta применяются для данных ЕС

Связанные ресурсы

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
AI-ассистент

Привет! Спрашивайте меня о документации.