---
title: "Google Ads Konektor"
description: "Kompletan vodič za integraciju Google Adsa za sinkronizaciju podataka o kampanjama, popisa publika i praćenja konverzija s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/hr/docs/connectors/marketing/google-ads.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Google Ads Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite Google Ads s Brevom putem Taja kako biste sinkronizirali reklamne publike, uvezli podatke o konverzijama i kreirali ujedinjene korisničke profile koji premošćuju plaćeno stjecanje s marketingom životnog ciklusa.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Google Ads |
| **Kategorija** | Marketing |
| **Složenost postavljanja** | Napredno |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Kampanje, Publike, Konverzije, Kupci |
| **Dostupne vještine** | 7 |

## Značajke

- **Sinkronizacija Customer Match** - Učitajte Brevo popise kontakata u Google Ads kao Customer Match publike
- **Praćenje konverzija** - Uvezite offline konverzije iz Brevo događaja u Google Ads
- **Sinkronizacija publike** - Dvosmjerna sinkronizacija između Brevo popisa i Google Ads publika
- **Izvješćivanje o kampanjama** - Povucite podatke o performansama kampanje u Tajo dashboardove
- **Praćenje GCLID-a** - Hvatanje Google Click ID-ova za atribuciju offline konverzija
- **Podaci pametnog licitiranja** - Proslijedite vrijednost konverzija natrag Googleu za optimizaciju ponuda
- **Sinkronizacija obrazaca za potencijalne klijente** - Uvezite Google Ads prijave obrazaca za potencijalne klijente u Brevo kontakte

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Google Ads račun s omogućenim API pristupom
2. Google Cloud projekt s omogućenim Google Ads API-jem
3. OAuth 2.0 vjerodajnice (Client ID i Client Secret)
4. Google Ads Developer Token (prijavite se na [Google Ads API Center](https://ads.google.com/aw/apicenter))
5. Brevo račun s API pristupom
6. Tajo račun s API vjerodajnicama

## Autentifikacija

### OAuth 2.0

Google Ads API koristi OAuth 2.0 za autentifikaciju. Morate dobiti token za osvježavanje putem OAuth tijeka suglasnosti.

```bash
# Potrebni OAuth opsezi
https://www.googleapis.com/auth/adwords
```

### Developer Token

Developer Token je potreban za sve Google Ads API zahtjeve i mora biti odobren od strane Googlea.

```bash
# Postavljanje zaglavlja autentifikacije
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 konfiguracija

```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"  # Upravljački račun (opcionalno)

    # Opcije sinkronizacije podataka
    sync:
      customer_match: true
      conversions: true
      campaigns: true
      lead_forms: true

    # Praćenje konverzija
    conversions:
      action_id: "123456789"
      default_currency: "USD"
```

### Konfiguracija Customer Match

Učitajte Brevo kontakte kao Google Ads publike:

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

  # Polja za podudaranje podataka
  match_fields:
    - email
    - phone
    - first_name
    - last_name
    - country_code
    - zip_code

  # Raspored sinkronizacije
  schedule: "daily"
  sync_mode: "mirror"  # mirror, append ili remove
```

### Uvoz offline konverzija

```yaml
conversion_import:
  enabled: true
  conversion_action: "purchase"
  gclid_attribute: "GCLID"  # Brevo atribut koji pohranjuje 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 krajnje točke

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Pretraživanje kampanja i resursa (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Strujanje rezultata pretraživanja |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Kreiraj zadatak učitavanja Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Učitaj offline konverzije |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Učitaj konverzije poziva |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Dohvati budžete kampanje |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Upravljaj popisima korisnika |

## Primjeri koda

### Inicijalizacija 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
});

// Povežite Google Ads račun
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'
});
```

### Učitavanje Customer Match publike

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

### Uvoz offline konverzija

```javascript
// Učitaj offline konverzije iz Brevo događaja narudžbi
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'
    }
  ]
});
```

### Upit o performansama kampanje (GAQL)

```javascript
// Upitajte metrike kampanje koristeći 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 });
```

## Ograničenja brzine

| Resurs | Ograničenje | Detalji |
| --- | --- | --- |
| **API zahtjevi** | 15.000/dan | Po developer tokenu |
| **Mutate operacije** | 10.000/dan | Po korisničkom računu |
| **GAQL upiti** | 1.500/dan | Po korisničkom računu |
| **Customer Match učitavanja** | 10 zadataka/dan | Po popisu korisnika |
| **Učitavanja konverzija** | 2.000/zahtjev | Po seriji učitavanja |
| **Veličina stranice** | 10.000 redova | Maks. po odgovoru pretraživanja |

Odobrenje Developer Tokena

Google Ads API zahtijeva odobreni Developer Token. Prijavite se putem Google Ads API Centra u vašem upravljačkom računu. Testni računi imaju smanjena ograničenja brzine.

## Rješavanje problema

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token čeka na pregled | Pričekajte Googleovo odobrenje ili koristite testni račun |
| `CUSTOMER_NOT_FOUND` | Pogrešan ID korisnika | Uklonite crtice iz ID-a korisnika ili provjerite upravljački račun |
| Nizak postotak podudaranja Customer Match | Nedovoljno podataka | Uključite više identifikatora (e-mail, telefon, ime, poštanski broj) |
| Konverzije se ne pojavljuju | Prozor atribucije | Konverzijama može trebati do 24 sata za obradu |
| `OAUTH_TOKEN_EXPIRED` | Token za osvježavanje nevažeći | Ponovo autentificirajte i dobijte novi token za osvježavanje |
| `PERMISSION_DENIED` | Nedovoljan pristup | Provjerite razinu API pristupa i povezivanje računa |

## Preporučene prakse

1. **Koristite upravljački račun** - Upravljajte višestrukim Ads računima putem jednog upravljačkog (MCC) računa
2. **Hashirajte Customer Match podatke** - Uvijek SHA-256 hashirajte PII prije učitavanja u Customer Match
3. **Pratite GCLID-ove** - Pohranite Google Click ID-ove u Brevo atribute za praćenje offline konverzija
4. **Skupna učitavanja konverzija** - Grupiranje konverzija u dnevne serije umjesto učitavanja u stvarnom vremenu
5. **Koristite GAQL za izvješćivanje** - Iskoristite Google Ads Query Language za fleksibilno izvješćivanje o kampanjama
6. **Pratite stope podudaranja** - Pratite stope podudaranja Customer Match publike i poboljšajte kvalitetu podataka
7. **Postavite poboljšane konverzije** - Koristite Enhanced Conversions za preciznije mjerenje konverzija

## Sigurnost

- **OAuth 2.0** - Sigurna autentifikacija temeljena na tokenima s tokenima za osvježavanje
- **SHA-256 hashiranje** - Customer Match podaci se hashiraju prije učitavanja
- **Minimizacija podataka** - Samo potrebna polja se prenose Googleu
- **Usklađenost Google Clouda** - SOC 2, ISO 27001 i GDPR usklađeno
- **Opseženi pristup** - API dozvole opsežene na specifične korisničke račune
- **Revizijsko zapisivanje** - Svi API zahtjevi zapisani u Google Ads povijesti promjena

## Povezani resursi

- [Meta Ads Konektor](https://tajo.io/hr/docs/connectors/marketing/meta-ads)
- [Klaviyo Konektor](https://tajo.io/hr/docs/connectors/marketing/klaviyo)
- [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)