文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:4月29日

成效分析

您可以使用 Instagram 图谱 API 获取 Instagram 用户及其 Instagram 媒体对象的社交互动指标。每个指标的数量均根据 API 请求计算而得。

根据隐私规定,用户在某些地区执行的与消息相关的快拍 Instagram 媒体互动将不再包含在一些指标计算中。这些地区包括:欧洲(从 2020 年 12 月 1 日开始)和日本(从 2021 年 4 月 14 日开始)。

  • 对于受影响地区的用户创建的快拍,replies 指标现将返回 0 值。
  • 对于受影响地区以外的用户创建的快拍,replies 指标将返回回复次数,但不会将受影响地区的用户作出的回复计算在内。

限制

  • 一些指标不适用于粉丝数不足 100 的 Instagram 用户。
  • 该 API 仅报告自然互动指标;在包含媒体对象的广告上进行的互动不计算在内。
  • 媒体指标数据的存储时间长达 2 年。用户指标数据的存储时间长达 90 天。
  • 您每次只能获取单个用户的成效分析。
  • 您无法获取 Facebook 公共主页的成效分析。
  • 即使已将快拍归档或为之添加星标,该快拍成效分析的有效期也只有 24 小时。如果您希望在快拍过期之前获得最新成效分析,请为 Instagram 主题设置 Webhooks,并订阅 story_insights 字段。
  • 不支持相册子 Instagram 媒体的成效分析。
  • 如果您正在请求的成效分析数据不存在或者目前无法查看,API 将为各个指标返回空数据集,而不是返回 0

UTC

API 响应中的时间戳使用零偏移量的 UTC,并采用 ISO-8601 格式。例如:2019-04-05T07:56:32+0000

端点

此 API 包含以下端点:

如需了解可用的指标、参数和权限要求,请参阅每个端点的参考文档。

示例

获取账户指标

如需获取 Instagram 业务账户或创作者账户的指标,请查询 GET /{ig-user-id}/insights 连线,并指定您希望返回的指标。

请求示例

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

响应示例

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

获取媒体指标

如需获取媒体对象的指标,请查询 GET /{ig-media-id}/insights 连线,并指定您希望返回的指标。

请求示例

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

响应示例

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