Godina s Google Ads API-jem: dva tvrda roka, ostalo je prilika

U siječnju je Google objavio v23 Ads API-ja i najavio da će od tada nova verzija izlaziti svaki mjesec. Pročitao sam to dvaput. Dvanaest godina pišem kod protiv ovog API-ja i većinu tog vremena bio je to spori teren koji si posjetio jednom godišnje, podigao broj verzije i zaboravio.

Onda sam učinio ono što su me te godine naučile. Otvorio sam naš kod u Lyntu i potražio shoppingcontent.googleapis.com. Svaki pogodak je skripta koja umire 18. kolovoza 2026., na dan kada se gasi Content API for Shopping. Odmah iza vreba drugi datum. U rujnu 2026. svaka preostala Dynamic Search Ads kampanja automatski prelazi na AI Max, htio ti to ili ne.

Ta dva sata obveze su Googleove API godine. Sve ostalo što je platforma isporučila je prilika. AI servisi za kreative, izvještavanje o prodaji na razini proizvoda, Merchant API unutar Google Ads Scriptsa. Zato ću godinu proći po prioritetu, najtvrđi rok prvi. Za svaku promjenu: što je, zašto se tiče tvog računa i koji točno poziv, payload ili migraciju pokrenuti.

Ništa neću ostaviti na “trebao bi migrirati”. Rok bez konkretnog artefakta samo je tjeskoba. Na svakom koraku dobivaš endpoint koji zamjenjuje stari, payload eksperimenta ili GAQL upit, pa točno vidiš što izgraditi prije nego datum stigne.

Rok broj jedan: Content API for Shopping umire 18. kolovoza 2026.

Ovo je najtvrđi datum godine, pa ide prvi.

Što se promijenilo. Content API for Shopping v2.1 gasi se 18. kolovoza 2026. Njegov nasljednik, Merchant API v1, u GA-u je od srpnja 2025., a međukorak v1beta već je ugašen 28. veljače 2026. Stari monolit zamjenjuju fokusirani pod-API-ji. datasources, products, inventories, reports, notifications.

Zašto se tiče tvog računa. Sve što dira tvoj feed kroz stari API tog dana prestaje raditi. Slanje feedova, dopunski feedovi, prilagođene oznake, ažuriranja cijena i zaliha, čitanje odbijanja. Ovo nije “bilo bi zgodno migrirati”, ovo je tvrdi rez. Ako ti dnevna skripta sinkronizira cijene, 18. kolovoza zanijemi, a feed polako odluta od stvarnosti dok netko ne primijeti izgubljeni prihod. Vidio sam taj obrazac kvara na stvarnim računima i skupo nikad nije samo ispadanje, skupi su tjedni u kojima ga nitko ne primijeti.

Što učiniti. Obnovi prema strukturi pod-API-ja. Migracija je mehanička. Mijenjaju se host, putanja i model resursa, namjera ostaje. Evo prije i poslije za najčešći poziv od svih, upsert proizvoda:

# 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"} } }'

(Hostovi endpointa i podjela na pod-API-je dolaze iz Googleove dokumentacije. Točan body zahtjeva za svoj resurs provjeri prije objave u referenci Merchant API-ja, jer su se promijenili nazivi polja, a ne samo URL.)

Odredište je iskreno bolje od onoga što zamjenjuje, i to je dio koji ti nitko ne kaže. Tri poboljšanja koja migracijom nasljeđuješ besplatno:

Ako se odavno spremaš očvrsnuti svoje alate za feedove, gašenje je prisilni povod. Obnovi jednom i izađi s čišćim rukovanjem greškama i manje kruženja nego što je v2.1 ikad dopuštao.

Rok broj dva: Dynamic Search Ads u rujnu 2026. postaje AI Max

Druga datirana promjena, i ona koja preslaguje koliko kontrole zadržavaš.

Što se promijenilo. AI Max for Search dosegao je GA 15. travnja 2026. nakon beta lansiranja u svibnju 2025. Od rujna 2026. Google automatski prebacuje na AI Max sve preostale DSA, automatski stvorene resurse i široko podudaranje na razini kampanje. Nakon toga novu DSA kampanju više ne stvaraš. Ni u sučelju, ni u Editoru, ni preko API-ja.

Zašto se tiče tvog računa. Trgovina glasi: kontrola za rast. S punim skupom funkcija (podudaranje pojmova plus prilagodba teksta plus proširenje završnih URL-ova) Google navodi oko +7 % konverzija ili vrijednosti konverzija u odnosu na samo podudaranje. Zauzvrat modelu predaješ podudaranje, tekstove resursa i izbor odredišne stranice. Ako imaš brend ili compliance pravila ručno ugrađena u svoj DSA setup, tihi rujanski prelazak može početi slati promet na URL-ove i tekstove koje nikad nisi odobrio. Automatizacija koju nisi izmjerio automatizacija je koju ne kontroliraš.

Što učiniti. Ne čekaj da vidiš što će prelazak napraviti tvojim brojkama. Izmjeri to sada. Google je ograde i mjerne kuke kroz API isporučio usporedno s funkcijom, pa prelazak možeš A/B testirati na vlastitim podacima prije nego postane obavezan:

Praktični potez je onaj posljednji. Stvori eksperiment ADOPT_AI_MAX na svojim računima i pusti ga da radi. Deltu CPA i ROAS-a čitaš usporedbom kampanja eksperimentalne grane s kontrolom. Običan GAQL upit zatim ti pokaže što je proširenje bez ključnih riječi stvarno uparilo i zaradilo:

-- 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 jedan je od novih tipova eksperimenata iz v24.1; targeting_expansion_view resurs je za izvještavanje iz v22. Dostupnost polja provjeri u release notes verzije koju pozivaš.)

Klizni rok: izdanje svaki mjesec

Ne jedan datum, nego sat koji sada otkucava stalno.

Što se promijenilo. Od v23 (28. siječnja 2026.) Google Ads API prešao je na mjesečni ritam izdanja. Četiri major verzije godišnje plus mjesečne minor verzije, s godinom podrške po major verziji.

Zašto se tiče tvog računa. Brži pristup funkcijama i brže zastarijevanje. Verzije istječu prema objavljenom kalendaru. v20 dolazi do kraja životnog vijeka u lipnju 2026., v21 u kolovozu, v22 u listopadu. Mjesečni minor skok ništa ne lomi. Propušteno gašenje major verzije znači da ti skripte počinju vraćati greške bez ikakvog upozorenja osim datuma u kalendaru koji nisi pratio.

Što učiniti. Prikvači svoju verziju i prati kalendar gašenja. Najjeftinije osiguranje je ponavljajuća provjera koja zna koju verziju pozivaš i javi se oko 60 dana prije isteka. Sve stane u nekoliko redaka:

# 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 s ugašene verzije ispad je koji si sam priuštio. Tretiraj upravljanje verzijama kao stalni ponavljajući zadatak, a ne kao vatrogasnu vježbu.

A sada prilika: AI se useljava u kreative i feed

S riješenim rokovima, ostatak godine poluga je koju uvodiš po vlastitom rasporedu. Dva servisa pretvorila su posao s resursima i feedom u nešto što skriptiraš preko tisuća SKU-ova.

• AssetGenerationService (Ads API, v22, zatvorena beta). AI generiranje teksta i slika, s poboljšanjem i izvlačenjem slika za PMax; v23.2 dodala je VideoEnhancement za video koji generira Google. Izrada kreativa seli se iz sučelja u programabilni sloj.
• Product Studio (Merchant API, alpha od travnja 2025.). AI generirani naslovi i opisi proizvoda, plus AutomatedDiscounts za cijene u stvarnom vremenu. Prepisivanje naslova na razini API-ja znači masovno poboljšanje tisuća SKU-ova bez ručnog rada.

Feed polovicu shvaćam osobno. U Lyntu smo dvije godine gradili Boosteru, AI sloj koji obogaćuje feedove Merchant Centera, jer kvaliteta feeda strop je učinka Shoppinga i PMaxa. Bolji naslovi pomiču više prihoda nego većina promjena licitacija. Product Studio unosi dio te sposobnosti izravno u platformu.

Pipeline koji ovo otključava čita SKU iz feeda, generira usklađen naslov, opis i slikovne resurse i gura ih ravno u grupu resursa, bez ručnog koraka u Canvi u sredini. Oba servisa su pre-GA. Tretiraj ih kao pilot na dijelu kataloga, a ne kao rollout na cijeli katalog, dok ne sazriju.

Vodoinstalacije: Ads i Merchant napokon zajedno

Najpodcijenjenija promjena godine posve je neglamurozna. Dvije polovice e-commerce računa završavaju na jednom mjestu.

Što se promijenilo. Od 22. travnja 2026. Merchant API dostupan je iz Google Ads Scriptsa. U kombinaciji s product_filters (uvjetno dijeljenje feeda s Google Adsom, izdano u studenom 2025.) i CartDataSalesView (v24), petlja između zdravlja feeda i potrošnje na oglase zatvara se u jednom okruženju.

Zašto se tiče tvog računa. Stara podjela, kampanje u Scriptsu i feed upravljan negdje drugdje, značila je da odbijeni proizvod pali proračun dok čovjek to ne primijeti. Sada jedna skripta može reagirati na odbijanje u feedu pauziranjem kampanje ili izbacivanjem SKU-a iz PMax grupe s popisima. A CartDataSalesView unosi u API prihod po prodanom SKU-u iz podataka o košarici. Nosi prihod, ne potrošnju, pa stvarni ROAS po SKU-u traži dva upita. Kreni od strane prihoda:

-- 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

Zatim povuci stranu troškova iz shopping_performance_view i spoji oba rezultata preko 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

Ti spojeni retci ulaz su u razvrstavanje po profitabilnosti koje si prije svaki mjesec slagao ručno. Za klijente vodimo poslovno izvještavanje na razini kupca u BigQueryju i pola posla oduvijek je bilo šivanje oglasnih podataka s podacima o proizvodima. Šav sada živi u dva API poziva umjesto u exportu feeda i možeš ga validirati. Provjeri da se item ID-jevi poklapaju s obje strane prije nego što povjeruješ omjeru. (Resurs je cart_data_sales_view, izdan u v24; dostupnost segmenata provjeri u release notes svoje verzije.)

Godina na jednoj vremenskoj crti

Svaka major verzija ispod dolazi iz službenih release notes; Merchant prekretnice iz Merchant API latest updates. Desni stupac jedini je koji bi trebao voditi tvoj kalendar. Sve označeno TVRDO nije stvar pregovora.

Prvi sat posla

Ne cijela migracija. Grep. Pretraži svoj kod za shoppingcontent.googleapis.com i zapiši svaki job koji iskoči. Taj popis tvoja je izloženost 18. kolovoza, a oduzeo ti je deset minuta.

Ostatak sata posveti stvaranju jednog eksperimenta ADOPT_AI_MAX na računu gdje DSA znači najviše, da rujan stigne kao izmjerena promjena, a ne kao iznenađenje. Rokovi pripadaju Googleu. Hoće li te pogoditi kao ispadi ili kao nadogradnje, i dalje je tvoj izbor.

FAQ