Meta Ads-kobling
Koble Meta Ads (Facebook og Instagram) til Brevo gjennom Tajo for å synkronisere Custom Audiences, importere konverteringshendelser via Conversions API og bygge bro mellom betalt sosial annonsering og livssyklusmarkedsføringsautomatisering.
Oversikt
| Egenskap | Verdi |
|---|---|
| Plattform | Meta Ads (Facebook, Instagram, Messenger, WhatsApp) |
| Kategori | Markedsføring |
| Oppsettskompleksitet | Avansert |
| Offisiell integrasjon | Nei |
| Synkroniserte data | Målgrupper, konverteringer, kampanjer, leads |
| Tilgjengelige ferdigheter | 8 |
| API-versjon | v25.0 (Graph API) |
Funksjoner
- Synkronisering av Custom Audience - Last opp Brevo-kontaktlister som Meta Custom Audiences
- Conversions API (CAPI) - Send konverteringshendelser på tjenersiden for nøyaktig attribusjon
- Synkronisering av lead-skjema - Importer innsendinger fra Facebook Lead Ads direkte til Brevo-kontakter
- Kampanjeinnsikt - Hent annonseytelsesmålinger inn i Tajo-dashbord
- Lookalike-målgrupper - Opprett Lookalike Audiences fra synkroniserte Brevo-segmenter
- Katalogsynkronisering - Synkroniser produktkataloger for dynamiske produktannonser
- Multi-plattform - Én integrasjon dekker Facebook-, Instagram-, Messenger- og WhatsApp-annonser
Forutsetninger
Før du begynner, sørg for at du har:
- En Meta Business Manager-konto
- En Facebook App med Marketing API-tilgang
- En System User med passende rettigheter
- Et tilgangstoken med
ads_management- ogads_read-rettigheter - En Brevo-konto med API-tilgang
- En Tajo-konto med API-påloggingsdetaljer
Autentisering
System User-tilgangstoken
Meta anbefaler å bruke System User-tokens for integrasjoner fra tjener til tjener. Disse tokensne utløper ikke.
# Nødvendige rettigheter for System Userads_managementads_readbusiness_managementleads_retrievalpages_read_engagementcatalog_managementApp-nivå-autentisering
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"Konfigurasjon
Grunnleggende oppsett
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"
# Synkroniseringsalternativer sync: custom_audiences: true conversions_api: true lead_forms: true campaign_insights: true
# API-versjon api_version: "v25.0"Custom Audience-konfigurasjon
Synkroniser Brevo-lister til Meta Custom Audiences:
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-felt match_keys: - EMAIL - PHONE - FN # Fornavn - LN # Etternavn - CT # By - ST # Stat - ZIP - COUNTRY
schedule: "daily" sync_mode: "mirror"Conversions API-konfigurasjon
conversions_api: enabled: true pixel_id: "111222333444" test_event_code: "" # Sett for testing, la stå tom for produksjon
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-endepunkter
| Metode | Endepunkt | Beskrivelse |
|---|---|---|
POST | /v25.0/act_{id}/customaudiences | Opprett en Custom Audience |
POST | /v25.0/{audience_id}/users | Legg brukere til Custom Audience |
DELETE | /v25.0/{audience_id}/users | Fjern brukere fra Custom Audience |
POST | /v25.0/{pixel_id}/events | Send Conversions API-hendelser |
GET | /v25.0/act_{id}/campaigns | List kampanjer |
GET | /v25.0/act_{id}/insights | Hent kampanjeinnsikt |
GET | /v25.0/{form_id}/leads | Hent lead-skjemainnsendinger |
POST | /v25.0/act_{id}/adcreatives | Opprett annonsekreativer |
GET | /v25.0/{catalog_id}/products | List katalogprodukter |
Kodeeksempler
Initialiser Meta Ads-kobling
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
// Koble til Meta Ads-kontoawait 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'});Send Conversions API-hendelser
// Send en kjøpshendelse via Conversions APIconst 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: { 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' // Nettleser-ID }, custom_data: { value: 89.99, currency: 'USD', content_ids: ['SKU-001'], content_type: 'product' } }], access_token: process.env.META_ACCESS_TOKEN }) });Synkroniser Custom Audience fra Brevo-liste
// Last opp en Brevo-kontaktliste som en Meta Custom Audienceawait tajo.connectors.syncAudience('meta-ads', { brevoListId: 5, audienceName: 'High Value Customers', matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'], syncMode: 'mirror'});Hent kampanjeinnsikt
// Hent kampanjeytelsesmålingerconst 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'});Ratebegrensninger
| Ressurs | Grense | Detaljer |
|---|---|---|
| Marketing API | Nivåbasert | Basert på apptilgangsnivå og forbruk |
| Custom Audience-opplastinger | 700 forespørsler/time | Per annonsekonto |
| Conversions API | 2 000 hendelser/sek | Per pixel |
| Insights API | 200 kall/time | Per annonsekonto |
| Lead-henting | 200 kall/time | Per side |
| Batch-forespørsler | 50 forespørsler/batch | Per batch-kall |
Forretningsverifisering kreves
Full Marketing API-tilgang krever forretningsverifisering i Meta Business Manager. Uverifiserte apper er begrenset til utviklingsmodus med reduserte ratebegrensninger.
Feilsøking
| Problem | Årsak | Løsning |
|---|---|---|
OAuthException | Token utløpt eller ugyldig | Regenerer System User-tilgangstoken |
| Lav matchrate for Custom Audience | Dårlig datakvalitet | Hash all PII med SHA-256, inkluder flere match-nøkler |
| Konverteringer ikke attribuert | Manglende fbc-/fbp-parametere | Send Facebook Click-ID og nettleser-ID fra cookies |
RATE_LIMIT_REACHED | For mange API-kall | Implementer eksponentiell backoff, sjekk API-tilgangsnivå |
| Lead-skjemaer synkroniseres ikke | Manglende leads_retrieval-rettighet | Legg rettigheten til System User |
| Hendelser i testmodus | test_event_code fortsatt satt | Fjern testhendelseskoden for produksjon |
Beste praksis
- Bruk System User-tokens - System Users gir stabile, ikke-utløpende tokens for tjenerintegrasjoner
- Hash all PII - SHA-256-hash all personidentifiserbar informasjon før sending til Meta
- Send både CAPI og Pixel - Bruk både Conversions API og Meta Pixel for redundant sporing med deduplisering
- Inkluder hendelses-ID-er - Sett
event_idpå både CAPI- og Pixel-hendelser for å muliggjøre deduplisering - Send
fbcogfbp- Inkluder Facebook Click-ID og nettleser-ID for maksimal konverteringsattribusjon - Verifiser virksomheten din - Fullfør forretningsverifisering for full API-tilgang og høyere ratebegrensninger
- Bruk
test_event_code- Test Conversions API-hendelser i Events Manager før lansering
Sikkerhet
- System User-tokens - Ikke-personlige, forretningsavgrensede autentiseringstokens
- SHA-256-hashing - All PII hashes før overføring til Meta-tjenere
- App Secret Proof - Valgfritt ekstra lag med autentiseringssikkerhet
- Forretningsavgrensing - Rettigheter avgrenset til spesifikke annonsekontoer og sider
- Meta-samsvar - Underlagt Meta Platform Terms og annonseringsretningslinjer
- Databehandlingsvilkår - Metas Data Processing Terms gjelder for EU-data