---
title: "Google Ads konektor"
description: "Kompletný sprievodca integráciou Google Ads na synchronizáciu dát kampaní, zoznamov publík a sledovania konverzií s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/sk/docs/connectors/marketing/google-ads.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Google Ads konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj Google Ads s Brevo cez Tajo na synchronizáciu reklamných publík, import dát konverzií a vytváranie zjednotených profilov zákazníkov, ktoré spájajú platené získavanie so life cycle marketingom.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Google Ads |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Pokročilé |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Kampane, Publiká, Konverzie, Zákazníci |
| **Dostupné skilly** | 7 |

## Funkcie

- **Synchronizácia Customer Match** - Nahrávaj zoznamy kontaktov Brevo do Google Ads ako publiká Customer Match
- **Sledovanie konverzií** - Importuj offline konverzie z udalostí Brevo do Google Ads
- **Synchronizácia publík** - Obojsmerná synchronizácia medzi zoznamami Brevo a publikami Google Ads
- **Reportovanie kampaní** - Sťahuj dáta výkonu kampaní do dashboardov Tajo
- **Sledovanie GCLID** - Zachytávaj Google Click ID pre offline priradenie konverzií
- **Dáta pre Smart Bidding** - Preposielaj dáta hodnoty konverzií späť do Google pre optimalizáciu ponúk
- **Synchronizácia leadových formulárov** - Importuj odovzdania leadových formulárov Google Ads do kontaktov Brevo

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Google Ads účet s povoleným API prístupom
2. Google Cloud projekt s povoleným Google Ads API
3. OAuth 2.0 prihlasovací údaje (Client ID a Client Secret)
4. Google Ads Developer Token (požiadaj na [Google Ads API Center](https://ads.google.com/aw/apicenter))
5. Brevo účet s API prístupom
6. Tajo účet s API prihlasovacími údajmi

## Autentifikácia

### OAuth 2.0

Google Ads API používa OAuth 2.0 pre autentifikáciu. Musíš získať refresh token cez OAuth consent flow.

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

### Developer Token

Developer Token je potrebný pre všetky požiadavky Google Ads API a musí byť schválený Googlom.

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

## Konfigurácia

### Základné nastavenie

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

### Konfigurácia Customer Match

Nahrávaj kontakty Brevo ako publiká 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
```

### Import offline konverzií

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

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Vyhľadávanie kampaní a zdrojov (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Streamovanie výsledkov vyhľadávania |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Vytvorenie úlohy nahrávania Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Nahranie offline konverzií |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Nahranie konverzií hovorov |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Získanie rozpočtov kampaní |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Správa zoznamov zákazníkov |

## Ukážky kódu

### Inicializácia Google Ads konektora

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

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

### Import offline konverzií

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

### Dopyt na výkon kampaní (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 });
```

## Obmedzenia rýchlosti

| Zdroj | Limit | Detaily |
| --- | --- | --- |
| **API požiadavky** | 15 000/deň | Na developer token |
| **Mutate operácie** | 10 000/deň | Na zákaznícky účet |
| **GAQL dopyty** | 1 500/deň | Na zákaznícky účet |
| **Nahrávky Customer Match** | 10 úloh/deň | Na zoznam zákazníkov |
| **Nahrávky konverzií** | 2 000/požiadavku | Na dávku nahrávania |
| **Veľkosť stránky** | 10 000 riadkov | Max na odpoveď vyhľadávania |

Schválenie Developer Token

Google Ads API vyžaduje schválený Developer Token. Požiadaj cez Google Ads API Center v tvojom Manager účte. Testovacie účty majú znížené limity rýchlosti.

## Riešenie problémov

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token čaká na schválenie | Počkaj na schválenie Googlu alebo použi testovací účet |
| `CUSTOMER_NOT_FOUND` | Nesprávne ID zákazníka | Odstráň pomlčky z ID zákazníka alebo skontroluj manager účet |
| Nízka miera zhody Customer Match | Nedostatočné dáta | Zahrň viacero identifikátorov (e-mail, telefón, meno, PSČ) |
| Konverzie sa neobjavujú | Okno priradenia | Konverzie môžu trvať až 24 hodín na spracovanie |
| `OAUTH_TOKEN_EXPIRED` | Neplatný refresh token | Znovu autentifikuj a získaj nový refresh token |
| `PERMISSION_DENIED` | Nedostatočný prístup | Skontroluj úroveň prístupu API a prepojenie účtu |

## Odporúčané postupy

1. **Použi Manager účet** - Spravuj viacero Ads účtov cez jeden Manager (MCC) účet
2. **Hashuj dáta Customer Match** - Vždy hashuj osobné údaje SHA-256 pred nahrávaním do Customer Match
3. **Sleduj GCLID** - Uchovávaj Google Click ID v atribútoch Brevo pre sledovanie offline konverzií
4. **Dávkuj nahrávky konverzií** - Zoskupuj konverzie do denných dávok namiesto nahrávok v reálnom čase
5. **Použi GAQL pre reportovanie** - Využi Google Ads Query Language pre flexibilné reportovanie kampaní
6. **Monitoruj miery zhody** - Sleduj miery zhody publika Customer Match a zlepšuj kvalitu dát
7. **Nastav Enhanced Conversions** - Použi Enhanced Conversions pre presnejšie meranie konverzií

## Bezpečnosť

- **OAuth 2.0** - Bezpečná autentifikácia na základe tokenov s refresh tokenmi
- **Hashovanie SHA-256** - Dáta Customer Match sú hashované pred nahrávaním
- **Minimalizácia dát** - Do Googlu sa prenášajú iba povinné polia
- **Súlad s Google Cloud** - SOC 2, ISO 27001 a GDPR súlad
- **Scoped prístup** - Oprávnenia API obmedzené na konkrétne zákaznícke účty
- **Audit logging** - Všetky API požiadavky zaznamenané v histórii zmien Google Ads

## Súvisiace zdroje

- [Meta Ads konektor](https://tajo.io/sk/docs/connectors/marketing/meta-ads)
- [Klaviyo konektor](https://tajo.io/sk/docs/connectors/marketing/klaviyo)
- [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)