API Messaging Insights

Questo documento spiega come ottenere a livello di codice le metriche per i messaggi inviati o ricevuti dalla tua azienda. L'API Messaging Insights è un'estensione dell'API Pages Insights e consente di ottenere le stesse informazioni visualizzate nella tab Insights della Pagina della tua Pagina Facebook.

Prima di iniziare

Per visualizzare le metriche di una Pagina Facebook di tua proprietà o su cui puoi eseguire l'attività ANALYZE, l'app avrà bisogno di quanto segue:

• L'ID della Pagina Facebook per cui desideri visualizzare le metriche

  • Per i messaggi di Instagram, questa sarà la Pagina Facebook collegata all'account Instagram per professionisti
• Un token d'accesso della Pagina
• Le seguenti autorizzazioni:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Accesso standard

Per visualizzare le metriche per una Pagina non di tua proprietà o su cui non puoi eseguire l'attività ANALYZE, l'app avrà bisogno di quanto segue:

• L'ID della Pagina Facebook per cui desideri visualizzare le metriche

  • Per i messaggi di Instagram, questa sarà la Pagina Facebook collegata all'account Instagram per professionisti
• Un token d'accesso della Pagina richiesto da un utente che può eseguire l'attività ANALYZE sulla Pagina
• Le seguenti autorizzazioni tramite Facebook Login:

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• Accesso avanzato

Limitazioni

• Affinché una nuova conversazione sia conteggiata, la persona deve aver eseguito un'azione, ad esempio aver inviato una risposta alla tua azienda. Finché la persona non eseguirà un'azione, la conversazione sarà visibile solo a lei e non sarà conteggiata.

Lettura delle metriche Insights

Per leggere le informazioni relative a una o più metriche, invia una richiesta GET all'endpoint /PAGE-ID/insights con il parametro metric impostato su una lista separata da virgole di metriche che desideri visualizzare.

Esempio di richiesta

curl -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights
    ?metric=page_messages_new_conversations_unique,page_messages_blocked_conversations_unique 
    &access_token=PAGE-ACCESS-TOKEN"

Se l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON:

{ 
  "data": [ 
    { 
      "name": "page_messages_new_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "42", 
          "end_time": "1665175977" 
        }, 
      ]
    },
    { 
      "name": "page_messages_blocked_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "0", 
          "end_time": "1665175977" 
        }, 
      ]
    } 
  ],
}

Esempio di richiesta per un intervallo totale

L'esempio seguente trova il numero di conversazioni uniche e nuove in uno specifico periodo di tempo grazie al parametro period impostato su total_over_range, con l'intervallo temporale definito dai parametri since e until della chiamata API.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=page_messages_new_conversations_unique
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &access_token=PAGE-ACCESS-TOKEN"

Se l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON con il numero di conversazioni uniche e nuove alla fine dell'intervallo temporale:

{
  "data": [
    {
      "name": "page_messages_new_conversations_unique",
      "period": "total_over_range",
      "values": [
        {
          "value": 27
          "end_time": "1665175977"
        }
      ],
    }
  ]
}

Esempio di richiesta di dettagli

L'esempio seguente trova il numero di token per notifiche ricorrenti in uno specifico periodo di tempo e raggruppati per argomento e frequenza.

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=recurring_notifications_tokens   
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &breakdown=recurring_notifications_topic,recurring_notifications_frequency 
    &access_token=PAGE-ACCESS-TOKEN"

Se l'azione viene eseguita correttamente, l'app riceve la seguente risposta JSON, con i token raggruppati per argomento, "newproducts" e "10percentsale" e la frequenza dei messaggi disponibile per ogni argomento, "daily", "weekly" e "monthly" per "newproducts" e "daily" e "weekly" per "10percentsale":

{
  "data": [
    {
      "name": "recurring_notifications_tokens",
      "period": "total_over_range",
      "values": [ 
        {
          "value": 3,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 15,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "weekly"
        },
        {
          "value": 8,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "monthly"
        },
        {
          "value": 17,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 14,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "weekly"
        },
      ]
    }
  ]
}

Parametri di Insights

Metriche disponibili

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

Ulteriori informazioni sulle metriche in via di sviluppo.

Proprietà della risposta

Le seguenti informazioni potrebbero essere restituite in una chiamata all'API Insights.

Altri contenuti da consultare

• Ulteriori informazioni su Insights della Pagina
• Ulteriori informazioni sul riferimento agli oggetti di Insights