Versione 3.0

API Marketing

Rilasciata martedì 1 maggio 2018 | Disponibile fino a venerdì 1 febbraio 2019 | Post sul blog

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

Nuove funzioni

Strategia offerta più economica, campo bid_strategy

Abbiamo introdotto il nuovo campo bid_strategy per {account-id}/adsets che ti consente di selezionare una strategia di offerta annunci in base ai tuoi obiettivi di business. Ogni strategia presenta vantaggi e svantaggi. Le opzioni includono:

• LOWEST_COST: ottieni il maggior numero di risultati in base al budget del gruppo di inserzioni e all'optimization_goal della pubblicazione. Facebook farà automaticamente offerte più elevata come necessario per spendere il tuo budget. Con questa opzione, puoi fornire un massimo per la tua offerta o non indicare alcun limite.

• TARGET_COST: fornisce costi medi stabili per le tue inserzioni man mano che aumenti il budget del tuo gruppo di inserzioni.

Per maggiori informazioni, vedi Ottimizzazione e acquisto di inserzioni, Strategia di offerta

Inserzioni raccolta, creazione

Nuova API per la creazione di inserzioni raccolta: in passato Facebook creava una canvas in background ogni volta che veniva creata un'inserzione raccolta. Ciò limitava l'accesso alla canvas sottostante; non era possibile utilizzarla per ritargetizzare il pubblico con il pubblico in base alle interazioni della canvas. Ora quando crei un'inserzione raccolta dagli insiemi di prodotti, deve anche creare esplicitamente una canvas con gli elementi corretti. Quando usi questa canvas in un'inserzione raccolta, Facebook genera automaticamente l'inserzione raccolta. Per maggiori dettagli, vedi Inserzioni raccolta da insiemi di prodotti.

Modifiche sostanziali

Ads Management

• Invalidazione della colonna di destra: vengono considerate non valide le inserzioni che targetizzano solo la posizione di Facebook, right_hand_column con obiettivi non validi per right_hand_column su {ad_account_id}/adsets. Ora supportiamo solo il posizionamento sul lato destro per i formati pubblicitari supportati con questi obiettivi: Traffico, conversioni e vendite dal catalogo prodotti.

• is_autobid e is_average_price_pacing sono stati dichiarati obsoleti in GET e POST nella versione 3.0 e successive.

Segmenti di pubblico e targetizzazione delle inserzioni

• Sintassi delle regole modificata per il pubblico personalizzato: abbiamo aggiornato la struttura per le regole utilizzate per la creazione di segmenti di pubblico personalizzato per siti web, segmenti di pubblico personalizzato per app per dispositivi mobili, segmenti di pubblico personalizzato in base alle interazioni con la Pagina, segmenti di pubblico in base alle interazioni per acquisizione contatti, segmenti di pubblico in base alle interazioni canvas e segmenti di pubblico personalizzato offline. Ciò ti consente di creare regole basate sul comportamento aggregato, regole da diverse origini di eventi e di escludere delle regole. Vedi:

  • Segmenti di pubblico personalizzato dal sito web, Regole per il pubblico,

  • Segmenti di pubblico personalizzato dalla tua app per dispositivi mobili, Regole per il pubblico,

  • Segmenti di pubblico personalizzato in base alle interazioni con la Pagina

  • Segmenti di pubblico in base alle interazioni per inserzioni di acquisizione contatti

  • Segmenti di pubblico in base alle interazioni per canvas e

  • Segmenti di pubblico personalizzato da conversioni offline

Inserzioni dinamiche

• Accesso al catalogo prodotti: per accedere alle voci del catalogo è necessario specificare il verticale del catalogo corretto. Se la tua richiesta non corrisponde al verticale corretto per il catalogo, verrà generato un errore. Ad esempio, se hai un catalogo e-commerce devi accedervi con il corrispondente endpoint /products come GET {catalog_id}/products, GET {product_feed_id}/products o GET {product_set_id}/products. Non puoi accedere al catalogo con gli endpoint per altri verticali come GET {catalog_id}/autos, GET {product_feed_id}/hotels o GET {product_set_id}/flights.

• Stringa vuota nei tag modello: non sono più consentite stringhe vuote come parametri per inserzioni dinamiche, opzioni tag modello. Ad esempio, se passi una stringa vuota a {{trip.checkin_date date_format:}} viene generato un errore. Per informazioni di base, consulta Inserzioni dinamiche, Ads Management.

Dati statistici e misurazione delle inserzioni

• Timeout dati statistici: se prevediamo che una richiesta API Insights determini un timeout prima del completamento, restituiamo un errore con codice di errore 100 e sottocodice 1504033. Tale stima viene fatta sulla base della dimensione della richiesta e dai progressi di elaborazione fatti in relazione ai limiti di timeout. Se viene visualizzato questo errore, devi effettuare una richiesta API Insights asincrona per questi dati. Vedi Processi asincroni API Insights.

• Valori negativi nei dati degli eventi: se pubblichi dati di eventi su {data_set_id}/events con un valore negativo, l'operazione non va a buon fine. Questo influisce sul campo data per POST /{data_set_id-id}/events.

• Dati statistici sull'ottimizzazione del budget della campagna: adset_budget_value ora restituisce using campaign budget quando la tua campagna pubblicitaria utilizza l'ottimizzazione del budget della campagna. Tale modifica influisce su:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• Ordinamento predefinito per pixel: se chiami il segmento GET {account_id}/adspixel su un account aziendale o su un account pubblicitario vengono restituiti i risultati, ordinati per impostazione predefinita, in base al nome del pixel anziché all'ultimo orario di attivazione del pixel.

• Ridenominazione del campo statistiche pixel: abbiamo rinominato il campo timestamp sul segmento delle statistiche del pixel in start_time. Rappresenta l'ora di inizio dell'aggregazione dei dati orari sulle attivazioni del pixel. Ora lo restituiamo in formato ISO 8601 e includiamo l'offset del fuso orario. Questo risolve un problema a causa del quale venivano restituiti timestamp Unix non validi. Saranno interessati i seguenti endpoint: GET {ads-pixel-id}/stats.

Funzioni obsolete

Business Manager

Endpoint POST {pixel-id}/shared_agencies dichiarato obsoleto. Usa l'interfaccia utente di Business Manager per condividere il pixel delle inserzioni con le agenzie.

Ads Management

• kpi_custom_conversion_id, kpi_type, e kpi_results da /{ad_campaign_id} e /ad_account_ID/campaigns dichiarati obsoleti.

• Flag `redownload` dichiarato obsoleto dai seguenti endpoint per semplificare l'API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  Puoi ancora leggere queste informazioni con il parametro `fields`.

• Dichiarato obsoleto il campo zipbytes da POST act_{ad-account-id}/adimages ed eliminata la possibilità di caricare file ZIP su tale segmento. Usa un'immagine con le estensioni: jpg, jpeg, gif, bmp, png, tiff o tif.

• Dichiarato obsoleto il metodo corrente per creare inserzioni raccolta che utilizzavano una chiamata API con tutte le risorse richieste come parametri. Invece ora devi prima creare una canvas e poi usare il link della canvas per creare un'inserzione raccolta. Questo ti consente di accedere all'oggetto canvas sottostante in modo da poter, ad esempio, ritargetizzare i segmenti di pubblico. Vedi Inserzioni raccolta.

• Uso del formato inserzione carosello dichiarato obsoleto per le inserzioni con l'obiettivo "interazione con il post della Pagina". Questa combinazione non è più valida. Vedi Convalida, obiettivi e creatività.

Acquisto di inserzioni e offerte

• Dichiarati obsoleti i campi is_autobid e is_average_price_pacing dagli endpoint: POST {ad-account-id}/adsets e POST {adset-id}. Usa invece il nuovo campo bid_strategy per specificare una particolare strategia di offerta per il gruppo di inserzioni. Per ulteriori informazioni, vedi Offerte e ottimizzazione.

• Dichiarati obsoleti i campi in delivery_estimate per inserzioni e account pubblicitari. I risultati non hanno soddisfatto le esigenze degli inserzionisti. Inoltre, molti inserzionisti hanno obiettivi di business che potrebbero non essere soddisfatti al meglio dall'ammontare dell'offerta suggerita da Facebook. I campi e i parametri dichiarati obsoleti includono:

  • Campo bid_estimate,

  • parametro currency,

  • parametro daily_budget,

  • parametro optimize_for

  Ti consigliamo di utilizzare il vero valore di business intrinseco che ottieni dalle inserzioni di Facebook e fare offerte in base ad esso. Se non conosci già questo valore, ti consigliamo di utilizzare l'offerta automatica. Per informazioni generali, vedi Centro assistenza inserzioni, asta pubblicitaria e Acquisto e ottimizzazione inserzioni.

• Dichiarato obsoleto il risultato restituito dal campo curve_budget_reach su GET /{rf-prediction-id}. Ora restituiamo la mappa e abbiamo dichiarato obsoleto il valore di ritorno della stringa serializzata JSON. Tale modifica influisce su: GET /{rf-prediction-id}.

• Dichiarato obsoleto il segmento GET /{ad-account-id}/ratecard.

• Dichiarati obsoleti diversi campi relativi alla fatturazione su /ad_accounts. Ecco alcuni esempi:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Dichiarati obsoleti i campi pixel_id e external_event_sourceGET /customaudience.

Dati statistici e misurazione delle inserzioni

• Dichiarato obsoleto matched_unique_users su OFFLINE_EVENT_SET_ID restituito da GET /{data-set-id} e GET /{data-set-upload-id}. Vedi API Offline Conversions.

• Dichiarati obsoleti il segmento attributed_events e il campo attribute_stats su GET /{data_set_id} API. Usa l'API GET /{data_set_id}/stats per ottenere le statistiche sugli eventi attribuite.

• Dichiarato obsoleto il campo matched_unique_users su OFFLINE_EVENT_SET_ID restituito da GET /{data-set-id} e GET /{data-set-upload-id}.

• Dichiarati obsoleti i valori di ritorno predefiniti a GET {data_set_upload_id}. Questo non restituisce più questi campi per impostazione predefinita: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats e matched_unique_users.

• Dichiarati obsoleti i valori di ritorno predefiniti a GET {data_set_id}/stats. Ora restituisce solo le statistiche di conteggio per impostazione predefinita. Per specificare quali statistiche devono essere restituite, usa il parametro fields o il parametro summary per statistiche cumulative come average_upload_delay.

• Dichiarati obsoleti i valori di ritorno predefiniti per GET {data_set_id}. Questo non restituisce più questi campi per impostazione predefinita: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Dichiarato obsoleto il segmento GET {data-set-upload-id}/stats. Usa invece i campi valid_entries o matched_entries da GET {data-set-upload-id}.

• Dichiarato obsoleto canvas_component_avg_pct_view dall'API Insights.