Σύνδεσμος Meta Ads

Συνδέστε το Meta Ads (Facebook & Instagram) με το Brevo μέσω Tajo για συγχρονισμό Custom Audiences, εισαγωγή εκδηλώσεων μετατροπής μέσω του Conversions API και γεφύρωση επί πληρωμή κοινωνικής διαφήμισης με αυτοματισμό lifecycle marketing.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός Custom Audience - Μεταφόρτωση λιστών επαφών Brevo ως Meta Custom Audiences
• Conversions API (CAPI) - Αποστολή εκδηλώσεων μετατροπής πλευράς server για ακριβή απόδοση
• Συγχρονισμός φόρμας δυνητικού πελάτη - Εισαγωγή υποβολών Facebook Lead Ads απευθείας σε επαφές Brevo
• Πληροφορίες καμπάνιας - Ανάκτηση μετρικών απόδοσης διαφημίσεων σε dashboards Tajo
• Κοινά Lookalike - Δημιουργία Lookalike Audiences από συγχρονισμένα τμήματα Brevo
• Συγχρονισμός καταλόγου - Συγχρονισμός καταλόγων προϊόντων για δυναμικές διαφημίσεις προϊόντων
• Πολυπλατφορμικό - Μία ενσωμάτωση καλύπτει διαφημίσεις Facebook, Instagram, Messenger και WhatsApp

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Meta Business Manager
2. Εφαρμογή Facebook με πρόσβαση Marketing API
3. Χρήστη Συστήματος με κατάλληλα δικαιώματα
4. Token πρόσβασης με δικαιώματα ads_management και ads_read
5. Λογαριασμό Brevo με πρόσβαση API
6. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Token Πρόσβασης Χρήστη Συστήματος

Η Meta συνιστά χρήση tokens Χρήστη Συστήματος για ενσωματώσεις server-to-server. Αυτά τα tokens δεν λήγουν.

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

Πιστοποίηση Επιπέδου Εφαρμογής

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"

    # Data sync options
    sync:
      custom_audiences: true
      conversions_api: true
      lead_forms: true
      campaign_insights: true

    # API version
    api_version: "v25.0"

Διαμόρφωση Custom Audience

Συγχρονισμός λιστών Brevo σε 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

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"

Endpoints API

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου Meta Ads

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

Αποστολή Εκδηλώσεων Conversions API

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

Συγχρονισμός Custom Audience από Λίστα Brevo

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

Ανάκτηση Πληροφοριών Καμπάνιας

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

Όρια Ρυθμού

Αντιμετώπιση Προβλημάτων

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε tokens Χρήστη Συστήματος - Οι Χρήστες Συστήματος παρέχουν σταθερά, μη-λήγοντα tokens για ενσωματώσεις server
2. Κατακερματίστε όλα τα PII - Κατακερματίστε με SHA-256 όλα τα προσωπικά αναγνωρίσιμα στοιχεία πριν αποστολή στη Meta
3. Στείλτε τόσο CAPI όσο και Pixel - Χρησιμοποιήστε Conversions API και Meta Pixel για πλεονάζουσα παρακολούθηση με αφαίρεση διπλοτύπων
4. Συμπεριλάβετε event IDs - Ορίστε event_id τόσο σε εκδηλώσεις CAPI όσο και Pixel για αφαίρεση διπλοτύπων
5. Περάστε fbc και fbp - Συμπεριλάβετε Facebook Click ID και Browser ID για μέγιστη απόδοση μετατροπών
6. Επαληθεύστε την επιχείρησή σας - Ολοκληρώστε Επαλήθευση Επιχείρησης για πλήρη πρόσβαση API και υψηλότερα όρια ρυθμού
7. Χρησιμοποιήστε test_event_code - Δοκιμάστε εκδηλώσεις Conversions API στον Events Manager πριν τη δημοσίευση

Ασφάλεια

• Tokens Χρήστη Συστήματος - Μη-προσωπικά, επιχειρηματικά tokens πιστοποίησης
• Κατακερματισμός SHA-256 - Όλα τα PII κατακερματίζονται πριν τη μεταφορά στους servers Meta
• App Secret Proof - Προαιρετικό επιπρόσθετο επίπεδο ασφάλειας πιστοποίησης
• Εύρος επιχείρησης - Δικαιώματα περιορισμένα σε συγκεκριμένους λογαριασμούς διαφημίσεων και σελίδες
• Συμμόρφωση Meta - Υπόκεινται σε Όρους Πλατφόρμας Meta και πολιτικές διαφήμισης
• Όροι Επεξεργασίας Δεδομένων - Ισχύουν Όροι Επεξεργασίας Δεδομένων Meta για δεδομένα EU

Σχετικοί Πόροι

• Σύνδεσμος Google Ads
• Σύνδεσμος Klaviyo
• Σύνδεσμος Brevo
• Δεξιότητα Συγχρονισμού Πελατών