Dettagli relativi all'API Insights

Puoi raggruppare i risultati dell'API Insights in vari insiemi utilizzando i dettagli.

L'API Insights può restituire diverse metriche stimate, in fase di sviluppo oppure che riportano entrambe le condizioni. I valori dei dettagli di Insights sono stimati. Per maggiori informazioni, consulta API Insights, Metriche stimate e obsolete.

Limitazioni

Campi non disponibili

I seguenti campi non possono essere richiesti quando si specifica un dettaglio:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Restrizioni per le metriche delle azioni fuori da Meta

I seguenti dettagli non saranno più disponibili per le metriche delle azioni fuori da Meta.

Tipo 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone

Tipo 2

• action_device
• action_destination
• action_target_id
• product_id
• action_carousel_card_id/action_carousel_card_name
• action_canvas_component_name

Regole correlate alle query contenenti i dettagli precedenti:

• Tipo 1: l'API Insights non restituirà metriche fuori dal sito non supportate (ad es. metriche delle azioni con dettagli del Tipo 1).
• Tipo 2: le metriche web fuori dal sito continueranno a essere restituite dall'API, ma non conterranno il valore relativo ai dettagli. Le metriche mobili non verranno più restituite quando interrogate con questi dettagli.

Nota: i dettagli elencati in precedenza sono comunque supportati per le metriche su Meta come impression, clic sul link, ecc. Inoltre, le modifiche non hanno alcun impatto sui dati storici precedenti al 27 aprile 2021. Infatti, i dettagli per i dati storici continueranno a essere disponibili.

Metriche delle azioni

Le metriche non sono disponibili nei seguenti scenari:

• Quando è presente un tentativo di aggregazione su più impostazioni sull'attribuzione.
• Quando richiesto con dettagli interessati (questa restrizione si applica solo ai tipi di azione e fuori da Meta).

Nota: le metriche sono disponibili se si esegue una query con action_attribution_windows=1d_click,7d_click,1d_view (non includendo la finestra predefinita).

Dettagli generici

Sono disponibili i seguenti dettagli.

Note

• L'applicazione del filtro per app_id e skan_conversion_id usando il campo filtering attualmente non è supportata.
• Il dettaglio dma non è disponibile per la metrica estimated_ad_recall_rate o video_thruplay_watched_actions.
• Il dettaglio dma utilizza una metodologia di campionamento per calcolare metriche uniche come la copertura. In presenza di numerose regioni DMA con volumi relativamente bassi, queste potrebbero non essere rappresentate nel campione o potrebbero essere raddoppiate. Per questo, è consigliabile interrogare anche le impression corrispondenti per una maggiore accuratezza.
• frequency_value viene utilizzato solo con reach. Ad esempio, con quale frequenza un utente unico ha visualizzato un'inserzione.
• Per design, i dettagli image_asset e video_asset non sono disponibili a livello di account pubblicitario per le risorse utilizzate nella Creatività dinamica.
• Le azioni dell'inserzionevideo_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions e video_p100_watched_actions non supportano i dettagli region.
• Tutti i dettagli delle risorse delle creatività dinamiche supportano solo un insieme limitato di metriche:

La chiamata indicata di seguito raggruppa i risultati per age e gender.

curl -G \
  -d "breakdowns=age,gender" \
  -d "fields=impressions" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

Dettagli orari

Adesso, le statistiche orarie sono disponibili tramite i dettagli seguenti:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Vedi Uso combinato dei dettagli per i limiti relativi al numero di quelli che puoi richiedere tramite i dettagli orari. I dettagli orari non supportano campi unici, ovvero quelli preceduti da unique_*, reach o frequency. I campi reach e frequency restituiscono 0 quando usi i dettagli orari.

curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

Dettagli relativi alle azioni

Raggruppa i risultati nel campo actions. Puoi usare i dettagli seguenti per action_breakdowns:

I dettagli seguenti sono quelli che puoi inserire nel campo action_breakdowns.

• action_device
• conversion_destination
• matched_persona_id
• matched_persona_name
• signal_source_bucket
• standard_event_content_type
• action_canvas_component_name
• action_carousel_card_id
• action_carousel_card_name
• action_destination
• action_reaction
• action_target_id
• action_type
• action_video_sound
• action_video_type

Se il parametro action_breakdowns non è specificato, action_type viene implicitamente aggiunto come action_breakdowns.

Numero totale in actions

Numero totale (somma) di tutti i valori restituiti nei risultati del gruppo (actions).

total_actions - 33
    page_engagement - 10
        post_engagement - 10
            link_click - 2
            comment - 3
            post_reaction - 3
            like - 2
    mobile_app_install - 12
    app_custom_event - 11
        app_custom_event.fb_mobile_activate_app - 6
        app_custom_event.other - 5

In questo esempio, post_engagement è la somma di link_click, comment, like e post_reaction, dove post_reaction rappresenta il numero di tutte le reazioni, compresi i "Mi piace". Il campo total_actions rappresenta una somma di azioni di alto livello per un oggetto, come page_engagement, mobile_app_install e app_custom_event.

Uso combinato dei dettagli

Per via dei limiti dello spazio di archiviazione, sono disponibili solo alcune versioni dei dettagli. Le versioni contrassegnate con un asterisco (*) possono essere unite a action_type, action_target_id e action_destination, ovvero il nome di action_target_id.

Limitazioni

• I campi video_* non possono essere richiesti con i dettagli relativi alle statistiche orarie.
• Il campo video_avg_time_watched_actions non può essere richiesto con i dettagli relativi all'area geografica.
• action_type viene implicitamente aggiunto come action_breakdowns quando il parametro action_breakdowns non viene specificato.