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:

Keskkonnamuutujate viide (kanooniline)

⚠️ 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:

## 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:

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

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:

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