موصل Google Ads

اربط Google Ads بـ Brevo من خلال Tajo لمزامنة جماهير الإعلانات، واستيراد بيانات التحويل، وإنشاء ملفات عملاء موحدة تربط الاكتساب المدفوع بتسويق دورة الحياة.

نظرة عامة

الميزات

• مزامنة Customer Match - تحميل قوائم جهات اتصال Brevo إلى Google Ads كجماهير Customer Match
• تتبع التحويلات - استيراد التحويلات دون اتصال من أحداث Brevo إلى Google Ads
• مزامنة الجماهير - مزامنة ثنائية الاتجاه بين قوائم Brevo وجماهير Google Ads
• تقارير الحملات - سحب بيانات أداء الحملات إلى لوحات Tajo
• تتبع GCLID - التقاط معرّفات النقرات من Google لإسناد التحويلات دون اتصال
• بيانات العطاءات الذكية - تغذية بيانات قيمة التحويلات لـ Google لتحسين العطاءات
• مزامنة نماذج العملاء المحتملين - استيراد إرسالات نماذج Google Ads إلى جهات اتصال Brevo

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Google Ads مع تفعيل وصول API
2. مشروع Google Cloud مع تفعيل Google Ads API
3. بيانات اعتماد OAuth 2.0 (Client ID وClient Secret)
4. Google Ads Developer Token (تقدّم بطلب في Google Ads API Center)
5. حساب Brevo مع وصول إلى API
6. حساب Tajo مع بيانات اعتماد API

المصادقة

OAuth 2.0

يستخدم Google Ads API بروتوكول OAuth 2.0 للمصادقة. تحتاج إلى الحصول على refresh token عبر تدفق OAuth consent.

# 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"

نقاط نهاية واجهة البرمجة

أمثلة على الكود

تهيئة موصل 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

// مزامنة قائمة Brevo مع Google Ads Customer Match
await tajo.connectors.syncAudience('google-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchType: 'CONTACT_INFO',
  syncMode: 'mirror'
});

استيراد التحويلات دون اتصال

// تحميل التحويلات دون اتصال من أحداث طلبات 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'
    }
  ]
});

استعلام أداء الحملة (GAQL)

// استعلام مقاييس الحملة باستخدام 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 - قم دائمًا بتجزئة PII باستخدام SHA-256 قبل التحميل إلى Customer Match
3. تتبع GCLIDs - خزّن معرّفات النقرات من Google في سمات Brevo لتتبع التحويلات دون اتصال
4. تحميلات التحويلات بالدفعات - جمّع التحويلات في دفعات يومية بدلاً من التحميلات الآنية
5. استخدم GAQL للتقارير - استفد من Google Ads Query Language لتقارير حملات مرنة
6. راقب معدلات المطابقة - تتبع معدلات مطابقة جماهير Customer Match وحسّن جودة البيانات
7. إعداد Enhanced Conversions - استخدم Enhanced Conversions لقياس تحويلات أكثر دقة

الأمان

• OAuth 2.0 - مصادقة آمنة قائمة على الرموز مع refresh tokens
• تجزئة SHA-256 - تُجزَّأ بيانات Customer Match قبل التحميل
• تقليل البيانات - تُرسل الحقول المطلوبة فقط إلى Google
• الامتثال لـ Google Cloud - متوافق مع SOC 2، وISO 27001، وGDPR
• وصول مقيد - صلاحيات API مقيدة بحسابات عملاء محددة
• تسجيل المراجعة - تُسجَّل جميع طلبات API في سجل تغييرات Google Ads

موارد ذات صلة

• موصل Meta Ads
• موصل Klaviyo
• موصل Brevo
• مهارة مزامنة العملاء