Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.

Anglais mis à jour : 3 mars
Français (France) mis à jour : 28 juil. 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

Propriété	Description
`marketing_messages_cost_per_delivered`	Coût moyen par message distribué. Cet indicateur est en développement.
`marketing_messages_cost_per_link_btn_click`	Coût moyen de chaque clic sur un lien dans un message. Cet indicateur n’inclut pas les messages envoyés vers l’Europe, l’Argentine, la Turquie, la Corée du Sud et le Japon. Cet indicateur est en développement.
`marketing_messages_delivered`	Nombre de messages qu’une entreprise a envoyés aux utilisateur·ices et qui ont été distribués. Il peut arriver que certains messages ne soient pas distribués, par exemple lorsque l’appareil d’un·e utilisateur·ice est hors service. Cet indicateur n’inclut pas les messages distribués en Europe et au Japon. Dans certains cas, cet indicateur peut être estimé et peut différer de ce qui est porté sur votre facture en raison de petites variations dans le traitement des données. Cet indicateur est en développement.
`marketing_messages_link_btn_click`	Nombre de clics ou d’appuis dans le message marketing ayant redirigé vers des destinations précisées par l’annonceur, sur ou en dehors des technologies Meta. Cet indicateur n’inclut pas les messages envoyés vers l’Europe, l’Argentine, la Turquie, la Corée du Sud et le Japon. Cet indicateur est en développement.
`marketing_messages_link_btn_click_rate`	Pourcentage de messages distribués qui ont reçu un clic sur un lien par rapport au nombre total de messages distribués. Cet indicateur n’inclut pas les messages envoyés vers l’Europe, l’Argentine, la Turquie, la Corée du Sud et le Japon. Cet indicateur est en développement.
`marketing_messages_read_rate`	Nombre de messages lus divisé par le nombre de messages distribués. Il peut arriver que certaines lectures de messages ne soient pas comptabilisées, par exemple lorsque les client·es ont désactivé les confirmations de lecture. Cet indicateur n’inclut pas les messages envoyés vers l’Europe et le Japon. Cet indicateur est en développement.
`marketing_messages_spend`	Montant total que vous avez dépensé pour votre campagne, votre ensemble ou votre message pendant toute la durée de sa diffusion. Cet indicateur est en développement.

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.