Σύνδεσμος Google Ads

Συνδέστε το Google Ads με το Brevo μέσω Tajo για συγχρονισμό διαφημιστικού κοινού, εισαγωγή δεδομένων μετατροπών και δημιουργία ενοποιημένων προφίλ πελατών που γεφυρώνουν την επί πληρωμή απόκτηση με το lifecycle marketing.

Επισκόπηση

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

• Συγχρονισμός Customer Match - Μεταφόρτωση λιστών επαφών Brevo στο Google Ads ως κοινά Customer Match
• Παρακολούθηση μετατροπών - Εισαγωγή εκτός σύνδεσης μετατροπών από εκδηλώσεις Brevo στο Google Ads
• Συγχρονισμός κοινού - Αμφίδρομος συγχρονισμός μεταξύ λιστών Brevo και κοινών Google Ads
• Αναφορά καμπάνιας - Ανάκτηση δεδομένων απόδοσης καμπάνιας σε dashboards Tajo
• Παρακολούθηση GCLID - Καταγραφή Google Click IDs για απόδοση εκτός σύνδεσης μετατροπών
• Δεδομένα smart bidding - Ανάδραση δεδομένων αξίας μετατροπής στο Google για βελτιστοποίηση προσφοράς
• Συγχρονισμός φόρμας δυνητικού πελάτη - Εισαγωγή υποβολών φόρμας δυνητικού πελάτη Google Ads σε επαφές Brevo

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

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

1. Λογαριασμό Google Ads με ενεργοποιημένη πρόσβαση API
2. Έργο Google Cloud με ενεργοποιημένο Google Ads API
3. Διαπιστευτήρια OAuth 2.0 (Client ID και Client Secret)
4. Developer Token Google Ads (αιτηθείτε στο Google Ads API Center)
5. Λογαριασμό Brevo με πρόσβαση API
6. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

OAuth 2.0

Το Google Ads API χρησιμοποιεί OAuth 2.0 για πιστοποίηση. Πρέπει να αποκτήσετε refresh token μέσω της ροής συναίνεσης OAuth.

# Required OAuth scopes
https://www.googleapis.com/auth/adwords

Developer Token

Απαιτείται Developer Token για όλα τα αιτήματα Google Ads API και πρέπει να εγκριθεί από την Google.

# Set up authentication headers
curl -X POST https://googleads.googleapis.com/v18/customers/1234567890/googleAds:search \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "developer-token: DEVELOPER_TOKEN" \
  -H "login-customer-id: MANAGER_ACCOUNT_ID"

Διαμόρφωση

Βασική Ρύθμιση

connectors:
  google_ads:
    enabled: true
    developer_token: "your-developer-token"
    oauth:
      client_id: "your-client-id"
      client_secret: "your-client-secret"
      refresh_token: "your-refresh-token"
    customer_id: "123-456-7890"
    login_customer_id: "111-222-3333"  # Manager account (optional)

    # Data sync options
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Conversion tracking
    conversions:
      action_id: "123456789"
      default_currency: "USD"

Διαμόρφωση Customer Match

Μεταφόρτωση επαφών Brevo ως κοινά Google Ads:

customer_match:
  enabled: true
  lists:
    - brevo_list_id: 5
      audience_name: "All Customers"
      match_type: "CONTACT_INFO"
    - brevo_list_id: 7
      audience_name: "High Value Customers"
      match_type: "CONTACT_INFO"

  # Data fields to match
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Sync schedule
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append, or remove

Εισαγωγή Εκτός Σύνδεσης Μετατροπών

conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Brevo attribute storing GCLID
  conversion_events:
    - brevo_event: "order_completed"
      conversion_name: "Purchase"
      value_field: "revenue"
    - brevo_event: "subscription_created"
      conversion_name: "Subscription"
      value_field: "plan_value"

Endpoints API

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

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

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Google Ads account
await tajo.connectors.connect('google-ads', {
  developerToken: process.env.GOOGLE_ADS_DEV_TOKEN,
  clientId: process.env.GOOGLE_OAUTH_CLIENT_ID,
  clientSecret: process.env.GOOGLE_OAUTH_CLIENT_SECRET,
  refreshToken: process.env.GOOGLE_OAUTH_REFRESH_TOKEN,
  customerId: '123-456-7890'
});

Μεταφόρτωση Κοινού Customer Match

// Sync a Brevo list to Google Ads Customer Match
await tajo.connectors.syncAudience('google-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchType: 'CONTACT_INFO',
  syncMode: 'mirror'
});

Εισαγωγή Εκτός Σύνδεσης Μετατροπών

// Upload offline conversions from Brevo order events
await tajo.connectors.uploadConversions('google-ads', {
  conversionAction: 'customers/123456/conversionActions/789',
  conversions: [
    {
      gclid: 'CjwKCAiA...',
      conversionDateTime: '2024-01-15 10:30:00-05:00',
      conversionValue: 89.99,
      currencyCode: 'USD'
    }
  ]
});

Ερώτημα Απόδοσης Καμπάνιας (GAQL)

// Query campaign metrics using Google Ads Query Language
const query = `
  SELECT
    campaign.name,
    campaign.status,
    metrics.impressions,
    metrics.clicks,
    metrics.cost_micros,
    metrics.conversions
  FROM campaign
  WHERE segments.date DURING LAST_30_DAYS
  ORDER BY metrics.impressions DESC
  LIMIT 20
`;

const results = await tajo.connectors.query('google-ads', { gaql: query });

Όρια Ρυθμού

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

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

1. Χρησιμοποιήστε λογαριασμό Manager - Διαχειριστείτε πολλαπλούς λογαριασμούς Ads μέσω ενός λογαριασμού Manager (MCC)
2. Κατακερματίστε δεδομένα Customer Match - Πάντα να κατακερματίζετε με SHA-256 τα PII πριν τη μεταφόρτωση στο Customer Match
3. Παρακολουθήστε GCLIDs - Αποθηκεύστε Google Click IDs σε χαρακτηριστικά Brevo για παρακολούθηση εκτός σύνδεσης μετατροπών
4. Ομαδοποιήστε μεταφορτώσεις μετατροπών - Ομαδοποιήστε μετατροπές σε ημερήσιες παρτίδες αντί για μεταφορτώσεις σε πραγματικό χρόνο
5. Χρησιμοποιήστε GAQL για αναφορές - Αξιοποιήστε Google Ads Query Language για ευέλικτες αναφορές καμπάνιας
6. Παρακολουθήστε ποσοστά αντιστοίχισης - Παρακολουθήστε ποσοστά αντιστοίχισης κοινού Customer Match και βελτιώστε την ποιότητα δεδομένων
7. Ρυθμίστε Enhanced Conversions - Χρησιμοποιήστε Enhanced Conversions για πιο ακριβή μέτρηση μετατροπών

Ασφάλεια

• OAuth 2.0 - Ασφαλής πιστοποίηση βάσει token με refresh tokens
• Κατακερματισμός SHA-256 - Τα δεδομένα Customer Match κατακερματίζονται πριν τη μεταφόρτωση
• Ελαχιστοποίηση δεδομένων - Μόνο τα απαραίτητα πεδία μεταδίδονται στην Google
• Συμμόρφωση Google Cloud - Συμμορφώνεται με SOC 2, ISO 27001 και GDPR
• Εύρος πρόσβασης - Δικαιώματα API περιορισμένα σε συγκεκριμένους λογαριασμούς πελατών
• Αρχείο καταγραφής ελέγχου - Όλα τα αιτήματα API καταγράφονται στο ιστορικό αλλαγών Google Ads

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

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