---
title: "Google Ads Connector"
description: "Popoln vodnik za integracijo Google Ads za sinhronizacijo podatkov kampanj, seznamov občinstev in sledenja konverzijam z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/sl/docs/connectors/marketing/google-ads.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Google Ads Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Google Ads z Brevo prek Tajo za sinhronizacijo oglaševalskih občinstev, uvoz podatkov o konverzijah in ustvarjanje enotnih profilov strank, ki premostijo plačano pridobivanje s trženjskim življenjskim ciklom.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Google Ads |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Napredna |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Kampanje, občinstva, konverzije, stranke |
| **Razpoložljivi Skills** | 7 |

## Funkcionalnosti

- **Sinhronizacija Customer Match** – naloži sezname stikov Brevo kot občinstva Customer Match v Google Ads
- **Sledenje konverzijam** – uvozi konverzije brez spleta iz dogodkov Brevo v Google Ads
- **Sinhronizacija občinstev** – dvosmerna sinhronizacija med seznami Brevo in občinstvi Google Ads
- **Poročanje o kampanjah** – prenesi podatke o uspešnosti kampanj v nadzorne plošče Tajo
- **Sledenje GCLID** – zajemi ID-je klikov Google za pripisovanje konverzij brez spleta
- **Podatki za pametno licitiranje** – vrni vrednostne podatke o konverzijah v Google za optimizacijo ponudb
- **Sinhronizacija obrazcev za potencialne stranke** – uvozi oddaje obrazcev za potencialne stranke iz Google Ads v stike Brevo

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Google Ads z omogočenim dostopom do API
2. Projekt Google Cloud z omogočenim Google Ads API
3. Poverilnice OAuth 2.0 (ID odjemalca in skrivnost odjemalca)
4. Razvijalski žeton Google Ads (prijavi se na [Google Ads API Center](https://ads.google.com/aw/apicenter))
5. Brevo račun z dostopom do API
6. Tajo račun s poverilnicami API

## Avtentikacija

### OAuth 2.0

Google Ads API za avtentikacijo uporablja OAuth 2.0. Prek toka soglasja OAuth moraš pridobiti žeton za osvežitev.

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

### Razvijalski žeton

Razvijalski žeton je zahtevan za vse zahtevke Google Ads API in ga mora odobriti 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"
```

## Konfiguracija

### Osnovna nastavitev

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

### Konfiguracija Customer Match

Naloži stike Brevo kot občinstva 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
```

### Uvoz konverzij brez spleta

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

## Končne točke API

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Iskanje kampanj in virov (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Pretakanje rezultatov iskanja |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Ustvarjanje naloge za nalaganje Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Nalaganje konverzij klikov |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Nalaganje konverzij klicev |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Pridobi proračune kampanj |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Upravljanje seznamov strank |

## Primeri kode

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

### Nalaganje občinstva 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'
});
```

### Uvoz konverzij brez spleta

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

### Poizvedba uspešnosti kampanj (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 });
```

## Omejitve hitrosti

| Vir | Omejitev | Podrobnosti |
| --- | --- | --- |
| **Zahtevki API** | 15.000/dan | Na razvijalski žeton |
| **Operacije mutiranja** | 10.000/dan | Na račun stranke |
| **Poizvedbe GAQL** | 1.500/dan | Na račun stranke |
| **Nalaganja Customer Match** | 10 nalog/dan | Na seznam strank |
| **Nalaganja konverzij** | 2.000/zahtevek | Na paket nalaganja |
| **Velikost strani** | 10.000 vrstic | Max na iskalni odgovor |

Odobritev razvijalskega žetona

Google Ads API zahteva odobren razvijalski žeton. Prijavi se prek Google Ads API Center v računovodskem računu. Testni računi imajo zmanjšane omejitve hitrosti.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Žeton čaka na pregled | Počakaj na odobritev Google ali uporabi testni račun |
| `CUSTOMER_NOT_FOUND` | Napačen ID stranke | Odstrani pomišljaje iz ID-ja stranke ali preveri računovodski račun |
| Nizka stopnja ujemanja Customer Match | Nezadostni podatki | Vključi več identifikatorjev (e-mail, telefon, ime, poštna številka) |
| Konverzije se ne prikažejo | Okno pripisovanja | Konverzijam lahko traja do 24 ur za obdelavo |
| `OAUTH_TOKEN_EXPIRED` | Neveljaven žeton za osvežitev | Znova se preveri in pridobi nov žeton za osvežitev |
| `PERMISSION_DENIED` | Nezadosten dostop | Preveri raven dostopa API in povezavo računa |

## Najboljše prakse

1. **Uporabi računovodski račun** – upravljaj več računov Ads prek enega računovodskega (MCC) računa
2. **Zgoščuj podatke Customer Match** – vedno zgoščuj OI z SHA-256 pred nalaganjem v Customer Match
3. **Sledi GCLID** – shrani ID-je klikov Google v atribute Brevo za sledenje konverzijam brez spleta
4. **Paketna nalaganja konverzij** – grupiraj konverzije v dnevne pakete namesto nalaganj v realnem času
5. **Za poročanje uporabi GAQL** – za prilagodljivo poročanje o kampanjah izkoristi Google Ads Query Language
6. **Sprljuj stopnje ujemanja** – sledi stopnjam ujemanja občinstva Customer Match in izboljšaj kakovost podatkov
7. **Nastavi Enhanced Conversions** – za natančnejše merjenje konverzij uporabi Enhanced Conversions

## Varnost

- **OAuth 2.0** – varno avtentikacijo na osnovi žetonov z žetoni za osvežitev
- **Zgoščevanje SHA-256** – podatki Customer Match so pred nalaganjem zgoščeni
- **Minimizacija podatkov** – Google se prenašajo samo zahtevana polja
- **Skladnost z Google Cloud** – certificiran po SOC 2, ISO 27001 in GDPR
- **Obsegast dostop** – dovoljenja API obsegana na specifične račune strank
- **Revizijsko beleženje** – vsi zahtevki API zabeleženi v zgodovini sprememb Google Ads

## Povezani viri

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