Statistiques des contenus multimédias Instagram

Représente les indicateurs d’interaction sociale sur un objet de contenu multimédia Instagram « IG Media ».

Création

Cette opération n’est pas prise en charge.

Lecture

GET /{ig-media-id}/insights

Permet d’obtenir des données statistiques sur un objet IG Media.

Limites

• Les données statistiques ne sont pas disponibles pour les contenus multimédias au sein d’objets IG Media d’un album.
• Les indicateurs des contenus multimédias des stories sont disponibles uniquement pendant 24 heures, même si les stories sont archivées ou mises à la une. Pour obtenir les dernières statistiques sur une story avant qu’elle n’expire, configurez un webhook pour le sujet Instagram et abonnez-vous au champ story_insights.
• Les indicateurs des contenus multimédias des stories présentant une valeur inférieure à cinq renvoient un code d’erreur 10 avec le message (#10) Not enough viewers for the media to show insights (Pas assez de spectateur·ices pour pouvoir afficher les statistiques).
• Pour les stories créées par des utilisateur·ices en Europe et au Japon, l’indicateur replies renvoie désormais la valeur 0.
• Les réponses aux stories envoyées par des utilisateur·ices en Europe et au Japon ne sont pas comptabilisées dans le calcul des réponses avec replies.
• Si les données statistiques demandées n’existent pas ou sont actuellement indisponibles, l’API renvoie un ensemble de données vide au lieu de la valeur 0 pour les indicateurs individuels.
• Les données utilisées pour calculer les indicateurs peuvent avoir jusqu’à 48 heures de retard.

Conditions requises

Syntaxe de la requête

GET https://graph.facebook.com/{api-version}/{ig-media-id}/insights
  ?metric={metric}
  &access_token={access-token}

Paramètres du chemin

Paramètres de chaîne de requête

Indicateurs

Indicateurs d’album

Indicateurs de photo et de vidéo

Les indicateurs sur les contenus multimédias au sein d’un album ne sont pas pris en charge. Obtenez des indicateurs sur l’album à la place.

Indicateurs de reels

Indicateurs de story

Exemple de requête

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

Exemple de réponse

{
  "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"
    }
  ]
}

Nouveaux indicateurs

Syntaxe de la requête

GET https://graph.facebook.com/{api-version}/{ig-media-id}/insights
  ?metric={metric}
  &breakdown={breakdown}
  &access_token={access-token}

Paramètres du chemin

Paramètres de chaîne de requête

Répartition

Vous pouvez également spécifier une ou plusieurs répartitions des résultats, afin de créer des sous-ensembles de moindre taille en fonction de la répartition souhaitée. Les valeurs possibles sont les suivantes :

• action_type : uniquement compatible avec l’indicateur profile_activity. Répartit les résultats en fonction du composant de l’UI de profil que l’utilisateur ou l’utilisatrice a actionné après avoir consulté le profil de l’utilisateur·ice de l’application. Les valeurs de réponse possibles sont les suivantes :

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type : répartit les résultats en fonction de l’action de navigation que l’utilisateur ou l’utilisatrice a réalisée après avoir consulté le contenu multimédia.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Consultez le tableau de la section Indicateurs pour déterminer les indicateurs compatibles avec les répartitions, ainsi que les répartitions qu’ils prennent en charge. Si votre requête porte sur un indicateur incompatible avec les répartitions, l’API renvoie le message d’erreur An unknown error has occurred. (Une erreur inconnue s’est produite). Vérifiez donc avec soin vos requêtes qui contiennent plusieurs indicateurs.

Indicateurs

Indicateurs de publication

Les indicateurs suivants sont disponibles pour les contenus multimédias d’une publication Instagram comprenant des images et des vidéos. Les carrousels d’albums et IGTV ne sont pas pris en charge.

Indicateurs de story

Les indicateurs suivants sont disponibles pour les contenus multimédias Instagram publiés dans une story.

Réponse

Objet JSON contenant les résultats de votre requête. En fonction des caractéristiques de votre requête, les résultats peuvent comprendre les données suivantes :

{
  "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}"
    }
  ]
}

Contenu de la réponse

Exemple de requête d’indicateurs pour une publication

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

Exemple de réponse pour les indicateurs d’une publication

{
  "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"
    }
  ]
}

Exemple de requête d’indicateurs pour une story

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

Exemple de réponse pour les indicateurs d’une story

{
  "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"
    }
  ]
}

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.