Meta Ads-kobling
Koblingsstatus: Planlagt Ikke bygget ennå. Tajo kjører ikke denne koblingen i dag.
Illustrasjon · eksempeldata
Eksempel på synkronisering
Kilde
Meta Ads
Koblingsstatus: Planlagt
Mål
Det andre verktøyet ditt
Koblingsstatus: Eget verktøy
Feltkobling
| Kildefelt | Målfelt | Eksempelverdi |
|---|---|---|
record.id | source_id | record_1042 |
record.updated_at | updated_at | 2026-10-18T08:00:00Z |
record.value | value | sample_value |
- Utkast
- Se gjennom én oppføring
- Godkjenn denne versjonen
Status gjelder hver enkelt kobling og garanterer ikke at denne synkroniseringen er klar. Feltene er illustrative. Kontroller faktisk skjema og tillatelser før synkroniseringen kjører.
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