Google Ads کنیکٹر

اشتہاری آڈیئنسز کو ہم آہنگ کرنے، conversion ڈیٹا امپورٹ کرنے، اور متحدہ گاہک پروفائلز بنانے کے لیے Tajo کے ذریعے Google Ads کو Brevo سے منسلک کریں جو paid acquisition کو lifecycle مارکیٹنگ سے جوڑتے ہیں۔

جائزہ

خصوصیات

• Customer Match سنک - Brevo رابطہ فہرستوں کو Customer Match آڈیئنسز کے طور پر Google Ads پر اپ لوڈ کریں
• Conversion ٹریکنگ - Brevo ایونٹس سے آف لائن conversions کو Google Ads میں امپورٹ کریں
• آڈیئنس سنک - Brevo فہرستوں اور Google Ads آڈیئنسز کے درمیان دو طرفہ سنک
• مہم رپورٹنگ - مہم کارکردگی ڈیٹا کو Tajo dashboards میں pull کریں
• GCLID ٹریکنگ - آف لائن conversion attribution کے لیے Google Click IDs capture کریں
• Smart bidding ڈیٹا - bid optimization کے لیے conversion value ڈیٹا واپس 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 consent flow کے ذریعے 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 آڈیئنسز کے طور پر اپ لوڈ کریں:

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 امپورٹ

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 آڈیئنس اپ لوڈ کریں

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

آف لائن Conversions امپورٹ کریں

// 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 اکاؤنٹ استعمال کریں - ایک Manager (MCC) اکاؤنٹ کے ذریعے متعدد Ads اکاؤنٹس کا انتظام کریں
2. Customer Match ڈیٹا کو hash کریں - Customer Match پر اپ لوڈ کرنے سے پہلے ہمیشہ PII کو SHA-256 hash کریں
3. GCLIDs ٹریک کریں - آف لائن conversion ٹریکنگ کے لیے Google Click IDs کو Brevo خصوصیات میں اسٹور کریں
4. بیچ conversion اپ لوڈز - ریئل ٹائم اپ لوڈز کے بجائے conversions کو روزانہ بیچز میں گروپ کریں
5. رپورٹنگ کے لیے GAQL استعمال کریں - لچکدار مہم رپورٹنگ کے لیے Google Ads Query Language کا فائدہ اٹھائیں
6. میچ ریٹس کی نگرانی کریں - Customer Match آڈیئنس میچ ریٹس کو ٹریک کریں اور ڈیٹا کے معیار کو بہتر بنائیں
7. Enhanced Conversions سیٹ اپ کریں - زیادہ درست conversion پیمائش کے لیے Enhanced Conversions استعمال کریں

سیکیورٹی

• OAuth 2.0 - refresh tokens کے ساتھ محفوظ token پر مبنی تصدیق
• SHA-256 hashing - اپ لوڈ سے پہلے Customer Match ڈیٹا hash کیا جاتا ہے
• ڈیٹا minimization - صرف مطلوبہ فیلڈز Google کو منتقل کیے جاتے ہیں
• Google Cloud کمپلائنس - SOC 2, ISO 27001, اور GDPR کمپلائنٹ
• اسکوپڈ رسائی - API اجازتیں مخصوص گاہک اکاؤنٹس پر اسکوپڈ
• Audit logging - تمام API درخواستیں Google Ads change history میں لاگ شدہ

متعلقہ وسائل

• Meta Ads کنیکٹر
• Klaviyo کنیکٹر
• Brevo کنیکٹر
• گاہک سنک اسکل