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.