Google Ads

Prehľad

Google Ads Connector poskytuje programový prístup k účtom Google Ads cez Google Ads API. Umožňuje agentom a aplikáciám spravovať kampane, získavať reporty, nastavovať bidding stratégie, cielenie, reklamné kreatívy, assety a konverzie.

Konektor je rozdelený do funkčných skupín nástrojov (tools), takže je možné bezpečne riadiť ako read-only analytiku, tak aj zmenové operácie.

Podporované oblasti zahŕňajú:

• reporting a analytiku cez GAQL,
• správu účtov a MCC štruktúr,
• správu kampaní, ad groups a kľúčových slov,
• cielenie, publika a negatívne kľúčové slová,
• tvorbu reklám a správu assetov,
• správu konverzií,
• batch operácie pre veľké množstvo zmien.

Ako používateľ pridá Google Ads konektor

1. Používateľ otvorí Add Connection a vyberie GoogleAds

1. V administrácii prejdite do sekcie Connections / Connected Apps.
2. Kliknite na Add Connection.
3. Vyberte dlaždicu GoogleAds.

2. Používateľ si pripraví Customer ID

Customer ID je identifikátor Google Ads účtu, ktorý budete vyplňovať do konektora.

Ako ho nájsť:

1. Prihláste sa do Google Ads.
2. V zozname účtov alebo v hornej lište otvorte účet, ktorý chcete pripojiť.
3. Skopírujte Customer ID správcu účtu (zvyčajne formát 123-456-7890).

3. Používateľ si pripraví Developer Token

Developer Token získate v Google Ads, ale predtým musíte mať účet správcu (Manager Account, MCC).

Najprv vytvorte MCC účet: Založiť účet správcu.

Ako získať Developer Token:

1. Prihláste sa do Manager Account (MCC).
2. Otvorte Admin sekciu.
3. Prejdite do API Center (v SK rozhraní Centrum rozhraní API).
4. Skopírujte hodnotu Developer token.

Video návod k Developer Tokenu:

Priamy odkaz na video: YouTube.

4. Používateľ vyplní detail konektora

Vo formulári Detail vyplní:

• Name: interný názov pripojenia (napr. GoogleAds).
• Provide your Customer Id: Customer ID účtu.
• Provide your Developer Token: Developer Token z API Center.

5. Používateľ konektor uloží a nastaví oprávnenia funkcií

Po vytvorení pripojenia nastavte u jednotlivých funkcií režim volania:

• Enabled,
• Enabled with confirmation,
• Disabled.

Odporúčanie: meniacie operácie (napr. tvorba kampaní, zmeny bidov, mazanie) nechajte minimálne na Enabled with confirmation.

Funkcie

1. Reporting a analytika

Nástroj	Popis
RunReportAsync	Spúšťa vlastné GAQL dotazy
RunReportStreamAsync	Používa SearchStream pre veľké reporty
GetCampaignPerformanceAsync	Vracia metriky výkonu kampane pre dané obdobie
ListPolicyDiagnosticsAsync	Vracia diagnostiku reklamných politík a stav schválenia reklám

GAQL (Google Ads Query Language) slúži pre štruktúrované dotazovanie nad dátami Google Ads. RunReportStreamAsync je vhodný pre väčšie objemy dát.

2. Správa účtov a zákazníkov

Nástroj	Popis
ListAccessibleCustomersAsync	Vracia zoznam všetkých účtov dostupných prihlásenému používateľovi
ListManagedCustomersAsync	Vracia zoznam klientských účtov pod MCC
RunReportAcrossAccountsAsync	Spúšťa GAQL report cez viac účtov

Tieto nástroje sa používajú hlavne v MCC prostredí, kde agentúra spravuje viac účtov.

3. Správa kampaní

Nástroj	Popis
ListCampaignsAsync	Vracia zoznam kampaní okrem odstránených
CreateCampaignAsync	Vytvorí novú kampaň (výchozí stav PAUSED)
CreatePerformanceMaxCampaignAsync	Vytvorí Performance Max kampaň
UpdateCampaignStatusAsync	Zapne, pozastaví alebo odstráni kampaň
UpdateCampaignBudgetAsync	Aktualizuje denný rozpočet kampane

Nové kampane sú v stave PAUSED, aby nedošlo k nechcenému spusteniu reklamy.

4. Správa bidding stratégií

Nástroj	Popis
UpdateCampaignBiddingStrategyAsync	Zmení bidding stratégiu kampane

Podporované stratégie:

• MANUAL_CPC,
• Target CPA (tCPA),
• Target ROAS (tROAS),
• Maximize Conversions,
• Maximize Conversion Value.

5. Správa reklamných zostáv (Ad Groups)

Nástroj	Popis
ListAdGroupsAsync	Vracia zoznam ad groups (možno filtrovať podľa kampane)
CreateAdGroupAsync	Vytvorí novú ad group v kampani
UpdateAdGroupStatusAsync	Zapne, pozastaví alebo odstráni ad group
UpdateAdGroupBidAsync	Aktualizuje výchozí CPC bid

6. Správa kľúčových slov

Nástroj	Popis
ListKeywordsAsync	Vracia zoznam kľúčových slov vrátane match typov a bidov
AddKeywordsAsync	Hromadne pridá kľúčové slová
UpdateKeywordStatusAsync	Zapne alebo pozastaví kľúčové slovo
UpdateKeywordBidAsync	Aktualizuje CPC bid
RemoveKeywordAsync	Trvalo odstráni kľúčové slovo

Podporované typy zhody (match types):

• BROAD,
• PHRASE,
• EXACT.

7. Cielenie a negatívne kľúčové slová

Nástroj	Popis
AddCampaignNegativeKeywordsAsync	Pridá negatívne kľúčové slová na úrovni kampane
AddAdGroupNegativeKeywordsAsync	Pridá negatívne kľúčové slová na úrovni ad group
AddCampaignLocationTargetsAsync	Pridá geografické cielenie cez location constant ID
AddCampaignLanguageTargetsAsync	Pridá jazykové cielenie
AddCampaignDeviceTargetAsync	Pridá alebo vylúči cielenie podľa zariadenia
AddCampaignAdScheduleTargetAsync	Nastaví časový rozvrh zobrazovania reklám
AddCampaignAudienceTargetsAsync	Pridá cielenie na publikum alebo user list
UpdateCampaignCriterionStatusAsync	Aktualizuje stav cielenia
RemoveCampaignCriterionAsync	Odstráni cielenie na úrovni kampane
RemoveAdGroupCriterionAsync	Odstráni cielenie na úrovni ad group

8. Správa reklám

Nástroj	Popis
CreateResponsiveSearchAdAsync	Vytvorí Responsive Search Ad
UpdateAdStatusAsync	Zapne alebo pozastaví reklamu

Požiadavky pre Responsive Search Ad:

• nadpisy: 3-15,
• popisy: 2-4.

9. Správa Asset Groups

Nástroj	Popis
ListAssetGroupsAsync	Vracia zoznam asset groups
CreateAssetGroupAsync	Vytvorí novú asset group
UpdateAssetGroupStatusAsync	Aktualizuje stav asset group

Táto oblasť sa používa hlavne u Performance Max kampaní.

10. Reklamné rozšírenia (Assets)

Nástroj	Popis
CreateSitelinkAssetAsync	Vytvorí sitelink rozšírenie
CreateCalloutAssetAsync	Vytvorí callout rozšírenie
CreateStructuredSnippetAssetAsync	Vytvorí structured snippet
LinkAssetToCampaignAsync	Pripojí asset ku kampani
UpdateCampaignAssetStatusAsync	Aktualizuje stav prepojenia assetu

11. Sledovanie konverzií

Nástroj	Popis
CreateConversionActionAsync	Vytvorí konverznú akciu (web alebo offline)
UpdateConversionActionStatusAsync	Aktivuje, skryje alebo odstráni konverznú akciu
RemoveConversionActionAsync	Trvalo odstráni konverznú akciu
UploadOfflineClickConversionAsync	Nahraje offline konverzie pomocou GCLID

Offline konverzie vyžadujú:

• GCLID,
• conversion action,
• čas konverzie,
• hodnotu konverzie (voliteľné).

12. Batch operácie

Nástroj	Popis
CreateBatchJobAsync	Vytvorí batch job
AddKeywordOperationsToBatchJobAsync	Pridá operácie s kľúčovými slovami do fronty
RunBatchJobAsync	Spustí batch job
ListBatchJobResultsAsync	Vrátí výsledky batch operácie
RemoveBatchJobAsync	Odstráni batch job

Typické použitie batch operácií:

• import veľkého množstva kľúčových slov,
• hromadné úpravy bidov,
• aktualizácie kampaní vo veľkom rozsahu.

Bezpečnosť a odporúčané postupy

Aby sa znížilo riziko nechcených nákladov alebo chýb:

• nové kampane vytvárajte v stave PAUSED,
• veľké zmeny vykonávajte cez Batch Jobs,
• pred zmenami validujte rozpočty, bidding stratégie a cielenie,
• mazacie operácie držte na režime Enabled with confirmation.

Typické scenáre automatizácie

Google Ads Connector možno využiť napríklad pre:

• automatické generovanie reportov výkonu kampaní,
• tvorbu a priebežnú optimalizáciu kampaní,
• úpravy bidding stratégie podľa výkonových dát,
• detekciu problémov s reklamnými politikami,
• rozširovanie zoznamu kľúčových slov,
• upload offline konverzií,
• správu viac účtov v MCC prostredí.