Versione 7.0

API Graph

Data di rilascio 5 maggio 2020 | Disponibile fino al 4 agosto 2022 | Post sul blog

Estensione Facebook Business, v2

Questa modifica si applica a tutte le versioni.

Sono stati aggiunti due nuovi campi all'estensione Facebook Business, v2.

• ID account pubblicitario (ad_account_id): rappresenta l'ID dell'account pubblicitario selezionato dall'utente all'interno di FBE. Questo account pubblicitario può essere utilizzato per gestire le inserzioni se la tua app dispone delle autorizzazioni ads_management.

• ID catalogo (catalog_id): l'ID catalogo selezionato dall'utente all'interno di FBE. Questo ID può essere utilizzato per gestire il catalogo prodotti.

Instagram

Hashtag Search

Questa modifica si applica a partire dalla versione 7.0.

Ora puoi richiedere il campo timestamp sui contenuti multimediali di IG restituiti dalle query GET /{ig-hashtag-id}/top_media e GET /{ig-hashtag-id}/recent_media di Hashtag Search. Ad esempio: GET /{ig-hashtag-id}/top_media?fields=timestamp.

Messenger

Plug-in per la chat con i clienti

Questa modifica si applica a partire dalla versione 7.0 e si applicherà a tutte le versioni a partire dal 2 novembre 2020.

Quando viene iniziata una nuova conversazione o ne viene proseguita una esistente tramite il plug-in per la chat con i clienti, le notifiche webhook messaging_postbacks e messaging_referrals iniziali conterranno un ID user_ref anonimo per l'utente invece dell'ID per singola Pagina (PSID) dell'utente. Una volta che l'utente invia un messaggio, le successive notifiche webhook conterranno il PSID dell'utente.

Profili Messenger della Pagina

Questa modifica si applica a partire dalla versione 7.0.

La proprietà home_url sui profili Messenger della Pagina è stata dichiarata obsoleta per tutte le operazioni (GET, POST e DELETE).

Open Graph

Obsolescenze

Questa modifica si applica alla versione 7.0 e si applicherà a tutte le versioni a partire dal 3 agosto 2020.

• GET /{open-graph-action-type-id}
• POST /{user-id}/{open-graph-action-type-id}

Pagine

ID utente per singola app

Queste modifiche si applicano a partire dalla versione 7.0 e si applicheranno a tutte le versioni a partire dal 5 maggio 2021.

In data 1 maggio 2018, l'API Pages ha iniziato a restituire ID utente per singola Pagina (PSID) invece di ID utente per singola app (ASID) per tutte le nuove app. Le app create prima di questa data hanno continuato a ricevere ASID, eccetto quelle che avevano fornito un consenso esplicito alla ricezione di PSID. Ora tutte le app riceveranno PSID dall'API Pages.

L'API Page-Scoped ID ti consente di mappare gli ASID ai PSID equivalenti. L'API è obsoleta a partire dalla versione 7.0, ma può essere utilizzata con versioni precedenti fino al 5 maggio 2021.

Obsolescenze

Queste modifiche si applicano a partire dalla versione 7.0 e si applicheranno a tutte le versioni a partire dal 3 agosto 2020.

Gli endpoint seguenti sono stati dichiarati obsoleti:

• GET /{page-id}/featured_videos_collection
• POST /{page-id}/albums

Autorizzazioni

L'autorizzazione manage_pages è stata dichiarata obsoleta e sostituita con 4 nuove autorizzazioni:

• pages_manage_ads
• pages_manage_metadata
• pages_read_engagement
• pages_read_user_content

L'autorizzazione publish_pages è stata dichiarata obsoleta e sostituita con 2 nuove autorizzazioni:

• pages_manage_posts
• pages_manage_engagement

Le app che sono già state approvate per l'autorizzazione manage_pages, publish_pages o per entrambe saranno migrate alle nuove autorizzazioni entro il 1 giugno 2020.

Per le app che sono state inviate per l'analisi ma che non sono ancora state controllate per l'autorizzazione manage_pages o publish_pages oppure per nessuna delle due, la procedura di controllo proseguirà come di consueto. Una volta approvate, le app saranno migrate alle nuove autorizzazioni entro il 1 giugno 2020.

Per candidarsi o inviare una nuova richiesta per le autorizzazioni per la Pagina entro il 1 giugno 2020, seleziona le autorizzazioni che vedi nella Dashboard gestione app: manage_pages, publish_pages o entrambe; in alternativa puoi selezionare le nuove autorizzazioni. La tua app sarà migrata automaticamente alle nuove autorizzazioni entro il 1 giugno 2020, se necessario.

Dopo il 1 giugno 2020, le autorizzazioni manage_pages e publish_pages non saranno più disponibili per la selezione in Analisi dell'app > Autorizzazioni e funzioni nella Dashboard gestione app.

Le autorizzazioni manage_pages e publish_pages saranno dichiarate del tutto obsolete a maggio 2022. Le modifiche a livello di codice devono essere apportate prima di questa data.

SDK

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

Utente

Obsolescenze

Queste modifiche si applicano a partire dalla versione 7.0 e si applicheranno a tutte le versioni a partire dal 3 agosto 2020.

Gli endpoint seguenti sono stati dichiarati obsoleti:

• GET /{user-id}/books
• GET /{user-id}/games
• GET /{user-id}/movies
• GET /{user-id}/television

API Marketing

Data di rilascio 5 maggio 2020 | Disponibile fino al 3 marzo 2021 | Post sul blog

Campagne pubblicitarie

Ottimizzazione del budget della campagna

Questa modifica si applica a partire dalla versione 7.0.

Per una specifica campagna pubblicitaria, non puoi più impostare sia lifetime_budget che spend_cap. Puoi selezionare solo lifetime_budget.

Il budget totale della campagna viene distribuito in modo tale da coprire l'intero corso della campagna. Quando usi lifetime_budget a livello della campagna, le informazioni sul limite di spesa sono già incluse, motivo per cui non è necessario aggiungere un secondo limite di spesa.

Puoi continuare a usare spend_cap per le campagne che non ricorrono all'ottimizzazione del budget della campagna.

Categoria speciale di inserzioni

Questa modifica si applica a partire dalla versione 7.0.

Il parametro special_ad_category sull'endpoint POST /act_<AD_ACCOUNT_ID>/campaigns è stato dichiarato obsoleto e sostituito con il nuovo parametro special_ad_categories.

Il nuovo parametro special_ad_categories è obbligatorio e accetta un array. Se ottieni il parametro special_ad_category, sarà restituita una stringa, ma devi usare GET /{campaign-id}?fields=special_ad_categories perché venga restituito un array.

Per maggiori informazioni, consulta Categoria speciale di inserzioni.

Scopri di più sulle categorie speciali di inserzioni nel Centro assistenza per le inserzioni.

Obsolescenze

Questa modifica si applica a partire dalla versione 7.0.

Il parametro budget_rebalance_flag è stato dichiarato obsoleto. Ti consigliamo di usare l'ottimizzazione del budget della campagna al suo posto.

Campagne pubblicitarie Atlas

Obsolescenze

Questa modifica si applica a partire dalla versione 7.0.

• GET /{atlas-ad-campaign-id}/cumulative_edited_date

Catalogo prodotti

Obsolescenze

Questa modifica si applica a partire dalla versione 7.0.

Il parametro cpas_parent_catalog_settings sul segmento POST /PRODUCT_CATALOG_ID è stato dichiarato obsoleto per le app di terzi.