Microsoft Advertising API:n vuosi — SOAP kuolee, ja tässä on REST-kutsu jonka rakennat tilalle

Koko vuosi yhdessä lauseessa

Yhdellä muutoksella on kello päällä — Microsoft lopettaa SOAP-API:nsa siten, että uudet ominaisuudet tulevat vain REST-muodossa 1. lokakuuta 2026 ja SOAP sammuu täysin 31. tammikuuta 2027 — ja kaikki muu on Microsoftin hiljaista ominaisuuspariteetin saavuttamista Googlen kanssa, mikä tekee vuodesta 2026 hetken aloittaa Bingin automatisointi, kun lähes kukaan muu ei tee niin. Jos sinulla on yksikin skripti, liitin tai raportointityö rakennettuna SOAP SDK:n päälle, sinulla on suunnilleen vuosi aikaa ja konkreettinen uudelleenrakennus aikataulutettavana. Loppu on lisäarvoa, jonka otat käyttöön silloin kun itse valitset.

Käsittelen jokaisen muutoksen samalla tavalla: mikä muuttui, miksi sillä on merkitystä sinun tilillesi ja tarkka kutsu tai payload rakennettavaksi — takaraja ensin, mahdollisuus perään. Syy siihen, että 2026 on oikea hetki, ei ole hypeä: API osaa vihdoin sen mitä Googlenkin — PMax, AI Max, generatiiviset elementit, New Customer Acquisition, Google-kirjautuminen ja -tuonti — ja kilpailu yhä kohtelee Bingiä sivuseikkana. Ikkuna on auki nimenomaan siksi, etteivät he ole vielä täällä.

Mutta yhteen muutokseen liittyy päivämäärä. Aloita siitä.

Takaraja — SOAP poistetaan, REST on ainoa polku

Tämä on Microsoftin vuoden ainoa kova kello, joten se menee ensin.

Mikä muuttui. 1. huhtikuuta 2026 Microsoft ilmoitti kovan aikataulun siirtää Advertising API pois SOAP:ista ja REST:in päälle. Kaksi päivämäärää merkitsee:

• 1. lokakuuta 2026 — uudet ominaisuudet tulevat vain REST-API:in. SOAP ei saa enää mitään uutta.
• 31. tammikuuta 2027 — SOAP sammutetaan täysin. Olemassa olevat SOAP-integraatiot toimivat siihen asti, eivätkä päivääkään pidempään.

PPC.land- ja ALM Corp -katsaukset vahvistavat molemmat samat päivämäärät.

Miksi sillä on merkitystä tilillesi. Jos jokin raportointityö, hintatarjous-skripti tai liitin koskettaa Bingiä SOAP SDK:n kautta, sillä on kova viimeinen voimassaolopäivä. Eikä kyse ole kosmeettisesta vaihdosta — raportointi toimii REST:ssä eri tavalla, autentikointivirta poikkeaa ja virheenkäsittely muuttuu. Raportointiputki, jonka unohdat, yksinkertaisesti lakkaa palauttamasta dataa 31. tammikuuta 2027, kesken neljänneksen, ilman muuta varoitusta kuin kymmenen kuukautta aiempi blogikirjoitus.

Mitä tehdä. Jos Bing-työkalustosi on ohut tai olematon, älä siirrä vanhaa SOAP-koodia — rakenna REST-ensisijaisesti ja hyppää sukupolven yli. REST on pelkkää HTTP:tä ja JSON:ia: raportti muuttuu SOAP-kuoresta JSON-POSTiksi Reporting-endpointia vasten, mukana OAuth bearer -token ja developer-tokenisi otsakkeissa:

# VANHA: SOAP-kuori ReportingService.svc:lle (pois 2027-01-31)
#   <s:Envelope><s:Body><SubmitGenerateReport>...</SubmitGenerateReport></s:Body></s:Envelope>

# UUSI: REST — lähetä raporttipyyntö JSON:ina
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": ["CampaignName","Clicks","Spend"] } }'

(REST-host, OAuth + DeveloperToken -otsakemalli ja v13-polku ovat Microsoftin dokumentaatiosta; varmista raporttisi tarkka pyyntörunko julkaisutietoja vasten ennen kuin julkaiset.)

Lisäarvo #1 — Generatiivinen AI kirjoittaa elementtisi, API:n kautta

Kun takaraja on aikataulutettu, loppuvuosi on pariteettia jonka Google jo opetti sinut käyttämään.

Mikä muuttui. Helmikuu 2025 (SDK 13.0.24) toi suositusendpointit — CreateResponsiveSearchAdRecommendation, CreateAssetGroupRecommendation, CreateResponsiveAdRecommendation, kullakin Refine…-vastinparinsa. Heinäkuu 2025 (13.0.25) lisäsi työpohjaisen variantin ja brand-kit-suositukset; helmikuu 2026 lisäsi AutoGeneratedAssetsEnabled:n RSA-asetuksiin. Kaikki julkaisutiedoista.

Miksi sillä on merkitystä tilillesi. Mainoskopion generointi ja iterointi on nyt skriptattavissa, ei pelkkä UI-puuhastelu — mikä on ero kymmenen elementtiryhmän kopion käsinkirjoittamisen ja satojen generoimisen välillä.

Mitä tehdä. Kytke suositusendpointit samaan luovaan työnkulkuun jonka jo ajat Googlelle — generoi, hio brand-kittiä vasten, työnnä:

feed/tuote → CreateResponsiveSearchAdRecommendation
          → RefineResponsiveSearchAdRecommendation (brand-kit-termipoissulkemiset)
          → työnnä mainosryhmään  (ei manuaalista copy-pastea UI:sta)

Bingistä tulee toinen tulostuskanava olemassa olevaan mainoskopioputkeesi, ei erillinen käsin rakennettu.

Lisäarvo #2 — AI Max for Search, API-kytkimellä

Mikä muuttui. AI Max for Search avautui pilottiin toukokuussa 2026, API-koukulla AISearchSetting (Campaign Management). Se tuo laajennetun kyselyvastaavuuden, elementtien personoinnin ja älykkään URL-reitityksen — saman avainsanan jälkeisen trendin kuin Googlen AI Max — suojakaiteilla jotka on tuotu esiin API:n kautta: brändin sisällytykset ja poissulkemiset, termipoissulkemiset, viestintärajoitukset. Search Engine Land kattoi julkistuksen Microsoftin laajemman agentic-web-työnnön ohessa.

Miksi sillä on merkitystä tilillesi. Jos ajat jo DSA-to-AI-Max-migraation Googlessa, sama pelikirja siirtyy Microsoftiin lähes yksi yhteen. Vaihtokauppa on myös identtinen — saat kattavuutta ja luovutat vastaavuuden ja URL-valinnan, joten suojakaiteet ovat se osa jota et ohita.

Mitä tehdä. Aseta AISearchSetting kampanjaan ja ota brand-kit-suojakaiteesi käyttöön ohjelmallisesti tilien yli, samalla tavalla kuin teet Googlessa:

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

(AISearchSetting ja brand-kit-poissulkemiset ovat todellisia Campaign Management -lisäyksiä maalis/toukokuulta 2026; tarkka objektien sisäkkäisyys on havainnollistava — AI Max on yhä pilotti, joten varmista skeema ja GA-status julkaisutiedoista juuri ennen kuin rakennat sitä vasten.)

Lisäarvo #3 — Yhtenevyys Googlen kanssa tekee siirtämisestä halpaa

Vuoden selkein teema: Microsoft teki Google-asetelmasi tuonnista halpaa.

Miksi sillä on merkitystä tilillesi. “Mitä teet Googlessa, voit nyt siirtää Bingiin lähes 1:1” — ja Google-kirjautumisen myötä et edes ylläpidä toista OAuth-ajattelumallia. Sama Google-identiteetti autentikoi molemmat:

# Autentikoi MICROSOFT-API olemassa olevalla Google-identiteetilläsi (joulu 2025+).
# GoogleOAuthWebAuthCodeGrant on Bing Ads SDK:n auth-luokka — ei raaka grant_type.
from bingads.authorization import GoogleOAuthWebAuthCodeGrant

authentication = GoogleOAuthWebAuthCodeGrant(
    client_id=CLIENT_ID, client_secret=CLIENT_SECRET, redirection_uri=REDIRECT_URI,
)
# yksi OAuth-virta Google Adsin + Microsoft Advertisingin yli;
# maaliskuun 2026 korjaus säilyttää Googlen refresh-tokenin ajojen välillä.

Mitä tehdä. Valitse se yksi Google-työ jolla on suurin tuotto — NCA-tavoitteet tai generatiiviset elementit ovat tavallisia ensivalintoja — ja siirrä se Bingiin pilottina. Autentikointi- ja tuontityö on jo tehty puolestasi; uudelleenkäytät malleja, et keksi niitä uudelleen. (Google-OAuth-grant-luokat ovat todellisia SDK-lisäyksiä joulukuulta 2025; varmista tarkka konstruktori ja autentikointivirta julkaisutietoja vasten — se on SDK-apuväline, ei token-endpointin grant-arvo.)

Lisäarvo #4 — Mittaaminen kasvoi aikuiseksi

Kolme päivitystä tekee Bing-datasta vihdoin helppoa kytkeä omaan BI:hin ja CRM:ään:

Miksi sillä on merkitystä tilillesi. MSClickIdPerformanceReport on se johon tarttua ensin: yhdistä MSCLKID CRM-tilauksiisi ja saat todellisen ROAS:in alustan raportoimien lukujen sijaan — sama liitos jonka jo ajat Googlen GCLID:lle. Raportin muoto on vain toinen REST-submit v13 Reporting-endpointia vasten, joten se uppoaa suoraan migraatioon jota jo teet ensimmäisessä osiossa.

Shopping puolestaan on hiljaa konsolidoitunut: vanha Content API v9.1 on käytännössä jäädytetty (viimeisin muutos 2024). Moderni Microsoft Shopping toimii Microsoft Merchant Centerin plus Bing Ads v13:n kautta — PMax-elementtiryhmät, listing-group-polut ja FeedItemPerformanceReport.

Horisontissa — mainoksia chatbotin sisällä

Tulevaisuuteen katsovin lanka on Microsoftin veto agentic commerceen. Activate 2026:ssa se julkisti Copilot Checkoutin — ostamisen suoraan chatin sisällä — Shopifyn Brand Agentsien ja Copilotin keskustelevien vastausten alle tulevien mainospaikkojen ohella, joissa Performance Max pulpahtaa esiin noiden tulosten alla. Markkinointikommentaari kehystää sen Microsoftin “AI-first”-siirtymänä — aidosti uutena ostopintana eikä toisena mainospaikkana.

Toistaiseksi tämä on enemmän “seuraa tätä tilaa” kuin “automatisoi tänään”, mutta sillä on konkreettinen edellytys: feedin ja brand-kitin hygienia. Tuotteet näkyvät siististi AI-pinnalla vain jos niiden feed-data ja viestintä ovat kunnossa — joten tämä vaatimaton työ asemoi kaupan keskustelevaa kanavaa varten. Luovalla puolella vuosi toi myös HTML5-elementit API:n kautta (AddHTML5s, maaliskuu 2026) ja Video Animationin (staattisesta kuvasta videoelementti, marraskuu 2025) — halpoja tapoja syöttää rikkaampia formaatteja ilman tuotantotiimiä.

Vuosi yhdellä aikajanalla

Jokainen alla oleva v13-merkintä tulee Bing Ads API:n julkaisutiedoista (päivitetty viimeksi 5. kesäkuuta 2026); alustailmoitukset Microsoft Advertising -blogista. Ainoat kovat takarajat ovat SOAP:in poiston kaksi päivämäärää (merkitty HARD); EU:n poliittisten mainosten rivi on compliance-velvoite, ja kaikki muu on valinnaista lisäarvoa — oikeanpuoleinen sarake kertoo kumpi on kumpi.

[HARD 1.10.]   1. Auditoi auth/liitin → suunnittele REST-uudelleenrakennus
[HARD 31.1.]   2. Rakenna REST-ensisijaisesti → ohita SOAP-siirto kokonaan
[pariteetti]   3. Siirrä yksi Google-työ → NCA tai generatiiviset elementit
[pilotti]      4. AISearchSetting → ota brand-kit-suojakaiteet käyttöön
[mittaa]       5. MSClickId + offline-konversiot → BI:hisi

FAQ