Torna alle notizie per sviluppatori

Presentazione dell'API Graph v18.0 e dell'API Marketing v18.0 di Facebook

12 settembre 2023DiNaveen Santhanavel

Oggi rilasciamo l'API Graph v18.0 e l'API Marketing v18.0 di Facebook. Come parte 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 considerate rilevanti per l'integrazione delle tue app con la nostra piattaforma.

Per una lista completa di tutte le modifiche e i relativi dettagli, visita il nostro registro modifiche.

Aggiornamenti generali

Consolidamento delle opzioni sullo stato della posizione geografica del pubblico per la targetizzazione basata sulla posizione

Come abbiamo annunciato a maggio 2023, abbiamo consolidato lo Stato della posizione geografica del pubblico all'opzione predefinita "Le persone che vivono o si trovavano in questo luogo di recente" al momento della scelta del tipo di pubblico di destinazione nelle selezioni di targetizzazione basata sulla posizione. Questo aggiornamento riflette un consolidamento di altre opzioni in precedenza disponibili e l'eliminazione dell'opzione "Persone che viaggiano in questo luogo".

Questa modifica fa parte del nostro continuo impegno nell'offrire maggiore valore alle aziende, semplificare i nostri sistemi di inserzioni e semplificare le opzioni di targetizzazione per aumentare l'efficienza delle prestazioni e rimuovere le opzioni il cui utilizzo è scarso.

Questo aggiornamento sarà valido per le campagne nuove o duplicate. Le campagne esistenti create prima del lancio non saranno coinvolte da questa modifica a meno che non siano in modalità bozza o duplicate.

Aggiunta di "aggiungi_suggerimenti_sulla_sicurezza" e "codice_scadenza_minuti" all'API Modello di messaggio di WA

All'inizio di quest'anno, abbiamo rilasciato la soluzione di autenticazione di WhatsApp che permetteva di creare e inviare modelli di autenticazione con pulsanti nativi e messaggi di autenticazione predefiniti. Con il rilascio dell'API Graph V18, stiamo apportando dei miglioramenti al recupero dei modelli di autenticazione, rendendo il processo del modello di autenticazione end-to-end più semplice per i BSP e le aziende.

Con l'API Graph v18, i BSP e le aziende possono avere maggiore visibilità sui contenuti dei modelli di autenticazione dei messaggi predefiniti successivamente alla loro creazione. In particolare, i payload restituiranno le opzioni di configurazione dei contenuti preimpostate oltre al testo utilizzato da WhatsApp. Questo miglioramento può consentire ai BSP e alle aziende di creare interfacce utente di "modifica" per i modelli di autenticazione che possono essere costruiti attraverso l'API.

Tieni presente che possono verificarsi degli errori nel caricamento dell'API Graph v18 se i BSP o le aziende prendono tutta la risposta dalla richiesta GET e la restituiscono alla richiesta POST per aggiornare i modelli. Per risolvere, i campi di testo campo/intestazione/piè di pagina devono essere eliminati prima di passare all'API.

Rilancio dei documenti di sviluppo e dei registri modifiche per la creazione di inserzioni per effettuare una chiamata

  • Posizionamento Facebook Reels per le inserzioni per effettuare una chiamata
    Meta sta rilasciando la possibilità di pubblicare inserzioni per effettuare una chiamata tramite la piattaforma Facebook Reels. Le inserzioni per effettuare una chiamata consentono agli utenti di chiamare le aziende nel momento della considerazione quando vedono un'inserzione e aiutano le aziende ad avere discussioni più complesse con gli utenti interessati. Si tratta di un'opportunità per le aziende di fare pubblicità con le inserzioni per effettuare una chiamata in base al comportamento in tempo reale delle persone su Facebook. Nel livello di gruppo di inserzioni in Gestione inserzioni, le aziende possono scegliere di aggiungere "Facebook Reels" nella sezione Posizionamenti.
  • Rilancio delle inserzioni per effettuare una chiamata tramite API
    Dal 12 settembre 2023, stiamo fornendo assistenza aggiornata per la creazione di inserzioni per effettuare una chiamata tramite l'API. Stiamo introducendo della documentazione esclusivamente per le inserzioni per effettuare una chiamata, così gli sviluppatori 3P potranno creare campagne per le inserzioni per effettuare una chiamata più facilmente e sapranno come vedere gli insight sulle campagne per le inserzioni per effettuare una chiamata in corso, incluse le metriche relative alla chiamata. In futuro prevediamo anche di supportare add-on per le chiamate tramite la nostra piattaforma API. Gli sviluppatori devono avere accesso alle autorizzazioni generali per creare inserzioni generali per poter creare inserzioni per effettuare una chiamata tramite la piattaforma API.

    Per ulteriori informazioni, consulta la documentazione per gli sviluppatori.

Rimozioni e modifiche sostanziali

Modifiche dell'API Graph per la funzione autorizzazione granulare dell'utente

Stiamo aggiornando due endpoint dell'API graph per gli account WhatsApp Business. Questi endpoint sono i seguenti:

  • Recupero dei modelli di messaggio associati all'account WhatsApp Business
  • Recupero dei numeri di telefono associati all'account WhatsApp Business

Con v18 stiamo introducendo la nuova funzione "autorizzazione granulare dell'utente". Tutti gli utenti esistenti che sono già aggiunti all'account WhatsApp Business saranno inseriti di nuovo e continueranno ad avere accesso (senza impatti).

L'amministratore ha la flessibilità di modificare queste autorizzazioni. Se l'amministratore modifica le autorizzazioni e rimuove l'accesso alla visualizzazione dei modelli di messaggio o dei numeri di telefono per uno degli utenti, questo utente specifico inizierà a ricevere un messaggio di errore che lo informerà che non ha l'autorizzazione a visualizzare i modelli di messaggio o i numeri di telefono in tutte le versioni v18 o precedenti.

Disattivazione della denominazione delle metriche legacy per i contenuti multimediali IG e gli insight degli utenti

A partire dal 12 settembre, Instagram rimuoverà le metriche duplicate e legacy relative agli insight dall'API Instagram Graph per condividere un'unica origine delle metriche con gli sviluppatori.

Questo nuovo aggiornamento riduce eventuali fraintendimenti e aumenta l'affidabilità e la qualità dei nostri report.

Novanta giorni dopo questo lancio (l'11 dicembre 2023), rimuoveremo tutte queste metriche duplicate e legacy relative agli insight dall'API Instagram Graph su tutte le versioni in modo da essere più coerenti con l'app Instagram.

Apprezziamo tutti i feedback che abbiamo ricevuto dalla nostra community di sviluppatori e speriamo di continuare a lavorare insieme.

Consulta gli insight sui contenuti multimediali e la documentazione degli sviluppatori sugli insight degli utenti per saperne di più.

Disattivazione degli endpoint Facebook Wi-Fi v1 e Facebook Wi-Fi v2

Facebook Wi-Fi è stato progettato per migliorare le esperienze di connessione agli hotspot Wi-Fi delle aziende. Ha permesso ai clienti di un venditore di avere il Wi-Fi gratuito semplicemente accedendo a Facebook. Ha anche permesso ai venditori di controllare chi poteva usare il loro Wi-Fi e per quanto tempo e l'ha integrato con le inserzioni per consentire la targetizzazione dei clienti che avevano utilizzato il Wi-Fi del venditore. Questo prodotto è stato dichiarato obsoleto dal 12 giugno 2023. Poiché il periodo di avviso ai partner si è concluso, tutti gli endpoint usati da Facebook Wi-Fi v1 e Facebook Wi-Fi v2 sono stati dichiarati obsoleti e rimossi.

Obsolescenze delle versioni dell'API:

Nell'ambito del programma di gestione delle versioni di Facebook per l'API Graph e l'API Marketing, tieni presente le seguenti obsolescenze in programma:

API Graph

  • 14 settembre 2023: l'API Graph v11.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • 8 febbraio 2024: l'API Graph v12.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • 28 maggio 2024: l'API Graph v13.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

API Marketing

  • 20 settembre 2023: l'API Marketing v14.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • 20 settembre 2023: l'API Marketing v15.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • 6 febbraio 2024: l'API Marketing v16.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

Per evitare interruzioni alla tua attività, consigliamo di effettuare la migrazione di tutte le chiamate all'ultima versione dell'API lanciata oggi.

SDK della Piattaforma Facebook

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

  • Ottobre 2023: gli SDK della Piattaforma Facebook v11.0 o versioni precedenti saranno disattivati
  • Febbraio 2024: gli SDK della Piattaforma Facebook v12.0 o versioni precedenti saranno disattivati