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

Properti	Deskripsi
`marketing_messages_cost_per_delivered`	Rata-rata biaya per pesan yang diterima. Metrik ini sedang dalam pengembangan.
`marketing_messages_cost_per_link_btn_click`	Biaya rata-rata untuk setiap klik tautan pesan. Metrik ini tidak termasuk pesan yang dikirim ke Eropa, Argentina, Turki, Korea Selatan, dan Jepang. Metrik ini sedang dalam pengembangan.
`marketing_messages_delivered`	Jumlah pesan yang dikirim bisnis dan diterima pengguna. Beberapa pesan mungkin tidak diterima, seperti ketika perangkat pengguna rusak. Metrik ini tidak termasuk pesan yang dikirim ke Eropa dan Jepang. Dalam beberapa kasus, metrik ini mungkin berupa estimasi dan berbeda dari yang ditampilkan di invoice Anda karena ada sedikit variasi dalam pemrosesan data. Metrik ini sedang dalam pengembangan.
`marketing_messages_link_btn_click`	Jumlah klik atau ketukan pada pesan marketing yang mengarahkan ke destinasi pilihan pengiklan, baik di dalam atau di luar teknologi Meta. Metrik ini tidak termasuk pesan yang dikirim ke Eropa, Argentina, Turki, Korea Selatan, dan Jepang. Metrik ini sedang dalam pengembangan.
`marketing_messages_link_btn_click_rate`	Persentase pesan diterima yang mendapatkan klik tautan dibandingkan jumlah total pesan yang diterima. Metrik ini tidak termasuk pesan yang dikirim ke Eropa, Argentina, Turki, Korea Selatan, dan Jepang. Metrik ini sedang dalam pengembangan.
`marketing_messages_read_rate`	Jumlah pesan yang dibaca dibagi dengan jumlah pesan yang diterima. Beberapa pesan yang dibaca mungkin tidak tercatat, seperti jika pelanggan menonaktifkan laporan dibaca. Metrik ini tidak termasuk pesan yang dikirim ke Eropa dan Jepang. Metrik ini sedang dalam pengembangan.
`marketing_messages_spend`	Jumlah total uang yang sudah Anda keluarkan untuk kampanye, set iklan, atau pesan selama jadwal penayangannya. Metrik ini sedang dalam pengembangan.

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.