Thông tin chi tiết về File phương tiện trên Instagram

Biểu thị số liệu tương tác xã hội của đối tượng File phương tiện trên Instagram.

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET /{ig-media-id}/insights

Lấy dữ liệu thông tin chi tiết về đối tượng File phương tiện trên Instagram.

Giới hạn

• Hệ thống không cung cấp dữ liệu thông tin chi tiết cho bất kỳ file phương tiện nào trong File phương tiện trên Instagram thuộc album.
• Số liệu về file phương tiện trong Tin chỉ tồn tại trong 24 giờ, ngay cả khi tin được lưu trữ hoặc nêu bật. Nếu bạn muốn lấy thông tin chi tiết mới nhất về một tin trước khi tin đó hết hạn, hãy thiết lập Webhook cho chủ đề Instagram và đăng ký trường story_insights.
• Số liệu về file phương tiện trong Tin có giá trị nhỏ hơn 5 sẽ trả về mã lỗi 10 kèm theo thông báo (#10) Not enough viewers for the media to show insights.
• Đối với Tin do người dùng tại châu Âu và Nhật Bản tạo, số liệu replies hiện trả về giá trị 0.
• Đối với Tin, phản hồi của người dùng tại châu Âu và Nhật Bản không được đưa vào khi tính toán replies.
• Nếu dữ liệu thông tin chi tiết bạn đang yêu cầu không tồn tại hoặc hiện không có sẵn, API sẽ trả về một tập dữ liệu trống thay cho 0 đối với từng số liệu.
• Dữ liệu dùng để tính toán số liệu có thể hiển thị chậm tối đa 48 giờ.

Yêu cầu

Cú pháp yêu cầu

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

Thông số đường dẫn

Thông số chuỗi truy vấn

Số liệu

Số liệu về album

Số liệu về ảnh và video

Số liệu về file phương tiện trong một album không được hỗ trợ. Thay vào đó, hãy lấy số liệu về album.

Số liệu về thước phim

Số liệu về Tin

Yêu cầu mẫu

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

Phản hồi mẫu

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

Số liệu mới

Cú pháp yêu cầu

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

Thông số đường dẫn

Thông số chuỗi truy vấn

Số liệu chia nhỏ

Bạn cũng có thể chỉ định một hoặc nhiều số liệu chia nhỏ. Kết quả sẽ được chia thành các tập hợp nhỏ hơn dựa trên số liệu chia nhỏ đã chỉ định. Các giá trị có thể là:

• action_type - Chỉ tương thích với số liệu profile_activity. Chia nhỏ kết quả theo thành phần giao diện người dùng của trang cá nhân mà người xem đã nhấn hoặc nhấp vào sau khi xem trang cá nhân của người dùng ứng dụng. Giá trị phản hồi có thể là:

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type - Chia nhỏ kết quả theo hành động điều hướng mà người xem thực hiện sau khi xem file phương tiện.

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

Tham khảo bảng Số liệu để xác định số liệu nào hỗ trợ số liệu chia nhỏ và những số liệu chia nhỏ được hỗ trợ. Nếu bạn yêu cầu một số liệu không hỗ trợ số liệu chia nhỏ, API sẽ trả về lỗi ("An unknown error has occurred."). Vì vậy, bạn cần thận trọng khi yêu cầu nhiều số liệu trong một truy vấn.

Số liệu

Số liệu về bài viết

File phương tiện trên Instagram (hình ảnh và video) được đăng dưới dạng Bài viết có các số liệu sau. Thẻ quay vòng album và IGTV không được hỗ trợ.

Số liệu về Tin

File phương tiện trên Instagram được đăng dưới dạng Tin có các số liệu sau.

Phản hồi

Đối tượng JSON có chứa kết quả truy vấn của bạn. Tùy theo quy cách truy vấn, kết quả có thể bao gồm những dữ liệu sau:

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

Nội dung phản hồi

Yêu cầu mẫu cho số liệu về bài viết

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

Phản hồi mẫu cho số liệu về bài viết

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

Yêu cầu mẫu cho số liệu về tin

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

Phản hồi mẫu cho số liệu về tin

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

Cập nhật

Thao tác này không được hỗ trợ.

Xóa

Thao tác này không được hỗ trợ.