Estadísticas multimedia de Instagram

Representa las métricas de interacción social sobre un objeto de contenido multimedia de Instagram.

Creación

No se admite esta operación.

Lectura

GET /{ig-media-id}/insights

Obtén datos estadísticos sobre un objeto multimedia de Instagram.

Limitaciones

• Los datos estadísticos no están disponibles para cualquier contenido multimedia dentro de un álbum de contenido multimedia de Instagram.
• Las métricas del contenido multimedia de Instagram de la historia solo están disponibles durante 24 horas, aunque las historias se archiven o se destaquen. Si quieres obtener las últimas estadísticas de una historia antes de que caduque, configura un webhook para el tema de Instagram y suscríbete al campo story_insights.
• Las métricas del contenido multimedia de la historia con valores inferiores a 5 devuelven un código de error 10 con el mensaje (#10) Not enough viewers for the media to show insights.
• En el caso de las historias creadas por usuarios de Europa y Japón, la métrica replies ahora devolverá ahora el valor 0.
• En cuanto a las historias, no se incluyen las respuestas de los usuarios en Europa y Japón en los cálculos de replies.
• Si los datos estadísticos que solicitas no existen o no están disponibles en el momento, la API devuelve un conjunto de datos vacíos en lugar de devolver 0 en las métricas individuales.
• Los datos que se usan para calcular las métricas pueden tener hasta 48 horas de retraso.

Requisitos

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetros de la cadena de consulta

Métricas

Métricas de álbumes

Métricas de foto y video

No se admiten las métricas de contenido multimedia dentro de un álbum. En su lugar, deberás consultar las métricas del álbum.

Métricas de reels

Métricas de historias

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Nuevas métricas

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetros de la cadena de consulta

Desglose

Solo puedes especificar uno o más desgloses y los resultados se desglosarán en conjuntos más pequeños según el desglose especificado. Los valores pueden ser los siguientes:

• action_type: solo compatible con la métrica "profile_activity". Desglosa los resultados según el componente de UI de los perfiles que los espectadores tocan o en el que hacen clic después de ver el perfil de usuario de la app. Los valores de la respuesta pueden ser los siguientes:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type: desglosa los resultados según la acción de navegación que realiza el espectador al ver el contenido multimedia.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Consulta la tabla de métricas para determinar cuáles de estas son compatibles con los desgloses y qué desgloses se admiten. Si solicitas una métrica que no admite desgloses, la API devuelve un error ("An unknown error has occurred."). Por este motivo, ten cuidado si solicitas varias métricas en una sola consulta.

Métricas

Métricas de publicaciones

Las siguientes métricas están disponibles en el contenido multimedia de Instagram de videos o imágenes que se publicó como publicación. No se admiten secuencias de álbumes ni IGTV.

Métricas de historias

Las siguientes métricas están disponibles en el contenido multimedia de Instagram publicado como historia.

Respuesta

Un objeto JSON que contiene los resultados de tu consulta. Los resultados pueden incluir los siguientes datos, según lo que se especificó en la consulta:

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

Contenido de la respuesta

Ejemplo de solicitud de métricas de la publicación

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

Ejemplo de respuesta de métricas de la publicación

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

Ejemplo de solicitud de métricas de la historia

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

Ejemplo de respuesta de métricas de la historia

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

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.