---
title: "Konektor Google Ads"
description: "Kompletní průvodce integrací Google Ads pro synchronizaci dat kampaní, seznamů publik a sledování konverzí s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/cz/docs/connectors/marketing/google-ads.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Google Ads

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte Google Ads s Brevo přes Tajo pro synchronizaci reklamních publik, import konverzních dat a vytváření sjednocených zákaznických profilů propojujících placenou akvizici s marketingem životního cyklu.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Google Ads |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Pokročilá |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Kampaně, Publika, Konverze, Zákazníci |
| **Dostupné dovednosti** | 7 |

## Funkce

- **Synchronizace Customer Match** – Nahrávejte seznamy kontaktů Brevo do Google Ads jako publika Customer Match
- **Sledování konverzí** – Importujte offline konverze z událostí Brevo do Google Ads
- **Synchronizace publik** – Obousměrná synchronizace mezi seznamy Brevo a publiky Google Ads
- **Reportování kampaní** – Stahujte data výkonu kampaní do řídicích panelů Tajo
- **Sledování GCLID** – Zachycujte Google Click ID pro přiřazení offline konverzí
- **Data pro Smart Bidding** – Předávejte data o hodnotě konverzí zpět do Google pro optimalizaci nabídek
- **Synchronizace formulářů potenciálních zákazníků** – Importujte odeslání formulářů potenciálních zákazníků Google Ads do kontaktů Brevo

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Google Ads s povoleným přístupem k API
2. Projekt Google Cloud s povoleným Google Ads API
3. Přihlašovací údaje OAuth 2.0 (Client ID a Client Secret)
4. Developer Token Google Ads (požádejte na [Google Ads API Center](https://ads.google.com/aw/apicenter))
5. Účet Brevo s přístupem k API
6. Účet Tajo s API přihlašovacími údaji

## Ověření

### OAuth 2.0

Google Ads API používá pro ověřování OAuth 2.0. Musíte získat refresh token prostřednictvím toku souhlasu OAuth.

```bash
# Požadované rozsahy OAuth
https://www.googleapis.com/auth/adwords
```

### Developer Token

Developer Token je vyžadován pro všechny požadavky Google Ads API a musí být schválen Googlem.

```bash
# Nastavení hlaviček ověřování
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"
```

## Konfigurace

### Základní nastavení

```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"  # Správcovský účet (volitelné)

    # Možnosti synchronizace dat
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Sledování konverzí
    conversions:
      action_id: "123456789"
      default_currency: "USD"
```

### Konfigurace Customer Match

Nahrávejte kontakty Brevo jako publika 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"

  # Datová pole pro párování
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Plán synchronizace
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append nebo remove
```

### Import offline konverzí

```yaml
conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Atribut Brevo ukládající GCLID
  conversion_events:
    - brevo_event: "order_completed"
      conversion_name: "Purchase"
      value_field: "revenue"
    - brevo_event: "subscription_created"
      conversion_name: "Subscription"
      value_field: "plan_value"
```

## Koncové body API

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Vyhledávání kampaní a zdrojů (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Streamování výsledků vyhledávání |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Vytvoření úlohy nahrávání Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Nahrání offline konverzí |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Nahrání konverzí hovorů |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Získání rozpočtů kampaní |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Správa seznamů zákazníků |

## Příklady kódu

### Inicializace konektoru Google Ads

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Připojení účtu Google Ads
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'
});
```

### Nahrání publika Customer Match

```javascript
// Synchronizace seznamu Brevo do Customer Match Google Ads
await tajo.connectors.syncAudience('google-ads', {
  brevoListId: 5,
  audienceName: 'High Value Customers',
  matchType: 'CONTACT_INFO',
  syncMode: 'mirror'
});
```

### Import offline konverzí

```javascript
// Nahrání offline konverzí z událostí objednávek 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'
    }
  ]
});
```

### Dotaz na výkon kampaní (GAQL)

```javascript
// Dotaz na metriky kampaní pomocí 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 });
```

## Omezení rychlosti

| Zdroj | Limit | Podrobnosti |
| --- | --- | --- |
| **API požadavky** | 15 000/den | Na developer token |
| **Mutační operace** | 10 000/den | Na zákaznický účet |
| **GAQL dotazy** | 1 500/den | Na zákaznický účet |
| **Nahrávání Customer Match** | 10 úloh/den | Na seznam zákazníků |
| **Nahrávání konverzí** | 2 000/požadavek | Na dávku nahrávání |
| **Velikost stránky** | 10 000 řádků | Max. na odpověď vyhledávání |

Schválení Developer Tokenu

Google Ads API vyžaduje schválený Developer Token. Požádejte prostřednictvím Google Ads API Center ve svém správcovském účtu. Testovací účty mají snížené limity rychlosti.

## Řešení problémů

| Problém | Příčina | Řešení |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token čeká na schválení | Počkejte na schválení Googlem nebo použijte testovací účet |
| `CUSTOMER_NOT_FOUND` | Nesprávné ID zákazníka | Odstraňte pomlčky z ID zákazníka nebo zkontrolujte správcovský účet |
| Nízká míra shody Customer Match | Nedostatečná data | Zahrňte více identifikátorů (e-mail, telefon, jméno, PSČ) |
| Konverze se nezobrazují | Atribuční okno | Zpracování konverzí může trvat až 24 hodin |
| `OAUTH_TOKEN_EXPIRED` | Neplatný refresh token | Znovu ověřte a získejte nový refresh token |
| `PERMISSION_DENIED` | Nedostatečný přístup | Zkontrolujte úroveň přístupu k API a propojení účtu |

## Osvědčené postupy

1. **Používejte správcovský účet** – Spravujte více účtů Ads přes jeden správcovský účet (MCC)
2. **Hashujte data Customer Match** – Vždy SHA-256 hashujte PII před nahráváním do Customer Match
3. **Sledujte GCLID** – Ukládejte Google Click ID v atributech Brevo pro sledování offline konverzí
4. **Dávkujte nahrávání konverzí** – Seskupujte konverze do denních dávek místo nahrávání v reálném čase
5. **Používejte GAQL pro reporting** – Využívejte Google Ads Query Language pro flexibilní reportování kampaní
6. **Sledujte míry shody** – Sledujte míry shody publik Customer Match a zlepšujte kvalitu dat
7. **Nastavte Enhanced Conversions** – Používejte Enhanced Conversions pro přesnější měření konverzí

## Zabezpečení

- **OAuth 2.0** – Bezpečné ověřování na základě tokenů s refresh tokeny
- **Hashování SHA-256** – Data Customer Match jsou hashována před nahráváním
- **Minimalizace dat** – Do Googlu jsou přenášena pouze povinná pole
- **Soulad s Google Cloud** – Soulad se SOC 2, ISO 27001 a GDPR
- **Vymezený přístup** – Oprávnění API vymezena na konkrétní zákaznické účty
- **Auditní protokolování** – Všechny API požadavky protokolovány v historii změn Google Ads

## Související zdroje

- [Konektor Meta Ads](https://tajo.io/cz/docs/connectors/marketing/meta-ads)
- [Konektor Klaviyo](https://tajo.io/cz/docs/connectors/marketing/klaviyo)
- [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)