Introducing Graph API v22.0 and Marketing API v22.0

Oggi rilasciamo l'API Graph v22.0 e l'API Marketing v22.0. Nell'ambito del lancio riportiamo di seguito le modifiche che riteniamo rilevanti per parte della nostra community di sviluppatori. Queste modifiche includono annunci, aggiornamenti di prodotti e notifiche di obsolescenze relative all'integrazione di una o più applicazioni con la nostra piattaforma.

Per un elenco completo di tutte le modifiche e i relativi dettagli, consulta il nostro registro modifiche.

Aggiornamenti generali

Cambiamenti nell'uso di gruppi di pubblico personalizzato da un elenco di clienti nelle campagne relative ad abitazioni, impiego e prodotti e servizi finanziari (incluso il credito) per l'API Marketing v22.0

Si applicano alla 'v22.0+' e verranno lanciati in tutte le versioni a marzo 2025

Alcuni gruppi di pubblico personalizzato da un elenco di clienti non saranno più idonei per essere utilizzati nelle campagne relative ad abitazioni, impiego e prodotti e servizi finanziari (incluso il credito). Scopri di più sull'aggiornamento qui e verifica se le restrizioni si applicano al tuo caso. Inoltre, il campo is_sac_cfca_terms_certified verrà aggiunto a livello del gruppo di inserzioni, come in questo esempio. Dovrai usare questo campo per certificare che tutti i gruppi di pubblico personalizzato da un elenco di clienti utilizzati in un gruppo di inserzioni di campagne relative ad abitazioni, impiego e prodotti e servizi finanziari (incluso il credito) rispettano la certificazione CLCA di Meta. A partire da aprile 2025, le campagne/i gruppi di inserzioni esistenti che utilizzano gruppi di pubblico personalizzato da un elenco di clienti non conformi ai requisiti possono essere sospesi. In tal caso, vedrai gli errori in con le relative istruzioni in Gestione inserzioni e nell'API Marketing.

Saranno interessati i seguenti endpoint:

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

API del pubblico personalizzato v22.0

A partire dal 6 gennaio 2025, puoi utilizzare il nuovo campo is_eligible_for_sac_campaigns per identificare se un pubblico personalizzato può essere utilizzato in gruppi di inserzioni di campagne con categorie speciali di inserzioni. Devi fornire i valori special_ad_categories e special_ad_category_countries previsti della campagna con categorie speciali di inserzioni che userà il pubblico, oltre al valore ad_account_id che userà il pubblico per creare o modificare il gruppo di inserzioni.

Saranno interessati i seguenti endpoint:

• GET /custom_audience_id

Raggiungimento delle persone interessate nelle città e aree geografiche da te selezionate

Siamo entusiasti di condividere il lancio di una nuova funzione per la targetizzazione basata sulla posizione che aiuta gli inserzionisti a migliorare le prestazioni spingendosi oltre le città e aree geografiche selezionate. Infatti, offre al nostro sistema pubblicitario la flessibilità di mostrare inserzioni a persone che hanno dimostrato interesse in una posizione diversa.

Questa funzione espande la nostra funzione di targetizzazione basata sulla posizione esistente, consentendoti di raggiungere le persone che hanno mostrato l'intenzione di viaggiare, effettuare acquisti o un interesse generale per le città e le aree geografiche che hai selezionato, all'interno dello stesso Paese.

Durante la fase di test, i clienti che hanno usato la nuova funzione per la targetizzazione basata sulla posizione hanno assistito a una diminuzione del 6,7% del costo per risultato.

Per maggiori informazioni clicca qui.

Rimozioni e modifiche sostanziali

Sostituzione degli endpoint Instagram User, Instagram Media, Instagram Carousel e Instagram Comment con gli endpoint IG User, IG Media e IG Comment

Abbiamo deciso di apportare modifiche all'API Instagram Graph e all'API Marketing per permettere agli sviluppatori di costruire più facilmente soluzioni per le aziende. A fronte di queste modifiche, gli oggetti Instagram User, Instagram Media, Instagram Carousel e Instagram Comment verranno resi obsoleti nell'API Graph v22.0 e saranno sostituiti dagli oggetti IG User, IG Media che include i caroselli, e IG Comments. Abbiamo anche aggiunto funzionalità a questi nuovi oggetti per renderli equamente funzionali per la maggior parte dei casi d'uso.

Gli sviluppatori avranno fino al 21 gennaio 2026 per aggiornare gli endpoint dell'API Marketing coinvolti e fino al 21 aprile 2025 per aggiornare gli endpoint dell'API Graph coinvolti che stanno utilizzando. Se hai scelto di aggiornare automaticamente le versioni dell'API Graph durante le chiamate API, ti consigliamo di controllare questi cambiamenti in quanto si applicano immediatamente per gli sviluppatori che utilizzano l'API Graph v22.0.

Consulta il blog degli sviluppatori per ottenere ulteriori dettagli su questi cambiamenti, incluso quali endpoint stanno cambiando, quali casi d'uso non sono più supportati e quali tempistiche è necessario rispettare.

Rimozione delle esclusioni di targetizzazione dettagliata

In linea con i nostri continui sforzi per aiutare gli inserzionisti a migliorare le prestazioni, abbiamo deciso di rimuovere le esclusioni di targetizzazione dettagliata. Nell'ambito di questa procedura, continueremo a supportare la possibilità di escludere i tuoi datori di lavori tra i controlli del pubblico a livello dell'account. Per ulteriori informazioni sui controlli dell'account, dai un'occhiata qui.

Crediamo che questa modifica possa aiutare a migliorare le prestazioni delle campagne. Un test di un'inserzionista ha dimostrato che il costo mediano per conversione era inferiore del 22,6% quando non sono state applicate le esclusioni della targetizzazione dettagliata (rispetto a quando sono state usate).

Di conseguenza, i gruppi di pubblico personalizzato non saranno più disponibili nel campo delle esclusioni. Puoi comunque continuare a usare le esclusioni dei gruppi di pubblico personalizzati usando il campo excluded_custom_audiences.

A partire dal 21 gennaio 2025, gli sviluppatori possono iniziare a implementare le modifiche del codice, e avranno tempo fino al 21 aprile 2025 per apportare questi aggiornamenti. Questa modifica verrà rilasciata nella v22.0. Consulta il blog degli sviluppatori per visualizzare una lista degli endpoint coinvolti in questo cambiamento.

Disattivazione del bundle di miglioramenti standard dall'API Marketing

Impatto dell'API Marketing v22.0 sui miglioramenti delle creatività Advantage+

In questa nuova versione dell'API Marketing, il bundle dei miglioramenti standard delle creatività Advantage+ sarà reso obsoleto e lo sostituiremo con l'attivazione di miglioramenti delle singole creatività. Scopri di più sulle creatività Advantage+ qui.

Qui trovi maggiori informazioni che possono interessare la community degli sviluppatori, mentre qui trovi ulteriori dettagli all'interno della documentazione per gli sviluppatori.

I miglioramenti standard non saranno più supportati con questi endpoint:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• GET /{ad_id}/previews

Introduzione della metrica Visualizzazioni su Instagram e disattivazione delle metriche Impression e Riproduzioni

Proseguendo nell'intento di allineare la funzionalità dell'API Instagram con quella dell'app Instagram, abbiamo deciso di introdurre la metrica Visualizzazioni in tutte le versioni dell'API per gli insight sia sui contenuti multimediali che sugli utenti. Per gli insight sui contenuti multimediali, gli oggetti feed, storia e reel restituiranno le visualizzazioni. Per gli insight sugli utenti, l'API supporterà la metrica Visualizzazioni con dettagli multidimensionali per tipo di follower e per tipo di prodotto con contenuto multimediale.

Inoltre, le seguenti metriche diventeranno obsolete a partire dalla v22.0:

• riproduzioni (insight sui contenuti multimediali): numero di volte in cui viene avviata la riproduzione del reel dopo che un'impression è già stata conteggiata.
• clips_replays_count (insight sui contenuti multimediali): numero di volte in cui viene avviata la riproduzione del tuo reel dopo essere già stato riprodotto una prima volta. In questo caso, una riproduzione viene considerata a partire da 1 millisecondo nella stessa sessione di reel.
• ig_reels_aggregated_all_plays_count (insight sui contenuti multimediali): numero di volte in cui viene avviata la riproduzione o la riproduzione ripetuta del tuo reel dopo che un'impression è già stata conteggiata.
• impression (insight sui contenuti multimediali e sugli utenti): numero totale di volte in cui l'oggetto contenuto multimediale di Instagram è stato visualizzato.

La metrica degli insight sui contenuti multimediali Impression sarà resa obsoleta solo per i contenuti multimediali creati a partire dal 2 luglio 2024. Per quelli creati prima di questa data, l'API continuerà a restituire valori come di consueto in tutte le versioni.

Per ulteriori informazioni sugli insight sugli utenti di Instagram e sugli insight sui contenuti multimediali di Instagram, consulta la nostra documentazione per sviluppatori. Per evitare problemi, invita i tuoi sviluppatori a effettuare gli aggiornamenti entro il 21 aprile 2025.

SDK di Meta Business

Rilascio dell'SDK di Meta Business v22.0

Il rilascio dell'SDK v22.0 di Meta Business avverrà poco dopo il rilascio dell'API Graph v22.0 e includerà risoluzioni di bug, aggiornamenti delle dipendenze, nuove funzioni e, soprattutto, un'interfaccia dell'API aggiornata per garantire la corrispondenza con l'API Graph v22.0.

Nell'ambito del nostro programma di obsolescenza a 2 anni per gli SDK della piattaforma, ti ricordiamo le obsolescenze e le disattivazioni in programma:

• Maggio 2025: gli SDK della Piattaforma Facebook v17.0 o versioni precedenti diventeranno obsoleti.

Obsolescenze delle versioni dell'API:

Nell'ambito del programma di gestione delle versioni per l'API Graph e l'API Marketing, tieni conto delle obsolescenze programmate:

API Graph

• 14 maggio 2025: l'API Graph v16.0 sarà resa obsoleta e rimossa dalla piattaforma
• 12 settembre 2025: l'API Graph v17.0 sarà resa obsoleta e rimossa dalla piattaforma

API Marketing

• 4 febbraio 2025: l'API Marketing v19.0 sarà resa obsoleta e rimossa dalla piattaforma
• 6 maggio 2025: l'API Marketing v20.0 sarà resa obsoleta e rimossa dalla piattaforma

Per evitare disservizi, consigliamo di effettuare la migrazione di tutte le chiamate all'ultima versione dell'API lanciata oggi.