메시지 인사이트 API 참고 자료

메시지 인사이트 API를 사용하면 Facebook 페이지의 '페이지 인사이트' 탭에 표시되는 것과 동일한 정보를 프로그래밍 방식으로 가져올 수 있습니다.

메시지 인사이트 API와 Messenger 플랫폼에서 사용 가능한 기타 분석 정보에 대한 자세한 내용은 분석을 참조하세요.

사용 가능한 기타 지표와 필수 권한에 대한 정보를 포함하여 페이지 인사이트 API에 대한 자세한 내용은 페이지 인사이트 문서나 인사이트 개체 참고 자료를 참조하세요.

권한

이 엔드포인트와 상호작용하려면 read_insights 권한이 있는 페이지 액세스 토큰이 필요합니다.

요청 예시

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=

응답 예시

{ 
  "data": [ 
    { 
      "name": "

매개변수

매개변수	설명
`breakdowns`	응답이 그룹화되는 차원입니다. `messaging_channel`(Messenger 또는 Instagram), `recurring_notification_topic`, `recurring_notifications_freuency`일 수 있습니다.
`date_preset`	`since` 및 `until`을 대신하여 사용할 수 있는 상대적 날짜 범위입니다. `last_week`, `last_month`, `last_quarter`, 그 밖의 값일 수 있습니다.
`metric`	반환할 지표를 쉼표로 구분한 리스트입니다.
`period`	since/until 또는 date_preset 범위 내에 제공된 집계 값입니다. `total_over_range` 값은 지정된 기간 동안 지표에 대한 단일 값을 제공합니다. `day`, `week`, `month`, `days_28`, `total_over_range`일 수 있습니다.
`since`	지표를 가져올 시작 시간의 UNIX 타임스탬프입니다.
`until`	지표를 가져올 종료 시간의 UNIX 타임스탬프입니다.

사용 가능한 지표

메시지 인사이트 API를 통해 다음과 같은 지표를 사용할 수 있습니다.

`metric` 이름	설명
`recurring_notification_tokens`	계정이 비즈니스로부터 마케팅 메시지를 받기 위해 구독한 횟수입니다. 계정이 여러 주제를 구독한 경우 각 주제에 대해 다시 집계됩니다. 계산 방법: 이 지표는 계정이 정기 메시지 수신에 동의한 횟수에서 계정이 구독 취소한 횟수를 뺀 횟수를 집계합니다. 가능한 `breakdowns` 값: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` 이 지표는 개발 중입니다.
`page_messages_engagement`	사용자가 비즈니스 페이지에서 행동 유도 버튼을 눌러서 메시지에 반응을 보인 횟수입니다. 이 지표에는 마케팅 메시지의 데이터만 포함됩니다. 가능한 `breakdowns` 값: `messaging_channel` `recurring_notifications_topic` 이 지표는 개발 중입니다.
`page_messages_sent`	비즈니스 페이지가 고객에게 보낸 메시지의 수입니다. 이 지표에는 마케팅 메시지의 데이터만 포함됩니다. 가능한 `breakdowns` 값: `messaging_channel` `recurring_notifications_topic` 이 지표는 개발 중입니다.
`page_messages_read_ratio`	읽은 메시지 수를 페이지에서 보낸 메시지 수로 나눈 값입니다. 경우에 따라 일부 메시지 확인이 파악되지 않을 수 있습니다. 고객이 메시지 확인 여부를 해제한 경우가 여기에 해당합니다. 이 지표에는 마케팅 메시지의 데이터만 포함됩니다. 가능한 `breakdowns` 값: `messaging_channel` `recurring_notifications_topic` 이 지표는 개발 중입니다.
`page_messages_order_count`	메시지 대화 또는 메시지 대화를 관리하는 데 사용된 타사 앱 또는 웹사이트에서 주문을 생성한 횟수입니다. 이 지표는 개발 중입니다.
`page_messages_paid_order_earnings`	메시지 대화 또는 메시지 대화를 관리하는 데 사용된 타사 앱 또는 웹사이트에서 생성된 주문을 통해 얻은 대략적인 수익입니다. 통화 변환으로 인해 최종 수익은 다를 수 있습니다. 이 지표는 개발 중입니다.
`page_messages_with_business_outcomes`	최소 한 건의 주문을 생성한 적이 있는 메시지 상대의 수입니다. 이 지표는 개발 중입니다.
`page_messages_blocked_conversations_unique`	차단된 페이지 대화 수입니다.
`page_messages_new_conversations_unique`	전에 비즈니스와 메시지를 주고받은 적이 없는 사람들과 시작한 Messenger상의 메시지 대화 수입니다.
`page_messages_reported_conversations_unique`	스팸이거나 부적절한 콘텐츠를 포함했다는 등의 이유로 사람들이 신고한 페이지의 대화 수입니다.
`page_messages_total_messaging_connections`	비즈니스가 메시지를 보낼 수 있는 사람의 수입니다. 이 지표는 Messenger에서 비즈니스에 메시지를 보낸 적이 있는 사람의 수를 표시합니다. Messenger에서 비즈니스를 차단하거나 신고한 사람은 여기에 포함되지 않습니다. 연결된 연락처에 메시지를 보내는 기능에 몇 가지 제약이 적용될 수도 있습니다(특정 기간에 보낼 수 있는 메시지 수에 대한 제한 등). 또한 이 지표에는 해당 데이터를 사용할 수 있게 된 2016년 10월 이후에 연결된 연락처만 포함됩니다.

응답 속성

속성	설명
`data` 개체 배열	지표 개체 리스트입니다.
`name` 문자열	지표의 이름입니다.
`period` 문자열	데이터가 수집된 기간입니다.
`values` 개체 배열	지표를 위한 데이터 리스트입니다.
`value` 개체 배열	일일 요청 지표의 수입니다. 유형별로 분석되는 지표의 경우 각 유형의 수를 포함하는 개체가 반환됩니다.
`end_time` unix 타임스탬프	지표에 대한 종료 시간의 UTC 타임스탬프입니다.

기타 참고 자료

메시지 인사이트 API의 사용법에 대한 자세한 내용은 메시지 인사이트 API 사용법 가이드를 참조하세요.