---
title: "Conector Google Ads"
description: "Ghid complet de integrare Google Ads pentru sincronizarea datelor de campanie, listelor de audiențe și urmăririi conversiilor cu Brevo prin Tajo."
url: https://tajo.io/ro/docs/connectors/marketing/google-ads/
markdown: https://tajo.io/ro/docs/connectors/marketing/google-ads.md
lang: ro-RO
robots: noindex
---

Solicită acces anticipat

Introduceți prenumele și adresa de e-mail profesională. Vă vom trimite un link pentru a confirma cererea de acces la Tajo.

# Conector Google Ads

Starea conectorului: Planificat Încă neconstruit. Tajo nu rulează astăzi acest conector.

| Câmp sursă | Câmp destinație | Valoare exemplu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conectați Google Ads la Brevo prin Tajo pentru a sincroniza audiențele publicitare, a importa datele de conversie și a crea profiluri unificate ale clienților care leagă achiziția plătită de marketingul ciclului de viață.

## Prezentare generală

| Proprietate | Valoare |
| --- | --- |
| **Platformă** | Google Ads |
| **Categorie** | Marketing |
| **Complexitate configurare** | Avansată |
| **Integrare oficială** | Nu |
| **Date sincronizate** | Campanii, Audiențe, Conversii, Clienți |
| **Skilluri disponibile** | 7 |

## Funcționalități

- **Sincronizare Customer Match** - Încărcați listele de contacte Brevo ca audiențe Customer Match în Google Ads
- **Urmărire conversii** - Importați conversii offline din evenimentele Brevo în Google Ads
- **Sincronizare audiențe** - Sincronizare bidirecțională între listele Brevo și audiențele Google Ads
- **Raportare campanii** - Extrageți datele de performanță ale campaniilor în tablourile de bord Tajo
- **Urmărire GCLID** - Capturați ID-urile de clic Google pentru atribuirea conversiilor offline
- **Date Smart Bidding** - Transmiteți înapoi datele valorii conversiei la Google pentru optimizarea licitațiilor
- **Sincronizare formulare lead** - Importați trimiterile formularelor lead Google Ads în contactele Brevo

## Cerințe preliminare

Înainte de a începe, asigurați-vă că aveți:

1. Un cont Google Ads cu acces API activat
2. Un proiect Google Cloud cu API-ul Google Ads activat
3. Credențiale OAuth 2.0 (Client ID și Client Secret)
4. Un Developer Token Google Ads (aplicați la [Google Ads API Center](https://ads.google.com/aw/apicenter))
5. Un cont Brevo cu acces API
6. Un cont Tajo cu credențiale API

## Autentificare

### OAuth 2.0

API-ul Google Ads utilizează OAuth 2.0 pentru autentificare. Trebuie să obțineți un refresh token prin fluxul de consimțământ OAuth.

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

### Developer Token

Un Developer Token este necesar pentru toate cererile API Google Ads și trebuie aprobat de 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"
```

## Configurare

### Configurare de bază

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

### Configurare Customer Match

Încărcați contactele Brevo ca audiențe 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 conversii offline

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

## Puncte finale API

| Metodă | Punct final | Descriere |
| --- | --- | --- |
| `POST` | `/v18/customers/{id}/googleAds:search` | Caută campanii și resurse (GAQL) |
| `POST` | `/v18/customers/{id}/googleAds:searchStream` | Transmite rezultatele căutării în flux |
| `POST` | `/v18/customers/{id}/offlineUserDataJobs:create` | Creează job de încărcare Customer Match |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadClickConversions` | Încarcă conversii offline |
| `POST` | `/v18/customers/{id}/conversionUploads:uploadCallConversions` | Încarcă conversii telefonice |
| `GET` | `/v18/customers/{id}/campaignBudgets` | Obține bugetele campaniei |
| `POST` | `/v18/customers/{id}/customerLists:mutate` | Gestionează listele de clienți |

## Exemple de cod

### Inițializare conector 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'
});
```

### Încărcare audiență 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 conversii offline

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

### Interogare performanță campanie (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 });
```

## Limite de rată

| Resursă | Limită | Detalii |
| --- | --- | --- |
| **Cereri API** | 15.000/zi | Per developer token |
| **Operații mutate** | 10.000/zi | Per cont de client |
| **Interogări GAQL** | 1.500/zi | Per cont de client |
| **Încărcări Customer Match** | 10 joburi/zi | Per listă de clienți |
| **Încărcări conversii** | 2.000/cerere | Per lot de încărcare |
| **Dimensiune pagină** | 10.000 rânduri | Maxim per răspuns de căutare |

Aprobare Developer Token

API-ul Google Ads necesită un Developer Token aprobat. Aplicați prin Google Ads API Center în contul dvs. Manager. Conturile de test au limite de rată reduse.

## Depanare

| Problemă | Cauză | Soluție |
| --- | --- | --- |
| `DEVELOPER_TOKEN_NOT_APPROVED` | Token în așteptarea revizuirii | Așteptați aprobarea Google sau utilizați contul de test |
| `CUSTOMER_NOT_FOUND` | ID client greșit | Eliminați liniuțele din ID-ul clientului sau verificați contul manager |
| Rată de potrivire Customer Match scăzută | Date insuficiente | Includeți mai mulți identificatori (e-mail, telefon, nume, cod poștal) |
| Conversii care nu apar | Fereastră de atribuire | Conversiile pot dura până la 24 de ore pentru procesare |
| `OAUTH_TOKEN_EXPIRED` | Refresh token invalid | Re-autentificați și obțineți un nou refresh token |
| `PERMISSION_DENIED` | Acces insuficient | Verificați nivelul de acces API și legătura contului |

## Bune practici

1. **Utilizați un cont Manager** - Gestionați mai multe conturi Ads printr-un singur cont Manager (MCC)
2. **Hash-uiți datele Customer Match** - Hash SHA-256 întotdeauna PII înainte de încărcarea în Customer Match
3. **Urmăriți GCLID-urile** - Stocați ID-urile de clic Google în atributele Brevo pentru urmărirea conversiilor offline
4. **Grupați încărcările de conversii** - Grupați conversiile în loturi zilnice, nu încărcări în timp real
5. **Utilizați GAQL pentru raportare** - Valorificați Google Ads Query Language pentru raportare flexibilă a campaniilor
6. **Monitorizați ratele de potrivire** - Urmăriți ratele de potrivire ale audiențelor Customer Match și îmbunătățiți calitatea datelor
7. **Configurați Enhanced Conversions** - Utilizați Enhanced Conversions pentru măsurarea mai precisă a conversiilor

## Securitate

- **OAuth 2.0** - Autentificare securizată bazată pe token cu refresh token-uri
- **Hash SHA-256** - Datele Customer Match sunt hash-uite înainte de încărcare
- **Minimizare date** - Numai câmpurile necesare sunt transmise la Google
- **Conformitate Google Cloud** - Conformitate SOC 2, ISO 27001 și GDPR
- **Acces cu scope** - Permisiuni API cu scope pentru conturi de client specifice
- **Jurnalizare audit** - Toate cererile API înregistrate în istoricul modificărilor Google Ads

## Resurse conexe

- [Conector Meta Ads](https://tajo.io/ro/docs/connectors/marketing/meta-ads)
- [Conector Klaviyo](https://tajo.io/ro/docs/connectors/marketing/klaviyo)
- [Conector Brevo](https://tajo.io/ro/docs/connectors/marketing/brevo)
- [Skill Sincronizare clienți](https://tajo.io/ro/docs/skills/data-sync/customer-sync)