Versione 2.11

API Marketing

Rilasciata il 7 novembre, 2017 | Post sul blog

• Nuove funzioni
• Modifiche sostanziali
• Funzioni obsolete
• Funzioni immediatamente obsolete

Nuove funzioni

Nuova versione dell'API Business Manager

Abbiamo una nuova relazione che rappresenta clienti e agenzie. In passato non avevamo nessun user; gestivamo tutti gli accessi e gli inviti a un Business Manager e alle relative risorse mediante bid/userpermissions che creava problemi di prestazioni. I contenuti in evidenza della nuova API includono:

• Utenti assegnati al Business Manager: il nuovo utente è collegato a un particolare Business Manager e dispone delle autorizzazioni per tale Business Manager. Gli utenti possono gestire profili, autorizzazioni e accessi alle risorse associate al Business Manager in questione.
• Inviti: invita gli utenti ad accedere a un Business Manager attraverso nuovi endpoint. Controlla e aggiorna lo stato degli inviti utente in questi endpoint.
• Categorie di risorse: suddividi i vari tipi di risorse in categorie e fornisci endpoint separati per ciascuna categoria. Ciò semplifica l'impaginazione dei risultati per la lettura delle risorse e riduce i problemi di prestazioni se gestisci migliaia di risorse per un Business Manager. Per la nuova versione abbiamo aggiunto diversi nuovi endpoint.

Per accedere agli utenti in un Business Manager:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

Per accedere alle risorse assegnate agli utenti:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

Per accedere alle Pagine aziendali:

• BUSINESS_ID/owned_pages: per ottenere una lista di Pagine di proprietà dell'azienda.
• BUSINESS_ID/client_pages: per ottenere una lista di Pagine dei clienti dell'azienda.
• BUSINESS_ID/pending_owned_pages: per ottenere una lista di Pagine di proprietà dell'azienda in attesa di approvazione.
• BUSINESS_ID/pending_client_pages: per ottenere una lista di Pagine appartenenti ai clienti di un'azienda in attesa di approvazione.

Per accedere agli account pubblicitari aziendali:

• BUSINESS_ID/owned_ad_accounts: per ottenere una lista di account pubblicitari di proprietà dell'azienda.
• BUSINESS_ID/client_ad_accounts: per ottenere una lista di account pubblicitari dei clienti dell'azienda.
• BUSINESS_ID/pending_owned_ad_accounts: per ottenere una lista di account pubblicitari di proprietà dell'azienda in attesa di approvazione.
• BUSINESS_ID/pending_client_ad_accounts: per ottenere una lista di account pubblicitari dei clienti dell'azienda in attesa di approvazione.

Per accedere ai cataloghi prodotti dell'azienda:

• BUSINESS_ID/owned_product_catalogs: per ottenere una lista di cataloghi prodotti di proprietà dell'azienda.
• BUSINESS_ID/client_product_catalogs: per ottenere una lista di cataloghi prodotti appartenenti ai clienti dell'azienda.

Per accedere alle app dell'azienda:

• BUSINESS_ID/owned_apps: per ottenere una lista di app di proprietà dell'azienda.
• BUSINESS_ID/client_apps: per ottenere una lista di app dei clienti dell'azienda.
• BUSINESS_ID/pending_client_apps: per ottenere una lista di app appartenenti ai clienti di un'azienda in attesa di approvazione.

Per maggiori informazioni, consulta Business Manager, API, Business Manager, utente di sistema, API Business Asset Management e API Business Manager, best practice.

Inserzioni carosello, luogo in tempo reale

Adesso puoi creare un'inserzione carosello con un allegato che mostra un luogo in tempo reale. Sono state aggiunte le opzioni type=REALTIME e location_source_id = PAGE_ID in place_data per AD_CREATIVE_ID/object_story_spec. Questo è disponibile nel campo object_story_spec in:

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

Visite al punto vendita, targetizzazione di luoghi geografici

Adesso puoi targetizzare aree geografiche al di fuori delle zone limitrofe alla sede del tuo punto vendita. Abbiamo aggiunto il parametro geo_locations nel campo targeting_specs quando crei un gruppo di inserzioni con obiettivo Visite al punto vendita. Soggetto a disponibilità limitata. Consulta il tuo rappresentante di Facebook per l'accesso. Consulta Obiettivo Visite al punto vendita.

• POST AD_ACCOUNT_ID/adsets presenta la nuova opzione.
• Supporta tutte le aree geografiche in Specifiche di targetizzazione, luoghi, salvo la targetizzazione mediante country_groups e la targetizzazione del tipo di luogo travel_in.
• La creazione di inserzioni con obiettivo STORE_VISITS è disponibile su base limitata. Consulta Visite al punto vendita.

Gruppo di inserzioni, tipi di destinazioni

Riflette il tipo di destinazione a cui rimanda un'inserzione, ovvero, la posizione in cui viene rimandato un utente quando clicca su un'inserzione o sulla call to action in un'inserzione. Ciò garantisce un tipo di destinazione coerente per tutte le inserzioni in un gruppo di inserzioni, in modo che le inserzioni contengano solo tipi diversi di creatività delle inserzioni. Consulta Gruppo di inserzioni, tipi di destinazioni.

• Aggiunto destination_type per i gruppi di inserzioni
• Disponibile in /ADSET_ID

Indicatore di prestazioni chiave

Abbiamo aggiunto il nuovo campo kpi_type a AD_ACCOUNT_ID/CAMPAIGN_ID che descrive il tipo di indicatore di prestazioni chiave che desideri monitorare per la campagna o per gli oggetti pubblicitari della campagna. Per consultare i dati statistici mediante kpi_type in kpi_results, effettua queste chiamate:

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

Per maggiori informazioni, consulta Campagne pubblicitarie, riferimento.

Modifiche sostanziali

Gestione delle inserzioni

• Invalidazione delle inserzioni con targetizzazione right_hand_column: le inserzioni che targetizzano questa posizione con creatività non valide per right_hand_column su AD_ACCOUNT_ID/adsets restituiscono un errore. Non consentiamo il posizionamento solo su right_hand_column con formati pubblicitari video, raccolta e Canvas. Per i posizionamenti solo su right_hand_column, puoi usare i formati carosello e con una sola immagine.

• GET VERSION/RF_PREDICTION_ID/pause_periodsmodificato: per restituire Array e non String al fine di semplificare la gestione.

API Business Manager

• Campi ridenominati: il campo admin_system_user è stato ridenominato in admin e il campo system_user è stato ridenominato in employee. Ciò riguarda i seguenti segmenti:

  • /{business-id}/userpermissions
  • /{business-id}/system_users

Funzioni obsolete

Gestione delle inserzioni

Ottimizzazioni obsolete per VIDEO_VIEWS: le campagne con l'obiettivo VIDEO_VIEWS non possono più usare CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT o REACH come obiettivi di ottimizzazione.

• La creazione di gruppi di inserzioni con questi obiettivi di ottimizzazione restituisce un errore.
• La duplicazione di gruppi di inserzione con l'obiettivo di ottimizzazione REACH comporta la conversione in automatico all'obiettivo di ottimizzazione VIDEO_VIEWS.
• La duplicazione di gruppi di inserzione con CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT o POST_ENGAGEMENT come obiettivo di ottimizzazione restituisce un errore. Questo perché la creazione o la duplicazione di un'inserzione in un gruppo di inserzioni esistente prova a riutilizzare uno di questi obiettivi di ottimizzazione.

Segmenti interessati da questa modifica:

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

reachobsoleto: come optimization_goal per l'obiettivo Notorietà del brand. Rimosso per o /adset; è disponibile solo per l'ottimizzazione per il ricordo dell'inserzione. Ciò evita confusione per gli utenti che usano la copertura come un obiettivo dedicato.

Resa obsoleta l'ottimizzazioneBRAND_AWARENESS: sostituita da AD_RECALL_LIFT. Ciò riflette un nuovo e più efficiente modello di pubblicazione delle inserzioni. Il nuovo obiettivo di ottimizzazione supporta creatività miste, come inserzioni statiche e video nello stesso gruppo di inserzioni e nella stessa offerta manuale. BRAND_AWARENESS non è più disponibile in:

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

frequency_capobsoleto: compresi i campi lifetime_frequency_cap e frequency_cap_reset_period negli elementi seguenti.

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

Usa invece frequency_control_specs.

Reso obsoleto il costo per azionePOST_ENGAGEMENT: non puoi più usare POST_ENGAGEMENT come un billing_event per questo obiettivo. Ciò ottimizza l'allineamento della pubblicazione e della misurazione delle inserzioni. Riguarda l'endpoint: /AD_SET_ID.

Dati statistici e misurazione delle inserzioni

video_15_sec_watched_actionsobsoleto negli elementi seguenti.

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

recurrence_valueobsoleto: dall'API Advanced Measurement. Il campo era anche previsto nell'API Atlas come programmazione dei report. Lo abbiamo sostituito con recurrence_values. Consulta Misurazione avanzata, programmazioni dei report.

Gestione aziendale

Endpoint obsoleti per la nuova versione dell'API Business Manager:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Endpoint obsoleti per la gestione delle tue risorse:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

Per accedere alle risorse, usa BUSINESS_ID/owned_ASSET o BUSINESS_ID/client_ASSET.

Endpoint obsoleti per la gestione delle risorse appartenenti a un altro Business Manager:

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

Usa invece BUSINESS_USER_ID/assigned_ASSET.

Funzioni immediatamente obsolete

Queste funzioni obsolete riguardano tutte le versioni dell'API e saranno effettive il 14 novembre 2017.

Inserzioni per promuovere un evento e inserzioni con link

È diventa obsoleta la creazione e la modifica di inserzioni per promuovere un evento o inserzioni con link non collegate a una Pagina valida. I seguenti formati non sono più validi e restituiscono un errore.

Firme diventate obsolete:

• Inserzioni per promuovere un evento

  • Obiettivo: EVENT_RESPONSES
  • Campi delle creatività: body, object_id
• Inserzioni con link

  • Obiettivo: LINK_CLICKS
  • Campi delle creatività: title, body, object_url (image_file o image_hash)

Firme supportate

• Inserzioni per promuovere un evento

  • Obiettivo: EVENT_RESPONSES
  • Campi delle creatività: object_story_id o object_story_spec.
• Inserzioni con link

  • Obiettivo: LINK_CLICKS
  • Campi delle creatività: object_story_id o object_story_spec.

Le inserzioni per promuovere un evento o con link create in precedenza rimarranno attive, ma non potrai modificare le creatività delle inserzioni o creare nuove inserzioni una volta entrata in vigore questa modifica (riceverai un errore). Consulta Inserzioni per promuovere un evento e con link e Inserzione, riferimento.