Een jaar Microsoft Advertising API: SOAP sterft, het venster staat open

Op 1 april dit jaar publiceerde Microsoft een blogpost die het einde van zijn SOAP-API aankondigde. Ik heb de datum twee keer gecheckt, want wie de begrafenis van een protocol uitgerekend op 1 april aankondigt, vraagt om problemen. Het was geen grap. Nieuwe functies komen vanaf 1 oktober 2026 niet meer naar SOAP, en op 31 januari 2027 gaat het hele ding uit.

Toen deed ik wat twintig jaar PPC me heeft ingeprent. Ik opende onze codebase bij Lynt en keek welke connectors nog SOAP spreken met Bing. Niet omdat de deadline dichtbij is. Omdat een API-stopzetting nooit iets sloopt op de dag dat ze wordt aangekondigd. Ze sloopt een rapportagetaak veertien maanden later, midden in een kwartaal, in een account waar niemand zich nog herinnert wie het script schreef.

Die deadline is de enige klok die in Microsofts API-jaar echt tikt. Al het andere dat het platform opleverde is stiller en, eerlijk gezegd, interessanter. Stuk voor stuk haalde de Bing Ads API Google in. PMax, AI Max, generatieve componenten, Google login, rijkere import. Ik programmeer al twaalf jaar met de Google Ads API, en het grootste deel van die tijd was Microsofts API de laatste die je integreerde, met tegenzin, als de klant erop stond. Dit is het eerste jaar waarin een Google-automatisering naar Bing overzetten bijna niets kost.

En de concurrentie behandelt Bing nog steeds als bijzaak, en dat is precies waarom het venster openstaat. Dus ik loop het jaar op dezelfde manier door als dat van Google. Bij elke verandering: wat het is, waarom het ertoe doet voor jouw account, en welke call of payload je bouwt. Deadline eerst, kans daarna.

De enige klok die echt tikt: SOAP wordt uitgefaseerd

Dit is de enige gedateerde verplichting van het Microsoft-jaar, dus die komt eerst.

Wat er veranderde. Op 1 april 2026 kondigde Microsoft een harde tijdlijn aan om de Advertising API van SOAP naar REST te verhuizen. Twee datums tellen:

• 1 oktober 2026 is de dag waarop nieuwe functies alleen nog in de REST API verschijnen. SOAP krijgt niets nieuws meer.
• 31 januari 2027 is de dag waarop SOAP volledig uitgaat. Bestaande SOAP-integraties draaien tot dan, en geen dag langer.

De stukken van PPC.land en ALM Corp bevestigen allebei dezelfde datums.

Waarom het ertoe doet voor jouw account. Praat een rapportagetaak, biedscript of connector via de SOAP-SDK met Bing, dan heeft die een houdbaarheidsdatum. En de verhuizing is geen cosmetische ingreep. Rapportage werkt anders in REST, de authenticatieflow verschilt en de foutafhandeling verandert. Een pipeline die je vergeet, stopt op 31 januari 2027 simpelweg met data leveren, zonder andere waarschuwing dan een blogpost van tien maanden eerder.

Wat te doen. Is je Bing-tooling dun of onbestaand, doe dan geen moeite om de oude SOAP-code te porten. Bouw REST-first en sla een generatie over. REST is kale HTTP en JSON. Een rapport gaat van een SOAP-envelop naar een JSON-POST tegen het Reporting-endpoint, met een OAuth bearer-token en je developer token in de headers:

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

(De REST-host, het headermodel met OAuth plus DeveloperToken en het v13-pad komen uit Microsofts docs. Bevestig de exacte request body voor jouw rapport tegen de release notes voordat je live gaat.)

Generatieve componenten, geschreven door de API

Met de deadline in de agenda is de rest van het jaar pariteit. Google heeft je al geleerd hoe je al deze functies gebruikt.

Wat er veranderde. De aanbevelingsendpoints kwamen in februari 2025 (SDK 13.0.24): CreateResponsiveSearchAdRecommendation, CreateAssetGroupRecommendation en CreateResponsiveAdRecommendation, elk met een Refine…-tegenhanger. Een job-based variant en brand-kit-aanbevelingen volgden in juli 2025 (13.0.25), en AutoGeneratedAssetsEnabled kwam in februari 2026 bij de RSA-instellingen. Allemaal uit de release notes.

Waarom het ertoe doet voor jouw account. Advertentieteksten genereren en itereren is nu scriptbaar in plaats van een klusje dat alleen in de UI kan. Dat is het verschil tussen met de hand teksten schrijven voor tien componentengroepen en ze genereren voor honderden.

Wat te doen. Haak de aanbevelingsendpoints in de creatieve workflow die je al voor Google draait. Genereren, afstemmen op de brand kit, pushen:

feed/product → CreateResponsiveSearchAdRecommendation
             → RefineResponsiveSearchAdRecommendation (brand-kit-termen uitsluiten)
             → naar advertentiegroep pushen  (niet handmatig kopiëren en plakken vanuit de UI)

Bing wordt nog een outputkanaal van je bestaande advertentietekst-pipeline in plaats van een aparte, handgebouwde pipeline.

AI Max for Search, met een API-schakelaar

Wat er veranderde. AI Max for Search opende als pilot in mei 2026, met de API-schakelaar AISearchSetting in Campaign Management. Het brengt uitgebreide query-matching, componentpersonalisatie en slimme URL-routing, oftewel dezelfde beweging weg van zoekwoorden als Googles AI Max. En het stelt de guardrails beschikbaar via de API: merken in- en uitsluiten, termen uitsluiten, beperkingen op je boodschap. Search Engine Land behandelde de lancering naast Microsofts bredere agentic-web-offensief.

Waarom het ertoe doet voor jouw account. Draai je al een DSA-naar-AI-Max-migratie op Google, dan verhuist het draaiboek vrijwel een-op-een naar Microsoft. De afruil ook. Je wint bereik en geeft matching en URL-keuze uit handen. Daarom zijn de guardrails het onderdeel dat je niet overslaat.

Wat te doen. Zet AISearchSetting op de campagne en rol je brand-kit-guardrails programmatisch uit over accounts, zoals je dat op Google doet:

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

(AISearchSetting en de brand-kit-exclusies zijn echte Campaign Management-toevoegingen uit maart en mei 2026. De exacte object-nesting is illustratief. AI Max is nog een pilot, dus bevestig het schema en de GA-status in de release notes vlak voordat je erop bouwt.)

Je Google-setup overzetten werd net goedkoop

Het duidelijkste thema van het jaar is convergentie. Microsoft maakte het goedkoop om je Google-setup mee te nemen.

Waarom het ertoe doet voor jouw account. Wat je op Google bouwt, zet je nu bijna een-op-een over naar Bing. Met Google login onderhoud je niet eens een tweede OAuth-denkmodel, want je gebruikt voor beide dezelfde Google-identiteit:

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

Wat te doen. Kies de ene Google-taak met het hoogste rendement (NCA-doelen en generatieve componenten zijn de gebruikelijke eerste keuzes) en port die als pilot naar Bing. Het auth- en importwerk is al voor je gedaan, dus de port is vooral je eigen Google-code teruglezen. (De Google-OAuth-grantklassen zijn echte SDK-toevoegingen uit december 2025. Bevestig de exacte constructor en auth-flow tegen de release notes, want het is een SDK-helper, geen grantwaarde op het token-endpoint.)

Meten werd volwassen

Vier upgrades verbinden Bing eindelijk met je eigen BI en CRM, en dat in beide richtingen:

Waarom het ertoe doet voor jouw account. MSClickIdPerformanceReport is degene waar je het eerst naar grijpt. Wij draaien businessrapportage in BigQuery voor onze klanten, tot op het niveau van hun individuele eindklanten. De waardevolste join in die rapportage is klik-ID aan CRM-order, want een CRM-join vervangt platformcijfers door de echte ROAS. Op Google draait die join op de GCLID. Dit rapport geeft Bing dezelfde join, op MSCLKID. En het rapport zelf is gewoon nog een REST-submit tegen het v13 Reporting-endpoint, dus het valt rechtstreeks in de migratie uit de eerste sectie.

Shopping is intussen stilletjes geconsolideerd. De oude Content API v9.1 is feitelijk bevroren (laatste wijziging in 2024). Modern Microsoft Shopping loopt via Microsoft Merchant Center plus Bing Ads v13, dus via PMax-componentengroepen, het FeedItemPerformanceReport en paden in vermeldingsgroepen, oftewel de takken van de productboom waarop je biedt.

Aan de horizon: advertenties in de chatbot

De meest toekomstgerichte ontwikkeling is Microsofts inzet op agentic commerce. Op Activate 2026 lanceerde Microsoft Copilot Checkout, waarmee je rechtstreeks in de chat koopt, naast Brand Agents voor Shopify en advertentieplaatsingen onder Copilots conversationele antwoorden. Performance Max verschijnt onder die resultaten. Het marketingcommentaar ziet hierin Microsofts omslag naar AI-first: een echt nieuw shoppingoppervlak in plaats van zomaar nog een advertentieplek.

Voorlopig is dit meer “houd dit in de gaten” dan “automatiseer vandaag”, maar het heeft een concrete voorwaarde, en die neem ik serieus. We hebben twee jaar besteed aan het bouwen van Boostora, onze tool die Google Merchant Center-feeds verrijkt met AI, juist omdat feedkwaliteit het plafond is van elk geautomatiseerd shoppingoppervlak. Dezelfde regel geldt hier. Een product verschijnt alleen netjes in een AI-antwoord als zijn feedgegevens en boodschap op orde zijn, dus het ondankbare feedwerk is wat een winkel klaarmaakt om in de chat te verkopen.

Aan de creatieve kant kreeg de API ook HTML5-componenten (AddHTML5s, maart 2026) en Video Animation (statisch beeld naar videocomponent, november 2025). Het zijn allebei goedkope manieren om rijkere advertentieformats te draaien zonder productieteam.

Het jaar op één tijdlijn

Elke v13-regel hieronder komt uit de Bing Ads API release notes (laatst bijgewerkt 5 juni 2026). De regels met het label Platform komen uit de Microsoft Advertising-blog. De enige harde deadlines zijn de twee SOAP-datums, die het label HARD dragen. De rij over politieke EU-advertenties is een compliance-verplichting, en al het andere is opt-in-winst. De rechterkolom vertelt je wat wat is.

Waar ik vanavond zou beginnen

Niet met de hele migratie. Met een grep. Doorzoek je codebase op ReportingService.svc en de SOAP-SDK-imports, en schrijf elke taak op die eruit rolt. Op die lijst staat elke taak die op 31 januari 2027 stopt met werken, en daar was je in totaal tien minuten mee bezig.

Kies daarna één Google-automatisering waar je trots op bent en vraag je af wat die zou opleveren op een platform waar je concurrenten nog niet zijn opgedoken. Het pariteitswerk is gedaan. Het venster staat open. Welke taak port jij als eerste?

FAQ