Leto na Microsoft Advertising API-ju: SOAP umira, okno je odprto

Prvega aprila letos je Microsoft objavil blog zapis, s katerim je napovedal konec svojega SOAP API-ja. Datum sem preveril dvakrat, ker pokopati protokol v objavi s 1. aprila pomeni iskati težave. Bilo je res. Nove funkcije 1. oktobra 2026 nehajo prihajati na SOAP, 31. januarja 2027 pa se vsa stvar izklopi.

Potem sem naredil to, kar mi je dvajset let PPC-ja vtisnilo v glavo. Odprl sem našo kodo v Lyntu in preveril, kateri konektorji še govorijo SOAP proti Bingu. Ne zato, ker bi bil rok blizu. Zato ker upokojitev API-ja nikoli ne pokvari ničesar na dan, ko je napovedana. Pokvari poročevalsko opravilo štirinajst mesecev pozneje, sredi četrtletja, na računu, kjer se nihče več ne spomni, kdo je napisal skripto.

Ta rok je edina ura, ki v Microsoftovem letu z API-jem zares teče. Vse ostalo, kar je platforma izdala, je tišje in, iskreno, bolj zanimivo. Kos za kosom je Bing Ads API ujel Google. PMax, AI Max, generativni elementi, prijava z Googlom, bogatejši uvoz. Dvanajst let pišem kodo za Googlov Ads API in večino tega časa je bil Microsoftov API tisti, ki ga integriraš zadnjega, nejevoljno, če stranka vztraja. Letos je prvo leto, ko prenos Googlove avtomatizacije na Bing ne stane skoraj nič.

Konkurenca pa Bing še vedno obravnava kot nekaj postranskega in prav zato je okno odprto. Leto bom torej prehodil enako kot Googlovo. Pri vsaki spremembi bom pojasnil, kaj to je, zakaj je pomembna za tvoj račun in kateri klic ali payload je treba zgraditi. Najprej rok, potem priložnost.

Edina ura, ki zares teče: SOAP se upokojuje

To je edina obveznost Microsoftovega leta s trdnim datumom, zato gre prva.

Kaj se je spremenilo. 1. aprila 2026 je Microsoft napovedal trd časovni načrt za prehod Advertising API-ja s SOAP na REST. Pomembna sta dva datuma:

• 1. oktober 2026 je dan, od katerega nove funkcije pridejo samo v REST API. SOAP ne dobi nič novega.
• 31. januar 2027 je dan, ko se SOAP popolnoma izklopi. Obstoječe integracije SOAP tečejo do takrat in niti dan dlje.

Zapisa na PPC.land in ALM Corp potrjujeta ista datuma.

Zakaj je pomembno za tvoj račun. Če se katerokoli poročevalsko opravilo, skripta za ponudbe ali konektor dotika Binga prek SOAP SDK, ima rok trajanja. In prehod ni kozmetična zamenjava. Poročanje v REST deluje drugače, potek avtentikacije se razlikuje, obravnava napak se spremeni. Cevovod, na katerega pozabiš, bo 31. januarja 2027 preprosto nehal vračati podatke, brez opozorila razen blog objave izpred desetih mesecev.

Kaj storiti. Če je tvoje orodje za Bing skopo ali ga sploh ni, se ne muči s prenosom stare kode SOAP. Gradi REST-first in preskoči celo generacijo. REST je čisti HTTP in JSON. Poročilo gre iz ovojnice SOAP v zahtevo JSON POST na poročevalski endpoint, z žetonom OAuth bearer in tvojim razvijalskim žetonom v glavah:

# OLD: SOAP envelope to ReportingService.svc (off on 2027-01-31)
#   <s:Envelope><s:Body><SubmitGenerateReport>...</SubmitGenerateReport></s:Body></s:Envelope>

# NEW: REST. Submit a report request as JSON.
curl -X POST \
  "https://reporting.api.bingads.microsoft.com/Reporting/v13/GenerateReport/Submit" \
  -H "Authorization: Bearer $OAUTH_TOKEN" \
  -H "DeveloperToken: $DEV_TOKEN" \
  -H "CustomerAccountId: $ACCOUNT_ID" -H "CustomerId: $CUSTOMER_ID" \
  -H "Content-Type: application/json" \
  -d '{ "ReportRequest": { "Type": "CampaignPerformanceReportRequest",
        "Aggregation": "Daily", "Columns": ["TimePeriod","CampaignName","Clicks","Spend"] } }'

(Gostitelj REST, model glav OAuth + DeveloperToken in pot v13 izvirajo iz Microsoftove dokumentacije. Točno telo zahteve za svoje poročilo potrdi v opombah ob izdaji, preden objaviš.)

Generativni elementi, ki jih piše API

Z rokom v koledarju je preostanek leta izenačevanje. Google te je že naučil uporabljati vse te funkcije.

Kaj se je spremenilo. Endpointi za priporočila so prišli februarja 2025 (SDK 13.0.24): CreateResponsiveSearchAdRecommendation, CreateAssetGroupRecommendation in CreateResponsiveAdRecommendation, vsak s pripadajočim Refine…. Različica na podlagi opravil in priporočila za brand kit so sledili julija 2025 (13.0.25), nastavitve RSA pa so februarja 2026 dobile AutoGeneratedAssetsEnabled. Vse iz opomb ob izdaji.

Zakaj je pomembno za tvoj račun. Generiranje in iteriranje besedila oglasov je zdaj skriptabilno, ne več opravilo samo v vmesniku. To je razlika med ročnim pisanjem besedila za deset skupin elementov in generiranjem za stotine.

Kaj storiti. Vključi endpointe za priporočila v kreativni potek, ki ga že izvajaš za Google. Generiraj, izpili po brand kitu, pošlji:

feed/izdelek → CreateResponsiveSearchAdRecommendation
             → RefineResponsiveSearchAdRecommendation (izključitve izrazov iz brand kita)
             → pošlji v skupino oglasov (brez ročnega kopiranja iz vmesnika)

Bing postane še en izhodni kanal tvojega obstoječega cevovoda za besedilo oglasov, ne pa ločen, ročno zgrajen cevovod.

AI Max for Search, s stikalom v API-ju

Kaj se je spremenilo. AI Max for Search se je maja 2026 odprl za pilot, s stikalom AISearchSetting v API-ju za Campaign Management. Prinaša razširjeno ujemanje poizvedb, personalizacijo elementov in pametno usmerjanje URL-jev, kar je isti odmik od ključnih besed kot pri Googlovem AI Maxu. Hkrati prek API-ja odpira dostop do varoval: vključitve in izključitve znamke, izključitve izrazov, omejitve sporočanja. Search Engine Land je poročal o lansiranju ob Microsoftovem širšem premiku k agentnemu spletu.

Zakaj je pomembno za tvoj račun. Če na Googlu že izvajaš migracijo z DSA na AI Max, se priročnik na Microsoft prenese skoraj ena na ena. Prenese pa se tudi kompromis. Pridobiš doseg, ujemanje in izbiro URL-ja pa prepustiš sistemu. Zato varoval ne smeš izpustiti.

Kaj storiti. Nastavi AISearchSetting na kampanji in programsko namesti svoja varovala brand kita po vseh računih, tako kot to počneš na Googlu:

{
  "AISearchSetting": { "Enabled": true },
  "BrandKit": {
    "TermExclusions": ["competitor-name", "off-brand-claim"],
    "MessagingRestrictions": ["no superlatives without proof"]
  }
}

(AISearchSetting in izključitve brand kita so resnične dopolnitve Campaign Managementa iz marca in maja 2026. Točno gnezdenje objekta je ilustrativno. AI Max je še vedno pilot, zato shemo in status GA potrdi v opombah ob izdaji tik preden začneš graditi na njem.)

Prenos tvoje Googlove postavitve je pravkar postal poceni

Najjasnejša tema leta je konvergenca. Microsoft je poskrbel, da svojo Googlovo postavitev preseliš poceni.

Zakaj je pomembno za tvoj račun. Kar zgradiš na Googlu, se zdaj na Bing prenese skoraj ena na ena. Ob prijavi z Googlom niti ne potrebuješ drugega miselnega modela OAuth, saj za obe platformi uporabljaš isto Googlovo identiteto:

# Authenticate TO the MICROSOFT API with your existing Google identity (Dec 2025+).
# GoogleOAuthWebAuthCodeGrant is a Bing Ads SDK auth class, not a raw grant_type.
from bingads.authorization import GoogleOAuthWebAuthCodeGrant

authentication = GoogleOAuthWebAuthCodeGrant(
    client_id=CLIENT_ID, client_secret=CLIENT_SECRET, redirect_url=REDIRECT_URI,
)
# one OAuth flow across Google Ads + Microsoft Advertising;
# a March 2026 fix preserves the Google refresh token between runs.

Kaj storiti. Izberi eno samo Googlovo opravilo z najvišjim donosom (cilji NCA in generativni elementi so običajna prva izbira) in ga kot pilot prenesi na Bing. Delo z avtentikacijo in uvozom je že opravljeno namesto tebe, zato je prenos večinoma branje lastne Googlove kode. (Razredi za Google OAuth grant so resnične dopolnitve SDK iz decembra 2025. Točen konstruktor in potek avtentikacije potrdi v opombah ob izdaji, ker gre za pomočnika SDK, ne za vrednost granta na token endpointu.)

Merjenje je odraslo

Štiri nadgradnje končno povežejo Bing s tvojim lastnim BI in CRM, in to v obe smeri:

Zakaj je pomembno za tvoj račun. MSClickIdPerformanceReport je tisti, po katerem sežeš prvi. Za svoje stranke v BigQueryju vodimo poslovno poročanje vse do njihovih posameznih končnih kupcev. Najdragocenejši spoj v tem poročanju je click ID z naročilom v CRM, ker spoj s CRM zamenja ROAS, ki ga poroča platforma, s pravo številko. Na Googlu ta spoj teče na GCLID. To poročilo da Bingu isti spoj prek MSCLKID. Samo poročilo pa je le še en REST submit na poročevalski endpoint v13, zato pade naravnost v migracijo iz prvega razdelka.

Shopping se je medtem tiho konsolidiral. Stari Content API v9.1 je dejansko zamrznjen (zadnja sprememba leta 2024). Sodoben Microsoft Shopping teče prek Microsoft Merchant Centra plus Bing Ads v13, kar pomeni skupine elementov v PMaxu, FeedItemPerformanceReport in poti skupin vnosov, torej veje drevesa izdelkov, na katere oddajaš ponudbe.

Na obzorju: oglasi znotraj klepetalnika

Najbolj v prihodnost zazrta nit je Microsoftova stava na agentni commerce. Na Activate 2026 je Microsoft predstavil Copilot Checkout, ki omogoča nakup neposredno v klepetu, ob tem pa še Brand Agents za Shopify in oglasne umestitve pod Copilotovimi pogovornimi odgovori. Pod temi odgovori se pojavlja tudi Performance Max. Marketinški komentar to opisuje kot Microsoftov prehod v AI-first: resnično novo nakupovalno površino in ne le še eno oglasno mesto.

Zaenkrat je to bolj opazovanje kot avtomatizacija, ima pa konkreten predpogoj in jaz ga jemljem resno. Dve leti smo gradili Boostoro, naše orodje, ki z AI bogati feede Google Merchant Centra, prav zato, ker kakovost feeda določa zgornjo mejo vsake avtomatizirane nakupovalne površine. Isto pravilo velja tudi tukaj. Izdelek se v AI odgovoru pokaže čisto le, če so njegovi podatki v feedu in sporočanje urejeni, zato prav nehvaležno delo s feedom trgovino pripravi na prodajo kar v klepetu.

Na kreativni strani je API dobil tudi HTML5 elemente (AddHTML5s, marec 2026) in Video Animation (statična slika v video element, november 2025). Oboje je poceni način, da poganjaš bogatejše oglasne formate brez produkcijske ekipe.

Leto na eni časovnici

Vsak vnos v13 spodaj izvira iz opomb ob izdaji Bing Ads API (nazadnje posodobljeno 5. junija 2026). Vrstice z oznako Platform izvirajo z bloga Microsoft Advertising. Edina trda roka sta datuma SOAP, ki nosita oznako HARD. Vrstica o političnih oglasih EU je obveza skladnosti, vse drugo pa je prostovoljna prednost. Desni stolpec ti pove, kaj je kaj.

Kje bi jaz začel nocoj

Ne s celotno migracijo. Z grepom. Preglej svojo kodo in poišči ReportingService.svc ter importe SOAP SDK, pa si zapiši vsako opravilo, ki se pojavi. Ta seznam vsebuje vsa opravila, ki ti 31. januarja 2027 nehajo delovati, celoten postopek pa ti je vzel deset minut.

Potem izberi eno Googlovo avtomatizacijo, na katero si ponosen, in se vprašaj, koliko bi zaslužila na platformi, kamor tvoji tekmeci še niso prišli. Delo za enakost je opravljeno. Okno je odprto. Katero opravilo boš prenesel prvo?

FAQ