Vuosi Microsoft Advertising API:n parissa: SOAP kuolee, ikkuna on auki

Tämän vuoden huhtikuun ensimmäisenä päivänä Microsoft julkaisi blogikirjoituksen, jossa se ilmoitti SOAP-API:nsa lopusta. Tarkistin päivämäärän kahdesti, koska protokollan hautajaisten piilottaminen aprillipäivän postaukseen on riskin ottamista. Se oli totta. Uudet ominaisuudet lakkaavat tulemasta SOAPiin 1. lokakuuta 2026, ja 31. tammikuuta 2027 koko juttu sammuu.

Sitten tein sen, minkä kaksikymmentä vuotta PPC:tä on minuun iskostanut. Avasin Lyntin koodikannan ja tarkistin, mitkä liittimet puhuvat Bingille yhä SOAPia. En siksi, että takaraja olisi lähellä. Vaan siksi, että API:n eläköityminen ei koskaan riko mitään ilmoituspäivänä. Se rikkoo raportointityön neljätoista kuukautta myöhemmin, kesken kvartaalin, tilillä jossa kukaan ei enää muista, kuka skriptin kirjoitti.

Tuo takaraja on Microsoftin API-vuoden ainoa kova kello. Kaikki muu, mitä alusta julkaisi, on hiljaisempaa ja suoraan sanottuna kiinnostavampaa. Pala palalta Bing Ads API kuroi Googlen kiinni. PMax, AI Max, generatiiviset elementit, Google-kirjautuminen, rikkaampi tuonti. Olen kirjoittanut koodia Googlen Ads API:a vasten kaksitoista vuotta, ja suurimman osan siitä ajasta Microsoftin API oli se, jonka integroit viimeisenä, vastentahtoisesti, jos asiakas vaati. Tämä on ensimmäinen vuosi, jolloin Google-automaation siirtäminen Bingiin ei maksa juuri mitään.

Ja kilpailijat kohtelevat Bingiä yhä sivuseikkana, mikä on juuri se syy, miksi ikkuna on auki. Käyn siis vuoden läpi samalla tavalla kuin kävin Googlen vuoden. Jokaisesta muutoksesta kerron, mikä se on, miksi sillä on väliä tilillesi ja mikä tarkka kutsu tai payload kannattaa rakentaa. Takaraja ensin, mahdollisuus perään.

Ainoa kova kello: SOAP jää eläkkeelle

Tämä on Microsoftin vuoden ainoa päivämäärällä varustettu velvoite, joten se menee ensin.

Mikä muuttui. 1. huhtikuuta 2026 Microsoft ilmoitti kovan aikataulun siirtää Advertising API pois SOAPista RESTiin. Kaksi päivämäärää ratkaisee:

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

PPC.landin ja ALM Corpin katsaukset vahvistavat molemmat samat päivämäärät.

Miksi sillä on väliä tilillesi. Jos jokin raportointityö, hintatarjousskripti tai liitin koskettaa Bingiä SOAP SDK:n kautta, sillä on viimeinen käyttöpäivä. Eikä siirtymä ole kosmeettinen vaihto. Raportointi toimii RESTissä eri tavalla, autentikointi kulkee eri reittiä ja virheenkäsittely muuttuu. Putki, jonka unohdat, lakkaa yksinkertaisesti palauttamasta dataa 31. tammikuuta 2027, ilman muuta varoitusta kuin kymmenen kuukautta vanhempi blogikirjoitus.

Mitä tehdä. Jos Bing-työkalusi ovat ohuet tai olemattomat, älä vaivaudu siirtämään vanhaa SOAP-koodia. Rakenna REST edellä ja hyppää sukupolven yli. REST on pelkkää HTTP:tä ja JSONia. Raportti muuttuu SOAP-kuoresta JSON-POSTiksi Reporting-endpointtiin, otsakkeissa OAuth bearer -token ja developer-tokenisi:

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

(REST-isäntä, OAuth + DeveloperToken -otsakemalli ja v13-polku ovat Microsoftin dokumentaatiosta. Varmista oman raporttisi tarkka pyyntörunko julkaisutiedoista ennen julkaisua.)

Generatiiviset elementit, API:n kirjoittamina

Kun takaraja on kalenterissa, loppuvuosi on pariteettia. Google opetti sinut jo käyttämään sen jokaisen palan.

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

Miksi sillä on väliä tilillesi. Mainostekstien generointi ja iterointi on nyt skriptattavissa, ei enää pelkkää käsityötä käyttöliittymässä. Se on ero sen välillä, kirjoitatko tekstit käsin kymmenelle elementtiryhmälle vai generoitko ne sadoille.

Mitä tehdä. Kytke suositusendpointit siihen luovaan työnkulkuun, jota jo ajat Googlelle. Generoi, hio brand kitiä vasten, työnnä:

feed/product → CreateResponsiveSearchAdRecommendation
            → RefineResponsiveSearchAdRecommendation (brand-kit term exclusions)
            → push to ad group  (no manual copy-paste from the UI)

Bingistä tulee olemassa olevan mainostekstiputkesi uusi tulostuskanava, ei erillinen käsin rakennettu.

AI Max for Search, API-kytkimellä

Mikä muuttui. AI Max for Search avautui pilottiin toukokuussa 2026, API-koukkuna AISearchSetting Campaign Managementissa. Se tuo laajennetun kyselyvastaavuuden, elementtien personoinnin ja älykkään URL-reitityksen, saman avainsanojen jälkeisen trendin kuin Googlen AI Max, ja se tuo suojakaiteet API:n ulottuville. Brändin sisällytykset ja poissulut, termipoissulut, viestintärajoitukset. Search Engine Land käsitteli julkistuksen Microsoftin laajemman agentic web -työnnön yhteydessä.

Miksi sillä on väliä tilillesi. Jos ajat Googlessa jo migraatiota DSA:sta AI Maxiin, pelikirja siirtyy Microsoftiin lähes yksi yhteen. Niin siirtyy vaihtokauppakin. Saat kattavuutta ja luovutat vastaavuuden ja URL-valinnan, mikä tekee suojakaiteista sen osan, jota et ohita.

Mitä tehdä. Aseta AISearchSetting kampanjalle ja vie brand kit -suojakaiteesi ohjelmallisesti kaikille tileille, kuten teet Googlessa:

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

(AISearchSetting ja brand kit -poissulut ovat todellisia Campaign Management -lisäyksiä maalis- ja toukokuulta 2026. Objektien tarkka sisäkkäisyys on havainnollistava. AI Max on yhä pilotti, joten varmista skeema ja GA-status julkaisutiedoista juuri ennen rakentamista.)

Google-asetelmasi siirtämisestä tuli halpaa

Vuoden selkein teema on lähentyminen. Microsoft teki Google-asetelmasi tuomisesta halpaa.

Miksi sillä on väliä tilillesi. Sen, minkä rakennat Googleen, voit nyt siirtää Bingiin lähes yksi yhteen. Google-kirjautumisen myötä et edes ylläpidä toista OAuth-ajattelumallia, koska sama Google-identiteetti autentikoi molemmat:

# Authenticate 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.

Mitä tehdä. Valitse se yksi Google-työ, jolla on suurin tuotto (NCA-tavoitteet ja generatiiviset elementit ovat tavallisimmat ensivalinnat), ja siirrä se Bingiin pilottina. Autentikointi- ja tuontityö on jo tehty puolestasi, joten siirto on enimmäkseen oman Google-koodisi lukemista. (Google-OAuth-grant-luokat ovat todellisia SDK-lisäyksiä joulukuulta 2025. Varmista tarkka konstruktori ja autentikointivirta julkaisutiedoista, koska kyseessä on SDK-apuri eikä token-endpointin grant-arvo.)

Mittaaminen kasvoi aikuiseksi

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

Miksi sillä on väliä tilillesi. MSClickIdPerformanceReport on se, johon tartut ensin. Ajamme asiakkaille asiakastason liiketoimintaraportointia BigQueryssa, ja sen arvokkain liitos on klikki-ID:stä CRM-tilaukseen, koska CRM-liitos korvaa alustan raportoiman ROASin todellisella luvulla. Googlessa liitos kulkee GCLID:llä. Tämä raportti antaa Bingille saman sauman. Ja raportti itsessään on vain yksi REST-submit lisää v13 Reporting-endpointtiin, joten se putoaa suoraan ensimmäisen osion migraatioon.

Shopping on sillä välin hiljaa konsolidoitunut. Vanha Content API v9.1 on käytännössä jäädytetty (viimeinen muutos 2024). Moderni Microsoft Shopping kulkee Microsoft Merchant Centerin ja Bing Ads v13:n kautta, mikä tarkoittaa PMax-elementtiryhmiä, listing group -polkuja ja FeedItemPerformanceReport-raporttia.

Horisontissa: mainokset chatbotin sisällä

Kauimmas eteenpäin katsova lanka on Microsoftin veto agenttiseen kaupankäyntiin. Activate 2026:ssa se julkaisi Copilot Checkoutin, ostamisen suoraan chatin sisällä, sekä Brand Agentit Shopifylle ja mainospaikat Copilotin keskustelevien vastausten alle, joissa Performance Max nousee esiin tulosten alla. Markkinointikommentaari kehystää tämän Microsoftin AI first -käänteenä, aidosti uutena ostopintana eikä yhtenä mainospaikkana lisää.

Toistaiseksi tämä on enemmän seurattavaa kuin tänään automatisoitavaa, mutta sillä on konkreettinen edellytys, ja otan sen vakavasti. Käytimme kaksi vuotta Boosteran rakentamiseen, työkalumme joka rikastaa Google Merchant Center -feedejä AI:lla, juuri siksi että feedin laatu on jokaisen automatisoidun shopping-pinnan katto. Sama sääntö pätee tässä. Tuote näkyy AI-vastauksessa siististi vain, jos sen feed-data ja viestit ovat kunnossa, joten epäkiitollinen feedityö on se, mikä asemoi verkkokaupan keskustelevaan kanavaan.

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), alustajulkistukset Microsoft Advertisingin blogista. Ainoat kovat takarajat ovat kaksi SOAP-päivämäärää, merkitty HARD. EU:n poliittisten mainosten rivi on compliance-velvoite, ja kaikki muu on vapaaehtoista hyötyä. Oikeanpuoleinen sarake kertoo, kumpi on kumpi.

Mistä aloittaisin tänä iltana

En koko migraatiosta. Grepistä. Hae koodikannastasi ReportingService.svc ja SOAP SDK:n importit ja kirjaa ylös jokainen työ, joka osuu hakuun. Se lista on sinun 31. tammikuuta 2027 -altistuksesi, ja siihen meni kymmenen minuuttia.

Valitse sitten yksi Google-automaatio, josta olet ylpeä, ja kysy, mitä se tienaisi alustalla, jonne kilpailijasi eivät ole vielä ilmestyneet. Pariteettityö on tehty. Ikkuna on auki. Minkä työn siirrät ensimmäisenä?

FAQ