---
title: "Google Ads کنیکٹر"
description: "Tajo کے ذریعے مہم ڈیٹا، آڈیئنس فہرستیں، اور conversion ٹریکنگ کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Google Ads انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/ur/docs/connectors/marketing/google-ads.md
lang: ur-PK
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` |

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

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Google Ads |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | جدید |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | مہمات، آڈیئنسز، Conversions، گاہک |
| **دستیاب اسکلز** | 7 |

## خصوصیات

- **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](https://ads.google.com/aw/apicenter) پر درخواست دیں)
5. API رسائی کے ساتھ Brevo اکاؤنٹ
6. API کریڈینشلز کے ساتھ Tajo اکاؤنٹ

## تصدیق

### OAuth 2.0

Google Ads API تصدیق کے لیے OAuth 2.0 استعمال کرتا ہے۔ آپ کو OAuth consent flow کے ذریعے refresh token حاصل کرنا ہوگا۔

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

### Developer Token

تمام Google Ads API درخواستوں کے لیے Developer Token درکار ہے اور 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
```

### آف لائن Conversion امپورٹ

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

## API اینڈ پوائنٹس

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | مہمات اور resources تلاش کریں (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | تلاش کے نتائج اسٹریم کریں |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Customer Match اپ لوڈ job بنائیں |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | آف لائن conversions اپ لوڈ کریں |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | کال conversions اپ لوڈ کریں |
| `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
// 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 امپورٹ کریں

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

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

## شرح کی حدود

| وسیلہ | حد | تفصیلات |
| --- | --- | --- |
| **API درخواستیں** | 15,000/دن | فی developer token |
| **Mutate آپریشنز** | 10,000/دن | فی گاہک اکاؤنٹ |
| **GAQL کوئریز** | 1,500/دن | فی گاہک اکاؤنٹ |
| **Customer Match اپ لوڈز** | 10 jobs/دن | فی گاہک فہرست |
| **Conversion اپ لوڈز** | 2,000/درخواست | فی اپ لوڈ بیچ |
| **پیج سائز** | 10,000 سطریں | فی تلاش جواب زیادہ سے زیادہ |

Developer Token منظوری

Google Ads API کو منظور شدہ Developer Token درکار ہے۔ اپنے Manager اکاؤنٹ میں Google Ads API Center کے ذریعے درخواست دیں۔ Test اکاؤنٹس میں کم شرح کی حدود ہیں۔

## ٹربل شوٹنگ

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token جائزے کے زیر التواء | Google کی منظوری کا انتظار کریں یا test اکاؤنٹ استعمال کریں |
| `CUSTOMER_NOT_FOUND` | غلط customer ID | customer ID سے hyphens ہٹائیں یا manager اکاؤنٹ چیک کریں |
| Customer Match کم میچ ریٹ | ناکافی ڈیٹا | متعدد شناخت کنندگان شامل کریں (ای میل، فون، نام، zip) |
| Conversions ظاہر نہیں ہو رہے | Attribution window | Conversions پروسیس ہونے میں 24 گھنٹے لگ سکتے ہیں |
| `OAUTH_TOKEN_EXPIRED` | Refresh token غلط | دوبارہ تصدیق کریں اور نیا refresh token حاصل کریں |
| `PERMISSION_DENIED` | ناکافی رسائی | API رسائی کی سطح اور اکاؤنٹ linking چیک کریں |

## بہترین طرز عمل

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 کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/meta-ads)
- [Klaviyo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/klaviyo)
- [Brevo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/brevo)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)