Konektor Google Ads

Propojte Google Ads s Brevo přes Tajo pro synchronizaci reklamních publik, import konverzních dat a vytváření sjednocených zákaznických profilů propojujících placenou akvizici s marketingem životního cyklu.

Přehled

Funkce

• Synchronizace Customer Match – Nahrávejte seznamy kontaktů Brevo do Google Ads jako publika Customer Match
• Sledování konverzí – Importujte offline konverze z událostí Brevo do Google Ads
• Synchronizace publik – Obousměrná synchronizace mezi seznamy Brevo a publiky Google Ads
• Reportování kampaní – Stahujte data výkonu kampaní do řídicích panelů Tajo
• Sledování GCLID – Zachycujte Google Click ID pro přiřazení offline konverzí
• Data pro Smart Bidding – Předávejte data o hodnotě konverzí zpět do Google pro optimalizaci nabídek
• Synchronizace formulářů potenciálních zákazníků – Importujte odeslání formulářů potenciálních zákazníků Google Ads do kontaktů Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Google Ads s povoleným přístupem k API
2. Projekt Google Cloud s povoleným Google Ads API
3. Přihlašovací údaje OAuth 2.0 (Client ID a Client Secret)
4. Developer Token Google Ads (požádejte na Google Ads API Center)
5. Účet Brevo s přístupem k API
6. Účet Tajo s API přihlašovacími údaji

Ověření

OAuth 2.0

Google Ads API používá pro ověřování OAuth 2.0. Musíte získat refresh token prostřednictvím toku souhlasu OAuth.

# Požadované rozsahy OAuth
https://www.googleapis.com/auth/adwords

Developer Token

Developer Token je vyžadován pro všechny požadavky Google Ads API a musí být schválen Googlem.

# Nastavení hlaviček ověřování
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"

Konfigurace

Základní nastavení

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"  # Správcovský účet (volitelné)

    # Možnosti synchronizace dat
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Sledování konverzí
    conversions:
      action_id: "123456789"
      default_currency: "USD"

Konfigurace Customer Match

Nahrávejte kontakty Brevo jako publika 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"

  # Datová pole pro párování
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Plán synchronizace
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append nebo remove

Import offline konverzí

conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Atribut Brevo ukládající GCLID
  conversion_events:
    - brevo_event: "order_completed"
      conversion_name: "Purchase"
      value_field: "revenue"
    - brevo_event: "subscription_created"
      conversion_name: "Subscription"
      value_field: "plan_value"

Koncové body API

Příklady kódu

Inicializace konektoru Google Ads

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

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

// Připojení účtu Google Ads
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'
});

Nahrání publika Customer Match

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

Import offline konverzí

// Nahrání offline konverzí z událostí objednávek Brevo
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'
    }
  ]
});

Dotaz na výkon kampaní (GAQL)

// Dotaz na metriky kampaní pomocí 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 });

Omezení rychlosti

Řešení problémů

Osvědčené postupy

1. Používejte správcovský účet – Spravujte více účtů Ads přes jeden správcovský účet (MCC)
2. Hashujte data Customer Match – Vždy SHA-256 hashujte PII před nahráváním do Customer Match
3. Sledujte GCLID – Ukládejte Google Click ID v atributech Brevo pro sledování offline konverzí
4. Dávkujte nahrávání konverzí – Seskupujte konverze do denních dávek místo nahrávání v reálném čase
5. Používejte GAQL pro reporting – Využívejte Google Ads Query Language pro flexibilní reportování kampaní
6. Sledujte míry shody – Sledujte míry shody publik Customer Match a zlepšujte kvalitu dat
7. Nastavte Enhanced Conversions – Používejte Enhanced Conversions pro přesnější měření konverzí

Zabezpečení

• OAuth 2.0 – Bezpečné ověřování na základě tokenů s refresh tokeny
• Hashování SHA-256 – Data Customer Match jsou hashována před nahráváním
• Minimalizace dat – Do Googlu jsou přenášena pouze povinná pole
• Soulad s Google Cloud – Soulad se SOC 2, ISO 27001 a GDPR
• Vymezený přístup – Oprávnění API vymezena na konkrétní zákaznické účty
• Auditní protokolování – Všechny API požadavky protokolovány v historii změn Google Ads

Související zdroje

• Konektor Meta Ads
• Konektor Klaviyo
• Konektor Brevo
• Dovednost synchronizace zákazníků