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

Oggi rilasciamo l'API Graph v16.0 e l'API Marketing v16.0 di Facebook. Come parte del lancio, riportiamo di seguito i cambiamenti che riteniamo rilevanti per parte della nostra community di sviluppatori. Queste modifiche includono annunci, aggiornamenti di prodotto e notifiche di obsolescenze che riteniamo 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.

Avvisi e aggiornamenti generali

Risposte agli errori della piattaforma WhatsApp Business

Nell'ambito del nostro costante impegno per migliorare il comportamento di risposta agli errori delle API, abbiamo apportato le seguenti modifiche.

• I sottocodici di errore, usati raramente e su cui non si dovrebbe fare affidamento, non saranno più inclusi nelle risposte degli errori a partire dalla versione 16.0. Usa invece code e details.
• Il codice di errore 100 ("code":100) aveva più titoli unici che indicavano la natura di un dato errore. Tutti gli errori codice 100 ora useranno come titolo Invalid Parameter. I vecchi titoli che descrivevano la natura di un dato errore codice 100 sono stati spostati nella proprietà details. Questa modifica si riflette anche nei payload dei webhook che descrivono una risposta all'errore codice 100.
• Gli oggetti degli errori webhook hanno ottenuto una nuova proprietà del messaggio che esegue il mapping alla proprietà del messaggio nei payload di risposta agli errori delle API.

La piattaforma per sviluppatori ora richiederà la verifica dell'azienda per l'accesso avanzato a qualsiasi API

Come annunciato il 1° febbraio 2023, come parte della procedura per confermare l'autenticità e la legittimità di un'azienda o un'organizzazione, ora Meta chiederà agli sviluppatori di verificare le loro aziende per ottenere l'accesso avanzato per qualsiasi autorizzazione sulla piattaforma per gli sviluppatori di Meta.

Per le app create dopo il 1° febbraio 2023, inizieremo a implementare gradualmente questa procedura quando le nuove app richiederanno l'accesso avanzato. Le app con accesso avanzato create prima del 1° febbraio 2023 dovranno essere collegate a un'azienda verificata a partire dal 1° maggio 2023. Per una lista delle autorizzazioni che richiedono la verifica dell'azienda prima di poter essere approvate per l'accesso avanzato, consulta questa pagina.

Obsolescenze e modifiche sostanziali

Obsolescenza della funzione Considerazione del viaggio

Nel 2018 abbiamo lanciato Considerazione del viaggio come funzione che gli inserzionisti di viaggi potevano attivare per dare priorità alla pubblicazione delle inserzioni per chi esprimeva l'intenzione di viaggiare, ma non aveva ancora deciso dove andare. Considerazione del viaggio funzionava in combinazione con le opzioni di targetizzazione esistenti per aiutare gli inserzionisti a pubblicare inserzioni per le persone giuste al momento giusto su Facebook, Instagram e Audience Network. Negli ultimi 4 anni abbiamo continuato a sviluppare i nostri sistemi di apprendimento automatico ed effettuato test approfonditi e ora siamo in grado di aiutare gli inserzionisti di viaggi a raggiungere i consumatori che intendono viaggiare e a conseguire obiettivi di prestazioni simili senza dover attivare una funzione specifica.

A partire dal 2 febbraio 2023, Considerazione del viaggio verrà rimossa come opzione in Gestione inserzioni e nell'API per le nuove campagne. Siamo giunti alla conclusione che gli inserzionisti dovrebbero poter vedere le stesse prestazioni senza dover attivare una funzione specifica. Nel frattempo, è improbabile che l'attivazione o la disattivazione abbia un impatto di qualche rilievo sulle prestazioni della campagna.

Con il costante miglioramento dei modelli di apprendimento automatico, gli stessi obiettivi e le stesse prestazioni ora possono essere raggiunti senza dover attivare un'opzione, per questo riteniamo che rimuoverla fornirà un'esperienza più snella.

Obsolescenza della funzione di prospecting per le inserzioni relative ai voli

A settembre 2018 abbiamo lanciato le inserzioni per il prospecting relative ai voli e questa funzione aveva ottenuto un certo successo. A metà del 2021, il prodotto ha iniziato a presentare problemi tecnici e sono stati identificati errori che impedivano l'esecuzione efficiente delle campagne. Pertanto, abbiamo deciso di mostrarci proattivi e comunicare agli inserzionisti di passare ad altre opzioni per l'acquisizione di clienti. La funzionalità di retargeting rimane ancora presente e può essere utilizzata dagli inserzionisti.

Se tu o un tuo partner state attualmente utilizzando la funzione di prospecting per le inserzioni relative ai voli, consigliamo di disattivare tutte le campagne esistenti entro il 1° maggio 2023.

Obsolescenza della funzione di posizionamento pubblicitario Instant Articles

Rimuoveremo Instant Articles e il posizionamento pubblicitario Instant Articles da Facebook a partire dal 20 aprile 2023. Abbiamo introdotto per la prima volta Instant Articles nel 2015 per consentire agli editori di creare articoli multimediali interattivi su dispositivi mobili e monetizzarli con inserzioni su Facebook. Tuttavia, la lettura di notizie è solo una piccola parte dell'esperienza di Facebook per la maggioranza delle persone che utilizzano la piattaforma e che ci dicono di voler vedere meno di questi contenuti nei loro feed. Pertanto, stiamo adattando i nostri investimenti per allinearli meglio alle preferenze degli utenti.

Il posizionamento pubblicitario Instant Articles non sarà più disponibile per la creazione di nuove campagne all'interno di Gestione inserzioni e dell'API Marketing a partire dal 20 aprile 2023. Dopo questa data, i gruppi di inserzioni precedenti contenenti esclusivamente il posizionamento Instant Articles saranno messi in pausa, mentre tutti gli altri gruppi di inserzioni che includono il posizionamento Instant Articles saranno aggiornati automaticamente per escludere il posizionamento.

Nascondere reazioni, commenti e tag sui contenuti pubblicati sui profili utente

Con questa versione, stiamo implementando una modifica che consentirà all'utente di nascondere i commenti, le reazioni e i tag della sessione. I campi "via" e "sharedposts" restituiranno dati vuoti anche per i post sui profili utente. Questa modifica influirà solo sui contenuti pubblicati nei profili utente.

Obsolescenza del supporto per le versioni di TLS antecedenti alla 1.2

Per migliorare il nostro approccio alla sicurezza, non forniremo più il supporto dell'API Graph per le versioni TLS antecedenti a TLS 1.2. Se si utilizza TLS 1.2, anche l'accesso tramite crittografia RSA statica (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) sarà dichiarato obsoleto. Le richieste API effettuate con versioni di TLS precedenti riceveranno un messaggio di errore dopo 90 giorni.

Rifiuteremo anche il traffico web verso developer.facebook.com dopo il 1° maggio 2023 dai browser che utilizzano versioni precedenti di TLS (antecedenti a TLS 1.2 e che utilizzano cifrari RSA statici [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] se si utilizza TLS1.2).

Categorie di modelli di WhatsApp

Lo scorso anno abbiamo aggiornato i tipi di categorie di modelli in WhatsApp Manager e API per acquisire nuovi casi d'uso inviati sulla piattaforma WhatsApp Business. Il 2 febbraio 2023 rinomineremo queste categorie di modelli per rispecchiare in modo più preciso questi casi d'uso:

• I modelli di marketing continueranno a essere denominati marketing (nessuna modifica)
• I modelli transazionali verranno rinominati in utility
• I modelli OTP verranno rinominati in autenticazione

Le aziende devono utilizzare queste categorie di modelli aggiornate se creano o modificano modelli utilizzando Graph v16. Il 1° maggio questa modifica verrà applicata a tutte le versioni, quindi qualsiasi tentativo di creare o modificare modelli utilizzando qualsiasi versione dovrà utilizzare queste nuove categorie. Per garantire che non vi siano interruzioni del processo di creazione o modifica dei modelli, le aziende e i fornitori di soluzioni business dovrebbero dare la priorità all'aggiornamento delle proprie chiamate API per utilizzare nuovi valori di categoria e modelli entro e non oltre il 1° maggio 2023.

Di seguito sono riportate alcune altre date e considerazioni chiave:

• Migrazione dei modelli: il 1° aprile WhatsApp eseguirà la migrazione di tutti i modelli esistenti alle nuove categorie di modelli. Le aziende possono visualizzare la nuova categorizzazione dei loro modelli in WhatsApp Manager e avranno tempo fino al 15 maggio per rivederla. Se un'azienda non è d'accordo con la classificazione, può presentare ricorso fino al 15 maggio. Tutti i nuovi modelli creati o modificati utilizzando l'API Graph v15 o versioni precedenti tra il 1° aprile e il 1° maggio migreranno al nuovo modello il 5 maggio. Pertanto, consigliamo di iniziare a chiamare v16 per la creazione dei modelli a partire dal 1° aprile. A partire dal 1° maggio, qualsiasi modello creato in WhatsApp Manager o qualsiasi versione dell'API Graph rifletterà le nuove categorie di modelli.
• Creazione di modelli in nuove categorie di modelli: a partire dal 1° aprile, tutti i modelli creati in Graph API v16 e WhatsApp Manager richiederanno la convalida della categoria per l'approvazione. Qualsiasi modello appena creato o modificato potrebbe essere rifiutato se WhatsApp rileva che la categoria selezionata non è corretta. Il motivo del rifiuto spiegherà che la categoria selezionata non corrisponde al contenuto del modello, secondo le nostre linee guida per i modelli. Le aziende possono quindi scegliere di modificare la selezione della categoria e ripetere l'invio, modificare il modello o presentare ricorso contro la decisione. A partire dal 1° maggio, i nuovi modelli con variabili richiederanno campioni in linea. A partire dal 1° giugno, le aziende riceveranno gli addebiti calcolati sui nuovi tariffari in base alla categoria del modello.

Piattaforma Messenger API

Stiamo semplificando le notifiche ricorrenti rimuovendo l'opzione per specificare la frequenza dei messaggi a partire dalla v16. Per ulteriori informazioni, consulta il registro modifiche di Messenger.

Obsolescenza di versioni dell'API:

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

API Graph

• 23 febbraio 2023: l'API Graph v9.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
• 8 giugno 2023: l'API Graph v10.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
• 14 settembre 2023: l'API Graph v11.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

API Marketing

• 25 aprile 2023: l'API Marketing v14.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

Per evitare interruzioni dell'attività, consigliamo di eseguire 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:

• Giugno 2023: gli SDK della Piattaforma Facebook v9.0 o versioni precedenti saranno disattivati
• 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