Google Ads

Yhteenveto

Google Ads Connector tarjoaa ohjelmallisen pääsyn Google Ads -tileihin Google Ads API:n kautta. Se mahdollistaa agenttien ja sovellusten hallita kampanjoita, saada raportteja, asettaa tarjousstrategioita, kohdistuksia, mainosluovia, resursseja ja konversioita.

Konnektori on jaettu toiminnallisiin työkaluryhmiin (tools), joten on mahdollista turvallisesti hallita sekä vain luku -analytiikkaa että muutoksia.

Tuetut alueet sisältävät:

• raportointi ja analytiikka GAQL:n kautta,
• tilien ja MCC-rakenteiden hallinta,
• kampanjoiden, mainosryhmien ja avainsanojen hallinta,
• kohdistus, yleisöt ja negatiiviset avainsanat,
• mainosten luominen ja resurssien hallinta,
• konversioiden hallinta,
• erätoiminnot suurille muutoksille.

Kuinka käyttäjä lisää Google Ads -konnectorin

1. Käyttäjä avaa Add Connection ja valitsee GoogleAds

1. Siirry hallinnassa kohtaan Connections / Connected Apps.
2. Napsauta Add Connection.
3. Valitse laatikko GoogleAds.

2. Käyttäjä valmistaa Customer ID:n

Customer ID on Google Ads -tilin tunniste, jonka täytät konnektorissa.

Kuinka löytää se:

1. Kirjaudu Google Ads -tilille.
2. Avaa tililuettelosta tai ylävalikosta tili, jonka haluat liittää.
3. Kopioi Customer ID -tilin hallitsijalta (yleensä muoto 123-456-7890).

3. Käyttäjä valmistaa Developer Tokenin

Developer Tokenin saat Google Adsista, mutta ennen sitä sinun on oltava hallintotili (Manager Account, MCC).

Ensiksi luo MCC-tili: Luo hallintotili.

Kuinka saada Developer Token:

1. Kirjaudu Manager Account (MCC) -tilille.
2. Avaa Admin-osio.
3. Siirry API Center -osioon (CZ-käyttöliittymässä Centrum rozhraní API).
4. Kopioi Developer token -arvo.

Videon ohje Developer Tokenista:

Suora linkki videoon: YouTube.

4. Käyttäjä täyttää konnektorin tiedot

Detail-lomakkeessa täytä:

• Name: sisäinen liitännän nimi (esim. GoogleAds).
• Provide your Customer Id: tilin Customer ID.
• Provide your Developer Token: Developer Token API Centeristä.

5. Käyttäjä tallentaa konnektorin ja asettaa toimintojen käyttöoikeudet

Liitännän luomisen jälkeen aseta yksittäisten toimintojen kutsumismoodi:

• Enabled,
• Enabled with confirmation,
• Disabled.

Suositus: muutostoiminnot (esim. kampanjoiden luominen, tarjousten muuttaminen, poistaminen) pidä vähintään Enabled with confirmation -tilassa.

Toiminnot

1. Raportointi ja analytiikka

Työkalu	Kuvaus
RunReportAsync	Suorittaa omia GAQL-kyselyjä
RunReportStreamAsync	Käyttää SearchStreamia suurille raporteille
GetCampaignPerformanceAsync	Palauttaa kampanjan suorituskykymittarit tietylle ajanjaksolle
ListPolicyDiagnosticsAsync	Palauttaa mainospolitiikan diagnostiikan ja mainosten hyväksymistilan

GAQL (Google Ads Query Language) on tarkoitettu Google Ads -datan rakenteelliseen kyselyyn. RunReportStreamAsync on sopiva suuremmille datamäärille.

2. Tilien ja asiakkaiden hallinta

Työkalu	Kuvaus
ListAccessibleCustomersAsync	Palauttaa luettelon kaikista kirjautuneelle käyttäjälle saatavilla olevista tileistä
ListManagedCustomersAsync	Palauttaa luettelon asiakastileistä MCC:n alla
RunReportAcrossAccountsAsync	Suorittaa GAQL-raportin useiden tilien yli

Näitä työkaluja käytetään pääasiassa MCC-ympäristössä, jossa toimisto hallitsee useita tilejä.

3. Kampanjoiden hallinta

Työkalu	Kuvaus
ListCampaignsAsync	Palauttaa luettelon kampanjoista, lukuun ottamatta poistettuja
CreateCampaignAsync	Luo uuden kampanjan (oletustila PAUSED)
CreatePerformanceMaxCampaignAsync	Luo Performance Max -kampanjan
UpdateCampaignStatusAsync	Käynnistää, keskeyttää tai poistaa kampanjan
UpdateCampaignBudgetAsync	Päivittää kampanjan päivittäisen budjetin

Uudet kampanjat ovat tilassa PAUSED, jotta mainosten ei tapahdu vahingossa käynnistymistä.

4. Tarjousstrategioiden hallinta

Työkalu	Kuvaus
UpdateCampaignBiddingStrategyAsync	Muuttaa kampanjan tarjousstrategiaa

Tuetut strategiat:

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

5. Mainosryhmien hallinta (Ad Groups)

Työkalu	Kuvaus
ListAdGroupsAsync	Palauttaa luettelon mainosryhmistä (voidaan suodattaa kampanjan mukaan)
CreateAdGroupAsync	Luo uuden mainosryhmän kampanjassa
UpdateAdGroupStatusAsync	Käynnistää, keskeyttää tai poistaa mainosryhmän
UpdateAdGroupBidAsync	Päivittää oletus CPC -tarjouksen

6. Avainsanojen hallinta

Työkalu	Kuvaus
ListKeywordsAsync	Palauttaa luettelon avainsanoista, mukaan lukien vastaavuustyypit ja tarjoukset
AddKeywordsAsync	Lisää avainsanoja suurina erinä
UpdateKeywordStatusAsync	Käynnistää tai keskeyttää avainsanan
UpdateKeywordBidAsync	Päivittää CPC -tarjouksen
RemoveKeywordAsync	Poistaa avainsanan pysyvästi

Tuetut vastaavuustyypit (match types):

• BROAD,
• PHRASE,
• EXACT.

7. Kohdistus ja negatiiviset avainsanat

Työkalu	Kuvaus
AddCampaignNegativeKeywordsAsync	Lisää negatiivisia avainsanoja kampanjan tasolla
AddAdGroupNegativeKeywordsAsync	Lisää negatiivisia avainsanoja mainosryhmän tasolla
AddCampaignLocationTargetsAsync	Lisää maantieteellistä kohdistusta location constant ID:n kautta
AddCampaignLanguageTargetsAsync	Lisää kielikohdistusta
AddCampaignDeviceTargetAsync	Lisää tai poistaa laitekohdistuksen
AddCampaignAdScheduleTargetAsync	Asettaa mainosten näyttöaikataulun
AddCampaignAudienceTargetsAsync	Lisää kohdistuksen yleisölle tai käyttäjälistalle
UpdateCampaignCriterionStatusAsync	Päivittää kohdistuksen tilan
RemoveCampaignCriterionAsync	Poistaa kohdistuksen kampanjan tasolla
RemoveAdGroupCriterionAsync	Poistaa kohdistuksen mainosryhmän tasolla

8. Mainosten hallinta

Työkalu	Kuvaus
CreateResponsiveSearchAdAsync	Luo Responsive Search Ad -mainoksen
UpdateAdStatusAsync	Käynnistää tai keskeyttää mainoksen

Vaatimukset Responsive Search Ad -mainoksille:

• otsikot: 3-15,
• kuvaukset: 2-4.

9. Resurssiryhmien hallinta

Työkalu	Kuvaus
ListAssetGroupsAsync	Palauttaa luettelon resurssiryhmistä
CreateAssetGroupAsync	Luo uuden resurssiryhmän
UpdateAssetGroupStatusAsync	Päivittää resurssiryhmän tilan

Tätä aluetta käytetään pääasiassa Performance Max -kampanjoissa.

10. Mainoslaajennukset (Assets)

Työkalu	Kuvaus
CreateSitelinkAssetAsync	Luo sitelink-laajennuksen
CreateCalloutAssetAsync	Luo callout-laajennuksen
CreateStructuredSnippetAssetAsync	Luo structured snippetin
LinkAssetToCampaignAsync	Liittää resurssin kampanjaan
UpdateCampaignAssetStatusAsync	Päivittää resurssin liitännän tilan

11. Konversioseuranta

Työkalu	Kuvaus
CreateConversionActionAsync	Luo konversiotoiminnon (verkkosivusto tai offline)
UpdateConversionActionStatusAsync	Aktivoi, piilottaa tai poistaa konversiotoiminnon
RemoveConversionActionAsync	Poistaa konversiotoiminnon pysyvästi
UploadOfflineClickConversionAsync	Lataa offline-konversioita GCLID:n avulla

Offline-konversiot vaativat:

• GCLID,
• conversion action,
• konversioaika,
• konversion arvo (valinnainen).

12. Erätoiminnot

Työkalu	Kuvaus
CreateBatchJobAsync	Luo erätyö
AddKeywordOperationsToBatchJobAsync	Lisää avainsanojen toiminnot jonoon
RunBatchJobAsync	Suorittaa erätyön
ListBatchJobResultsAsync	Palauttaa erätoiminnan tulokset
RemoveBatchJobAsync	Poistaa erätyön

Tyypillinen käyttö erätoiminnoille:

• suuren määrän avainsanojen tuonti,
• suurten tarjousmuutosten tekeminen,
• kampanjoiden päivittäminen suuressa mittakaavassa.

Turvallisuus ja suositellut käytännöt

Vähentääksesi ei-toivottujen kustannusten tai virheiden riskiä:

• luo uudet kampanjat tilassa PAUSED,
• tee suuret muutokset erätyökalujen kautta,
• validoi budjetit, tarjousstrategiat ja kohdistukset ennen muutoksia,
• pidä poistotoiminnot tilassa Enabled with confirmation.

Tyypilliset automaatioskenaariot

Google Ads Connectoria voidaan käyttää esimerkiksi:

• kampanjoiden suorituskykyraporttien automaattiseen luomiseen,
• kampanjoiden luomiseen ja jatkuvaan optimointiin,
• tarjousstrategioiden säätämiseen suorituskykytietojen mukaan,
• mainospolitiikkojen ongelmien havaitsemiseen,
• avainsanaluettelon laajentamiseen,
• offline-konversioiden lataamiseen,
• useiden tilien hallintaan MCC-ympäristössä.