Riferimento per l'API Messaging Insights

L'API Messaging Insights ti consente di recuperare a livello di codice le stesse informazioni visualizzate nella tab Insights della Pagina della tua Pagina Facebook.

Per maggiori informazioni sull'API Messaging Insights e altri dati statistici messi a disposizione dalla Piattaforma Messenger, consulta Dati statistici.

Per maggiori informazioni sull'API Pages Insights, comprese informazioni su altre metriche disponibili e sulle autorizzazioni obbligatorie, consulta la Documentazione su Insights della Pagina o il riferimento per gli oggetti della funzione Insights.

Autorizzazioni

Per interagire con questo endpoint, è necessario un token d'accesso della Pagina con l'autorizzazione read_insights.

Esempio di richiesta

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

Esempio di risposta

{ 
  "data": [ 
    { 
      "name": "

Parametri

Parametro	Descrizione
`breakdowns`	Dimensioni in base alle quali è raggruppata la risposta. Ad esempio `messaging_channel` (Messenger o Instagram), `recurring_notification_topic` o `recurring_notifications_freuency`.
`date_preset`	Intervallo di date relativo che può essere utilizzato al posto di `since` e `until`. Ad esempio `last_week`, `last_month`, `last_quarter`e altre opzioni.
`metric`	Una lista separata da virgole di metriche da restituire.
`period`	L'aggregazione fornita nell'intervallo since/until o date_preset. Il valore `total_over_range` fornisce un singolo valore per la metrica in uno specifico intervallo di date. Ad esempio `day`, `week`, `month`, `days_28` o `total_over_range`.
`since`	L'indicazione temporale UNIX dell'orario di inizio per cui ottenere la metrica.
`until`	L'indicazione temporale UNIX dell'orario di termine per cui ottenere la metrica.

Metriche disponibili

Le seguenti metriche sono disponibili tramite l'API Messaging Insights:

`metric` Nome	Descrizione
`recurring_notification_tokens`	Il numero di volte in cui un account ha attivato la ricezione di messaggi di marketing dalla tua azienda. Se un account ha attivato l'iscrizione a più argomenti, verrà conteggiato nuovamente per ciascun argomento. Modalità di calcolo: questa metrica conta il numero di volte in cui gli account hanno accettato di ricevere i messaggi ricorrenti meno il numero di volte in cui gli account hanno annullato l'iscrizione. Possibili valori di `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Questa metrica è in fase di sviluppo.
`page_messages_engagement`	Il numero di volte in cui gli utenti hanno interagito tramite messaggi sulla tua Pagina business, ad esempio toccando un pulsante di call to action. Questa metrica include solo i dati ottenuti dai messaggi di marketing. Possibili valori di `breakdowns`: `messaging_channel` `recurring_notifications_topic` Questa metrica è in fase di sviluppo.
`page_messages_sent`	Il numero di messaggi che la tua Pagina business ha inviato a un cliente. Questa metrica include solo i dati ottenuti dai messaggi di marketing. Possibili valori di `breakdowns`: `messaging_channel` `recurring_notifications_topic` Questa metrica è in fase di sviluppo.
`page_messages_read_ratio`	Il numero di messaggi letti diviso per il numero di messaggi inviati dalla tua Pagina. A volte il dato potrebbe non essere rilevato, ad esempio quando un cliente ha disattivato le conferme di lettura. Questa metrica include solo i dati ottenuti dai messaggi di marketing. Possibili valori di `breakdowns`: `messaging_channel` `recurring_notifications_topic` Questa metrica è in fase di sviluppo.
`page_messages_order_count`	Il numero delle volte in cui hai creato un ordine a partire da conversazioni oppure tramite app o siti web di terzi usati per gestire le conversazioni. Questa metrica è in fase di sviluppo.
`page_messages_paid_order_earnings`	L'importo stimato che hai guadagnato dagli ordini creati a partire da conversazioni oppure effettuati tramite app o siti web di terzi usati per gestire conversazioni. I ricavi finali potrebbero variare per via delle conversioni di valuta. Questa metrica è in fase di sviluppo.
`page_messages_with_business_outcomes`	Il numero di contatti dei messaggi con almeno un ordine creato. Questa metrica è in fase di sviluppo.
`page_messages_blocked_conversations_unique`	Il numero di conversazioni con la Pagina che sono state bloccate.
`page_messages_new_conversations_unique`	Il numero di conversazioni tramite messaggi su Messenger avviate con persone che non avevano mai inviato messaggi alla tua azienda prima.
`page_messages_reported_conversations_unique`	Il numero di conversazioni della tua Pagina che sono state segnalate dalle persone per motivi come spam o per la presenza di contenuti inappropriati.
`page_messages_total_messaging_connections`	Il numero di persone alle quali la tua azienda può inviare messaggi. Questa metrica riporta il numero di persone che hanno inviato almeno un messaggio alla tua azienda su Messenger, escluse quelle che hanno bloccato o segnalato la tua azienda su Messenger. Potrebbero esserci vincoli relativi alla tua capacità di inviare messaggi ai contatti, come limitazioni al numero di messaggi che puoi inviare in determinati intervalli di tempo. La metrica include inoltre solo le connessioni avvenute da ottobre 2016, quando i dati sono diventati disponibili.

Proprietà della risposta

Proprietà	Descrizione
`data` array di oggetti	Una lista di oggetti delle metriche.
`name` stringa	Il nome della metrica.
`period` stringa	Il periodo di tempo in cui sono stati raccolti i dati.
`values` array di oggetti	Una lista di dati per una metrica.
`value` array di oggetti	Il totale della metrica richiesta al giorno. Per le metriche suddivise per tipo, verrà restituito un oggetto contenente il totale relativo a ciascun tipo.
`end_time` indicazione temporale unix	Indicazione temporale UTC dell'orario di termine per la metrica.

Altri contenuti da consultare

Per maggiori informazioni sull'uso dell'API Messaging Insights, visita la Guida all'uso dell'API Messaging Insights.