---
title: "موصل Google Ads"
description: "دليل تكامل Google Ads الشامل لمزامنة بيانات الحملات، وقوائم الجمهور، وتتبع التحويلات مع Brevo عبر Tajo."
url: https://tajo.io/ar/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/ar/docs/connectors/marketing/google-ads.md
lang: ar-SA
robots: noindex
---

اطلب الوصول المبكر

أدخل اسمك الأول وعنوان بريدك الإلكتروني للعمل. سنرسل إليك رابطًا لتأكيد طلب الوصول إلى Tajo.

# موصل Google Ads

حالة الموصل: مخطط له لم يُبنَ بعد. لا يشغّل Tajo هذا الموصل اليوم.

| حقل المصدر | حقل الوجهة | قيمة نموذجية |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## نظرة عامة

| الخاصية | القيمة |
| --- | --- |
| **المنصة** | Google Ads |
| **الفئة** | التسويق |
| **تعقيد الإعداد** | متقدم |
| **تكامل رسمي** | لا |
| **البيانات المُزامَنة** | حملات، جماهير، تحويلات، عملاء |
| **المهارات المتاحة** | 7 |

## الميزات

- **مزامنة 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](https://ads.google.com/aw/apicenter))
5. حساب Brevo مع وصول إلى API
6. حساب Tajo مع بيانات اعتماد API

## المصادقة

### OAuth 2.0

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

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

### Developer Token

Developer Token مطلوب لجميع طلبات Google Ads API ويجب الموافقة عليه من Google.

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

## الإعداد

### الإعداد الأساسي

```yaml
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:

```yaml
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
```

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

```yaml
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"
```

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

| الطريقة | نقطة النهاية | الوصف |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | البحث في الحملات والموارد (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | بث نتائج البحث |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | إنشاء مهمة تحميل Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | تحميل التحويلات دون اتصال |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | تحميل تحويلات المكالمات |
| `GET` | `/v18/customers/{id}/campaignBudgets` | الحصول على ميزانيات الحملات |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | إدارة قوائم العملاء |

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

### تهيئة موصل Google Ads

```javascript
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

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

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

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

```javascript
// استعلام مقاييس الحملة باستخدام 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 });
```

## حدود المعدل

| المورد | الحد | التفاصيل |
| --- | --- | --- |
| **طلبات API** | 15,000/يوم | لكل developer token |
| **عمليات التعديل** | 10,000/يوم | لكل حساب عميل |
| **استعلامات GAQL** | 1,500/يوم | لكل حساب عميل |
| **تحميلات Customer Match** | 10 مهام/يوم | لكل قائمة عملاء |
| **تحميلات التحويلات** | 2,000/طلب | لكل دفعة تحميل |
| **حجم الصفحة** | 10,000 صف | الحد الأقصى لكل استجابة بحث |

الموافقة على Developer Token

يتطلب Google Ads API Developer Token معتمد. تقدّم بطلب عبر Google Ads API Center في حساب Manager الخاص بك. تحتوي حسابات الاختبار على حدود معدل مخفضة.

## استكشاف الأخطاء وإصلاحها

| المشكلة | السبب | الحل |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | الرمز قيد المراجعة | انتظر موافقة Google أو استخدم حساب اختبار |
| `CUSTOMER_NOT_FOUND` | معرّف عميل خاطئ | أزل الشرطات من معرّف العميل أو تحقق من حساب Manager |
| معدل مطابقة Customer Match منخفض | بيانات غير كافية | ضمّن معرّفات متعددة (بريد، هاتف، اسم، رمز بريدي) |
| التحويلات لا تظهر | نافذة الإسناد | قد تستغرق التحويلات حتى 24 ساعة للمعالجة |
| `OAUTH_TOKEN_EXPIRED` | Refresh token غير صالح | أعد المصادقة واحصل على refresh token جديد |
| `PERMISSION_DENIED` | وصول غير كافٍ | تحقق من مستوى وصول API وربط الحسابات |

## أفضل الممارسات

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](https://tajo.io/ar/docs/connectors/marketing/meta-ads)
- [موصل Klaviyo](https://tajo.io/ar/docs/connectors/marketing/klaviyo)
- [موصل Brevo](https://tajo.io/ar/docs/connectors/marketing/brevo)
- [مهارة مزامنة العملاء](https://tajo.io/ar/docs/skills/data-sync/customer-sync)