Graph API v24.0 e Marketing API v24.0: La Guida Definitiva ai Cambiamenti che Aumentano la Flessibilità e le Performance

Il mondo delle integrazioni Meta (precedentemente Facebook) non si ferma mai. Con il rilascio delle Graph API v24.0 e Marketing API v24.0 (ottobre 2025), gli sviluppatori e gli advertiser si trovano di fronte a un pacchetto di aggiornamenti che puntano dritto all’automazione, alla flessibilità di budget e alla semplificazione del targeting.

Se le vostre integrazioni si basano ancora sulla v23.0, è il momento di agire. Ecco un confronto diretto tra le versioni e le caratteristiche da implementare subito.

1. Rivoluzione del Budget: Flessibilità Estrema vs. Controllo Rigido

La novità più impattante riguarda la gestione del budget delle campagne, che introduce una maggiore dinamicità.

Caratteristica	Graph/Marketing API v23.0 (e precedenti)	Graph/Marketing API v24.0 (Novità)	Impatto per il tuo Business
Flessibilità Budget Giornaliero	Il sistema poteva spendere fino al 25% in più del budget giornaliero nei giorni migliori.	Il limite di flessibilità è innalzato fino al 75% del budget giornaliero.	Aumento delle Performance: Il sistema può cogliere molte più opportunità, bilanciando la spesa su base settimanale (massimo 7x il budget giornaliero).
Condivisione Budget Ad Set	Il budget era strettamente vincolato al singolo Ad Set (gruppo di annunci), a meno di usare la CBO.	Introduzione dell’Ad Set Budget Sharing, che consente di condividere fino al 20% del budget tra i gruppi di annunci della stessa campagna.	Ottimizzazione Automatica: Maggiore flessibilità e migliori risultati per le campagne che non utilizzano l’ottimizzazione del budget a livello di campagna (CBO).

2. Ottimizzazione delle Inserzioni: Automazione Abilitata per Default

La versione v24.0 prosegue il trend di rendere le funzionalità di ottimizzazione più semplici e predefinite, allineando l’API all’esperienza di Meta Ads Manager.

Caratteristica	Graph/Marketing API v23.0 (e precedenti)	Graph/Marketing API v24.0 (Novità)	Impatto per il tuo Business
Media Dinamici (Catalog Ads)	La funzionalità di media dinamici per gli annunci di catalogo Advantage+ era disabilitata per default (richiedeva l’opt-in esplicito).	È abilitata per default (OPT-IN) per tutti i nuovi annunci di catalogo Advantage+.	Migliore Utilizzo degli Asset: Aumento della creative liquidity (liquidità creativa) e migliore performance grazie all’uso automatico di video di prodotto e altri asset dinamici.
Controllo sui Posizionamenti	Era disponibile solo l’opt-out totale (esclusione completa) per i posizionamenti indesiderati.	È stata introdotta l’opzione “Spesa Limitata” (placement_soft_opt_out).	Controllo Sfumatato: Si può permettere a Meta di spendere fino al 5% del budget sui posizionamenti esclusi, solo se è previsto un significativo miglioramento delle performance.
Ottimizzazione Destinazione	La destinazione dell’annuncio era fissa all’URL impostato.	Possibilità di ottimizzare la destinazione, permettendo al sistema di selezionare dinamicamente l’URL più performante (es. homepage o pagina prodotto).	Miglioramento del Tasso di Conversione: L’utente viene indirizzato al miglior punto di atterraggio possibile, aumentando le chance di conversione.

3. Targeting e Dati: Semplificazione e Rigore

La v24.0 introduce modifiche che semplificano il targeting e aumentano la conformità sui dati.

• Consolidamento degli Interessi di Targeting Dettagliato: Meta sta unificando diversi interessi in raggruppamenti più ampi. Sebbene ciò riduca il numero di opzioni granulari, l’obiettivo è semplificare la configurazione senza sacrificare l’efficacia (es. “Etica animale” potrebbe confluire in “Diritti animali”). Azione Richiesta: Aggiornare gli elenchi di targeting utilizzati nelle integrazioni entro gennaio 2026.
• Enforcement dei Tipi di Campo per Lookalike Audiences: La creazione di Pubblici Simili (customaudiences con lookalike_spec) ora richiede un rigido allineamento dei tipi di campo specificati nella documentazione. Azione Richiesta: Verificare che i parametri inviati rispettino le specifiche per evitare fallimenti nella creazione di nuovi pubblici.

4. Aggiornamenti Strutturali e Breaking Changes

Non solo Marketing. La nuova versione porta con sé anche miglioramenti strutturali per gli sviluppatori.

• L’Introduzione di “Upsert” per i Prodotti: Con la v24.0, l’endpoint per i prodotti (POST /{product-item-id}) supporta il parametro allow_upsert=true. Questo è un enorme passo avanti, poiché permette di creare o aggiornare un articolo di prodotto in una singola chiamata API, eliminando la necessità di gestire logiche IF EXISTS THEN UPDATE ELSE CREATE.
• Breaking Change: Paginazione dei Modelli WhatsApp: È stato introdotto un nuovo codice di errore specifico per i cursori di paginazione non validi o scaduti sull’endpoint dei modelli di messaggio di WhatsApp. Azione Critica: Se si verifica questo errore, l’integrazione deve obbligatoriamente ricominciare la richiesta GET dal primo elemento (senza i parametri before e after).

La Tua Prossima Azione: Migrare Ora

La transizione alla Graph API e Marketing API v24.0 è fondamentale non solo per accedere alle nuove, potenti funzionalità di ottimizzazione del budget e delle campagne, ma anche per garantire la continuità del servizio.

Le vecchie versioni delle API vengono regolarmente dismesse. Per evitare interruzioni del tuo business e sfruttare i miglioramenti che garantiscono maggiori performance pubblicitarie, ti consigliamo di pianificare la migrazione alla v24.0 il prima possibile.