ข้อมูลเชิงลึกของสื่อบน Instagram

คือเกณฑ์ชี้วัดการโต้ตอบบนโซเชียลในอ็อบเจ็กต์สื่อบน Instagram

การสร้าง

ระบบไม่รองรับการดำเนินการนี้

การอ่าน

GET /{ig-media-id}/insights

รับข้อมูลเชิงลึกเกี่ยวกับอ็อบเจ็กต์สื่อบน Instagram

ข้อจำกัด

• ข้อมูลเชิงลึกไม่พร้อมให้ใช้งานสำหรับสื่อใดๆ ภายในสื่อบน Instagram ที่เป็นอัลบั้ม
• เกณฑ์ชี้วัดของสื่อที่เป็นสตอรี่จะใช้งานได้เป็นเวลา 24 ชั่วโมงเท่านั้น แม้จะจัดเก็บสตอรี่เข้าคลังหรือเพิ่มลงในไฮไลท์ก็ตาม หากต้องการรับข้อมูลเชิงลึกล่าสุดของสตอรี่ก่อนจะหมดอายุ ให้ตั้งค่า Webhook สำหรับหัวข้อ Instagram และสมัครรับข้อมูลของช่อง story_insights
• เกณฑ์ชี้วัดของสื่อที่เป็นสตอรี่ซึ่งมีค่าน้อยกว่า 5 จะส่งคืนรหัสข้อผิดพลาด 10 พร้อมข้อความว่า (#10) Not enough viewers for the media to show insights
• สำหรับสตอรี่ที่ผู้ใช้ในยุโรปและญี่ปุ่นสร้างขึ้น เกณฑ์ชี้วัด replies จะส่งคืนค่าเป็น 0 ในตอนนี้
• สำหรับสตอรี่ การตอบกลับจากผู้ใช้ในยุโรปและญี่ปุ่นจะไม่รวมอยู่ในการคำนวณ replies
• หากไม่มีข้อมูลเชิงลึกที่คุณขอหรือไม่สามารถใช้งานข้อมูลดังกล่าวได้ในขณะนี้ API จะส่งคืนชุดข้อมูลเปล่าแทน 0 สำหรับเกณฑ์ชี้วัดแต่ละรายการ
• ข้อมูลที่ใช้ในการคำนวณเกณฑ์ชี้วัดอาจล่าช้าถึง 48 ชั่วโมง

ข้อกำหนด

รูปแบบคำสั่งของคำขอ

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

พารามิเตอร์พาธ

พารามิเตอร์สตริงการสืบค้น

เกณฑ์ชี้วัด

เกณฑ์ชี้วัดอัลบั้ม

เกณฑ์ชี้วัดรูปภาพและวิดีโอ

ระบบไม่รองรับเกณฑ์ชี้วัดของสื่อภายในอัลบั้ม แต่จะได้รับเกณฑ์ชี้วัดของอัลบั้มแทน

เกณฑ์ชี้วัดคลิป Reels

เกณฑ์ชี้วัดสตอรี่

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

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

เกณฑ์ชี้วัดใหม่

รูปแบบคำสั่งของคำขอ

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

พารามิเตอร์พาธ

พารามิเตอร์สตริงการสืบค้น

ข้อมูลแยกย่อย

คุณสามารถระบุข้อมูลแยกย่อยได้อย่างน้อย 1 รายการ และผลลัพธ์จะถูกแบ่งออกเป็นชุดย่อยๆ ตามข้อมูลแยกย่อยที่ระบุ ซึ่งอาจมีค่าดังนี้

• action_type — ใช้ร่วมได้กับเกณฑ์ชี้วัด profile_activity เท่านั้น แยกย่อยผลลัพธ์ตามส่วนประกอบของ UI โปรไฟล์ที่ผู้ชมแตะหรือคลิกหลังจากดูโปรไฟล์ของผู้ใช้แอพ ค่าในการตอบกลับอาจเป็นดังนี้

  • BIO_LINK_CLICKED
  • CALL
  • DIRECTION
  • EMAIL
  • OTHER
  • TEXT
• story_navigation_action_type — แยกย่อยผลลัพธ์ตามการดำเนินการของผู้ชมขณะดูสื่อ

  • TAP_BACK
  • TAP_EXIT
  • TAP_FORWARD
  • SWIPE_FORWARD

โปรดดูตารางเกณฑ์ชี้วัดเพื่อพิจารณาว่าเกณฑ์ชี้วัดใดบ้างรองรับข้อมูลแยกย่อยและข้อมูลแยกย่อยที่รองรับมีอะไรบ้าง หากคุณส่งคำขอเกณฑ์ชี้วัดที่ไม่รองรับข้อมูลแยกย่อย API จะส่งคืนข้อผิดพลาด ("An unknown error has occurred.") ดังนั้น โปรดดำเนินการอย่างรอบคอบหากส่งคำขอเกณฑ์ชี้วัดหลายรายการในการสืบค้นเดียว

เกณฑ์ชี้วัด

เกณฑ์ชี้วัดของโพสต์

เกณฑ์ชี้วัดต่อไปนี้พร้อมใช้งานกับสื่อบน Instagram ที่เป็นรูปภาพและวิดีโอ ซึ่งเผยแพร่ในรูปแบบโพสต์ ระบบไม่รองรับภาพสไลด์แบบอัลบั้มและ IGTV

เกณฑ์ชี้วัดสตอรี่

เกณฑ์ชี้วัดต่อไปนี้พร้อมใช้งานกับสื่อบน Instagram ซึ่งเผยแพร่ในรูปแบบสตอรี่

การตอบกลับ

อ็อบเจ็กต์ JSON ที่มีผลลัพธ์ของการสืบค้น ผลลัพธ์อาจมีข้อมูลต่อไปนี้ตามข้อกำหนดในการสืบค้นของคุณ

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

เนื้อหาของการตอบกลับ

ตัวอย่างคำขอเกณฑ์ชี้วัดของโพสต์

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

ตัวอย่างการตอบกลับเกณฑ์ชี้วัดของโพสต์

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

ตัวอย่างคำขอเกณฑ์ชี้วัดของสตอรี่

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

ตัวอย่างการตอบกลับเกณฑ์ชี้วัดของสตอรี่

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

การอัพเดต

ระบบไม่รองรับการดำเนินการนี้

การลบ

ระบบไม่รองรับการดำเนินการนี้