تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.

تاريخ تحديث المصدر باللغة الإنجليزية: ‏٣ مارس‏
تاريخ تحديث اللغة ‏العربية‏: ‏٠٤‏/٠٨‏/٢٠٢٥‏

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.