Un anno sulla Microsoft Advertising API: SOAP sta morendo, la finestra è aperta

Il primo aprile di quest’anno Microsoft ha pubblicato un post sul blog annunciando la fine della sua API SOAP. Ho controllato la data due volte, perché infilare il funerale di un protocollo in un post del 1° aprile è andarsele a cercare. Era tutto vero. Le nuove funzionalità smettono di arrivare su SOAP il 1° ottobre 2026, e il 31 gennaio 2027 si spegne tutto.

Poi ho fatto quello che vent’anni di PPC mi hanno inculcato. Ho aperto il nostro codice in Lynt e ho controllato quali connettori parlano ancora SOAP con Bing. Non perché la scadenza sia vicina. Perché il ritiro di un’API non rompe mai niente il giorno in cui viene annunciato. Rompe un job di reporting quattordici mesi dopo, a metà trimestre, in un account dove nessuno ricorda chi ha scritto lo script.

Quella scadenza è l’unico orologio che corre davvero nell’anno API di Microsoft. Tutto il resto che la piattaforma ha rilasciato è più silenzioso e, onestamente, più interessante. Un pezzo alla volta, la Bing Ads API ha raggiunto Google. PMax, AI Max, asset generativi, login Google, import più ricco. Sono dodici anni che sviluppo con la Google Ads API, e per la maggior parte di quel tempo l’API di Microsoft era quella che integravi per ultima, controvoglia, se il cliente insisteva. Questo è il primo anno in cui portare un’automazione da Google a Bing non costa quasi niente.

E la concorrenza tratta ancora Bing come un canale di serie B, ed è esattamente per questo che la finestra è aperta. Quindi percorrerò l’anno come ho percorso quello di Google. Per ogni cambiamento: cos’è, perché conta per il tuo account e la chiamata o il payload esatto da costruire. Prima la scadenza, poi l’opportunità.

L’unico orologio che corre davvero: SOAP va in pensione

È l’unico obbligo con una data precisa in tutto l’anno Microsoft, quindi viene per primo.

Cosa è cambiato. Il 1° aprile 2026 Microsoft ha annunciato una timeline rigida per spostare l’Advertising API da SOAP a REST. Contano due date:

• Il 1° ottobre 2026 è il giorno in cui le nuove funzionalità arrivano solo nella REST API. SOAP smette di ricevere qualsiasi novità.
• Il 31 gennaio 2027 è il giorno in cui SOAP viene spento completamente. Le integrazioni SOAP esistenti girano fino ad allora, e non un giorno di più.

Gli articoli di PPC.land e di ALM Corp confermano entrambi le stesse date.

Perché conta per il tuo account. Se un job di reporting, uno script per le offerte o un connettore tocca Bing attraverso l’SDK SOAP, ha una data di scadenza. E il passaggio non è un ritocco cosmetico. Il reporting funziona diversamente in REST, il flusso di autenticazione differisce e la gestione degli errori cambia. Una pipeline che ti sei dimenticato smetterà semplicemente di restituire dati il 31 gennaio 2027, senza altro preavviso che un post sul blog di dieci mesi prima.

Cosa fare. Se la tua strumentazione Bing è scarna o inesistente, non perdere tempo a portare il vecchio codice SOAP. Costruisci REST-first e salta una generazione. REST è HTTP e JSON nudi e crudi. Un report passa da una busta SOAP a un POST JSON verso l’endpoint Reporting, con un token bearer OAuth e il tuo developer token negli header:

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

(L’host REST, il modello di header OAuth + DeveloperToken e il path v13 arrivano dalla documentazione di Microsoft. Conferma nelle release notes il body esatto della richiesta per il tuo report prima di rilasciare.)

Asset generativi, scritti dall’API

Con la scadenza messa in calendario, il resto dell’anno è fatto di parità. Google ti ha già insegnato a usare tutte queste funzionalità.

Cosa è cambiato. Gli endpoint di raccomandazione sono arrivati a febbraio 2025 (SDK 13.0.24): CreateResponsiveSearchAdRecommendation, CreateAssetGroupRecommendation e CreateResponsiveAdRecommendation, ognuno con la sua controparte Refine…. Una variante basata su job e le raccomandazioni di brand kit sono arrivate a luglio 2025 (13.0.25), e AutoGeneratedAssetsEnabled si è aggiunto alle impostazioni RSA a febbraio 2026. Tutto dalle release notes.

Perché conta per il tuo account. Generare e iterare il copy degli annunci non è più una faccenda solo da UI: ora si può fare via script. È la differenza tra scrivere a mano il copy per dieci gruppi di asset e generarlo per centinaia.

Cosa fare. Collega gli endpoint di raccomandazione al workflow creativo che già esegui per Google. Genera, affina in base al brand kit, pubblica:

feed/prodotto → CreateResponsiveSearchAdRecommendation
              → RefineResponsiveSearchAdRecommendation    (esclusioni di termini del brand kit)
              → pubblica nel gruppo di annunci            (senza copia-incolla manuale dalla UI)

Bing diventa un altro canale di output della pipeline di copy che hai già, invece di una pipeline separata costruita a mano.

AI Max for Search, con un interruttore API

Cosa è cambiato. AI Max for Search è entrato in pilot a maggio 2026, con l’interruttore API AISearchSetting in Campaign Management. Porta corrispondenza estesa delle query, personalizzazione degli asset e routing intelligente degli URL, ovvero lo stesso allontanamento dalle parole chiave dell’AI Max di Google. Espone anche i guardrail tramite l’API: inclusioni ed esclusioni di brand, esclusioni di termini, restrizioni sui messaggi. Search Engine Land ha coperto il lancio insieme alla più ampia spinta di Microsoft verso l’agentic web.

Perché conta per il tuo account. Se già esegui una migrazione da DSA ad AI Max su Google, il playbook si trasferisce su Microsoft quasi uno a uno. E anche il compromesso. Guadagni copertura e cedi la corrispondenza e la scelta dell’URL, il che rende i guardrail la parte da non saltare.

Cosa fare. Imposta AISearchSetting sulla campagna e distribuisci i tuoi guardrail di brand kit in modo programmatico su tutti gli account, come fai su Google:

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

(AISearchSetting e le esclusioni di brand kit sono aggiunte reali di Campaign Management da marzo e maggio 2026. L’esatto annidamento dell’oggetto è illustrativo. AI Max è ancora un pilot, quindi conferma lo schema e lo stato GA nelle release notes appena prima di costruirci sopra.)

Portare il tuo setup Google ora costa pochissimo

Il tema più chiaro dell’anno è la convergenza. Microsoft ha fatto crollare il costo del trasferimento del tuo setup Google.

Perché conta per il tuo account. Quello che costruisci su Google ora si porta su Bing quasi uno a uno. Con il login Google non mantieni nemmeno un secondo modello mentale OAuth, perché usi la stessa identità Google per tutte e due le piattaforme:

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

Cosa fare. Scegli un solo job Google, quello con il ritorno più alto (gli obiettivi NCA e gli asset generativi sono di solito le prime scelte), e portalo su Bing come pilot. Il lavoro di autenticazione e import è già fatto, quindi il porting è soprattutto leggere il tuo stesso codice Google. (Le classi di grant Google OAuth sono aggiunte reali dell’SDK di dicembre 2025. Conferma l’esatto costruttore e il flusso di autenticazione sulle release notes, perché è un helper dell’SDK e non un valore di grant del token endpoint.)

La misurazione è cresciuta

Quattro upgrade collegano finalmente Bing alla tua BI e al tuo CRM, in entrambe le direzioni:

Perché conta per il tuo account. MSClickIdPerformanceReport è quello a cui ricorrere per primo. In Lynt gestiamo in BigQuery il reporting di business dei nostri clienti, fino ai loro singoli clienti finali. La join più preziosa di quel reporting è quella tra click ID e ordine CRM, perché una join con il CRM sostituisce il ROAS riportato dalla piattaforma con il numero vero. Su Google quella join gira sul GCLID. Questo report dà a Bing la stessa join, sul MSCLKID. E il report in sé è solo un altro invio REST verso l’endpoint Reporting v13, quindi si inserisce dritto nella migrazione della prima sezione.

Shopping, intanto, si è consolidato in silenzio. La vecchia Content API v9.1 è di fatto congelata (ultimo cambiamento nel 2024). Il moderno Microsoft Shopping gira attraverso il Microsoft Merchant Center e Bing Ads v13, cioè gruppi di asset PMax, il FeedItemPerformanceReport e i percorsi dei gruppi di schede, quei rami dell’albero dei prodotti su cui fai offerte.

All’orizzonte: annunci dentro il chatbot

Il filone più orientato al futuro è la scommessa di Microsoft sul commercio agentico. Ad Activate 2026 Microsoft ha lanciato Copilot Checkout, che permette di comprare direttamente dentro la chat, insieme ai Brand Agents per Shopify e a posizionamenti di annunci sotto le risposte conversazionali di Copilot. Performance Max compare sotto quei risultati. Il commento di marketing presenta il lancio di Copilot Checkout come la svolta AI-first di Microsoft: una superficie di shopping davvero nuova più che l’ennesimo spazio pubblicitario.

Per ora questo è più roba da tenere d’occhio che da automatizzare oggi, ma ha un prerequisito concreto, e io lo prendo sul serio. Abbiamo passato due anni a costruire Boostora, il nostro strumento che arricchisce i feed di Google Merchant Center con l’AI, proprio perché la qualità del feed è il tetto di ogni superficie di shopping automatizzata. Qui vale la stessa regola. Un prodotto compare come si deve in una risposta AI solo se i dati del suo feed e i suoi messaggi sono in ordine, quindi il lavoro poco appariscente sul feed è ciò che prepara uno store a vendere dentro la chat.

Sul fronte creativo, l’API ha aggiunto anche gli asset HTML5 (AddHTML5s, marzo 2026) e Video Animation (da immagine statica ad asset video, novembre 2025). Sono entrambi modi economici per pubblicare formati pubblicitari più ricchi senza un team di produzione.

L’anno su una sola timeline

Ogni voce v13 qui sotto arriva dalle release notes della Bing Ads API (ultimo aggiornamento 5 giugno 2026). Le righe che portano l’etichetta Piattaforma arrivano dal blog di Microsoft Advertising. Le uniche scadenze inderogabili sono le due date di SOAP, che portano l’etichetta HARD. La riga degli annunci politici UE è un obbligo di compliance, e tutto il resto è vantaggio opzionale. La colonna di destra fa la distinzione.

Da dove comincerei stasera

Non dall’intera migrazione. Da un grep. Cerca nel tuo codice ReportingService.svc e gli import dell’SDK SOAP, e annota ogni job che salta fuori. Quella lista è l’elenco completo dei job che smetteranno di funzionare il 31 gennaio 2027, e l’intera operazione ti ha richiesto dieci minuti.

Poi scegli un’automazione Google di cui vai fiero e chiediti quanto renderebbe su una piattaforma dove i tuoi concorrenti non si sono ancora fatti vivi. Il lavoro di parità è fatto. La finestra è aperta. Quale job porterai per primo?

FAQ