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

Oggi rilasciamo l'API Graph v17.0 e l'API Marketing v17.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.

Obsolescenze e modifiche sostanziali

Obsolescenza di Strategie pubblicitarie

Il prodotto beta Strategie pubblicitarie è stato dichiarato obsoleto dal 28 ottobre 2022. Per questo motivo, con il rilascio dell'API Marketing v17.0 saranno dichiarati obsoleti i campi ad_strategy_id e ad_strategy_group_id sull'endpoint campaigns.

Obsolescenza dell'API Offline Conversions

Da febbraio 2023, l'API Conversions supporta completamente gli eventi offline, garantendo le funzioni di parità fornite dall'attuale endpoint dell'API Offline Conversions. Accorpando le nostre API per gli eventi web e offline in un'unica API, speriamo di semplificare e migliorare la modalità di utilizzo dei dati di marketing su più canali da parte degli inserzionisti per migliorare l'ottimizzazione delle inserzioni, i gruppi di pubblico personalizzato e la misurazione.

A partire dalla versione 17 dell'API Graph, rilasciata il 23 maggio 2023, l'API Offline Conversions non supporterà più gli eventi offline. Consigliamo agli inserzionisti con integrazioni dell'API Offline Conversions di convertire l'integrazione in un'integrazione dell'API Conversions e di non aggiornare l'API Offline Conversions fino al completamento di tale operazione.

Obsolescenza della creazione degli obiettivi precedente

Come annunciato a dicembre 2021, abbiamo riprogettato l'esperienza di selezione degli obiettivi durante la creazione di nuove campagne in modo da fornire agli inserzionisti una guida efficace alle configurazioni delle campagne, che possa aiutarli a raggiungere i loro obiettivi di marketing. La nuova esperienza, Esperienze pubblicitarie basate su risultati, ha determinato modifiche all'API Marketing.

A partire dal rilascio dell'API Marketing v17.0, inizieremo la procedura per dichiarare obsoleto il supporto per l'esperienza e gli obiettivi precedenti. Quando si utilizza l'API Marketing v17.0, le campagne possono essere create solo con obiettivi dell'Esperienza pubblicitaria basata su risultati e le API degli obiettivi precedenti diventeranno obsolete. Le campagne precedenti esistenti e la relativa duplicazione continueranno ad essere supportate senza subire modifiche in questa versione. Maggiori dettagli sono disponibili nel nostro ultimo post sul blog degli sviluppatori.

Campo per i miglioramenti standard delle creatività Advantage+ obbligatorio

All'inizio di quest'anno, abbiamo rilasciato miglioramenti standard delle creatività Advantage+ nell'API Marketing. A partire dal 23 maggio 2023, agli utenti dell'API Marketing verrà richiesto di specificare l'iscrizione di un'inserzione ai miglioramenti standard delle creatività Advantage+ fornendo "OPT_IN" o "OPT_OUT" nel campo "enroll_status". Se il campo viene lasciato vuoto, l'utente riceve un messaggio di errore e viene indicata la necessità di completare il campo. Per maggiori informazioni sui miglioramenti standard delle creatività Advantage+ nell'API Marketing, consulta questo post sul blog degli sviluppatori.

Sono interessati i seguenti endpoint:

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

Obsolescenza delle inserzioni del catalogo Advantage+ per lo streaming

Con il rilascio della versione v17 dell'API Marketing, viene dichiarato obsoleto l'utilizzo del catalogo Inserzioni del catalogo Advantage+ per lo streaming (A+CA per lo streaming). Le inserzioni del catalogo di vendita rappresentano l'alternativa consigliata ad A+CA per lo streaming. Di seguito è riportata una guida per la configurazione di un catalogo di vendita. I seguenti endpoint saranno dichiarati obsoleti:

• Creazione di un catalogo A+CA per lo streaming: segmento owned_product_catalogs con media_titles settore
• Caricamento dei feed Media Title: segmento product_feeds per un catalogo A+CA per lo streaming
• Creazione di un elemento Media Title: segmento media_titles per un catalogo A+CA per lo streaming
• Creazione di una campagna utilizzando un catalogo A+CA per lo streaming: segmento campaigns con un catalogo DAS su L3, L2 o L1

Il 21 agosto 2023, le modifiche precedenti si applicheranno a tutte le versioni dell'API Marketing e metteremo in pausa tutte le campagne con cataloghi A+CA per lo streaming collegate a livello L3, L2 o L1.

Obsolescenza dell'API Instant Articles

Poiché il prodotto Instant Articles è diventato obsoleto il 20 aprile 2023, ora sarà dichiarata obsoleta anche l'API che consente agli editori di gestire gli instant article.

Applicazione dell'autorizzazione Business Management agli account utente

In precedenza, venivano restituite pagine gestite dall'amministratore strumenti business aggiuntive senza l'accesso all'autorizzazione business_management. A partire dal 23 maggio 2023, se desideri continuare a ricevere l'accesso alle pagine gestite dall'amministratore strumenti business, sarà necessaria l'autorizzazione business_management. Puoi consultare la pagina business_management per maggiori dettagli relativi a questa autorizzazione.

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

• 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
• 8 febbraio 2024: l'API Graph v12.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

API Marketing

• 15 agosto 2023: l'API Marketing v14.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
• 15 agosto 2023: l'API Marketing v15.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:

• 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