Google Ads

Přehled

Google Ads Connector poskytuje programový přístup k účtům Google Ads přes Google Ads API. Umožňuje agentům a aplikacím spravovat kampaně, získávat reporty, nastavovat bidding strategie, cílení, reklamní kreativy, assety a konverze.

Konektor je rozdělený do funkčních skupin nástrojů (tools), takže je možné bezpečně řídit jak read-only analytiku, tak i změnové operace.

Podporované oblasti zahrnují:

• reporting a analytiku přes GAQL,
• správu účtů a MCC struktur,
• správu kampaní, ad groups a klíčových slov,
• cílení, publika a negativní klíčová slova,
• tvorbu reklam a správu assetů,
• správu konverzí,
• batch operace pro velké množství změn.

Jak uživatel přidá Google Ads connector

1. Uživatel otevře Add Connection a vybere GoogleAds

1. V administraci přejděte do sekce Connections / Connected Apps.
2. Klikněte na Add Connection.
3. Vyberte dlaždici GoogleAds.

2. Uživatel si připraví Customer ID

Customer ID je identifikátor Google Ads účtu, který budete vyplňovat do konektoru.

Jak ho najít:

1. Přihlaste se do Google Ads.
2. V seznamu účtů nebo v horní liště otevřete účet, který chcete připojit.
3. Zkopírujte Customer ID správce učtu (obvykle formát 123-456-7890).

3. Uživatel si připraví Developer Token

Developer Token získáte v Google Ads, ale předtím musíte mít účet správce (Manager Account, MCC).

Nejdřív vytvořte MCC účet: Založit účet správce.

Jak získat Developer Token:

1. Přihlaste se do Manager Account (MCC).
2. Otevřete Admin sekci.
3. Přejděte do API Center (v CZ rozhraní Centrum rozhraní API).
4. Zkopírujte hodnotu Developer token.

Video návod k Developer Tokenu:

Přímý odkaz na video: YouTube.

4. Uživatel vyplní detail konektoru

Ve formuláři Detail vyplní:

• Name: interní název připojení (např. GoogleAds).
• Provide your Customer Id: Customer ID účtu vkládejte bez pomlček (formát 1234567890). .
• Provide your Developer Token: Developer Token z API Center.

5. Uživatel konektor uloží a nastaví oprávnění funkcí

Po vytvoření připojení nastavte u jednotlivých funkcí režim volání:

• Enabled,
• Enabled with confirmation,
• Disabled.

Doporučení: měnící operace (např. tvorba kampaní, změny bidů, mazání) nechte minimálně na Enabled with confirmation.

Funkce

1. Reporting a analytika

Nástroj	Popis
RunReportAsync	Spouští vlastní GAQL dotazy
RunReportStreamAsync	Používá SearchStream pro velké reporty
GetCampaignPerformanceAsync	Vrací metriky výkonu kampaně pro dané období
ListPolicyDiagnosticsAsync	Vrací diagnostiku reklamních politik a stav schválení reklam

GAQL (Google Ads Query Language) slouží pro strukturované dotazování nad daty Google Ads. RunReportStreamAsync je vhodný pro větší objemy dat.

2. Správa účtů a zákazníků

Nástroj	Popis
ListAccessibleCustomersAsync	Vrací seznam všech účtů dostupných přihlášenému uživateli
ListManagedCustomersAsync	Vrací seznam klientských účtů pod MCC
RunReportAcrossAccountsAsync	Spouští GAQL report přes více účtů

Tyto nástroje se používají hlavně v MCC prostředí, kde agentura spravuje více účtů.

3. Správa kampaní

Nástroj	Popis
ListCampaignsAsync	Vrací seznam kampaní kromě odstraněných
CreateCampaignAsync	Vytvoří novou kampaň (výchozí stav PAUSED)
CreatePerformanceMaxCampaignAsync	Vytvoří Performance Max kampaň
UpdateCampaignStatusAsync	Zapne, pozastaví nebo odstraní kampaň
UpdateCampaignBudgetAsync	Aktualizuje denní rozpočet kampaně

Nové kampaně jsou ve stavu PAUSED, aby nedošlo k nechtěnému spuštění reklamy.

4. Správa bidding strategií

Nástroj	Popis
UpdateCampaignBiddingStrategyAsync	Změní bidding strategii kampaně

Podporované strategie:

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

5. Správa reklamních sestav (Ad Groups)

Nástroj	Popis
ListAdGroupsAsync	Vrací seznam ad groups (lze filtrovat podle kampaně)
CreateAdGroupAsync	Vytvoří novou ad group v kampani
UpdateAdGroupStatusAsync	Zapne, pozastaví nebo odstraní ad group
UpdateAdGroupBidAsync	Aktualizuje výchozí CPC bid

6. Správa klíčových slov

Nástroj	Popis
ListKeywordsAsync	Vrací seznam klíčových slov včetně match typů a bidů
AddKeywordsAsync	Hromadně přidá klíčová slova
UpdateKeywordStatusAsync	Zapne nebo pozastaví klíčové slovo
UpdateKeywordBidAsync	Aktualizuje CPC bid
RemoveKeywordAsync	Trvale odstraní klíčové slovo

Podporované typy shody (match types):

• BROAD,
• PHRASE,
• EXACT.

7. Cílení a negativní klíčová slova

Nástroj	Popis
AddCampaignNegativeKeywordsAsync	Přidá negativní klíčová slova na úrovni kampaně
AddAdGroupNegativeKeywordsAsync	Přidá negativní klíčová slova na úrovni ad group
AddCampaignLocationTargetsAsync	Přidá geografické cílení přes location constant ID
AddCampaignLanguageTargetsAsync	Přidá jazykové cílení
AddCampaignDeviceTargetAsync	Přidá nebo vyloučí cílení podle zařízení
AddCampaignAdScheduleTargetAsync	Nastaví časový rozvrh zobrazování reklam
AddCampaignAudienceTargetsAsync	Přidá cílení na publikum nebo user list
UpdateCampaignCriterionStatusAsync	Aktualizuje stav cílení
RemoveCampaignCriterionAsync	Odstraní cílení na úrovni kampaně
RemoveAdGroupCriterionAsync	Odstraní cílení na úrovni ad group

8. Správa reklam

Nástroj	Popis
CreateResponsiveSearchAdAsync	Vytvoří Responsive Search Ad
UpdateAdStatusAsync	Zapne nebo pozastaví reklamu

Požadavky pro Responsive Search Ad:

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

9. Správa Asset Groups

Nástroj	Popis
ListAssetGroupsAsync	Vrací seznam asset groups
CreateAssetGroupAsync	Vytvoří novou asset group
UpdateAssetGroupStatusAsync	Aktualizuje stav asset group

Tato oblast se používá hlavně u Performance Max kampaní.

10. Reklamní rozšíření (Assets)

Nástroj	Popis
CreateSitelinkAssetAsync	Vytvoří sitelink rozšíření
CreateCalloutAssetAsync	Vytvoří callout rozšíření
CreateStructuredSnippetAssetAsync	Vytvoří structured snippet
LinkAssetToCampaignAsync	Připojí asset ke kampani
UpdateCampaignAssetStatusAsync	Aktualizuje stav propojení assetu

11. Sledování konverzí

Nástroj	Popis
CreateConversionActionAsync	Vytvoří konverzní akci (web nebo offline)
UpdateConversionActionStatusAsync	Aktivuje, skryje nebo odstraní konverzní akci
RemoveConversionActionAsync	Trvale odstraní konverzní akci
UploadOfflineClickConversionAsync	Nahraje offline konverze pomocí GCLID

Offline konverze vyžadují:

• GCLID,
• conversion action,
• čas konverze,
• hodnotu konverze (volitelné).

12. Batch operace

Nástroj	Popis
CreateBatchJobAsync	Vytvoří batch job
AddKeywordOperationsToBatchJobAsync	Přidá operace s klíčovými slovy do fronty
RunBatchJobAsync	Spustí batch job
ListBatchJobResultsAsync	Vrátí výsledky batch operace
RemoveBatchJobAsync	Odstraní batch job

Typické použití batch operací:

• import velkého množství klíčových slov,
• hromadné úpravy bidů,
• aktualizace kampaní ve velkém rozsahu.

Bezpečnost a doporučené postupy

Aby se snížilo riziko nechtěných nákladů nebo chyb:

• nové kampaně vytvářejte ve stavu PAUSED,
• velké změny provádějte přes Batch Jobs,
• před změnami validujte rozpočty, bidding strategie a cílení,
• mazací operace držte na režimu Enabled with confirmation.

Typické scénáře automatizace

Google Ads Connector lze využít například pro:

• automatické generování reportů výkonu kampaní,
• tvorbu a průběžnou optimalizaci kampaní,
• úpravy bidding strategie podle výkonových dat,
• detekci problémů s reklamními politikami,
• rozšiřování seznamu klíčových slov,
• upload offline konverzí,
• správu více účtů v MCC prostředí.