Versione 11.0

API Graph

Data di rilascio 8 giugno 2021 | Disponibile fino a 14 settembre 2023 | Post sul blog

App Consumer

Livelli di accesso

Si applica a tutte le versioni.

Nelle prossime settimane, i livelli di accesso si applicheranno a tutte le app Consumer esistenti. Per queste app, autorizzazioni e funzioni già approvate tramite la procedura di Analisi dell'app saranno approvate automaticamente per l'accesso avanzato Tutte le altre autorizzazioni e funzioni saranno approvate automaticamente per l'accesso standard.

Nelle prossime settimane, i livelli di accesso si applicheranno anche a tutte le app di nuova creazione. Le app appena create saranno approvate automaticamente per l'accesso avanzato per le autorizzazioni email e public_profile. Tuttavia, entrambe le autorizzazioni saranno impostate su Accesso standard per impostazione predefinita e devono essere impostate manualmente su Accesso avanzato prima che possano essere richieste dagli utenti dell'app che non hanno ruoli nelle app.

Assistenza per gli sviluppatori

Abbiamo pubblicato lo strumento Facebook for Business Status per monitorare lo stato di integrità della piattaforma e dei prodotti aziendali come Gestione inserzioni, WhatsApp Business e Piattaforma per gli sviluppatori di Facebook.

Facebook Analytics

Elemento obsoleto

Si applica a tutte le versioni.

Facebook Analytics non sarà più disponibile a partire dal 30 giugno 2021. Inoltre, stiamo eliminando il plug-in Dashboard gestione app per l'API Marketing. Per ulteriori informazioni, consulta il Centro assistenza per le aziende.

Non sono più disponibili i seguenti campi Application Node:

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Non sono più disponibili i seguenti endpoint:

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

API Instagram Basic Display

Debugger dei token d'accesso

Si applica a tutte le versioni.

Lo strumento debugger dei token d'accesso ora restituisce solo un ID per singola app quando esegue il debug di un token.

Gestione delle versioni dell'API

Si applica a tutte le versioni.

Ora l'API supporta le chiamate con cambio di versione. Per eseguire una query su una versione API specifica, includi il numero di versione nel percorso della query dopo l'URL di base. Ad esempio:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Le richieste senza cambio di versione (con numero versione mancante) vengono risolte alla versione specificata nell'impostazione Dashboard gestione app > Impostazioni > Avanzate > Aggiorna la versione dell'API dell'app chiamante.

ID utente per singola app

Si applica alla versione 11.0 e successive.

Sono stati introdotti gli ID utente per singola app (ASID). Gli ASID sostituiranno gli ID utente raw tra circa due anni, quando la versione 10.0 sarà dichiarata obsoleta, quindi ti consigliamo di iniziare a mappare gli ID raw degli utenti della tua app ai loro ASID equivalenti.

Tutte le versioni supportano query basate su ID utenti raw.
Solo le chiamate della versione 11.0 e successive supportano query basate su ASID.
Le chiamate della versione 11.0 e successive riceveranno in risposta ASID, anche quando vengono interrogati ID utente raw.

Paginazione basata sul tempo

Si applica alla versione 11.0 e successive.

Aggiunti i parametri since e until sull'endpoint GET /{user-id}/media per supportare la paginazione basata sul tempo.

API Instagram Graph

Numero di "Mi piace"

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Se si interroga indirettamente un contenuto multimediale di IG tramite un altro endpoint o espansione dei campi, il campo like_count sarà omesso dalle risposte API se il creatore del contenuto multimediale ha nascosto il numero di "Mi piace". L'esecuzione di una query direttamente sul contenuto multimediale di IG, che può essere eseguita solo dal suo creatore, restituirà il numero di "Mi piace" effettivo, anche se tale informazione è stata nascosta.

Paginazione basata sul tempo

Si applica alla versione 11.0 e successive.

Aggiunti i parametri since e until sull'endpoint GET /{ig-user-id}/media per supportare la paginazione basata sul tempo.

Esperienze interattive

Modelli

Si applica alla versione 11.0 e successive.

I modelli Esperienza interattiva sono usciti dalla beta e ora sono disponibili per tutti gli sviluppatori.

Piattaforma Messenger

Webhook Messaging Postbacks

Si applica alla versione 11.0 e successive.

Il campo mid è stato aggiunto al webhook messaging_postbacks per consentire alle app di ottenere l'ID messaggio.

Rimozione dei modelli per compagnie aeree

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 6 dicembre 2021.

Le chiamate a POST /{page-id}/messages che includono modelli per compagnie aeree (template_type dei tipi airline_boardingpass, airline_checkin, airline_itinerary, airline_update) non andranno a buon fine.

oEmbed

Nuova funzione oEmbed Read

Si applica a tutte le versioni.

Il prodotto oEmbed è stato sostituito con una nuova funzione oEmbed Read. Se hai implementato il prodotto oEmbed prima dell'8 giugno 2021, hai tempo fino al 7 settembre 2021 per completare l'Analisi dell'app per la funzione oEmbed Read. Se non sei stato approvato per la funzione oEmbed Read entro il 7 settembre 2021, le tue implementazioni oEmbed non verranno caricate.

API Pages

ID commenti

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni il 7 settembre 2021.

Il campo id per i commenti non sarà restituito per le app che usano solo la funzione Accesso ai contenuti pubblici della Pagina per interrogare endpoint delle Pagine. Questi includono i campi id/PAGEPOST-ID/comments o /COMMENT-ID/comments. Per ottenere i campi id per i commenti per commenti sui post della Pagina, l'utente dell'app deve poter eseguire l'attività MODERATE sulla Pagina oggetto della query.

Nuova esperienza della Pagina

Nei prossimi mesi, tutte le Pagine classiche saranno migrate alla Nuova esperienza della Pagina. Usa il campo della Pagina has_transitioned_to_new_page_experience per determinare se una Pagina è stata migrata. Dopo che tutte le Pagine saranno state migrate, l'esperienza classica delle Pagine non sarà più disponibile.

La maggior parte degli endpoint dell'API Pages supporta sia le pagine classiche sia quelle NPE. Gli endpoint che supportano le pagine NPE mostrano la sezione "Nuova esperienza della Pagina" nei riferimenti.

Gli endpoint seguenti non supportano le Pagine NPE:

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

Diversi campi della Pagina non sono disponibili per NPE e restituiranno null, un set di dati diverso o un errore quando vengono chiamati. Visita la nostra panoramica Nuova esperienza della Pagina per un elenco di questi campi della Pagina.

Autorizzazioni

user_likes

Si applica a tutte le versioni.

L'utilizzo consentito per l'autorizzazione user_likes è stato aggiornato. A partire dal 7 settembre 2021, le app che sono già state approvate per questa autorizzazione ma che violano la nuova descrizione dell'utilizzo verranno revocate.

Vecchio utilizzo consentito: migliora in modo significativo la qualità dell'esperienza utente nell'app (devi indicare chiaramente agli utenti come userai i loro dati per offrire l'esperienza).
Nuovo utilizzo consentito: Fornisci un'esperienza personalizzata mettendo in correlazione o mostrando i contenuti relativi ai "Mi piace" di un utente. Ciò include la gestione di contenuti su vasta scala per personalizzare le app con volumi elevati di contenuti e la possibilità di condividere i "Mi piace" con altri utenti, ad esempio nelle app di musica e di incontri.

user_posts

Si applica a tutte le versioni.

L'utilizzo consentito per l'autorizzazione user_posts è stato aggiornato. A partire dal 7 settembre 2021, le app che sono già state approvate per questa autorizzazione ma che violano la nuova descrizione dell'utilizzo verranno revocate.

Vecchio utilizzo consentito: Migliora in modo significativo la qualità dell'esperienza utente nell'app (devi indicare chiaramente agli utenti come userai i loro dati per offrire l'esperienza).
Nuovo utilizzo consentito: Consenti agli utenti di creare libri o album fisici o digitali dei loro diari e di condividere i ricordi dal loro diario su Facebook o su altre app social.

SDK

Visita il Registro modifiche SDK iOS, Registro modifiche SDK Android e Registro modifiche SDK Unity per scoprire importanti modifiche imminenti a questi SDK.

API Marketing

Rilasciata il 8 giugno 2021 | Disponibile fino a 23 febbraio 2022 | Post sul blog

Gruppi di pubblico

Eliminazione di pubblico personalizzato, pubblico simile e pubblico salvato

Si applica a tutte le versioni.

A partire dall'8 giugno 2021, qualsiasi pubblico personalizzato, pubblico simile o pubblico salvato che non è stato utilizzato in nessun gruppo di inserzioni attivo da oltre due anni verrà contrassegnato come "Pubblico in scadenza". Quindi, il pubblico sarà programmato per essere eliminato 90 giorni dopo essere stato contrassegnato come "Pubblico in scadenza".

Gli sviluppatori saranno in grado di filtrare in base allo stato del "Pubblico in scadenza" utilizzando il campo operation_status e visualizzare il tempo stimato di eliminazione del pubblico nel sistema utilizzando il campo delete_time. Gli sviluppatori possono scegliere di eliminare in modo proattivo il pubblico o di utilizzare il pubblico in un gruppo di inserzioni attivo per impedire l'eliminazione. Una volta eliminato un pubblico, gli inserzionisti non saranno in grado di riattivarlo.

Per i gruppi di pubblico personalizzato (eccetto i gruppi di pubblico personalizzato dell'elenco clienti), i gruppi di pubblico simile o i gruppi di pubblico salvato:

Se gli inserzionisti desiderano che i gruppi di pubblico contrassegnati vengano eliminati automaticamente a partire dal 6 settembre 2021, non devono intraprendere alcuna azione. Tuttavia, se gli inserzionisti lo desiderano, possono anche eliminare in modo proattivo il pubblico prima della data di eliminazione automatica.
Per i gruppi di pubblico contrassegnati che desiderano mantenere, gli inserzionisti devono pianificarne l'utilizzo i in un gruppo di inserzioni attivo prima del 6 settembre 2021 per evitare che il pubblico venga eliminato.

Per i gruppi di pubblico personalizzato dell'elenco clienti:

Li conserviamo per conto degli inserzionisti in conformità con le loro istruzioni. Se gli inserzionisti non intraprendono alcuna azione per utilizzare i gruppi di pubblico contrassegnati in un gruppo di inserzioni attivo prima del 6 settembre 2021, considereremo questa come un'istruzione di eliminare il pubblico contrassegnato.

Saranno interessati i seguenti endpoint e campi:

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

Vedi Panoramica pubblico: modifiche all'eliminazione del pubblico personalizzato per maggiori informazioni su questi aggiornamenti.

API Business

Si applica a tutte le versioni.

Stiamo temporaneamente limitando l'accesso ai seguenti endpoint. Solo le app che hanno chiamato correttamente questi endpoint negli ultimi 30 giorni continueranno ad avere accesso.

Tutte le altre app riceveranno un errore quando effettuano chiamate a questi endpoint.

API Catalog

Eliminazione del campo Product Inventory

Si applica alla versione 11.0 e successive.

Il campo inventory sarà dichiarato obsoleto e sostituito con un nuovo campo quantity_to_sell_on_facebook. Continueremo a supportare il campo inventory nel breve termine, ma ti consigliamo di utilizzare il nuovo campo quantity_to_sell_on_facebook.

Sono interessati i seguenti endpoint:

Per maggiori informazioni su questo aggiornamento, consulta Quantità da vendere e Campi supportati per i prodotti - Inserzioni dinamiche e commerce.

Eliminazione di gruppi di prodotti non vuoti

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Non consentiremo più l'eliminazione di gruppi di prodotti non vuoti per impostazione predefinita. I gruppi di prodotti non vuoti possono essere eliminati applicando deletion_method=delete_items alla richiesta di eliminazione. Questa operazione eliminerà il gruppo di prodotti e i relativi articoli.

È interessato il seguente endpoint:

DELETE /<product_group_id>

Eliminazione dei gruppi di prodotti live

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Non consentiremo più l'eliminazione di un catalogo con gruppi di prodotti live per impostazione predefinita. Per consentire l'eliminazione di un catalogo che contiene un gruppo di prodotti live, imposta il parametro allow_delete_catalog_with_live_product_set del catalogo su true.

Questa modifica riguarda il seguente endpoint:

DELETE /<product_catalog_id>

Nuovo endpoint Diagnostics

Si applica alla versione 11.0 e successive.

Abbiamo aggiunto un nuovo endpoint: GET /{product_catalog_id}/diagnostics. Questo endpoint può essere utilizzato per recuperare i dati di diagnostica per un determinato catalogo, ad esempio problemi che impediscono la visualizzazione dei prodotti nei canali e opportunità che potrebbero migliorare la rilevabilità dei prodotti.

API Commerce

Dettagli sul pagamento stimato totale dell'ordine

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Stiamo modificando il modo in cui i dettagli sul pagamento stimato vengono riportati nei totali dell'ordine per le chiamate all'endpoint {commerce-order-id}/?fields=estimated_payment_details. In precedenza, se un ordine non veniva evaso, veniva utilizzata un'imposta stimata e, per gli ordini evasi, veniva utilizzata l'imposta assolta. A partire dalla versione 11.0, questo endpoint utilizzerà sempre l'imposta stimata. Puoi accedere ai dettagli sull'imposta assolta usando {commerce-order-id}/items?fields=tax_details.

Conversion lift

Modifiche alle metriche

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Le metriche restituite dal campo GET /{objective-id}/?fields=result sono cambiate.

Le seguenti metriche sono state aggiunte:

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

Le seguenti metriche sono state rimosse:

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

Le seguenti metriche sono state rinominate:

Vecchio nome	Nuovo nome
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

Un elenco completo delle metriche disponibili è riportata nel Glossario sulle metriche Facebook Lift.

API Insights

Deprecazione delle metriche sulle visite al punto vendita

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 6 settembre 2021.

Le metriche store_visits_actions e cost_per_store_visit_actions sono state dichiarate obsolete.

Sono interessati i seguenti endpoint:

API Offer Ads

Eliminazione degli endpoint dell'API Offer Ads

Si applica alla versione 11.0 e successive. Si applicherà a tutte le versioni a partire dal 7 settembre 2021.

Nell'ambito dell'impegno continuo a migliorare la stabilità del prodotto, Facebook interromperà il supporto per il nostro prodotto Inserzioni con offerte l'8 giugno 2021. Le inserzioni Facebook standard sono il sostituto raccomandato per la distribuzione degli sconti presso il punto vendita o online. Ti consigliamo di inserire direttamente le informazioni sugli sconti, i luoghi in cui poterli riscattare, la data di scadenza e i codici promozionali nella creatività Livello dell'inserzione.

Sono stati dichiarati obsoleti i seguenti endpoint:

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes