Meta Ads Connector

Forbind Meta Ads (Facebook og Instagram) til Brevo via Tajo for at synkronisere Custom Audiences, importere konverteringshændelser via Conversions API og bygge bro mellem betalt social annoncering og livscyklusmarketingautomatisering.

Oversigt

Funktioner

• Synkronisering af Custom Audiences - Upload Brevo-kontaktlister som Meta Custom Audiences
• Conversions API (CAPI) - Send serverside-konverteringshændelser for nøjagtig attribution
• Synkronisering af lead-formularer - Importér Facebook Lead Ads-indsendelser direkte i Brevo-kontakter
• Kampagneindsigt - Træk annonceperformance-metrikker ind i Tajo-dashboards
• Lookalike-målgrupper - Opret Lookalike Audiences fra synkroniserede Brevo-segmenter
• Katalogsynkronisering - Synkronisér produktkataloger til dynamiske produktannoncer
• Multi-platform - Én integration dækker Facebook-, Instagram-, Messenger- og WhatsApp-annoncer

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Meta Business Manager-konto
2. En Facebook-app med adgang til Marketing API
3. En System User med passende rettigheder
4. Et adgangstoken med rettighederne ads_management og ads_read
5. En Brevo-konto med API-adgang
6. En Tajo-konto med API-legitimationsoplysninger

Autentifikation

System User-adgangstoken

Meta anbefaler at bruge System User-tokens til server-til-server-integrationer. Disse tokens udløber ikke.

# Required permissions for System User
ads_management
ads_read
business_management
leads_retrieval
pages_read_engagement
catalog_management

App-niveau-autentifikation

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"

Konfiguration

Grundlæggende opsætning

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-konfiguration

Synkronisér 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 fields
  match_keys:
    - EMAIL
    - PHONE
    - FN     # First name
    - LN     # Last name
    - CT     # City
    - ST     # State
    - ZIP
    - COUNTRY

  schedule: "daily"
  sync_mode: "mirror"

Conversions API-konfiguration

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-endpoints

Kodeeksempler

Initialisér Meta Ads-konnektor

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'
});

Send Conversions API-hændelser

// 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('[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
    })
  }
);

Synkronisér Custom Audience fra Brevo-liste

// 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'
});

Træk kampagneindsigter

// 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'
});

Ratebegrænsninger

Fejlfinding

Best practices

1. Brug System User-tokens - System Users leverer stabile, ikke-udløbende tokens til serverintegrationer
2. Hash al personlig data - SHA-256-hash alle personligt identificerbare oplysninger, før de sendes til Meta
3. Send både CAPI og Pixel - Brug både Conversions API og Meta Pixel til redundant sporing med deduplikering
4. Inkludér hændelses-id’er - Sæt event_id på både CAPI- og Pixel-hændelser for at muliggøre deduplikering
5. Send fbc og fbp - Inkludér Facebook Click ID og Browser ID for maksimal konverteringsattribution
6. Verificér din virksomhed - Gennemfør Business Verification for fuld API-adgang og højere ratebegrænsninger
7. Brug test_event_code - Test Conversions API-hændelser i Events Manager før produktionssætning

Sikkerhed

• System User-tokens - Ikke-personlige, virksomhedsscoped autentifikationstokens
• SHA-256-hashing - Al personlig data hashes før transmission til Meta-servere
• App Secret Proof - Valgfrit ekstra lag af autentifikationssikkerhed
• Virksomhedsscoping - Rettigheder scopes til specifikke annoncekonti og sider
• Meta-overholdelse - Underlagt Meta Platform Terms og annonceringspolitikker
• Databehandlingsbetingelser - Metas Data Processing Terms gælder for EU-data

Relaterede ressourcer

• Google Ads Connector
• Klaviyo Connector
• Brevo Connector
• Customer Sync Skill