Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.

Englisch aktualisiert: 3. März
Deutsch aktualisiert: 28.07.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

Eigenschaft	Beschreibung
`marketing_messages_cost_per_delivered`	Die durchschnittlichen Kosten pro zugestellter Nachricht. Diese Kennzahl ist in Entwicklung.
`marketing_messages_cost_per_link_btn_click`	Die Durchschnittskosten pro Link-Klick in Nachrichten. Diese Kennzahl umfasst keine Nachrichten, die an Empfänger*innen in Europa, Argentinien, der Türkei, Südkorea und Japan gesendet wurden. Diese Kennzahl ist in Entwicklung.
`marketing_messages_delivered`	Die Anzahl der zugestellten Nachrichten, die ein Unternehmen an Nutzerinnen gesendet hat. Einige Nachrichten werden möglicherweise nicht zugestellt, z. B. wenn das Gerät desder Empfänger*in keinen Empfang hat. Diese Kennzahl umfasst keine Nachrichten, die in Europa und Japan zugestellt werden. In manchen Fällen kann diese Kennzahl ein Schätzwert sein und aufgrund geringfügiger Schwankungen bei der Datenverarbeitung von den Angaben auf deiner Rechnung abweichen. Diese Kennzahl ist in Entwicklung.
`marketing_messages_link_btn_click`	Die Anzahl der Interaktionen (Klicken, Tippen) innerhalb der Marketing-Nachricht, die zu vom Werbetreibenden festgelegten Destinationen auf oder außerhalb von Meta-Technologien geführt haben. Diese Kennzahl umfasst keine Nachrichten, die an Empfänger*innen in Europa, Argentinien, der Türkei, Südkorea und Japan gesendet wurden. Diese Kennzahl ist in Entwicklung.
`marketing_messages_link_btn_click_rate`	Der prozentuale Anteil der zugestellten Nachrichten, die einen Link-Klick erhalten haben, an der Gesamtzahl der zugestellten Nachrichten. Diese Kennzahl umfasst keine Nachrichten, die an Empfänger*innen in Europa, Argentinien, der Türkei, Südkorea und Japan gesendet wurden. Diese Kennzahl ist in Entwicklung.
`marketing_messages_read_rate`	Die Anzahl der gelesenen Nachrichten geteilt durch die Anzahl der zugestellten Nachrichten. Manche gelesenen Nachrichten werden möglicherweise nicht erfasst, etwa wenn derdie Kundin Lesebestätigungen deaktiviert hat. Diese Kennzahl umfasst keine Nachrichten, die an Empfänger*innen in Europa und Japan gesendet wurden. Diese Kennzahl ist in Entwicklung.
`marketing_messages_spend`	Der Gesamtbetrag, den du für deine Kampagne, Anzeigengruppe oder Nachricht während ihrer Laufzeit ausgegeben hast. Diese Kennzahl ist in Entwicklung.

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.