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

23 gennaio 2024DiMohamed Amr Abouelhassan

Attiva iscrizione a Novità per gli sviluppatori

Oggi rilasciamo l'API Graph v19.0 e l'API Marketing v19.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 relative all'integrazione di una o più applicazioni con la nostra piattaforma.

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

Aggiornamenti generali

Attivazione di targetizzazione dettagliata Advantage per gli obiettivi e le ottimizzazioni di tutte le campagne

Nell'ambito del nostro costante impegno per aiutare gli inserzionisti a ottenere maggiori prestazioni, stiamo estendendo la disponibilità della targetizzazione dettagliata Advantage agli obiettivi e alle ottimizzazioni di tutte le campagne.

La targetizzazione dettagliata Advantage fa parte della nostra suite di prodotti Advantage, che sfrutta tecnologie avanzate di automazione e apprendimento automatico per migliorare le prestazioni delle campagne degli inserzionisti. Più specificamente, la targetizzazione dettagliata Advantage può contribuire a migliorare le prestazioni delle campagne. Consente infatti al nostro sistema di raggiungere un gruppo di persone più ampio di quello definito nelle selezioni di targetizzazione dettagliata iniziali degli inserzionisti, se ritiene probabile un aumento delle prestazioni.

Il 23 gennaio 2024 useremo l'API Marketing per implementare le seguenti modifiche per inserzionisti e partner:

Nelle campagne ottimizzate per impression, visualizzazioni del video, copertura, interazioni o aumento del ricordo dell'inserzione è ora possibile attivare la targetizzazione dettagliata Advantage.
Nelle campagne ottimizzate per i contatti la targetizzazione dettagliata Advantage è applicata automaticamente con opzione di disattivazione.
- Nota: l'opzione di attivazione sarà disponibile per campagne/gruppi di inserzioni nuovi e duplicati e il pulsante potrà essere usato per l'eventuale disattivazione.
Nelle campagne ottimizzate per clic sul link o visualizzazioni della pagina di destinazione la targetizzazione dettagliata Advantage è applicata automaticamente senza opzione di disattivazione.

Per gli inserzionisti e i partner che usano l'API Marketing, tali modifiche rappresenteranno un cambiamento sostanziale. A partire dal 23 gennaio 2024, gli sviluppatori possono iniziare a implementare le modifiche del codice e hanno tempo fino al 22 aprile 2024 per apportare questi aggiornamenti. La modifica sarà disponibile nella nuova API versione V19.

<Impacted endpoints>

Tipo di richiesta	Endpoint	Modifiche
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	Nelle campagne ottimizzate per clic sul link o visualizzazioni della pagina di destinazione, il campo ‘targeting_optimization’ non sarà accettato. Questo vale anche per le ottimizzazioni precedenti incluse nella targetizzazione dettagliata Advantage senza opzione di disattivazione, tra cui conversioni, valore, installazioni dell'app, eventi nell'app e conversazioni. Nelle campagne ottimizzate per impression, visualizzazioni del video, copertura, interazioni, aumento del ricordo dell'inserzione o contatti, il campo targeting_as_signal deve avere un valore nullo o uguale a zero. In caso contrario, sarà restituito un errore.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	Nelle campagne ottimizzate per clic sul link o visualizzazioni della pagina di destinazione, il campo ‘targeting_optimization’ non sarà accettato. Questo vale anche per le ottimizzazioni precedenti incluse nella targetizzazione dettagliata Advantage senza opzione di disattivazione, tra cui conversioni, valore, installazioni dell'app, eventi nell'app e conversazioni. Per tutte le ottimizzazioni attivate in targetizzazione dettagliata Advantage senza opzione di disattivazione, il campo targeting_as_signal sarà automaticamente impostato su 1 o 3, a seconda del set composto da obiettivi e ottimizzazioni.

Tipo di richiesta

Endpoint

Modifiche

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

Nelle campagne ottimizzate per clic sul link o visualizzazioni della pagina di destinazione, il campo ‘targeting_optimization’ non sarà accettato. Questo vale anche per le ottimizzazioni precedenti incluse nella targetizzazione dettagliata Advantage senza opzione di disattivazione, tra cui conversioni, valore, installazioni dell'app, eventi nell'app e conversazioni.
Nelle campagne ottimizzate per impression, visualizzazioni del video, copertura, interazioni, aumento del ricordo dell'inserzione o contatti, il campo targeting_as_signal deve avere un valore nullo o uguale a zero. In caso contrario, sarà restituito un errore.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

Nelle campagne ottimizzate per clic sul link o visualizzazioni della pagina di destinazione, il campo ‘targeting_optimization’ non sarà accettato. Questo vale anche per le ottimizzazioni precedenti incluse nella targetizzazione dettagliata Advantage senza opzione di disattivazione, tra cui conversioni, valore, installazioni dell'app, eventi nell'app e conversazioni.
Per tutte le ottimizzazioni attivate in targetizzazione dettagliata Advantage senza opzione di disattivazione, il campo targeting_as_signal sarà automaticamente impostato su 1 o 3, a seconda del set composto da obiettivi e ottimizzazioni.

Nuove inserzioni, gruppi di inserzioni e campagne con l'API Marketing che usano gli obiettivi originali

A partire dall'API Marketing v19.0, non è più possibile creare nuove inserzioni, gruppi di inserzioni e campagne che usano gli obiettivi originali (elencati di seguito) ricorrendo a una copia dell'inserzione. Gli obiettivi pubblicitari dovranno essere aggiornati in modo da riflettere i nostri obiettivi semplificati.

A partire dall'API Marketing versione 20, la creazione di inserzioni e gruppi di inserzioni nell'ambito di campagne con obiettivi originali non sarà più supportata. Questa funzionalità continuerà a essere disponibile in tutte le versioni dell'API precedenti alla v20 (ad esempio, v19, v18). Le inserzioni già esistenti che usano obiettivi originali non richiedono alcuna azione immediata.

Obiettivi originali interessati

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

Endpoint POST interessati

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

Per riferimento, qui è disponibile il precedente post del blog degli sviluppatori sulle modifiche delle API relative alla creazione di campagne che usano obiettivi originali.

FAQ

D: Questa modifica richiede un aggiornamento del codice?

R: Sì, molte delle chiamate API per V18 non funzioneranno su V19 (ad esempio, non sarà possibile creare nuove inserzioni, gruppi di inserzioni e campagne che usano obiettivi originali ricorrendo a una copia dell'inserzione).

D: Qual è il comportamento previsto prima e dopo le modifiche?

R: Mentre prima l'uso delle chiamate API per duplicare inserzioni, gruppi di inserzioni o campagne che usano obiettivi originali funzionava, adesso avrà esito negativo.

D: Qual è la tempistica dell'implementazione delle modifiche al codice?

R: Fino all'obsolescenza di v18.0, prevista per settembre 2024.

Documentazione aggiuntiva per gli sviluppatori

Articoli di assistenza

Autorizzazione di accesso ai contenuti pubblici della Pagina (PPCA)

Il caso d'uso per i dati raccolti con l'autorizzazione PPCA (Page Public Content Access) è cambiato. Per informazioni dettagliate, visita il seguente link.

Presentazione dell'API Advantage+ audience

A ottobre dello scorso anno abbiamo lanciato pubblico Advantage+, una nuova esperienza di creazione del pubblico semplificata che consente di migliorare le prestazioni delle campagne ampliando il pubblico potenziale delle inserzioni, senza smettere di presentarle alle persone che gli inserzionisti sono più interessati a raggiungere.

Al momento, stiamo lavorando al rilascio di pubblico Advantage+ sull'API Marketing.

Per attivarlo, imposta il parametro targeting_automation di advantage_audience su 1.
Per disattivarlo, imposta il parametro targeting_automation di advantage_audience su 0.

Rimozioni e modifiche sostanziali

Obsolescenza dell'API Groups di Facebook

L'API Groups di Facebook diventerà obsoleta in v19 ed entro i 90 giorni successivi sarà rimossa da tutte le versioni. Questa obsolescenza include tutte le autorizzazioni (publish_to_groups, groups_access_member_info) e le funzioni consultabili (API Groups) associate all'API Groups di Facebook.

Un importante caso d'uso per l'API Groups sono state le risposte private nei gruppi. In v19 stiamo implementando un'altra modifica che consentirà questo caso d'uso senza alcun ricorso all'API Groups da parte degli sviluppatori. Per quanto riguarda la maggior parte degli sviluppatori di risposte private, in v19 non saranno apportate modifiche. Gli sviluppatori che ricorrevano alle chiamate agli endpoint Groups Post tramite l'API Groups dopo aver ricevuto un webhook sulle risposte private, ora dovranno accertarsi di gestire queste richieste usando un token d'accesso della Pagina.

Gli sviluppatori che non sanno se i propri endpoint usano un'autorizzazione obsoleta possono testare gli endpoint nella versione 19.9 per verificarlo.

Modifiche all'API Page Insights: metriche obsolete

Nella migrazione dalle Pagine classiche alla nuova esperienza delle Pagine su Facebook, elimineremo una serie di metriche per l'API Page Insights. Per maggiori informazioni, visita questo link.

Obsolescenze delle 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 obsolescenze:

API Graph

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
17 settembre 2024: l'API Graph v14.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

API Marketing

6 febbraio 2024: l'API Marketing v16.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
14 maggio 2024: l'API Marketing v17.0 sarà dichiarata obsoleta e rimossa dalla piattaforma

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

SDK di Meta Business

Rilascio dell'SDK v19 di Meta Business

Il rilascio dell'SDK v19 di Meta Business avverrà poco dopo il rilascio dell'API Graph v19 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 v19. In futuro, intendiamo aumentare la frequenza dei rilasci degli SDK per allinearla a quella degli aggiornamenti delle API. Gli sviluppatori potranno così stare al passo con le funzioni, le API e le funzionalità più recenti.

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