---
title: "Google Ads konnektor"
description: "Teljes Google Ads integrációs útmutató kampányadatok, közönséglisták és konverzió-követés Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/hu/docs/connectors/marketing/google-ads.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Google Ads konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Google Adst a Brevóhoz a Tajo segítségével hirdetési közönségek szinkronizálásához, konverziós adatok importálásához és egységesített ügyfélprofilok létrehozásához, amelyek áthidalják a fizetett akvizíciót és az életciklus-marketinget.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Google Ads |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Haladó |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Kampányok, Közönségek, Konverziók, Ügyfelek |
| **Elérhető Skillek** | 7 |

## Funkciók

- **Customer Match szinkronizáció** – Brevo kapcsolatlisták feltöltése a Google Adsba Customer Match közönségekként
- **Konverzió-követés** – Offline konverziók importálása Brevo eseményekből a Google Adsba
- **Közönség-szinkronizáció** – Kétirányú szinkronizálás Brevo listák és Google Ads közönségek között
- **Kampányriportolás** – Kampány-teljesítményadatok lekérése Tajo dashboardokra
- **GCLID követés** – Google Kattintás-azonosítók rögzítése offline konverzió-attribúcióhoz
- **Smart bidding adatok** – Konverziós érték adatok visszaküldése a Google-nek ajánlat-optimalizáláshoz
- **Lead form szinkronizáció** – Google Ads lead form beküldések importálása Brevo kapcsolatokba

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Google Ads fiókkal engedélyezett API-hozzáféréssel
2. Egy Google Cloud projekttel engedélyezett Google Ads API-val
3. OAuth 2.0 hitelesítő adatokkal (Client ID és Client Secret)
4. Google Ads fejlesztői tokennel (kérelmezd a [Google Ads API Centerben](https://ads.google.com/aw/apicenter))
5. Egy Brevo fiókkal API-hozzáféréssel
6. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### OAuth 2.0

A Google Ads API OAuth 2.0-t használ hitelesítéshez. Refresh tokent kell beszerezned az OAuth hozzájárulási folyamaton keresztül.

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

### Fejlesztői token

A fejlesztői token szükséges minden Google Ads API kéréshez, és a Google-nek jóvá kell hagynia.

```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áció

### Alapbeállítás

```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 konfiguráció

Brevo kapcsolatok feltöltése Google Ads közönségekként:

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

### Offline konverzió-importálás

```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 végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Kampányok és erőforrások keresése (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Keresési eredmények streamelése |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Customer Match feltöltési feladat létrehozása |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Offline konverziók feltöltése |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Hívás konverziók feltöltése |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Kampányköltségvetések lekérése |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Ügyféllisták kezelése |

## Kódpéldák

### A Google Ads konnektor inicializálása

```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 közönség feltöltése

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

### Offline konverziók importálása

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

### Kampány-teljesítmény lekérdezése (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 });
```

## Ráta-korlátok

| Erőforrás | Korlát | Részletek |
| --- | --- | --- |
| **API kérések** | 15 000/nap | Fejlesztői tokenenkénr |
| **Mutate műveletek** | 10 000/nap | Ügyfélszámlanként |
| **GAQL lekérdezések** | 1 500/nap | Ügyfélszámlanként |
| **Customer Match feltöltések** | 10 feladat/nap | Ügyféllistánként |
| **Konverzió feltöltések** | 2 000/kérés | Feltöltési kötegenkénr |
| **Oldal mérete** | 10 000 sor | Max. keresésenként |

Fejlesztői token jóváhagyás

A Google Ads API jóváhagyott fejlesztői tokent igényel. Kérelmezd a Google Ads API Centeren keresztül a Kezelői fiókodban. A teszt fiókoknál csökkentett ráta-korlátok érvényesek.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token jóváhagyásra vár | Várj a Google jóváhagyásra vagy használj tesztfiókot |
| `CUSTOMER_NOT_FOUND` | Rossz ügyfél azonosító | Távolítsd el a kötőjeleket az ügyfél azonosítóból vagy ellenőrizd a kezelői fiókot |
| Customer Match alacsony egyezési arány | Elégtelen adat | Adj meg több azonosítót (e-mail, telefon, név, irányítószám) |
| Konverziók nem jelennek meg | Attribúciós időablak | A konverziók feldolgozása akár 24 órát is igénybe vehet |
| `OAUTH_TOKEN_EXPIRED` | Refresh token érvénytelen | Hitelesítsd újra és szerezz új refresh tokent |
| `PERMISSION_DENIED` | Elégtelen hozzáférés | Ellenőrizd az API hozzáférési szintet és a fiókkapcsolást |

## Legjobb gyakorlatok

1. **Használj Kezelői fiókot** – Több Ads fiókot kezelj egyetlen Kezelői (MCC) fiókon keresztül
2. **Hasítsd el a Customer Match adatokat** – Mindig SHA-256 hash-elj személyes adatokat a Customer Match feltöltés előtt
3. **Kövesd a GCLID-eket** – Tárold a Google Kattintás-azonosítókat Brevo attribútumokban offline konverzió-követéshez
4. **Kötegelj konverzió-feltöltéseket** – Csoportosítsd a konverziókat napi kötegekbe a valós idejű feltöltések helyett
5. **Használj GAQL-t riportoláshoz** – Használd ki a Google Ads Lekérdezési Nyelvet rugalmas kampányriportoláshoz
6. **Figyeld az egyezési arányokat** – Kövesd a Customer Match közönség egyezési arányait és javítsd az adatminőséget
7. **Állíts be Enhanced Conversions-t** – Használj Enhanced Conversions-t a pontosabb konverzióméréshez

## Biztonság

- **OAuth 2.0** – Biztonságos token alapú hitelesítés refresh tokenekkel
- **SHA-256 hash-elés** – A Customer Match adatok feltöltés előtt hash-elve vannak
- **Adatminimalizálás** – Csak a szükséges mezők kerülnek továbbításra a Google-nek
- **Google Cloud megfelelőség** – SOC 2, ISO 27001 és GDPR megfelelőség
- **Hatókörhöz korlátozott hozzáférés** – API jogosultságok adott ügyfélszámlákra korlátozva
- **Audit naplózás** – Minden API kérés naplózva a Google Ads változástörténetben

## Kapcsolódó források

- [Meta Ads konnektor](https://tajo.io/hu/docs/connectors/marketing/meta-ads)
- [Klaviyo konnektor](https://tajo.io/hu/docs/connectors/marketing/klaviyo)
- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)