Google Ads

Oversikt

Google Ads Connector gir programmatisk tilgang til Google Ads-kontoer via Google Ads API. Det lar agenter og applikasjoner administrere kampanjer, hente rapporter, sette budstrategier, målretting, annonsekreativer, eiendeler og konverteringer.

Konnektoren er delt inn i funksjonelle grupper av verktøy, slik at det er mulig å trygt styre både read-only analyse og endringsoperasjoner.

Støttede områder inkluderer:

• rapportering og analyse via GAQL,
• administrasjon av kontoer og MCC-strukturer,
• administrasjon av kampanjer, annonsegrupper og søkeord,
• målretting, publikum og negative søkeord,
• oppretting av annonser og administrasjon av eiendeler,
• administrasjon av konverteringer,
• batchoperasjoner for store mengder endringer.

Hvordan brukeren legger til Google Ads-connector

1. Brukeren åpner Legg til tilkobling og velger GoogleAds

1. I administrasjonen går du til seksjonen Connections / Connected Apps.
2. Klikk på Add Connection.
3. Velg flisen GoogleAds.

2. Brukeren forbereder Customer ID

Customer ID er identifikatoren for Google Ads-kontoen som du skal fylle ut i konnektoren.

Slik finner du den:

1. Logg inn på Google Ads.
2. I kontolisten eller i toppmenyen åpner du kontoen du vil koble til.
3. Kopier Customer ID for administratorkontoen (vanligvis formatet 123-456-7890).

3. Brukeren forbereder Developer Token

Developer Token får du i Google Ads, men først må du ha en administratorkonto (Manager Account, MCC).

Først oppretter du en MCC-konto: Opprett administratorkonto.

Slik får du Developer Token:

1. Logg inn på Manager Account (MCC).
2. Åpne Admin-seksjonen.
3. Gå til API Center (i CZ-grensesnittet Centrum rozhraní API).
4. Kopier verdien Developer token.

Videoguide til Developer Token:

Direkte lenke til video: YouTube.

4. Brukeren fyller ut detaljene for konnektoren

I skjemaet Detail fyller du ut:

• Name: intern navn på tilkoblingen (f.eks. GoogleAds).
• Provide your Customer Id: Customer ID for kontoen.
• Provide your Developer Token: Developer Token fra API Center.

5. Brukeren lagrer konnektoren og setter tillatelser for funksjoner

Etter å ha opprettet tilkoblingen, sett opp anropsmodus for de enkelte funksjonene:

• Enabled,
• Enabled with confirmation,
• Disabled.

Anbefaling: La endringsoperasjoner (f.eks. oppretting av kampanjer, endringer i bud, sletting) være minst på Enabled with confirmation.

Funksjoner

1. Rapportering og analyse

Verktøy	Beskrivelse
RunReportAsync	Kjører egne GAQL-spørringer
RunReportStreamAsync	Bruker SearchStream for store rapporter
GetCampaignPerformanceAsync	Returnerer ytelsesmetrikker for kampanjen for en gitt periode
ListPolicyDiagnosticsAsync	Returnerer diagnose av annonsepolitikk og status for godkjenning av annonser

GAQL (Google Ads Query Language) brukes for strukturert spørring over data fra Google Ads. RunReportStreamAsync er egnet for større datamengder.

2. Administrasjon av kontoer og kunder

Verktøy	Beskrivelse
ListAccessibleCustomersAsync	Returnerer en liste over alle kontoer tilgjengelig for den innloggede brukeren
ListManagedCustomersAsync	Returnerer en liste over klientkontoer under MCC
RunReportAcrossAccountsAsync	Kjører GAQL-rapport over flere kontoer

Disse verktøyene brukes hovedsakelig i MCC-miljøet, der byrået administrerer flere kontoer.

3. Administrasjon av kampanjer

Verktøy	Beskrivelse
ListCampaignsAsync	Returnerer en liste over kampanjer bortsett fra slettede
CreateCampaignAsync	Oppretter en ny kampanje (standardstatus PAUSED)
CreatePerformanceMaxCampaignAsync	Oppretter en Performance Max-kampanje
UpdateCampaignStatusAsync	Slår på, pauser eller sletter kampanjen
UpdateCampaignBudgetAsync	Oppdaterer den daglige kampanjebudsjettet

Nye kampanjer er i status PAUSED for å unngå utilsiktet oppstart av annonser.

4. Administrasjon av budstrategier

Verktøy	Beskrivelse
UpdateCampaignBiddingStrategyAsync	Endrer budstrategien for kampanjen

Støttede strategier:

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

5. Administrasjon av annonsegrupper (Ad Groups)

Verktøy	Beskrivelse
ListAdGroupsAsync	Returnerer en liste over annonsegrupper (kan filtreres etter kampanje)
CreateAdGroupAsync	Oppretter en ny annonsegruppe i kampanjen
UpdateAdGroupStatusAsync	Slår på, pauser eller sletter annonsegruppen
UpdateAdGroupBidAsync	Oppdaterer standard CPC-bud

6. Administrasjon av søkeord

Verktøy	Beskrivelse
ListKeywordsAsync	Returnerer en liste over søkeord inkludert matchtyper og bud
AddKeywordsAsync	Legger til søkeord i bulk
UpdateKeywordStatusAsync	Slår på eller pauser søkeordet
UpdateKeywordBidAsync	Oppdaterer CPC-bud
RemoveKeywordAsync	Fjerner søkeordet permanent

Støttede matchtyper:

• BROAD,
• PHRASE,
• EXACT.

7. Målretting og negative søkeord

Verktøy	Beskrivelse
AddCampaignNegativeKeywordsAsync	Legger til negative søkeord på kampanjenivå
AddAdGroupNegativeKeywordsAsync	Legger til negative søkeord på annonsegruppenivå
AddCampaignLocationTargetsAsync	Legger til geografisk målretting via location constant ID
AddCampaignLanguageTargetsAsync	Legger til språkmålretting
AddCampaignDeviceTargetAsync	Legger til eller ekskluderer målretting etter enhet
AddCampaignAdScheduleTargetAsync	Setter opp tidsplan for visning av annonser
AddCampaignAudienceTargetsAsync	Legger til målretting mot publikum eller brukerlist
UpdateCampaignCriterionStatusAsync	Oppdaterer status for målretting
RemoveCampaignCriterionAsync	Fjerner målretting på kampanjenivå
RemoveAdGroupCriterionAsync	Fjerner målretting på annonsegruppenivå

8. Administrasjon av annonser

Verktøy	Beskrivelse
CreateResponsiveSearchAdAsync	Oppretter Responsive Search Ad
UpdateAdStatusAsync	Slår på eller pauser annonsen

Krav for Responsive Search Ad:

• overskrifter: 3-15,
• beskrivelser: 2-4.

9. Administrasjon av Asset Groups

Verktøy	Beskrivelse
ListAssetGroupsAsync	Returnerer en liste over asset groups
CreateAssetGroupAsync	Oppretter en ny asset group
UpdateAssetGroupStatusAsync	Oppdaterer status for asset group

Dette området brukes hovedsakelig for Performance Max-kampanjer.

10. Annonseutvidelser (Assets)

Verktøy	Beskrivelse
CreateSitelinkAssetAsync	Oppretter sitelink-utvidelse
CreateCalloutAssetAsync	Oppretter callout-utvidelse
CreateStructuredSnippetAssetAsync	Oppretter structured snippet
LinkAssetToCampaignAsync	Knytter eiendel til kampanjen
UpdateCampaignAssetStatusAsync	Oppdaterer status for tilknytning av eiendel

11. Konverteringssporing

Verktøy	Beskrivelse
CreateConversionActionAsync	Oppretter en konverteringshandling (nett eller offline)
UpdateConversionActionStatusAsync	Aktiverer, skjuler eller fjerner konverteringshandlingen
RemoveConversionActionAsync	Fjerner konverteringshandlingen permanent
UploadOfflineClickConversionAsync	Laster opp offline konverteringer ved hjelp av GCLID

Offline konverteringer krever:

• GCLID,
• conversion action,
• konverteringstidspunkt,
• konverteringsverdi (valgfritt).

12. Batchoperasjoner

Verktøy	Beskrivelse
CreateBatchJobAsync	Oppretter en batchjobb
AddKeywordOperationsToBatchJobAsync	Legger til søkeordoperasjoner i køen
RunBatchJobAsync	Kjører batchjobben
ListBatchJobResultsAsync	Returnerer resultatene fra batchoperasjonen
RemoveBatchJobAsync	Fjerner batchjobben

Typisk bruk av batchoperasjoner:

• import av store mengder søkeord,
• masseendringer av bud,
• oppdatering av kampanjer i stor skala.

Sikkerhet og beste praksis

For å redusere risikoen for utilsiktede kostnader eller feil:

• opprett nye kampanjer i status PAUSED,
• gjør store endringer via Batch Jobs,
• valider budsjetter, budstrategier og målretting før endringer,
• hold slettingsoperasjoner på modus Enabled with confirmation.

Typiske automatiseringsscenarier

Google Ads Connector kan brukes til for eksempel:

• automatisk generering av rapporter om kampanjeytelse,
• oppretting og kontinuerlig optimalisering av kampanjer,
• justering av budstrategier basert på ytelsesdata,
• oppdagelse av problemer med annonsepolitikk,
• utvidelse av listen over søkeord,
• opplasting av offline konverteringer,
• administrasjon av flere kontoer i MCC-miljøet.