Messengerプラットフォーム
日本語に戻す
このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。
英語の最終更新: 3月3日
日本語の最終更新: 2025/07/29

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

配信されたメッセージ1通ごとの平均コスト。この指標は開発中です。

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 NameDescription

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.