---
title: Google Adsi ühendamine
description: Google Adsi konto ühendamine, seisukorra kontroll ja kliendi valik.
category: Marketing
sublabel: Tasuline reklaam
author: Matt Berman
tags: 
license: MIT
source: https://github.com/TheMattBerman/google-ads-copilot
---

# Google Adsi ühendus

See oskus tegeleb torustikuga, et teised oskused saaksid keskenduda strateegiale.

Loe tööala, kui saadaval:
- `workspace/ads/account.md`

---

## Mida see oskus teeb

1. **Seadistuse kontroll** — kontrollib, kas MCP-server on konfigureeritud ja reageeriv
2. **Klientide avastamine** — loetleb kõik ligipääsetavad kontod nimede ja ID-dega
3. **Kliendi valimine** — aitab operaatoril õige konto valida
4. **Konto sõrmejälg** — tõmbab konto põhimetaandmed ja kirjutab tööalasse
5. **Tervisekontroll** — valideerib, et andmed voolavad ja päringud tagastavad tulemusi

---

## Käsud

### `/google-ads connect setup`
Täielik sisseseadmise voog: kontrolli MCP → avasta kontod → vali konto → sõrmejälg.
Kasuta seda esimest korda ühendudes.

### `/google-ads connect healthcheck`
Kiire valideerimine: Kas MCP elus? Konto valitud? Andmed voolavad?
Kasuta seda enne auditit või kui miski tundub katki.

### `/google-ads connect select [customer_id]`
Lülitu teisele kontole. Uuendab tööala mälu.

---

## Samm 1: Kontrolli MCP-serverit

**Test:** Kutsu `list_accessible_customers` google-ads-mcp MCP-serveri kaudu.

**Kui õnnestub:**
```
✅ MCP server is live
   Accessible accounts: N
```

**Kui ebaõnnestub, diagnoosi:**

| Sümptom | Tõenäoline põhjus | Lahendus |
|---------|-------------|-----|
| MCP-tööriista ei leitud | Server pole MCP-hostis konfigureeritud | Lisa konfiguratsioon — vaata `data/mcp-config.md` |
| „No credentials found“ | `GOOGLE_APPLICATION_CREDENTIALS` puudub või vale tee | Kontrolli, et keskkonnamuutuja osutab kehtivale JSON-failile |
| „Developer token not approved“ | Token puudub või ootel | Kontrolli keskkonnamuutujat `GOOGLE_ADS_DEVELOPER_TOKEN` |
| „Project not found“ | Vale projekti ID | **Kasuta `GOOGLE_CLOUD_PROJECT`** (mitte `GOOGLE_PROJECT_ID`) |
| Ühenduse aegumine | pipx või võrgu probleem | Kontrolli, et `pipx` on paigaldatud ja internet töötab |
| „Manager account required“ | Vaja MCC-ligipääsu | Lisa `GOOGLE_ADS_LOGIN_CUSTOMER_ID` |

### Keskkonnamuutujate viide (kanooniline)

| Muutuja | Nõutav | Eesmärk |
|----------|----------|---------|
| `GOOGLE_APPLICATION_CREDENTIALS` | Jah | Tee OAuth/ADC mandaadi JSON-ini |
| `GOOGLE_CLOUD_PROJECT` | Jah | Google Cloudi projekti ID (⚠️ MITTE `GOOGLE_PROJECT_ID`) |
| `GOOGLE_ADS_DEVELOPER_TOKEN` | Jah | Google Adsi API arendajatoken |
| `GOOGLE_ADS_LOGIN_CUSTOMER_ID` | Kui MCC | Halduskonto kliendi ID (ilma kriipsudeta) |

⚠️ **Levinud lõks:** MCP-server kasutab `GOOGLE_CLOUD_PROJECT`, mitte `GOOGLE_PROJECT_ID`. Varasem dokumentatsioon võib viidata valele nimele. `GOOGLE_CLOUD_PROJECT` on õige.

---

## Samm 2: Klientide avastamine

Kutsu `list_accessible_customers`. See tagastab kliendi ID-d ja kirjeldavad nimed.

**Esita valikutabelina:**

```markdown
## Accessible Google Ads Accounts

| # | Customer ID | Descriptive Name | Notes |
|---|-------------|-------------------|-------|
| 1 | 1234567890  | Acme Equipment Co. | |
| 2 | 9876543210  | Metro Recycling LLC | |
| 3 | 1234567890  | [Manager Account] | MCC — not a direct account |

Which account should we work with?
```

### Konto valimise reeglid

1. **Kui ainult üks konto:** Vali see automaatselt, kinnita operaatoriga.
2. **Kui mitu kontot:** Esita tabel ja küsi.
3. **Kui käsus oli antud kliendi ID:** Kasuta seda, kuid kontrolli, et see on ligipääsetavas loendis.
4. **Kui `workspace/ads/account.md`'il on juba kliendi ID:** Maini seda — „Praegu valitud: [Name] ([ID]). Lülitada?“
5. **Halduskontod (MCC):** Märgista need — need on konteinerkontod, mitte reklaamitavad kontod. Ära vali neid analüüsiks, kui operaator seda sõnaselgelt ei palu.

### Nime kontrollimine

**Kriitiline turvakontroll:** Kui operaator küsis konkreetse ettevõtte kohta (nt „auditeeri Acme Equipment“), kontrolli, et kirjeldav nimi klapib:

```
✅ Customer "Acme Equipment Co." (1234567890) matches your request.
```

või

```
⚠️ Warning: You asked about "Acme Equipment" but the closest match is 
   "Metro Recycling LLC" (9876543210). Please confirm this is the right account,
   or provide the correct customer ID.
```

See hoiab ära vale konto auditeerimise — reaalne probleem, mida me reaaltestimisel kohtasime.

---

## Samm 3: Konto sõrmejälg

Kui klient on valitud, tõmba põhimetaandmed:

**Konto ülevaate päring:**
```
Resource: customer
Fields: customer.id, customer.descriptive_name, customer.currency_code, customer.time_zone, customer.auto_tagging_enabled, customer.status
```

**Kampaania kokkuvõtte päring:**
```
Resource: campaign
Fields: campaign.name, campaign.status, campaign.advertising_channel_type
Conditions: campaign.status != 'REMOVED'
```

**Esita sõrmejälg:**

```markdown
## Account Fingerprint

| Field | Value |
|-------|-------|
| Customer ID | 1234567890 |
| Name | Acme Equipment Co. |
| Currency | USD |
| Timezone | America/New_York |
| Auto-tagging | Enabled ✅ |
| Account status | ENABLED |

### Campaigns
| Campaign | Status | Type |
|----------|--------|------|
| Search - Core Services | ENABLED | SEARCH |
| Brand - Acme Equipment | ENABLED | SEARCH |
| PMax - Lead Gen | PAUSED | PERFORMANCE_MAX |

**Active campaigns:** 2 search, 0 PMax
**Total campaigns:** 3 (1 paused)
```

### Konto oleku tõlgendamine

| Olek | Tähendus | Toiming |
|--------|---------|--------|
| ENABLED | Aktiivne, saab reklaame näidata | Jätka analüüsiga |
| SUSPENDED | Arveldus-/poliitikaprobleem, ei näita | Märgista kohe — see on P0 |
| CLOSED | Jäädavalt suletud | Ei saa analüüsida, vaja teist kontot |
| CANCELLED | Kasutaja tühistanud | Ei saa näidata, võib olla taastatav |

**Kui peatatud:** Peatu ja too see esile #1 leiuna. Ükski optimeerimine pole oluline, kui reklaame näidata ei saa. Suuna operaator Google Adsi kasutajaliideses arvelduse ja poliitikakeskuse (Billing ja Policy Center) juurde.

---

## Samm 4: Kirjuta tööalasse

Uuenda `workspace/ads/account.md` sõrmejäljega:

```markdown
## Last Updated
2026-03-14 by /google-ads connect

# Account Profile

## Identity
- Customer ID: 1234567890
- Descriptive Name: Acme Equipment Co.
- Currency: USD
- Timezone: America/New_York
- Account Status: ENABLED
- Auto-tagging: Enabled

## Connection
- Mode: Connected (google-ads-mcp)
- Last verified: 2026-03-14
- Accessible accounts: 3 (selected this one)

## Business
- Business model: [to be filled by audit]
- Industry: [to be filled by audit]
- Primary offer: [to be filled by audit]
- Geo scope: [to be filled by audit]

## Campaign Summary
- Search campaigns: 2 active
- PMax campaigns: 0 active (1 paused)
- Total campaigns: 3

## Notes
- [Any observations from the fingerprint]
```

---

## Samm 5: Tervisekontroll (eraldiseisev või sisseseadmise lõpus)

Käivita kiire andmevoo valideerimine:

1. ✅ MCP-server reageerib käsule `list_accessible_customers`
2. ✅ Valitud kliendi ID on ligipääsetav
3. ✅ Konto metaandmete päring tagastab andmeid
4. ✅ Kampaaniapäring tagastab tulemusi
5. ✅ Vähemalt üks kampaania on ENABLED (või märgi, kui kõik on peatatud/peatatud olekus)
6. ✅ Kuupäevavahemikuga päring tagastab andmeid (test: kampaania mõõdikud LAST_7_DAYS)

**Kui samm 6 tagastab null rida:** Konto võib olla uinunud. See EI OLE tõrge — see on kasulik info. Märgi: „Konto on uinunud — viimase 7 päeva jooksul aktiivsust pole. Analüüsiks on vaja kuupäevavahemiku varuvarianti.“

**Väljund:**
```
## Health Check Results

| Check | Status | Notes |
|-------|--------|-------|
| MCP server | ✅ | Responding |
| Account access | ✅ | CID 1234567890 accessible |
| Account metadata | ✅ | Acme Equipment Co. |
| Campaign data | ✅ | 3 campaigns found |
| Active campaigns | ✅ | 2 ENABLED |
| Recent data (7d) | ⚠️ | No activity — account may be dormant |

**Ready for analysis:** Yes (use date range fallback for dormant periods)
```

---

## Väljundi kuju

1. MCP-serveri olek
2. Ligipääsetavate kontode tabel
3. Valitud konto sõrmejälg
4. Konto olek ja tervisemärgised
5. Tööala mälu uuendamise kinnitus
6. Valmisoleku hinnang järgmisteks sammudeks

## Reeglid
- **Kontrolli alati, et konto nimi klapib operaatori kavatsusega** — vale konto auditid raiskavad kõigi aega
- **Märgi alati konto olek (peatatud/uinunud/aktiivne) silmapaistvalt** — see väravastab kõike muud
- **Kirjuta valik alati tööalasse** — teised oskused sõltuvad failist `account.md`
- **Kasuta kõigis dokumentides ja näidetes `GOOGLE_CLOUD_PROJECT`** — mitte `GOOGLE_PROJECT_ID`
- **Märgista MCC/halduskontod** — neid ei saa otse analüüsida