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 Name Description

Parameter Name	Description
`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.

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.