Thông tin chi tiết về người dùng Instagram

Biểu thị số liệu tương tác xã hội của Người dùng Instagram.

Tạo

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

Đọc

GET /{ig-user-id}/insights

Trả về thông tin chi tiết của Người dùng Instagram.

Giới hạn

• Người dùng Instagram có ít hơn 100 người theo dõi sẽ không xem được follower_count, online_followers và tất cả số liệu audience_*.
• Thông tin chi tiết về số liệu online_followers chỉ có dữ liệu trong 30 ngày qua.
• 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 vì 0 đối với từng số liệu.
• Số liệu nhân khẩu học chỉ trả về 45 thành phần đạt hiệu quả cao nhất (ví dụ: đối với audience_city, hệ thống có thể trả về tối đa 45 tỉnh/thành phố có số người theo dõi cao nhất).
• Chỉ những người xem mà chúng tôi có dữ liệu nhân khẩu học mới được sử dụng trong các phép tính số liệu nhân khẩu học.
• Việc tính tổng các giá trị số liệu nhân khẩu học có thể dẫn đến giá trị nhỏ hơn số lượng người theo dõi (xem dấu đầu dòng trước).
• Số liệuaudience_* không hỗ trợ thông số phạm visince và until.
• Dữ liệu dùng để tính toán các 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-user-id}/insights
  ?metric={metric}
  &period={period}
  &since={since}
  &until={until}
  &access_token={access-token}

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

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

Số liệu và khoảng thời gian

Các số liệu hỗ trợ khoảng thời gian lifetime sẽ nhận được kết quả trả về dưới dạng mảng thời gian 24 giờ, với khoảng thời gian kết thúc vào UTC−07:00. Số liệu audience_* không hỗ trợ thông số phạm visince và until.

Phạm vi

Cạnh này hỗ trợ tính năng phân trang theo thời gian. Vì vậy, bạn có thể thêm thông số since và until với nhãn thời gian Unix để xác định phạm vi. Ví dụ: để lấy dữ liệu về lượt hiển thị trong 28 ngày - mọi ngày trong 10 ngày qua - bạn có thể tạo nhãn thời gian Unix cho 10 ngày trước và hôm nay, chỉ định nhãn thời gian đó cho các thông số since và until rồi thêm vào yêu cầu của bạn:

metric=impressions&period=days_28&since=1501545600&until=1502493720

Thông số since và until đều được đưa vào. Vì vậy, nếu phạm vi của bạn có một ngày chưa kết thúc (ví dụ: hôm nay), các truy vấn tiếp theo trong cả ngày đó có thể trả về giá trị gia tăng. Nếu bạn không thêm thông số since và until, API này sẽ chọn phạm vi mặc định là 2 ngày: hôm qua đến hết hôm nay.

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 4,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 66,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times this profile has been seen",
      "id": "17841400008460056/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 3,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 36,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen this profile",
      "id": "17841400008460056/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 0,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 2,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of unique accounts that have viewed this profile within the specified period",
      "id": "17841400008460056/insights/profile_views/day"
    }
  ]
}

Lưu ý rằng yêu cầu mẫu ở trên không bao gồm thông số since và until nên API này đã trả về dữ liệu trong phạm vi mặc định là 2 ngày. Mỗi ngày được xác định bằng nhãn thời gian UTC theo định dạng ISO 8601 mà không bù trừ chênh lệch, nhãn thời gian này đã được chỉ định cho thuộc tính end_time.

Thuộc tính end_time cho biết ngày khóa sổ xem tập dữ liệu; dữ liệu cũ hơn giá trị này sẽ không được đưa vào phép tính của tập dữ liệu.

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ợ.

Số liệu mới

Cú pháp yêu cầu

GET https://graph.facebook.com/{api-version}/{ig-user-id}/insights
  ?metric={metric}
  &period={period}
  &timeframe={timeframe}
  &metric_type={metric-type}
  &breakdown={breakdown}
  &since={since}
  &until={until}
  &access_token={access-token}

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

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

Số liệu chia nhỏ

Nếu yêu cầu metric_type=total_value, 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à:

• contact_button_type - 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. Giá trị phản hồi có thể là:

  • BOOK_NOW
  • CALL
  • DIRECTION
  • EMAIL
  • INSTANT_EXPERIENCE
  • TEXT
  • UNDEFINED
• follow_type - Chia nhỏ kết quả theo người theo dõi hoặc người không theo dõi. Giá trị phản hồi có thể là:

  • FOLLOWER
  • NON_FOLLOWER
  • UNKNOWN
• media_product_type - Chia nhỏ kết quả theo giao diện mà người xem đã xem hoặc tương tác với file phương tiện của người dùng ứng dụng. Giá trị phản hồi có thể là:

  • AD
  • FEED
  • REELS
  • STORY

Tham khảo bảng Số liệu để xác định số liệu nào tương thích với một số liệu chia nhỏ. 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.

Nếu bạn yêu cầu metric_type=time_series, phản hồi sẽ không bao gồm số liệu chia nhỏ.

Loại số liệu

Bạn có thể chỉ định cách mình muốn tổng hợp kết quả - theo khoảng thời gian hoặc ở dạng tổng số đơn giản (có số liệu chia nhỏ, nếu được yêu cầu). Các giá trị có thể là:

• time_series - Cho API biết bạn muốn tổng hợp kết quả theo khoảng thời gian. Hãy xem phần Khoảng thời gian.
• total_value - Cho API biết bạn muốn trả về kết quả ở dạng tổng số đơn giản. Nếu yêu cầu bao gồm số liệu chia nhỏ, tập hợp kết quả sẽ được chia nhỏ thêm theo các số liệu chia nhỏ cụ thể. Hãy xem phần Số liệu chia nhỏ.

Khoảng thời gian

Cho API biết khung thời gian sẽ sử dụng khi tổng hợp kết quả. Chỉ tương thích với số liệu liên quan đến hoạt động tương tác.

Khung thời gian

Cho API biết khoảng thời gian xem lại dữ liệu trong quá khứ khi yêu cầu số liệu liên quan đến thông tin nhân khẩu học. Giá trị này ghi đè thông số since và until.

Phạm vi

Chỉ định nhãn thời gian UNIX cho thông số since và until để xác định phạm vi. API sẽ chỉ bao gồm dữ liệu được tạo trong phạm vi này (bao gồm). Nếu bạn không thêm những thông số này, API sẽ xem lại dữ liệu trong vòng 24 giờ qua.

Đối với số liệu liên quan đến thông tin nhân khẩu học, thông số timeframe sẽ ghi đè các giá trị này. Hãy xem phần Khung thời gian.

Số liệu

Số liệu tương tác

Số liệu nhân khẩu học

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": "{data}",
      "period": "{period}",
      "title": "{title}",
      "description": "{description}",
      "total_value": {
        "value": {value},
        "breakdowns": [
          {
            "dimension_keys": [
              "{key-1}",
              "{key-2",
              ...
            ],
            "results": [
              {
                "dimension_values": [
                  "{value-1}",
                  "{value-2}",
                  ...
                ],
                "value": {value},
                "end_time": "{end-time}"
              },
              ...
            ]
          }
        ]
      },
      "id": "{id}"
    }
  ],
  "paging": {
    "previous": "{previous}",
    "next": "{next}"
  }
}

Nội dung phản hồi

Yêu cầu mẫu về số liệu tương tác

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=reach&period=day&breakdown=media_product_type&metric_type=total_value&since=1658991600&access_token=EAAOc..."

Phản hồi mẫu về số liệu tương tác

{
  "data": [
    {
      "name": "reach",
      "period": "day",
      "title": "Accounts reached",
      "description": "The number of unique accounts that have seen your content, at least once, including in ads. Content includes posts, stories, reels, videos and live videos. Reach is different from impressions, which may include multiple views of your content by the same accounts. This metric is estimated and in development.",
      "total_value": {
        "value": 224,
        "breakdowns": [
          {
            "dimension_keys": [
              "media_product_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "CAROUSEL_CONTAINER"
                ],
                "value": 100
              },
              {
                "dimension_values": [
                  "POST"
                ],
                "value": 124
              }
            ]
          }
        ]
      },
      "id": "17841405309211844/insights/reach/day"
    }
  ],
  "paging": {
    "previous": "https://graph.face...",
    "next": "https://graph.face..."
  }

Yêu cầu mẫu về số liệu nhân khẩu học

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=engaged_audience_demographics&period=lifetime&timeframe=last_90_days&breakdowns=country&metric_type=total_value&access_token=EAAOc..."

Phản hồi mẫu về số liệu nhân khẩu học

{
  "data": [
    {
      "name": "engaged_audience_demographics",
      "period": "lifetime",
      "title": "Engaged audience demographics",
      "description": "The demographic characteristics of the engaged audience, including countries, cities and gender distribution.",
      "total_value": {
        "breakdowns": [
          {
            "dimension_keys": [
              "timeframe",
              "country"
            ],
            "results": [
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "AR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "RU"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "LA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "IQ"
                ],
                "value": 2
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MX"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "FR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "ES"
                ],
                "value": 3
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "NL"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "TR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "US"
                ],
                "value": 7
              }
            ]
          }
        ]
      },
      "id": "17841401130346306/insights/engaged_audience_demographics/lifetime"
    }
  ]
}