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

Measure Campaign Performance on Marketing Message API for Messenger

This document explains how to obtain insights for a marketing message campaign, including:

  • Number of messages delivered
  • Message read and click rate
  • Cost per delivery and click

Insights on delivered messages

Send a GET request to the <MESSAGE_CAMPAIGN_ID>/insights endpoint to get insights for marketing messages campaign with the fields parameter set to one or more of the following fields:

  • marketing_messages_cost_per_delivered
  • marketing_messages_cost_per_link_btn_click
  • marketing_messages_delivered
  • marketing_messages_link_btn_click
  • marketing_messages_link_btn_click_rate
  • marketing_messages_read_rate
  • marketing_messages_spend

Sample request

Formatted for readability.

curl -i -X GET \
     -H "Authorization: Bearer <SYSTEM_USER_ACCESS_TOKEN>" \
     "https://graph.facebook.com/<API_VERSION>/<MESSAGE_CAMPAIGN_ID>/insights \
       ?fields=marketing_messages_delivered,marketing_messages_read_rate"

Field Reference

คุณสมบัติ คำอธิบาย

marketing_messages_cost_per_delivered

ต้นทุนเฉลี่ยต่อข้อความที่ส่ง เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

marketing_messages_cost_per_link_btn_click

ต้นทุนเฉลี่ยต่อการคลิกลิงก์ข้อความแต่ละครั้ง เกณฑ์ชี้วัดนี้ไม่รวมข้อความที่ส่งถึงผู้รับในยุโรป อาร์เจนตินา ตุรกี เกาหลีใต้ และญี่ปุ่น เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

marketing_messages_delivered

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

marketing_messages_link_btn_click

จำนวนการคลิกหรือการแตะภายในข้อความทางการตลาดที่พาไปยังปลายทางที่ผู้ลงโฆษณากำหนดไว้ ทั้งในและนอกเทคโนโลยีในเครือ Meta เกณฑ์ชี้วัดนี้ไม่รวมข้อความที่ส่งถึงผู้รับในยุโรป อาร์เจนตินา ตุรกี เกาหลีใต้ และญี่ปุ่น เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

marketing_messages_link_btn_click_rate

เปอร์เซ็นต์ของข้อความที่ส่งซึ่งได้รับการคลิกลิงก์จากจำนวนทั้งหมดของข้อความที่ส่ง เกณฑ์ชี้วัดนี้ไม่รวมข้อความที่ส่งถึงผู้รับในยุโรป อาร์เจนตินา ตุรกี เกาหลีใต้ และญี่ปุ่น เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

marketing_messages_read_rate

จำนวนข้อความที่อ่านแล้วหารด้วยจำนวนข้อความที่ส่งถึงผู้รับ บางข้อความที่ถูกอ่านแล้วอาจไม่ถูกบันทึก เช่นในกรณีที่ลูกค้าปิดใช้งานการแจ้งการเปิดอ่านเอาไว้ เกณฑ์ชี้วัดนี้ไม่รวมข้อความที่ส่งไปยังผู้รับในยุโรปและญี่ปุ่น เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

marketing_messages_spend

จำนวนเงินทั้งหมดที่คุณใช้จ่ายไปกับแคมเปญ ชุดโฆษณา หรือข้อความของคุณระหว่างช่วงการกำหนดเวลา เกณฑ์ชี้วัดดังกล่าวอยู่ระหว่างการพัฒนา

On success, your app receives a JSON object with the number of messages delivered, the read rate, and the start and stop date of the messaging campaign.

Example response

{
  "data": [
    {
      "marketing_messages_delivered": "2755",
      "marketing_messages_link_btn_click": "268",
      "marketing_messages_spend": "38.87",
      "marketing_messages_read_rate": "79.419238",
      "marketing_messages_link_btn_click_rate": "9.727768",
      "marketing_messages_cost_per_link_btn_click": "0.145037",
      "marketing_messages_delivery_rate": "0",
      "marketing_messages_cost_per_delivered": "0.014109",
      "date_start": "2024-05-01",
      "date_stop": "2025-07-29"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD"
    }
  }
}

Additionally, insights under an ad account can be obtained by act_<AD_ACCOUNT_ID>/insights endpoint

Querying on time ranges and date presets is also supported for campaigns created March 1st or later. Below are query parameter options you can use to query on specific dates:

Parameter NameDescription

time_range

{'since':YYYY-MM-DD,'until':YYYY-MM-DD}

A single time range object. UNIX timestamp not supported.

date_preset

enum{today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year}

Default value: last_30d

Represents a relative time range. This field is ignored if time_range is specified.

Next Steps

Now that you have learned how to get insights on your campaign, learn how to increase a business' subscribers.