Google Ads कनेक्टर

विज्ञापन audiences को सिंक्रनाइज़ करने, कन्वर्जन डेटा आयात करने, और एकीकृत ग्राहक प्रोफ़ाइल्स बनाने के लिए Tajo के माध्यम से Google Ads को Brevo से कनेक्ट करें जो paid acquisition को lifecycle मार्केटिंग से जोड़ते हैं।

अवलोकन

विशेषताएं

• Customer Match सिंक - Brevo कॉन्टैक्ट लिस्ट्स को Google Ads में Customer Match audiences के रूप में अपलोड करें
• कन्वर्जन ट्रैकिंग - Brevo इवेंट्स से ऑफ़लाइन कन्वर्जन्स को Google Ads में आयात करें
• Audience सिंक - Brevo लिस्ट्स और Google Ads audiences के बीच द्विदिशीय सिंक
• कैंपेन रिपोर्टिंग - Tajo डैशबोर्ड्स में कैंपेन प्रदर्शन डेटा खींचें
• GCLID ट्रैकिंग - ऑफ़लाइन कन्वर्जन attribution के लिए Google Click IDs कैप्चर करें
• Smart bidding डेटा - bid अनुकूलन के लिए कन्वर्जन मान डेटा को Google पर वापस फ़ीड करें
• Lead form सिंक - Google Ads lead form सबमिशन को Brevo कॉन्टैक्ट्स में आयात करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. API एक्सेस सक्षम के साथ एक Google Ads खाता
2. Google Ads API सक्षम के साथ एक Google Cloud project
3. OAuth 2.0 क्रेडेंशियल्स (Client ID और Client Secret)
4. एक Google Ads Developer Token (Google Ads API Center पर आवेदन करें)
5. API एक्सेस वाला एक Brevo खाता
6. API क्रेडेंशियल्स वाला एक Tajo खाता

प्रमाणीकरण

OAuth 2.0

Google Ads API प्रमाणीकरण के लिए OAuth 2.0 का उपयोग करता है। आपको OAuth सहमति फ़्लो के माध्यम से एक refresh token प्राप्त करना होगा।

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

Developer Token

सभी Google Ads API अनुरोधों के लिए एक Developer Token आवश्यक है और इसे 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 audiences के रूप में अपलोड करें:

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"

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 Audience अपलोड करें

// 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 account का उपयोग करें - एक Manager (MCC) account के माध्यम से कई Ads accounts प्रबंधित करें
2. Customer Match डेटा को hash करें - Customer Match पर अपलोड करने से पहले हमेशा PII को SHA-256 hash करें
3. GCLIDs ट्रैक करें - ऑफ़लाइन कन्वर्जन ट्रैकिंग के लिए Google Click IDs को Brevo एट्रिब्यूट्स में संग्रहीत करें
4. कन्वर्जन uploads बैच करें - real-time uploads के बजाय कन्वर्जन्स को दैनिक बैचों में समूहबद्ध करें
5. रिपोर्टिंग के लिए GAQL का उपयोग करें - लचीली कैंपेन रिपोर्टिंग के लिए Google Ads Query Language का लाभ उठाएं
6. match rates की निगरानी करें - Customer Match audience match rates ट्रैक करें और डेटा गुणवत्ता में सुधार करें
7. Enhanced Conversions सेट करें - अधिक सटीक कन्वर्जन माप के लिए Enhanced Conversions का उपयोग करें

सुरक्षा

• OAuth 2.0 - refresh tokens के साथ सुरक्षित token-आधारित प्रमाणीकरण
• SHA-256 hashing - Customer Match डेटा अपलोड से पहले hash किया जाता है
• डेटा minimization - केवल आवश्यक फ़ील्ड्स Google को प्रसारित किए जाते हैं
• Google Cloud अनुपालन - SOC 2, ISO 27001, और GDPR अनुपालक
• Scoped एक्सेस - API अनुमतियां विशिष्ट customer accounts पर scope की गई
• ऑडिट लॉगिंग - सभी API अनुरोध Google Ads change history में लॉग किए गए

संबंधित संसाधन

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