Leto z Google Ads API-jem: dva trda roka, ostalo je priložnost

Januarja je Google izdal v23 Ads API-ja in napovedal, da bo odtlej nova različica izšla vsak mesec. Prebral sem dvakrat. Dvanajst let pišem kodo proti temu API-ju in večino tega časa je bil počasna površina, ki si jo obiskal enkrat na leto, dvignil številko različice in pozabil.

Potem sem naredil to, česar so me ta leta naučila. Odprl sem našo kodo v Lyntu in poiskal shoppingcontent.googleapis.com. Vsak zadetek je skripta, ki umre 18. avgusta 2026, na dan, ko se ugasne Content API for Shopping. Takoj za njim preži drugi datum. Septembra 2026 vsaka preostala kampanja Dynamic Search Ads samodejno preide na AI Max, pa če to hočeš ali ne.

Ti dve uri sta obveznosti Googlovega API leta. Vse ostalo, kar je platforma izdala, je priložnost. AI storitve za kreative, poročanje o prodaji na ravni izdelka, Merchant API znotraj Google Ads Scripts. Zato bom leto prehodil po prioriteti, najtrši rok najprej. Za vsako spremembo: kaj je, zakaj zadeva tvoj račun in kateri točen klic, payload ali migracijo pognati.

Ničesar ne bom pustil pri “moral bi migrirati”. Rok brez konkretnega artefakta je samo tesnoba. Na vsakem koraku dobiš endpoint, ki nadomešča starega, payload eksperimenta ali poizvedbo GAQL, da natančno vidiš, kaj zgraditi, preden datum pride.

Rok številka ena: Content API for Shopping umre 18. avgusta 2026

To je najtrši datum leta, zato gre prvi.

Kaj se je spremenilo. Content API for Shopping v2.1 se ugasne 18. avgusta 2026. Njegov naslednik, Merchant API v1, je v GA od julija 2025, vmesna v1beta pa je že ugasnila 28. februarja 2026. Stari monolit nadomeščajo osredotočeni pod-API-ji. datasources, products, inventories, reports, notifications.

Zakaj zadeva tvoj račun. Vse, kar se tvojega feeda dotika prek starega API-ja, tisti dan preneha delovati. Nalaganje feedov, dopolnilni feedi, oznake po meri, posodobitve cen in zalog, branje zavrnitev. To ni “lepo bi bilo migrirati”, to je trd rez. Če ti dnevna skripta sinhronizira cene, 18. avgusta utihne in feed počasi odplava od resničnosti, dokler kdo ne opazi izgubljenega prihodka. Ta vzorec odpovedi sem videl na resničnih računih in drago ni nikoli samo izpad, drage so tedne, ko ga nihče ne opazi.

Kaj storiti. Obnovi proti strukturi pod-API-jev. Migracija je mehanska. Spremenijo se gostitelj, pot in model virov, namen ostane. Tu je prej in potem za najpogostejši klic od vseh, upsert izdelka:

# OLD: Content API for Shopping v2.1 (off on 2026-08-18)
curl -X POST \
  "https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "offerId": "SKU-123", "title": "...", "price": {"value":"19.90","currency":"EUR"} }'

# NEW: Merchant API v1 (productInputs sub-API)
curl -X POST \
  "https://merchantapi.googleapis.com/products/v1/accounts/{account}/productInputs:insert?dataSource=accounts/{account}/dataSources/{ds}" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "offerId": "SKU-123", "contentLanguage": "en", "feedLabel": "US",
        "productAttributes": { "title": "...", "price": {"amountMicros":"19900000","currencyCode":"EUR"} } }'

(Gostitelji endpointov in delitev na pod-API-je prihajajo iz Googlove dokumentacije. Točen body zahteve za svoj vir pred objavo preveri v referenci Merchant API, ker so se spremenila imena polj, ne le URL.)

Cilj je odkrito boljši od tega, kar nadomešča, in to je del, ki ti ga nihče ne pove. Tri izboljšave, ki jih z migracijo podeduješ zastonj:

Če se že dolgo pripravljaš utrditi svoja orodja za feede, je ugasnitev prisilni povod. Obnovi enkrat in odidi s čistejšim ravnanjem z napakami in manj krogi, kot jih je v2.1 kdaj dovoljeval.

Rok številka dve: Dynamic Search Ads septembra 2026 postane AI Max

Druga datirana sprememba in tista, ki prerazporedi, koliko nadzora obdržiš.

Kaj se je spremenilo. AI Max for Search je dosegel GA 15. aprila 2026 po beta zagonu maja 2025. Od septembra 2026 Google samodejno prenese na AI Max vse preostale DSA, samodejno ustvarjena sredstva in široko ujemanje na ravni kampanje. Potem nove DSA kampanje ne ustvariš več. Ne v vmesniku, ne v Editorju, ne prek API-ja.

Zakaj zadeva tvoj račun. Kupčija se glasi: nadzor za rast. S celotnim naborom funkcij (ujemanje izrazov plus prilagajanje besedila plus širitev končnih URL-jev) Google navaja približno +7 % konverzij ali vrednosti konverzij v primerjavi z zgolj ujemanjem. V zameno modelu predaš ujemanje, besedila sredstev in izbiro ciljne strani. Če imaš pravila znamke ali skladnosti ročno vgrajena v svoj DSA setup, lahko tihi septembrski prehod začne pošiljati promet na URL-je in besedila, ki jih nikoli nisi odobril. Avtomatizacija, ki je nisi izmeril, je avtomatizacija, ki je ne nadzoruješ.

Kaj storiti. Ne čakaj, da vidiš, kaj bo prehod naredil tvojim številkam. Izmeri zdaj. Google je ograje in merilne kljuke prek API-ja izdal sočasno s funkcijo, zato lahko prehod A/B testiraš na lastnih podatkih, preden postane obvezen:

Praktična poteza je zadnja. Ustvari eksperiment ADOPT_AI_MAX na svojih računih in ga pusti teči. Delto CPA in ROAS prebereš tako, da kampanje eksperimentalne veje primerjaš s kontrolo. Običajna poizvedba GAQL ti nato pokaže, kaj je širitev brez ključnih besed v resnici ujela in zaslužila:

-- After ADOPT_AI_MAX runs: inspect automated expansion performance.
-- Calculate trial/control delta separately from the experiment arm campaigns.
SELECT campaign.name,
       metrics.conversions,
       metrics.conversions_value,
       metrics.cost_micros
FROM targeting_expansion_view
WHERE segments.date DURING LAST_30_DAYS

(ADOPT_AI_MAX je eden od novih tipov eksperimentov iz v24.1; targeting_expansion_view je poročevalski vir iz v22. Razpoložljivost polj preveri v release notes različice, ki jo kličeš.)

Drseči rok: izdaja vsak mesec

Ne en sam datum, ampak ura, ki zdaj tiktaka nenehno.

Kaj se je spremenilo. Od v23 (28. januarja 2026) je Google Ads API prešel na mesečni ritem izdaj. Štiri major različice na leto plus mesečne minor različice, z enim letom podpore na major različico.

Zakaj zadeva tvoj račun. Hitrejši dostop do funkcij in hitrejše zastaranje. Različice se iztečejo po objavljenem koledarju. v20 doseže konec življenjske dobe junija 2026, v21 avgusta, v22 oktobra. Mesečni minor dvig ničesar ne pokvari. Zamujena ugasnitev major različice pomeni, da tvoje skripte začnejo vračati napake brez drugega opozorila kot datuma v koledarju, ki ga nisi spremljal.

Kaj storiti. Pripni svojo različico in spremljaj koledar ugasnitev. Najcenejše zavarovanje je ponavljajoča se preverba, ki ve, katero različico kličeš, in se oglasi približno 60 dni pred iztekom. Vse skupaj je nekaj vrstic:

# Recurring guardrail: alert ~60 days before your pinned version sunsets.
from datetime import date

PINNED = "v22"                 # the version your client is pinned to
SUNSET = {"v20": "2026-06-01", "v21": "2026-08-01", "v22": "2026-10-01"}  # sunset-dates page
sunset = SUNSET.get(PINNED)    # None until your version reaches the published calendar
if sunset and (date.fromisoformat(sunset) - date.today()).days < 60:
    alert(f"{PINNED} sunsets {sunset}; schedule the version bump")  # major bump needs a re-test

404 z ugasnjene različice je izpad, ki si si ga privoščil sam. Obravnavaj upravljanje različic kot stalno ponavljajočo se nalogo, ne kot gasilsko vajo.

Zdaj priložnost: AI se seli v kreative in feed

Z urejenimi roki je preostanek leta vzvod, ki ga uvedeš po lastnem urniku. Dve storitvi sta delo s sredstvi in feedom spremenili v nekaj, kar skriptaš čez tisoče SKU-jev.

• AssetGenerationService (Ads API, v22, zaprta beta). AI generiranje besedil in slik, z izboljšavo in izločanjem slik za PMax; v23.2 je dodala VideoEnhancement za video, ki ga generira Google. Ustvarjanje kreativ se seli iz vmesnika v programabilno plast.
• Product Studio (Merchant API, alpha od aprila 2025). AI generirani naslovi in opisi izdelkov, plus AutomatedDiscounts za cene v realnem času. Prepisovanje naslovov na ravni API-ja pomeni množično izboljšanje tisočev SKU-jev brez ročnega dela.

Feed polovico jemljem osebno. V Lyntu smo dve leti gradili Boostero, AI plast, ki bogati feede Merchant Centra, ker je kakovost feeda strop učinkovitosti Shoppinga in PMaxa. Boljši naslovi premaknejo več prihodka kot večina sprememb ponudb. Product Studio prinaša kos te zmožnosti naravnost v platformo.

Pipeline, ki ga to odklene, prebere SKU iz feeda, generira skladen naslov, opis in slikovna sredstva ter jih potisne naravnost v skupino sredstev, brez ročnega koraka v Canvi vmes. Obe storitvi sta pre-GA. Obravnavaj ju kot pilot na rezini kataloga, ne kot uvedbo na cel katalog, dokler ne dozorita.

Vodovodne napeljave: Ads in Merchant končno skupaj

Najbolj podcenjena sprememba leta je povsem neglamurozna. Polovici e-commerce računa se znajdeta na enem mestu.

Kaj se je spremenilo. Od 22. aprila 2026 je Merchant API dosegljiv iz Google Ads Scripts. V kombinaciji s product_filters (pogojno deljenje feeda z Google Ads, izdano novembra 2025) in CartDataSalesView (v24) se zanka med zdravjem feeda in oglaševalsko porabo zapre v enem okolju.

Zakaj zadeva tvoj račun. Stara delitev, kampanje v Scripts in feed upravljan drugje, je pomenila, da je zavrnjen izdelek kuril proračun, dokler tega ni opazil človek. Zdaj se lahko ena sama skripta odzove na zavrnitev v feedu tako, da ustavi kampanjo ali umakne SKU iz PMax skupine z izdelki. In CartDataSalesView prinaša v API prihodek po prodanem SKU-ju iz podatkov o košarici. Nosi prihodek, ne porabe, zato pravi ROAS po SKU zahteva dve poizvedbi. Začni s prihodkovno stranjo:

-- Revenue per sold SKU from cart data (v24+)
SELECT segments.product_item_id,
       metrics.revenue_micros,
       metrics.all_revenue_micros
FROM cart_data_sales_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.revenue_micros DESC

Nato potegni stroškovno stran iz shopping_performance_view in oba rezultata združi prek product_item_id:

-- Cost per advertised SKU; join to the revenue query on product_item_id
SELECT segments.product_item_id,
       metrics.cost_micros,
       metrics.conversions_value
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC

Te združene vrstice so vhod v razvrščanje po donosnosti, ki si ga prej vsak mesec sestavljal ročno. Za stranke poganjamo poslovno poročanje na ravni kupca v BigQueryju in polovica dela je bila od nekdaj šivanje oglaševalskih podatkov s podatki o izdelkih. Šiv zdaj živi v dveh klicih API namesto v izvozu feeda in ga lahko validiraš. Preveri, da se item ID-ji ujemajo na obeh straneh, preden zaupaš razmerju. (Vir je cart_data_sales_view, izdan v v24; razpoložljivost segmentov preveri v release notes svoje različice.)

Leto na eni časovnici

Vsaka major različica spodaj prihaja iz uradnih release notes; Merchant mejniki iz Merchant API latest updates. Desni stolpec je edini, ki naj bi vodil tvoj koledar. Vse, kar je označeno TRDO, ni predmet pogajanj.

Prva ura dela

Ne cela migracija. Grep. Preišči svojo kodo za shoppingcontent.googleapis.com in zapiši vsak job, ki skoči ven. Ta seznam je tvoja izpostavljenost 18. avgustu, vzel pa ti je deset minut.

Preostanek ure nameni ustvarjanju enega eksperimenta ADOPT_AI_MAX na računu, kjer DSA šteje največ, da september pride kot izmerjena sprememba in ne kot presenečenje. Roki so Googlovi. Ali te zadenejo kot izpadi ali kot nadgradnje, je še vedno tvoja izbira.

FAQ