Introducing Facebook Graph API v12.0 and Marketing API v12.0
Oggi rilasciamo l'API Graph v12.0 e l'API Marketing v12.0 di Facebook. Di seguito abbiamo messo in evidenza le modifiche che interesseranno alcune parti della nostra community di sviluppatori. Tali modifiche includono avvisi e aggiornamenti del prodotto, promemoria di lanci precedenti e notifiche su rimozioni su larga scala che potrebbero influire sull'integrazione delle tue app con la nostra piattaforma.
Per una lista completa di tutte le modifiche e dei relativi dettagli, visita il nostro registro modifiche.
Avvi e aggiornamenti generali
API Conversions: espansione della versione minima richiamabile
Compatibilità dell'API Graph con le versioni precedenti per le app create con i token d'accesso con un clic A partire dalla v12.0, i token d'accesso appena creati e generati nella tab Impostazioni dell'API Conversions in Gestione eventi sono ora supportati da tutte le versioni disponibili dell'API Graph (consulta le versioni supportate qui).
Tieni presente che le chiamate effettuate con questi token a una versione dell'API Graph obsoleta verranno automaticamente fatte corrispondere alla versione meno recente disponibile. Questo comportamento si applica solo agli endpoint dell'API Graph. Gli endpoint dell'API Marketing, compresa l'API Conversions, non supportano il comportamento di aggiornamento automatico e genereranno un'eccezione.
API User Profile per messaggi di Instagram: nuovi campi
Stiamo apportando miglioramenti all'API User Profile per messaggi di Instagram. In precedenza, l'API User Profile per Instagram supportava due campi: 1) Nome e 2) URL dell'immagine del profilo. Per consentire alle aziende di personalizzare meglio e mostrare più in alto i messaggi in base alle informazioni utente pubblicamente disponibili, abbiamo aggiornato l'API in modo da includere anche le seguenti informazioni:
1. Numero di follower
2. Badge di verifica
3. Aziende che seguono l'account dell'utente [Sì/No]
4. Account dell'utente che segue l'account aziendale [Sì/No]
Fai riferimento alla documentazione per gli sviluppatori per i dettagli.
Targetizzazione dettagliata di nuove opportunità
Per aiutare gli inserzionisti a trovare altre opportunità che non erano disponibili per loro in origine, quando questi ultimi sfruttano la targetizzazione dettagliata e ottimizzano per conversioni, valore o eventi nell'app utilizzando l'obiettivo conversioni, verranno automaticamente inclusi nell'espansione della targetizzazione. Per ulteriori informazioni, fai riferimento all'articolo del Centro assistenza sull'espansione della targetizzazione dettagliata.
API Video: nuovi campi
Abbiamo aggiunto due nuovi campi (views e post_views) al nodo [Video]. Consulta la documentazione per gli sviluppatori sull'API Video per maggiori informazioni.
Rimozioni e modifiche sostanziali
Trasparenza degli errori
Il comportamento predefinito dell'API Graph e dell'API Marketing consiste nel generare un errore quando un'app richiede un campo o un segmento su un nodo che restituisce uno o più nodi associati, ma non dispone delle autorizzazioni adeguate richieste da tali nodi associati. Tuttavia, alcuni di questi campi e segmenti non seguivano questo protocollo e venivano semplicemente omessi dalle risposte dell'API se l'app per le chiamate non disponeva delle autorizzazioni adeguate.
A partire dalla v12.0, questi campi e segmenti rispetteranno il comportamento predefinito. Questa modifica verrà applicata a tutte le versioni il 13 dicembre 2021.
Utenti del sistema e ruoli dell'app
Non sarà più supportata la possibilità che agli utenti del sistema vengano assegnati ruoli sulle app a meno che gli utenti e le app non appartengano alle stesse aziende. Per evitare interruzioni della tua app e della tua azienda, ti consigliamo di rimuovere tali utenti del sistema dalla tua app e di utilizzare invece l'API Business On Behalf Of. Questa modifica sostanziale entrerà in vigore il 13 dicembre 2021.
Video in diretta programmato
Non stiamo più supportando il parametro planner_start_time all'interno della funzionalità di programmazione nell'API Live e la modifica sostanziale entrerà in vigore il 13 dicembre 2021. Un nuovo parametro sarà reso disponibile in una data futura.
Piattaforma Messenger: API Conversation
Non stiamo più supportando il campo user_id dai metadati della conversazione nell'API Conversation. Tutti gli sviluppatori dovranno effettuare la migrazione di qualsiasi riferimento a user_id (IGID) e affidarsi completamente a IGSID come identificativo principale di una conversazione tra l'utente e l'azienda.
Tale modifica sostanziale entrerà in vigore nelle versioni precedenti dell'API Graph il 13 dicembre 2021. Consulta la documentazione per gli sviluppatori sull'API Conversation per maggiori informazioni.
Piattaforma Messenger: webhook per Instagram
Stiamo aggiornando la nostra API Messenger per il webhook di reazione su Instagram per supportare meglio le reazioni con emoji. L'attuale versione restituisce il campo emoji come una stringa: con questo aggiornamento, i webhook di reazione restituiranno un nuovo formato unicode. Tieni presente che il campo "reazione" supporterà solo gli emoji predefiniti. Per tutti gli altri emoji il campo di reazione restituirà "altro", allo stesso modo di MSGR.
Questa modifica sostanziale entrerà in vigore nelle versioni precedenti dell'API Graph a partire dal 13 dicembre 2021. Per continuare a supportare le reazioni con emoji, tutti gli sviluppatori devono effettuare la migrazione del nuovo unicode che stiamo restituendo entro il 13 dicembre 2021. Fai riferimento alla documentazione per gli sviluppatori sui webhook per i dettagli.
Rimozioni di versioni dell'API:
Nell'ambito del programma di gestione delle versioni di Facebook per l'API Graph e l'API Marketing, di seguito sono riportate le prossime rimozioni:
API Graph
- 2 novembre 2021: l'API Graph v4.0 verrà dichiarata obsoleta e rimossa dalla piattaforma
- 3 febbraio 2022: l'API Graph v5.0 verrà dichiarata obsoleta e rimossa dalla piattaforma
- 22 maggio 2022: l'API Graph v6.0 verrà dichiarata obsoleta e rimossa dalla piattaforma
Per evitare interruzioni della tua azienda, ti consigliamo di effettuare la migrazione di tutte le chiamate all'ultima versione lanciata oggi.
API Marketing
- L'API Marketing v10.0 verrà dichiarata obsoleta il 4/10/2021
- L'API Marketing v11.0 verrà dichiarata obsoleta il 23/02/2022
Per evitare interruzioni della tua azienda, ti consigliamo di effettuare la migrazione di tutte le chiamate all'ultima versione dell'API Marketing lanciata oggi. (Visita il registro modifiche per maggiori dettagli).
SDK della piattaforma Facebook
- Il 19 gennaio 2021 abbiamo annunciato il programma di gestione delle rimozioni di 2 anni per l'SDK della piattaforma Facebook v8.x e precedenti. Queste versioni scadranno a gennaio 2023.
- L'8 giugno 2021, abbiamo rilasciato l'SDK della piattaforma Facebook v11.0, che ha iniziato la rimozione di 2 anni dell'SDK della piattaforma Facebook v9.0. L'SDK v9.0 scadrà a giugno 2023.
Rimozioni generali
Rimozione dell'endpoint delle offerte native
L'8 giugno 2021, abbiamo annunciato la rimozione dell'API Offers Ads. Entrerà in vigore immediatamente con il rilascio dell'API Graph v12.0.
Piattaforma Messenger: modelli per le compagnie aeree
L'8 giugno 2021, abbiamo annunciato la rimozione dei modelli per le compagnie aeree. Entrerà in vigore il 6 dicembre 2021.
