เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์
ภาษาอังกฤษที่อัพเดต: 6 พ.ค.

ข้อมูลเชิงลึก

คุณสามารถใช้ API กราฟของ Instagram เพื่อรับเกณฑ์ชี้วัดการโต้ตอบบนโซเชียลมีเดียของผู้ใช้ IG และอ็อบเจ็กต์สื่อบน IG ของผู้ใช้ได้ โดยจำนวนในเกณฑ์ชี้วัดแต่ละรายการจะได้รับการคำนวณเมื่อมีคำขอ API

เนื่องจากกฎด้านความเป็นส่วนตัว การโต้ตอบสื่อบน IG ที่เป็นสตอรี่ที่เกี่ยวข้องกับการส่งข้อความโดยผู้ใช้ในบางภูมิภาคจะไม่รวมอยู่ในการคำนวณเกณฑ์ชี้วัดบางรายการ ซึ่งได้แก่ ยุโรป โดยเริ่มต้นตั้งแต่วันที่ 1 ธันวาคม 2020 และญี่ปุ่น โดยเริ่มต้นตั้งแต่วันที่ 14 เมษายน 2021

  • สำหรับสตอรี่ที่ผู้ใช้ในภูมิภาคดังกล่าวสร้างขึ้น เกณฑ์ชี้วัด replies จะส่งคืนค่าเป็น 0 ในขณะนี้
  • สำหรับสตอรี่ที่ผู้ใช้นอกภูมิภาคดังกล่าวสร้างขึ้น เกณฑ์ชี้วัด replies จะส่งคืนค่าเป็นจำนวนการตอบกลับ แต่การตอบกลับจากผู้ใช้ในภูมิภาคดังกล่าวจะไม่รวมอยู่ในการคำนวณ

ข้อจำกัด

  • เกณฑ์ชี้วัดบางรายการจะไม่พร้อมใช้งานกับผู้ใช้ IG ที่มีผู้ติดตามน้อยกว่า 100 ราย
  • API จะรายงานเฉพาะเกณฑ์ชี้วัดการโต้ตอบแบบออร์แกนิก โดยจะไม่นำการโต้ตอบในโฆษณาที่มีอ็อบเจ็กต์สื่อมารวม
  • ข้อมูลเกณฑ์ชี้วัดของสื่อจะถูกจัดเก็บไว้สูงสุด 2 ปี ข้อมูลเกณฑ์ชี้วัดของผู้ใช้จะถูกจัดเก็บไว้สูงสุด 90 วัน
  • คุณจะรับข้อมูลเชิงลึกของผู้ใช้ได้ทีละรายเท่านั้น
  • คุณไม่สามารถรับข้อมูลเชิงลึกของเพจ Facebook ได้
  • ข้อมูลเชิงลึกของสตอรี่จะพร้อมให้ใช้งานเป็นเวลา 24 ชั่วโมงเท่านั้น แม้จะเก็บสตอรี่เข้าคลังหรือเพิ่มลงในไฮไลท์ก็ตาม หากคุณต้องการรับข้อมูลเชิงลึกล่าสุดของสตอรี่ก่อนจะหมดอายุ ให้ตั้งค่า Webhook สำหรับหัวข้อ Instagram และสมัครรับข้อมูลของช่อง story_insights
  • ระบบไม่รองรับข้อมูลเชิงลึกของสื่อบน IG รองที่เป็นอัลบั้ม
  • หากไม่มีข้อมูลเชิงลึกที่คุณขอหรือไม่สามารถใช้งานข้อมูลดังกล่าวได้ในขณะนี้ API จะส่งคืนชุดข้อมูลเปล่าแทน 0 สำหรับเกณฑ์ชี้วัดแต่ละรายการ

UTC

ประทับเวลาในการตอบกลับจาก API ใช้เวลาแบบ UTC ที่มีออฟเซ็ตเป็นศูนย์ และจัดรูปแบบตามมาตรฐาน ISO-8601 ตัวอย่างเช่น: 2019-04-05T07:56:32+0000

ตำแหน่งข้อมูล

API ประกอบด้วยตำแหน่งข้อมูลดังต่อไปนี้

  • GET /{ig-media-id}/insights - รับเกณฑ์ชี้วัดเกี่ยวกับอ็อบเจ็กต์สื่อ
  • GET /{ig-user-id}/insights - รับเกณฑ์ชี้วัดเกี่ยวกับบัญชีธุรกิจหรือครีเอเตอร์บน Instagram

ดูเกณฑ์ชี้วัดที่พร้อมใช้งาน พารามิเตอร์ และข้อกำหนดสิทธิ์การอนุญาตได้ในเอกสารอ้างอิงของตำแหน่งข้อมูลแต่ละรายการ

ตัวอย่าง

การรับเกณฑ์ชี้วัดบัญชี

หากต้องการรับเกณฑ์ชี้วัดเกี่ยวกับบัญชีธุรกิจหรือครีเอเตอร์บน 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"
    }
  ]
}