Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 3 mar.
Actualización del documento en Español (España): 28 jul. 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

Propiedad	Descripción
`marketing_messages_cost_per_delivered`	Coste medio por mensaje entregado. Esta métrica se encuentra en desarrollo.
`marketing_messages_cost_per_link_btn_click`	Coste medio por cada clic en el enlace del mensaje. Esta métrica no incluye los mensajes enviados a Europa, Argentina, Turquía, Corea del Sur y Japón. Esta métrica se encuentra en desarrollo.
`marketing_messages_delivered`	Número de mensajes que una empresa ha enviado a los usuarios y que fueron entregados. Algunos mensajes no pueden entregarse, por ejemplo, cuando el dispositivo de un usuario está fuera de servicio. Esta métrica no incluye los mensajes entregados en Europa y Japón. En algunos casos, esta métrica puede ser estimada y puede diferir de lo que aparece en la factura debido a pequeñas variaciones en el procesamiento de los datos. Esta métrica se encuentra en desarrollo.
`marketing_messages_link_btn_click`	Número de clics o toques dentro del mensaje de marketing que han llevado a destinos especificados por el anunciante, dentro o fuera de las tecnologías de Meta. Esta métrica no incluye los mensajes enviados a Europa, Argentina, Turquía, Corea del Sur y Japón. Esta métrica se encuentra en desarrollo.
`marketing_messages_link_btn_click_rate`	Tasa de mensajes entregados que han obtenido un clic en el enlace del total de mensajes entregados. Esta métrica no incluye los mensajes enviados a Europa, Argentina, Turquía, Corea del Sur y Japón. Esta métrica se encuentra en desarrollo.
`marketing_messages_read_rate`	Número de mensajes leídos dividido entre el número de mensajes entregados. Puede que algunos mensajes leídos no figuren, por ejemplo, si un cliente ha desactivado las confirmaciones de lectura. Esta métrica no incluye los mensajes enviados a Europa y Japón. Esta métrica se encuentra en desarrollo.
`marketing_messages_spend`	Cantidad total de dinero que has gastado en tu campaña, conjunto o mensaje durante su programación. Esta métrica se encuentra en desarrollo.

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.