Insights sul contenuto multimediale di IG

Rappresenta le metriche delle interazioni social su un oggetto IG Media.

Disponibile per l'API Instagram con Facebook Login.

Creazione

Questa operazione non è supportata.

Lettura

GET /<IG_MEDIA_ID>/insights

Ottieni dati di insight su un oggetto IG Media.

Limitazioni

• Gli insight non sono disponibili per i contenuti multimediali di IG all'interno di un album.
• Le metriche dei contenuti multimediali per la storia sono disponibili per 24 ore, anche se le storie sono state archiviate o messe in primo piano. Per ottenere gli insight più recenti su una storia prima che scada, imposta un webhook per l'argomento Instagram e attiva l'iscrizione al campo story_insights.
• Le metriche dei contenuti multimediali per le storie con valori inferiori a 5 restituiscono il codice di errore 10 con il messaggio (#10) Not enough viewers for the media to show insights.
• Per le storie create dagli utenti in Europa e Giappone, ora la metrica replies restituisce il valore 0.
• Per le storie, le risposte degli utenti in Europa e Giappone non sono incluse nei calcoli replies.
• Se gli insight richiesti non esistono o non sono attualmente disponibili, l'API restituisce un insieme di dati vuoto invece di 0 per le singole metriche.
• I dati utilizzati per calcolare le metriche possono essere ritardati fino a 48 ore.

Requisiti

Sintassi della richiesta

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/insights
  ?metric=<LIST_OF_METRICS>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

Parametri della stringa della query

Metriche

Metriche dell'album

Metriche per foto e video

Le metriche sui contenuti multimediali all'interno di un album non sono supportate. Puoi ottenere invece le metriche sull'album.

Metriche per i reel

Metriche delle storie

Esempio di richiesta

curl -X GET \
  'https://graph.facebook.com/v20.0/17895695668004550/insights?metric=impressions,reach&access_token=IGQVJ...'

Esempio di risposta

{
  "data": [
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 264
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "17855590849148465/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 103
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "17855590849148465/insights/reach/lifetime"
    }
  ]
}

Nuove metriche

Sintassi della richiesta

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/insights
  ?metric=<LIST_OF_METRICS>
  &breakdown=<LIST_OF_BREAKDOWNS>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

Parametri della stringa della query

Dettagli

Puoi anche specificare uno o più dettagli e i risultati saranno ripartiti in gruppi più piccoli sulla base del dettaglio specificato. I valori possono essere:

• action_type: compatibile solo con la metrica profile_activity. Filtra i risultati in base al componente UI del profilo che le persone che hanno visualizzato hanno toccato o cliccato dopo la visualizzazione del profilo dell'utente dell'app. I valori delle risposte possono essere:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type: filtra i risultati in base all'azione di navigazione eseguita dalla persona che ha visualizzato durante la visualizzazione dei contenuti multimediali.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Consulta la tabella Metriche per determinare quali metriche supportano i dettagli e quali dettagli in particolare. Richiedendo una metrica che non supporta i dettagli, l'API restituirà un errore ("An unknown error has occurred."), quindi fai attenzione quando richiedi più metriche in una singola query.

Metriche

Metriche dei post

Le seguenti metriche sono disponibili per i contenuti multimediali di IG immagine, video e album carosello pubblicati come post. IGTV non è supportata.

Metriche delle storie

Le metriche seguenti sono disponibili per i contenuti multimediali di IG pubblicati come storia.

Risposta

Un oggetto JSON che contiene i risultati della tua query. I risultati potrebbero includere i dati seguenti, sulla base delle specifiche della tua query:

{
  "data": [
    {
      "name": "{name}",
      "period": "{period}",
      "values": [
        {
          "value": {value}
        }
      ],
      "title": "{title}",
      "description": "{description}",
      "total_value": {
        "value":{value},
        "breakdowns": [
          {
            "dimension_keys": [
              "{dimension-key-1}",
              "{dimension-key-2}"
              ...
            ],
            "results": [
              {
                "dimension_values": [
                  "dimension-value-1",
                  "dimension-value-2"
                  ...
                ],
                "value": {value}
              },
              ...
            ]
          }
        ]
      },
      "id": "{id}"
    }
  ]
}

Contenuti della risposta

Esempio richiesta metrica post

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17932174733377207/insights?metric=profile_activity&breakdown=action_type&access_token=EAAOc..."

Esempio risposta metrica post

{
  "data": [
    {
      "name": "profile_activity",
      "period": "lifetime",
      "values": [
        {
          "value": 4
        }
      ],
      "title": "Profile activity",
      "description": "[IG Insights] This header is the name of a metric that appears on an educational info sheet for a particular post, story, video or promotion. This metric is the sum of all profile actions people take when they engage with this content.",
      "total_value": {
        "value": 4,
        "breakdowns": [
          {
            "dimension_keys": [
              "action_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "email"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "text"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "direction"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "bio_link_clicked"
                ],
                "value": 1
              }
            ]
          }
        ]
      },
      "id": "17932174733377207/insights/profile_activity/lifetime"
    }
  ]
}

Esempio richiesta metrica storia

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17969782069736348/insights?metric=navigation&breakdown=story_navigation_action_type&access_token=EAAOc..."

Esempio risposta metrica storia

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [
        {
          "value": 25
        }
      ],
      "title": "Navigation",
      "description": "This is the total number of actions taken from your story. These are made up of metrics like exited, forward, back and next story.",
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": [
              "story_navigation_action_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "tap_forward"
                ],
                "value": 19
              },
              {
                "dimension_values": [
                  "tap_back"
                ],
                "value": 4
              },
              {
                "dimension_values": [
                  "tap_exit"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "swipe_forward"
                ],
                "value": 1
              }
            ]
          }
        ]
      },
      "id": "17969782069736348/insights/navigation/lifetime"
    }
  ]
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.