Messenger 플랫폼
한국어 버전으로 돌아가기
문서가 업데이트되었습니다.
한국어로 번역이 아직 완료되지 않았습니다.
영어 업데이트됨: 3월 3일
한국어 업데이트됨: 2월 1일

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 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.