Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.

Aggiornamento inglese: 2 mag

Insight

Puoi usare l'API Instagram Graph per ottenere metriche delle interazioni social per gli utenti di IG e i relativi oggetti contenuti multimediali di IG. Le quantità per ciascuna metrica vengono calcolate al momento della richiesta all'API.

A causa delle regole sulla privacy, le interazioni di messaggistica con i contenuti multimediali delle Storie di Instagram eseguite dagli utenti che si trovano in alcune aree geografiche non saranno più incluse in determinati calcoli delle metriche. Queste regioni includono: Europa a partire dal 1° dicembre 2020 e Giappone a partire dal 14 aprile 2021.

Per le Storie create da utenti nelle aree geografiche interessate, la metrica replies ora restituirà un valore pari a 0.
Per le Storie create da utenti al di fuori delle aree geografiche interessate, la metrica replies restituirà il numero di risposte, ma le risposte inviate dagli utenti nelle aree geografiche interessate non saranno incluse in questo calcolo.

Limitazioni

Alcune metriche non sono disponibili per gli utenti di Instagram che hanno meno di 100 follower.
L'API riporta solo le metriche relative alle interazioni organiche; le interazioni associate a inserzioni contenenti un oggetto multimediale non vengono conteggiate.
I dati relativi alle metriche dei contenuti multimediali vengono conservati per un massimo di 2 anni. I dati relativi alle metriche degli utenti vengono conservati per un massimo di 90 giorni.
Puoi ottenere insight per un singolo utente alla volta.
Non puoi ottenere insights per le Pagine Facebook.
Gli insights relativi alle Storie sono disponibili solo per 24 ore, anche se le Storie sono archiviate o in primo piano. Se desideri ottenere le ultime informazioni su una Storia prima che scada, imposta un webhook per l'argomento Instagram e attiva l'iscrizione al campo story_insights.
Gli insights relativi a contenuti multimediali di IG secondari degli album non sono supportati.
Se gli insights che stai richiedendo non esistono o non sono attualmente disponibili, l'API restituirà un set di dati vuoto invece di 0 per le singole metriche.

UTC

Le marche temporali nelle risposte dell'API utilizzano il fuso orario UTC con offset zero e sono formattate in base allo standard ISO-8601. Ad esempio: 2019-04-05T07:56:32+0000

Endpoint

L'API si compone degli endpoint seguenti:

GET /{ig-media-id}/insights: ottiene le metriche relative a un oggetto multimediale.
GET /{ig-user-id}/insights: ottiene le metriche relative a un account business o creator di Instagram.

Consulta la documentazione di riferimento di ogni endpoint per metriche, parametri e requisiti di autorizzazione disponibili.

Esempi

Ottenere le metriche di un account

Per ottenere le metriche relative a un account business o creator di Instagram, interroga il segmento GET /{ig-user-id}/insights e specifica le metriche che desideri vengano restituite.

Esempio di richiesta

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

Esempio di risposta

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

Ottenere le metriche di oggetti multimediali

Per ottenere le metriche relative a un oggetto multimediale, interroga il segmento GET /{ig-media-id}/insights e specifica le metriche che desideri vengano restituite.

Esempio di richiesta

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

Esempio di risposta

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}