API ข้อมูลเชิงลึกของการส่งข้อความ

เอกสารฉบับนี้จะอธิบายวิธีการทางโปรแกรมในการเรียกดูเกณฑ์ชี้วัดต่างๆ สำหรับข้อความที่ธุรกิจของคุณรับส่ง API ข้อมูลเชิงลึกของการส่งข้อความคือส่วนต่อเติมของ API ข้อมูลเชิงลึกของเพจ และช่วยให้คุณได้ข้อมูลแบบเดียวกันกับที่ปรากฏบนแท็บข้อมูลเชิงลึกของเพจบนเพจ Facebook ของคุณ

ก่อนเริ่มต้น

หากต้องการดูเกณฑ์ชี้วัดสำหรับเพจ Facebook ที่คุณเป็นเจ้าของหรือสามารถดำเนินงาน ANALYZE บนเพจนั้นได้ แอพของคุณจำเป็นต้องมีสิ่งต่อไปนี้

• ID ของเพจสำหรับเพจ Facebook ที่คุณต้องการดูเกณฑ์ชี้วัด

  • สำหรับการส่งข้อความบน Instagram ส่วนนี้จะเป็นเพจ Facebook ที่ลิงก์กับบัญชีมืออาชีพบน Instagram
• โทเค็นการเข้าถึงเพจ
• สิทธิ์การอนุญาตดังต่อไปนี้

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• สิทธิ์การเข้าถึงแบบมาตรฐาน

หากต้องการดูเกณฑ์ชี้วัดสำหรับเพจ Facebook ที่คุณไม่ได้เป็นเจ้าของหรือไม่สามารถดำเนินงาน ANALYZE บนเพจนั้นได้ แอพของคุณจำเป็นต้องมีสิ่งต่อไปนี้

• ID ของเพจสำหรับเพจ Facebook ที่คุณต้องการดูเกณฑ์ชี้วัด

  • สำหรับการส่งข้อความบน Instagram ส่วนนี้จะเป็นเพจ Facebook ที่ลิงก์กับบัญชีมืออาชีพบน Instagram
• โทเค็นการเข้าถึงเพจที่ส่งคำขอโดยผู้ใช้ที่สามารถดำเนินงาน ANALYZE บนเพจนั้นๆ ได้
• สิทธิ์การอนุญาตต่อไปนี้ผ่านการเข้าสู่ระบบด้วย Facebook

  • pages_messaging
  • pages_read_engagement
  • pages_show_list
  • read_insights
• สิทธิ์การเข้าถึงระดับสูง

ข้อจำกัด

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

อ่านเกณฑ์ชี้วัดของข้อมูลเชิงลึก

หากต้องการอ่านข้อมูลสำหรับเกณฑ์ชี้วัดตั้งแต่ 1 รายการขึ้นไป ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /PAGE-ID/insights โดยตั้งค่าพารามิเตอร์ metric เป็นรายการเกณฑ์ชี้วัดที่คุณต้องการดูซึ่งคั่นด้วยเครื่องหมายจุลภาค

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

curl -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights
    ?metric=page_messages_new_conversations_unique,page_messages_blocked_conversations_unique 
    &access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้

{ 
  "data": [ 
    { 
      "name": "page_messages_new_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "42", 
          "end_time": "1665175977" 
        }, 
      ]
    },
    { 
      "name": "page_messages_blocked_conversations_unique", 
      "period": "day", 
      "values": [ 
        { 
          "value": "0", 
          "end_time": "1665175977" 
        }, 
      ]
    } 
  ],
}

ตัวอย่างคำขอ Total Over Range

ตัวอย่างต่อไปนี้จะค้นหาจำนวนรวมของการสนทนาใหม่ที่ไม่ซ้ำกันในช่วงระยะเวลาหนึ่ง โดยใส่พารามิเตอร์ period ซึ่งตั้งค่าเป็น total_over_range โดยมีการกำหนดช่วงเวลาด้วยพารามิเตอร์ since และ until ในการเรียกใช้ API ของเรา

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=page_messages_new_conversations_unique
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้พร้อมจำนวนของการสนทนาใหม่ที่ไม่ซ้ำกัน และเวลาสิ้นสุดของช่วงเวลานั้นดังนี้

{
  "data": [
    {
      "name": "page_messages_new_conversations_unique",
      "period": "total_over_range",
      "values": [
        {
          "value": 27
          "end_time": "1665175977"
        }
      ],
    }
  ]
}

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

ตัวอย่างต่อไปนี้ค้นหาจำนวนรวมของโทเค็นข้อความทางการตลาดในช่วงระยะเวลาหนึ่ง และจัดกลุ่มตามหัวข้อและความถี่

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/insights/
    ?metric=recurring_notifications_tokens   
    &since=UNIX-TIMESTAMP-START
    &until=UNIX-TIMESTAMP-STOP
    &period=total_over_range
    &breakdown=recurring_notifications_topic,recurring_notifications_frequency 
    &access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้ โดยมีการจัดกลุ่มโทเค็นตามหัวข้อ ได้แก่ "newproducts" และ "10percentsale" ส่วนความถี่ของข้อความที่เปิดให้แต่ละหัวข้อใช้งานได้ ได้แก่ "daily" "weekly" และ "monthly" สำหรับ "newproducts" และ "daily" และ "weekly" สำหรับ "10percentsale"

{
  "data": [
    {
      "name": "recurring_notifications_tokens",
      "period": "total_over_range",
      "values": [ 
        {
          "value": 3,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 15,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "weekly"
        },
        {
          "value": 8,
          "end_time": "1665175977",
          "recurring_notifications_topic": "newproducts",
          "recurring_notifications_frequency": "monthly"
        },
        {
          "value": 17,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "daily"
        },
        {
          "value": 14,
          "end_time": "1665175977",
          "recurring_notifications_topic": "10percentsale",
          "recurring_notifications_frequency": "weekly"
        },
      ]
    }
  ]
}

พารามิเตอร์ข้อมูลเชิงลึก

เกณฑ์ชี้วัดที่พร้อมใช้งาน

เกณฑ์ชี้วัดต่อไปนี้สามารถใช้งานได้ผ่าน API ข้อมูลเชิงลึกของการส่งข้อความ

เรียนรู้เพิ่มเติมเกี่ยวกับเกณฑ์ชี้วัดที่อยู่ระหว่างการพัฒนา

คุณสมบัติการตอบกลับ

ระบบอาจส่งคืนข้อมูลต่อไปนี้ในการเรียกใช้ไปยัง API ข้อมูลเชิงลึก

ดูเพิ่มเติม

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