Insights del contenido multimedia de Instagram

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

Creación

Esta operación no es compatible.

Lectura

GET /{ig-media-id}/insights

Obtén datos de insights de un objeto de contenido multimedia de Instagram.

Limitaciones

• Los datos de insights no están disponibles para los elementos de contenido multimedia de contenido multimedia de Instagram de un álbum.
• Las métricas del contenido multimedia de las historias solo están disponibles durante 24 horas, incluso si las historias se archivan o se destacan. Para obtener los insights más recientes de una historia antes de que caduque, configura un webhook para el tema Instagram y suscríbete al campo story_insights.
• Las métricas del contenido multimedia de las historias con valores inferiores a cinco devuelven el 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 devuelve un valor de 0.
• En el caso de las historias, las respuestas que provengan de usuarios de Europa y Japón no se incluyen en los cálculos de la métrica replies.
• Si los datos de insights que solicitas no existen o no están disponibles actualmente, la API devuelve un conjunto de datos vacío en lugar de 0 para las métricas individuales.
• Los datos utilizados para calcular métricas pueden retrasarse hasta 48 horas.

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 los álbumes

Métricas de las fotos y los vídeos

No es posible obtener métricas del contenido multimedia de un álbum. En su lugar, obtén las métricas del álbum.

Métricas de los reels

Métricas de las 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"
    }
  ]
}

Métricas nuevas

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

También puedes especificar uno o varios desgloses, de modo que los resultados se desglosarán en conjuntos más pequeños en función del desglose especificado. Los valores pueden ser los siguientes:

• action_type: solo compatible con la métrica profile_activity. Desglosa los resultados en función del componente de la IU del perfil en el que los usuarios hicieron clic o tocaron después de ver el perfil de usuario de la aplicación. Los valores de la respuesta pueden ser los siguientes:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type: desglosa los resultados en función de la acción de navegación que realizó el usuario después de ver el contenido multimedia.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Consulta la tabla Métricas para determinar qué métricas son compatibles con los desgloses y qué desgloses admite cada una. Si solicitas una métrica que no admite desgloses, la API devolverá un error (“An unknown error has occurred.”), así que debes prestar atención al solicitar varias métricas en una única consulta.

Métricas

Métricas de las publicaciones

Las siguientes métricas están disponibles para las publicaciones de contenido multimedia de Instagram que consistan en imágenes o vídeos. No se admiten las secuencias de álbumes ni IGTV.

Métricas de las historias

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

Respuesta

Objeto JSON que contiene los resultados de la consulta. Los resultados pueden incluir los siguientes datos, en función de las especificaciones de 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 una 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 a la solicitud de métricas de una 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 una 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 a la solicitud de métricas de una 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

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.