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

แสดงเกณฑ์ชี้วัดการโต้ตอบทางโซเชียลของผู้ใช้ Instagram

การสร้าง

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

การอ่าน

GET /{ig-user-id}/insights

ส่งคืนข้อมูลเชิงลึกเกี่ยวกับผู้ใช้ Instagram

ข้อจำกัด

• คุณไม่สามารถใช้เกณฑ์ชี้วัด follower_count, เกณฑ์ชี้วัด online_followers และเกณฑ์ชี้วัด audience_* ทั้งหมดกับผู้ใช้ Instagram ที่มีผู้ติดตามน้อยกว่า 100 คนได้
• ข้อมูลเชิงลึกสำหรับเกณฑ์ชี้วัด online_followers ใช้ได้เฉพาะช่วง 30 วันที่ผ่านมาเท่านั้น
• หากไม่มีข้อมูลเชิงลึกที่คุณขอหรือไม่สามารถใช้งานข้อมูลดังกล่าวได้ในขณะนี้ API จะส่งคืนชุดข้อมูลเปล่าแทน 0 สำหรับเกณฑ์ชี้วัดแต่ละรายการ
• เกณฑ์ชี้วัดทางประชากรศาสตร์จะส่งคืนผู้ดำเนินการ 45 อันดับแรกเท่านั้น (เช่น สำหรับ audience_city ระบบสามารถส่งคืนเมืองที่มีจำนวนผู้ติดตามสูงสุดได้ไม่เกิน 45 เมือง)
• เราจะใช้เฉพาะผู้รับชมที่เรามีข้อมูลทางประชากรศาสตร์ในการคำนวณเกณฑ์ชี้วัดทางประชากรศาสตร์
• การรวมค่าเกณฑ์ชี้วัดทางประชากรศาสตร์อาจได้ผลลัพธ์ที่มีค่าน้อยกว่าจำนวนผู้ติดตาม (ดูหัวข้อย่อยก่อนหน้านี้)
• เกณฑ์ชี้วัดaudience_* ไม่รองรับพารามิเตอร์ช่วงsince และ until
• ข้อมูลที่ใช้ในการคำนวณเกณฑ์ชี้วัดอาจล่าช้าถึง 48 ชั่วโมง

ข้อกำหนด

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

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

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

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

เกณฑ์ชี้วัดและระยะเวลา

เกณฑ์ชี้วัดที่รองรับระยะเวลา lifetime จะส่งคืนผลลัพธ์ในรูปแบบอาร์เรย์ของระยะเวลา 24 ชั่วโมง โดยระยะเวลาจะสิ้นสุดที่ UTC−07:00 ทั้งนี้ เกณฑ์ชี้วัด audience_* ไม่รองรับพารามิเตอร์ช่วงsince และ until

ช่วง

จุดเชื่อมโยงนี้รองรับการแบ่งหน้าโดยอิงจากเวลา คุณจึงสามารถใส่พารามิเตอร์ since และ until พร้อมประทับเวลา Unix เพื่อกำหนดช่วงได้ ตัวอย่างเช่น หากต้องการรับอิมเพรสชั่นในช่วงเวลา 28 วัน โดยมีอิมเพรสชั่นทุกวันในช่วง 10 วันที่ผ่านมา คุณสามารถสร้างประทับเวลา Unix สำหรับ 10 วันก่อนและวันนี้ แล้วกำหนดให้กับพารามิเตอร์ since และ until จากนั้นใส่ลงในคำขอของคุณดังนี้

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

พารามิเตอร์ since และ until จะนับรวมวันเริ่มต้นและวันสิ้นสุดด้วย ดังนั้นหากช่วงที่คุณระบุไว้มีวันที่ยังไม่สิ้นสุด (ซึ่งก็คือวันนี้) รวมอยู่ การสืบค้นหลังจากนั้นตลอดวันดังกล่าวอาจส่งคืนค่าที่เพิ่มขึ้น หากคุณไม่ระบุพารามิเตอร์ since และ until ค่าเริ่มต้นของ API จะเป็นช่วง 2 วัน นั่นคือ เมื่อวานถึงวันนี้

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

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

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

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

โปรดทราบว่าตัวอย่างคำขอข้างต้นไม่มีพารามิเตอร์ since และ until ดังนั้น API จึงส่งคืนข้อมูลในช่วง 2 วันตามค่าเริ่มต้น แต่ละวันจะระบุโดยประทับเวลา UTC ที่มีรูปแบบตามมาตรฐาน ISO 8601 และมีออฟเซ็ตเป็นศูนย์ ซึ่งได้รับการกำหนดให้กับคุณสมบัติ end_time แล้ว

คุณสมบัติ end_time จะระบุวันที่ตัดยอดการดูย้อนหลังของชุดข้อมูล แต่ข้อมูลที่เก่ากว่าค่านี้จะไม่รวมอยู่ในการคำนวณของชุดข้อมูลดังกล่าว

การอัพเดต

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

การลบ

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

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

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

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}

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

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

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

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

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

  • BOOK_NOW
  • CALL
  • DIRECTION
  • EMAIL
  • INSTANT_EXPERIENCE
  • TEXT
  • UNDEFINED
• follow_type — แยกย่อยผลลัพธ์ตามผู้ติดตามหรือผู้ที่ไม่ใช่ผู้ติดตาม ค่าในการตอบกลับอาจเป็นดังนี้

  • FOLLOWER
  • NON_FOLLOWER
  • UNKNOWN
• media_product_type — แยกย่อยผลลัพธ์ตามแพลตฟอร์มที่ผู้รับชมได้ดูหรือโต้ตอบกับสื่อของผู้ใช้แอพ ค่าในการตอบกลับอาจเป็นดังนี้

  • AD
  • FEED
  • REELS
  • STORY

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

หากคุณส่งคำขอ metric_type=time_series ระบบจะไม่รวมข้อมูลแยกย่อยไว้ในการตอบกลับ

ประเภทของเกณฑ์ชี้วัด

คุณสามารถกำหนดวิธีที่คุณต้องการรวมผลลัพธ์ได้ ไม่ว่าจะตามระยะเวลาหรือผลรวมอย่างง่าย (พร้อมรายละเอียด หากได้รับการร้องขอ) ซึ่งอาจมีค่าเป็น

• time_series — บอกให้ API รวมผลลัพธ์ตามระยะเวลา โปรดดูระยะเวลา
• total_value — บอกให้ API ส่งคืนผลลัพธ์เป็นผลรวมอย่างง่าย หากข้อมูลแยกย่อยรวมอยู่ในคำขอ ระบบจะแยกย่อยชุดผลลัพธ์เพิ่มเติมตามข้อมูลแยกย่อยที่เฉพาะเจาะจง โปรดดูข้อมูลแยกย่อย

ระยะเวลา

บอก API ว่าจะใช้กรอบเวลาใดเมื่อรวมผลลัพธ์ ใช้ร่วมกันได้กับเกณฑ์ชี้วัดที่เกี่ยวข้องกับการโต้ตอบเท่านั้น

กรอบเวลา

บอก API ว่าจะย้อนกลับไปดูข้อมูลมากน้อยแค่ไหน เมื่อส่งคำขอเกณฑ์ชี้วัดที่เกี่ยวข้องกับข้อมูลทางประชากรศาสตร์ ค่านี้จะแทนที่พารามิเตอร์ since และ until

ช่วง

กำหนดประทับเวลา UNIX ให้กับพารามิเตอร์ since และ until เพื่อกำหนดช่วง API จะรวมเฉพาะข้อมูลที่สร้างขึ้นในช่วงนี้ (รวมเวลาเริ่มต้นและสิ้นสุด) หากคุณไม่ได้ใส่พารามิเตอร์เหล่านี้ไว้ API จะย้อนกลับไปดูข้อมูล 24 ชั่วโมง

สำหรับเกณฑ์ชี้วัดที่เกี่ยวข้องกับข้อมูลทางประชากรศาสตร์ พารามิเตอร์ timeframe จะแทนที่ค่าเหล่านี้ โปรดดูกรอบเวลา

เกณฑ์ชี้วัด

เกณฑ์ชี้วัดการโต้ตอบ

เกณฑ์ชี้วัดทางประชากรศาสตร์

การตอบกลับ

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

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

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

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

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

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

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

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

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

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

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