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

EgenskapVerdi
PlattformMeta Ads (Facebook, Instagram, Messenger, WhatsApp)
KategoriMarkedsføring
OppsettskompleksitetAvansert
Offisiell integrasjonNei
Synkroniserte dataMålgrupper, konverteringer, kampanjer, leads
Tilgjengelige ferdigheter8
API-versjonv25.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:

  1. En Meta Business Manager-konto
  2. En Facebook App med Marketing API-tilgang
  3. En System User med passende rettigheter
  4. Et tilgangstoken med ads_management- og ads_read-rettigheter
  5. En Brevo-konto med API-tilgang
  6. 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.

Terminal window
# Nødvendige rettigheter for System User
ads_management
ads_read
business_management
leads_retrieval
pages_read_engagement
catalog_management

App-nivå-autentisering

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"

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

MetodeEndepunktBeskrivelse
POST/v25.0/act_{id}/customaudiencesOpprett en Custom Audience
POST/v25.0/{audience_id}/usersLegg brukere til Custom Audience
DELETE/v25.0/{audience_id}/usersFjern brukere fra Custom Audience
POST/v25.0/{pixel_id}/eventsSend Conversions API-hendelser
GET/v25.0/act_{id}/campaignsList kampanjer
GET/v25.0/act_{id}/insightsHent kampanjeinnsikt
GET/v25.0/{form_id}/leadsHent lead-skjemainnsendinger
POST/v25.0/act_{id}/adcreativesOpprett annonsekreativer
GET/v25.0/{catalog_id}/productsList 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-konto
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'
});

Send Conversions API-hendelser

// Send en kjøpshendelse 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('[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' // 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 Audience
await tajo.connectors.syncAudience('meta-ads', {
brevoListId: 5,
audienceName: 'High Value Customers',
matchKeys: ['EMAIL', 'PHONE', 'FN', 'LN'],
syncMode: 'mirror'
});

Hent kampanjeinnsikt

// Hent kampanjeytelsesmålinger
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'
});

Ratebegrensninger

RessursGrenseDetaljer
Marketing APINivåbasertBasert på apptilgangsnivå og forbruk
Custom Audience-opplastinger700 forespørsler/timePer annonsekonto
Conversions API2 000 hendelser/sekPer pixel
Insights API200 kall/timePer annonsekonto
Lead-henting200 kall/timePer side
Batch-forespørsler50 forespørsler/batchPer 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ÅrsakLøsning
OAuthExceptionToken utløpt eller ugyldigRegenerer System User-tilgangstoken
Lav matchrate for Custom AudienceDårlig datakvalitetHash all PII med SHA-256, inkluder flere match-nøkler
Konverteringer ikke attribuertManglende fbc-/fbp-parametereSend Facebook Click-ID og nettleser-ID fra cookies
RATE_LIMIT_REACHEDFor mange API-kallImplementer eksponentiell backoff, sjekk API-tilgangsnivå
Lead-skjemaer synkroniseres ikkeManglende leads_retrieval-rettighetLegg rettigheten til System User
Hendelser i testmodustest_event_code fortsatt sattFjern testhendelseskoden for produksjon

Beste praksis

  1. Bruk System User-tokens - System Users gir stabile, ikke-utløpende tokens for tjenerintegrasjoner
  2. Hash all PII - SHA-256-hash all personidentifiserbar informasjon før sending til Meta
  3. Send både CAPI og Pixel - Bruk både Conversions API og Meta Pixel for redundant sporing med deduplisering
  4. Inkluder hendelses-ID-er - Sett event_id på både CAPI- og Pixel-hendelser for å muliggjøre deduplisering
  5. Send fbc og fbp - Inkluder Facebook Click-ID og nettleser-ID for maksimal konverteringsattribusjon
  6. Verifiser virksomheten din - Fullfør forretningsverifisering for full API-tilgang og høyere ratebegrensninger
  7. 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

Relaterte ressurser

Subscribe to updates

developer-docs

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

auto-detect
AI-assistent

Hei! Spør meg om dokumentasjonen.