Torna alle notizie per sviluppatori

Presentazione dell'API Facebook Graph v15.0 e dell'API Marketing v15.0

15 settembre 2022DiAchyuth Venkatesh

Oggi rilasciamo l'API Facebook Graph v15.0 e l'API Marketing v15.0. 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 un elenco completo di tutte le modifiche e i relativi dettagli, visita il nostro registro modifiche.

Avvisi e aggiornamenti generali

Semplificazione dei criteri di creazione delle conversioni personalizzate

Per semplificare il processo di creazione delle campagne per gli inserzionisti, con il rilascio dell'API Graph v15.0 le conversioni personalizzate appena create richiederanno almeno una regola associata. Le conversioni personalizzate che non richiedono regole devono utilizzare l'ottimizzazione degli eventi personalizzati, che consente di ottimizzare le campagne pubblicitarie direttamente sugli eventi personalizzati. Stiamo lavorando attivamente per trasformare le nostre conversioni personalizzate esistenti da un'offerta unica e completa in prodotti multipli e specifici per soddisfare meglio le esigenze e i casi d'uso dei nostri inserzionisti. Questo cambiamento porterà gli inserzionisti a passare dalle conversioni personalizzate basate su eventi all'ottimizzazione di eventi personalizzati.

Aggiornamenti delle Condizioni della piattaforma

Stiamo aggiornando le Condizioni della piattaforma per quanto riguarda il momento in cui possiamo rimuovere l'accesso di un'app alle API, alle autorizzazioni o alle funzioni della piattaforma che l'app non ha utilizzato o a cui non ha avuto accesso per un certo periodo di tempo. A partire dal 15 dicembre 2022, le Condizioni della piattaforma richiederanno che siano state svolte attività entro un periodo di 28 giorni perché l'app sia considerata attiva.

Se ricevi l'avviso di inattività della tua app e desideri ripristinarla, puoi farlo accedendo come amministratore dell'app.

Puoi consultare le Condizioni della piattaforma per vedere un'anteprima completa di queste modifiche qui.

Obsolescenze e modifiche sostanziali

Introduzione del pubblico personalizzato Advantage

A partire dal 19 settembre 2022, inizieremo a distribuire il pubblico personalizzato Advantage. Il pubblico personalizzato Advantage utilizza il pubblico personalizzato di un inserzionista per guidare la pubblicazione e aiutare a trovare più persone che probabilmente raggiungeranno l'obiettivo di ottimizzazione espresso. Ciò significa che pubblicheremo inserzioni al di fuori del loro pubblico personalizzato, se ci sono probabilità che ciò migliori le prestazioni. Il pubblico personalizzato Advantage fa parte della nostra suite di prodotti di targetizzazione Advantage, che comprende anche la targetizzazione dettagliata Advantage e il pubblico simile Advantage. I nostri prodotti di targetizzazione Advantage sfruttano l'automazione avanzata e la tecnologia di apprendimento automatico per migliorare le prestazioni delle campagne pubblicitarie con un minore impegno manuale.

Gli inserzionisti che utilizzano il pubblico personalizzato potranno selezionare il pubblico personalizzato Advantage. Con il pubblico personalizzato Advantage, gli inserzionisti continueranno a creare un pubblico personalizzato (sito web, attività nell'app, elenco di clienti o interazioni) e ad applicare inclusioni/esclusioni pertinenti, beneficiando allo stesso tempo della nostra tecnologia avanzata di automazione e apprendimento automatico che utilizza il pubblico personalizzato come fonte per guidare la pubblicazione e raggiungere un maggior numero di utenti che probabilmente consentiranno di raggiungere l'obiettivo di ottimizzazione espresso.

Il pubblico personalizzato Advantage è attivato automaticamente quando crei una nuova campagna che include pubblico personalizzato dal sito web, mobile o in base alle interazioni. Puoi scegliere di disattivare il prodotto deselezionando la casella "Pubblico personalizzato Advantage" nella sezione Pubblico personalizzato del nostro strumento di creazione delle inserzioni.

Obsolescenza del Pubblico dell'inserzione speciale

Nell'ambito del nostro accordo con il Dipartimento degli Stati Uniti di Housing and Urban Development (HUD), disattiveremo il pubblico dell'inserzione speciale, uno strumento che consente agli inserzionisti di ampliare il proprio pubblico per i gruppi di inserzioni relativi al settore abitativo, creditizio e dell'occupazione. A partire dal 15 settembre 2022 non sarà più possibile creare gruppi di pubblico dell'inserzione speciale tramite l'API Marketing.

Per gli inserzionisti e i partner, il blocco della creazione di nuovo Pubblico dell'inserzione speciale a partire dal 15 settembre 2022 rappresenterà un cambiamento radicale, in quanto con questa modifica senza cambio di versione i valori precedenti verranno dichiarati obsoleti. Nel 2019, oltre ad aver eliminato alcune opzioni di targetizzazione per le inserzioni relative al settore abitativo, creditizio e dell'occupazione, abbiamo introdotto il pubblico dell'inserzione speciale come alternativa al pubblico simile. Ma il campo dell'equità nell'apprendimento automatico è dinamico e in continua evoluzione, e il pubblico dell'inserzione speciale è stato un primo modo per rispondere alle crescenti preoccupazioni. Ora la nostra attenzione si sposterà su nuovi approcci per migliorare l'equità, tra cui il metodo precedentemente annunciato.

Di seguito è riportato l'elenco degli endpoint interessati da questa obsolescenza:

Per la lettura del pubblico:

  • endpoint gr:get:AdAccount/customaudiences
  • field operation_status

Per la creazione di gruppi di inserzioni:

  • endpoint gr:post:AdAccount/adsets
  • field subtype

Per la modifica di gruppi di inserzioni:

  • endpoint gr:post:AdCampaign
  • field subtype

Per la creazione di pubblico personalizzato:

  • endpoint gr:post:AdAccount/customaudiences
  • field subtype

Per la modifica di pubblico personalizzato:

  • endpoint gr:post:CustomAudience

Consulta il precedente post sul blog e la documentazione per gli sviluppatori per maggiori dettagli sull'implementazione del codice.

Parità tra targetizzazione dettagliata Advantage e pubblico simile

Questo progetto porta la parità per la targetizzazione dettagliata come segnale (targetizzazione dettagliata Advantage) per gli utenti dell'API che utilizzano i gruppi di inserzioni con messaggi/installazioni di app come obiettivi (dopo il rilascio di Gestione inserzioni). In precedenza abbiamo lanciato la targetizzazione dettagliata Advantage per l'API sui gruppi di inserzioni con Conversioni come obiettivo e Conversioni/Valore come obiettivi di ottimizzazione (gruppi di inserzioni VO/OC).

Attualmente, quando gli inserzionisti creano gruppi di inserzioni tramite l'API con messaggi o installazioni dell'app come obiettivo, passano due elementi come parte dei criteri di targetizzazione (L2): un elenco di input di targetizzazione dettagliati (ad esempio: cricket, calcio, cani, ecc.) e un flag che indica se vogliono espandersi oltre questi input ("targetizzazione dettagliata Advantage"). Se il flag è abilitato, i nostri sistemi vanno oltre le selezioni di targetizzazione dettagliata, se è probabile che ciò migliori le prestazioni. Se è disabilitato, i sistemi limitano la pubblicazione all'elenco di selezioni fornite dagli inserzionisti.

In futuro (dopo il rilascio di Gestione inserzioni), quando gli inserzionisti creeranno nuove campagne con messaggi o installazioni dell'app mobili come obiettivi, le inclusioni di targetizzazione dettagliata saranno utilizzate come input (non come vincolo) per guidare la pubblicazione delle inserzioni. Per questo motivo, abbiamo dichiarato obsoleto il flag DTE per questi obiettivi, rendendo l'espansione della targetizzazione un comportamento predefinito delle selezioni di targetizzazione dettagliata. In questo caso, potremmo andare oltre le inclusioni di targetizzazione dettagliate, se è probabile che ciò migliori le prestazioni. Tutte le altre selezioni ed esclusioni della targetizzazione rimarranno inalterate. Questa modifica non si applica alle categorie speciali.

Come funziona:

In precedenza, gli inserzionisti passavano il flag targeting_optimization con un valore di expansion_all o none per abilitare o disabilitare l'espansione della targetizzazione dettagliata. Data la modifica della semantica del funzionamento della targetizzazione dettagliata per questi gruppi di inserzioni, gli inserzionisti non devono passare questo flag quando creano gruppi di inserzioni con messaggi o installazioni dell'app come obiettivo, poiché non avrà alcun impatto sui gruppi di inserzioni appena creati. Tutti questi nuovi gruppi di inserzioni appena creati utilizzeranno sempre le inclusioni di targetizzazione dettagliate come segnale per i nostri sistemi di backend, che possono decidere di pubblicare inserzioni al di là di queste selezioni se ciò significa prestazioni migliori per gli inserzionisti.

Dato che il flag targeting_optimization non avrà alcun effetto sui gruppi di inserzioni appena creati, intendiamo da questo momento in poi dichiarare obsoleto questo campo per le nuove campagne con messaggi e/o installazioni di app come obiettivo.

  • A tal fine, se gli inserzionisti passano il flag targeting_optimization quando creano nuovi gruppi di inserzioni MAI/messaggi o quando chiedono le stime di pubblicazione di questi gruppi di inserzioni appena creati, invieremo un messaggio di errore chiedendo loro di non inviare più questo parametro.
  • Un nuovo campo chiamato targeting_as_signal sarà impostato nel backend durante la creazione di nuovi gruppi di inserzioni con obiettivo installazioni dell'app/messaggi. Questo campo è disponibile solo per i comandi GET per aiutare gli inserzionisti a verificare se i loro gruppi di inserzioni vanno oltre le inclusioni della targetizzazione dettagliata.

NOTA: queste modifiche alla targetizzazione dettagliata come segnale si applicheranno solo ai gruppi di inserzioni appena creati con messaggi e/o installazioni dell'app come obiettivo.

Endpoint API nell'ambito di applicazione:

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

Obsolescenza delle tab Pagine

Comunichiamo che le funzioni dell'API Pages Custom Tab non saranno più disponibili tramite l'API Graph. Con l'introduzione della nuova esperienza delle Pagine, alcune funzioni dell'API Pages saranno dichiarate obsolete. Le funzioni delle tab personalizzate delle Pagine non saranno disponibili nella nuova esperienza delle Pagine, pertanto il supporto API per queste funzioni sarà dichiarato obsoleto. Stiamo condividendo questi aggiornamenti ora per dare agli sviluppatori e ai loro clienti il tempo necessario per comunicare l'obsolescenza di queste funzionalità dalle rispettive pagine e apportare le modifiche necessarie. Questa funzione sarà dichiarata completamente obsoleta entro il 14/12/2022.

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

  • Il 1° novembre 2022: l'API Graph v8.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • Il 23 febbraio 2023: l'API Graph v9.0 sarà dichiarata obsoleta e rimossa dalla piattaforma
  • L'8 giugno 2023: l'API Graph v10.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:

  • Gennaio 2023: gli SDK della Piattaforma Facebook v8.0 o precedente saranno disattivati
  • Giugno 2023: gli SDK della Piattaforma Facebook v9.0 o precedente saranno disattivati
  • Ottobre 2023: gli SDK della Piattaforma Facebook v11.0 o precedente saranno disattivati