---
title: "Google Ads конектор"
description: "Пълно ръководство за интеграция с Google Ads за синхронизация на данни за кампании, audience списъци и проследяване на конверсии с Brevo през Tajo."
url: https://tajo.io/bg/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/bg/docs/connectors/marketing/google-ads.md
lang: bg-BG
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, за да синхронизираш рекламни audiences, да импортираш данни за конверсии и да създадеш унифицирани клиентски профили, които свързват платеното привличане с lifecycle маркетинга.

## Преглед

| Свойство | Стойност |
| --- | --- |
| **Платформа** | Google Ads |
| **Категория** | Маркетинг |
| **Сложност на настройка** | Напреднала |
| **Официална интеграция** | Не |
| **Синхронизирани данни** | Кампании, audiences, конверсии, клиенти |
| **Налични скилове** | 7 |

## Функции

- **Синхронизация на Customer Match** – Качвай Brevo списъци с контакти в Google Ads като Customer Match audiences
- **Проследяване на конверсии** – Импортирай офлайн конверсии от Brevo събития в Google Ads
- **Синхронизация на audience** – Двупосочна синхронизация между Brevo списъци и Google Ads audiences
- **Отчети за кампании** – Извличай данни за performance на кампании в Tajo dashboards
- **GCLID проследяване** – Улавяй Google Click IDs за атрибуция на офлайн конверсии
- **Smart bidding данни** – Захранвай Google с данни за стойност на конверсии за оптимизация на офертите
- **Синхронизация на Lead form** – Импортирай изпращания на Google Ads lead форми в Brevo контакти

## Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Google Ads акаунт с активиран API достъп
2. Google Cloud проект с активиран Google Ads API
3. OAuth 2.0 credentials (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 credentials

## Автентикация

### 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 audiences:

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

## API крайни точки

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Търсене на кампании и ресурси (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Stream на резултати от търсене |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Създаване на Customer Match upload job |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Качване на офлайн конверсии |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Качване на call конверсии |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Получаване на бюджети на кампании |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Управление на customer lists |

## Примери с код

### Инициализация на 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 audience

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

### Импорт на офлайн конверсии

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

### Заявка за performance на кампании (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/ден | На customer акаунт |
| **GAQL заявки** | 1 500/ден | На customer акаунт |
| **Customer Match uploads** | 10 jobs/ден | На customer list |
| **Качване на конверсии** | 2 000/заявка | На upload batch |
| **Размер на страница** | 10 000 реда | Макс на search response |

Одобрение на Developer Token

Google Ads API изисква одобрен Developer Token. Кандидатствай чрез Google Ads API Center в своя Manager акаунт. Тест акаунтите имат намалени rate limits.

## Отстраняване на проблеми

| Проблем | Причина | Решение |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token чака преглед | Изчакай Google одобрение или използвай test акаунт |
| `CUSTOMER_NOT_FOUND` | Грешен customer ID | Премахни тиретата от customer ID или провери manager акаунта |
| Нисък match rate на Customer Match | Недостатъчни данни | Включи множество идентификатори (email, phone, name, zip) |
| Конверсиите не се появяват | Прозорец на атрибуция | Конверсиите могат да отнемат до 24 часа за обработка |
| `OAUTH_TOKEN_EXPIRED` | Невалиден refresh token | Автентикирай се повторно и получи нов refresh token |
| `PERMISSION_DENIED` | Недостатъчен достъп | Провери нивото на API достъп и account linking |

## Добри практики

1. **Използвай Manager акаунт** – Управлявай множество Ads акаунти чрез един Manager (MCC) акаунт
2. **Хеширай Customer Match данни** – Винаги SHA-256 хеширай PII преди качване в Customer Match
3. **Проследявай GCLID-и** – Съхранявай Google Click IDs в атрибути в Brevo за офлайн проследяване на конверсии
4. **Пакетирай качванията на конверсии** – Групирай конверсии в дневни пакети, вместо качвания в реално време
5. **Използвай GAQL за отчети** – Използвай Google Ads Query Language за гъвкави отчети за кампании
6. **Мониторирай match rates** – Проследявай match rate на Customer Match audiences и подобрявай качеството на данните
7. **Настрой Enhanced Conversions** – Използвай Enhanced Conversions за по-точно измерване на конверсии

## Сигурност

- **OAuth 2.0** – Сигурна token-базирана автентикация с refresh tokens
- **SHA-256 хеширане** – Customer Match данните се хешират преди качване
- **Минимизация на данни** – Предават се само необходимите полета към Google
- **Google Cloud съвместимост** – SOC 2, ISO 27001 и GDPR съвместим
- **Scoped достъп** – API разрешенията са scoped до конкретни customer акаунти
- **Audit logging** – Всички API заявки се логват в Google Ads change history

## Свързани ресурси

- [Meta Ads конектор](https://tajo.io/bg/docs/connectors/marketing/meta-ads)
- [Klaviyo конектор](https://tajo.io/bg/docs/connectors/marketing/klaviyo)
- [Brevo конектор](https://tajo.io/bg/docs/connectors/marketing/brevo)
- [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)