Tài liệu tham khảo về API Thông tin chi tiết nhắn tin

Với API Thông tin chi tiết nhắn tin, bạn có thể truy xuất theo lập trình các thông tin giống như hiển thị trong tab Thông tin chi tiết Trang của Trang Facebook.

Để biết thêm thông tin về API Thông tin chi tiết nhắn tin và các dịch vụ phân tích khác có sẵn trên Nền tảng Messenger, hãy xem phần Phân tích.

Để biết thêm thông tin về API Thông tin chi tiết Trang, bao gồm thông tin về số liệu khác có sẵn và các quyền cần thiết, vui lòng xem Tài liệu về Thông tin chi tiết Trang hoặc Tài liệu tham khảo về đối tượng Thông tin chi tiết.

Quyền

Bạn cần có mã truy cập trang có quyền read_insights thì mới tương tác được với điểm cuối này.

Yêu cầu mẫu

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

Phản hồi mẫu

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

Thông số

Thông số	Mô tả
`breakdowns`	Kích thước nhóm phản hồi. Có thể là `messaging_channel` (Messenger hoặc Instagram), `recurring_notification_topic`, `recurring_notifications_freuency`
`date_preset`	Khoảng ngày tương đối có thể dùng thay cho `since` và `until`. Có thể là `last_week`, `last_month`, `last_quarter`, v.v.
`metric`	Danh sách số liệu sẽ trả về, được phân tách bằng dấu phẩy
`period`	Khoảng thời gian tổng hợp được cung cấp trong khoảng since/until hoặc date_preset. Giá trị `total_over_range` cung cấp một giá trị duy nhất cho số liệu trong khoảng ngày cụ thể. Có thể là `day`, `week`, `month`, `days_28`, `total_over_range`
`since`	Nhãn thời gian UNIX của thời gian bắt đầu quá trình lấy số liệu về
`until`	Nhãn thời gian UNIX của thời gian kết thúc quá trình lấy số liệu về

Số liệu có sẵn

Bạn có thể lấy các số liệu sau qua API Thông tin chi tiết nhắn tin:

Tên `metric`	Mô tả
`recurring_notification_tokens`	Số lần một tài khoản đã đăng ký nhận tin nhắn marketing của doanh nghiệp bạn. Nếu đăng ký nhiều chủ đề, tài khoản đó sẽ được tính một lần nữa cho từng chủ đề. Cách tính: Số liệu này được tính bằng cách lấy số lần tài khoản đồng ý nhận tin nhắn định kỳ trừ đi số lần tài khoản hủy đăng ký. Giá trị có thể sử dụng cho `breakdowns`: `messaging_channel` `recurring_notifications_frequency` `recurring_notifications_topic` Số liệu này đang phát triển.
`page_messages_engagement`	Số lần người dùng tương tác với tin nhắn trên Trang kinh doanh của bạn, bằng cách nhấn vào nút kêu gọi hành động. Số liệu này chỉ bao gồm dữ liệu từ Tin nhắn marketing. Giá trị có thể sử dụng cho `breakdowns`: `messaging_channel` `recurring_notifications_topic` Số liệu này đang phát triển.
`page_messages_sent`	Số tin nhắn Trang kinh doanh của bạn đã gửi cho một khách hàng. Số liệu này chỉ bao gồm dữ liệu từ Tin nhắn marketing. Giá trị có thể sử dụng cho `breakdowns`: `messaging_channel` `recurring_notifications_topic` Số liệu này đang phát triển.
`page_messages_read_ratio`	Số tin nhắn đã đọc chia cho số tin nhắn Trang của bạn đã gửi. Một số lượt đọc tin nhắn có thể không được ghi lại, chẳng hạn như khi khách hàng tắt thông báo đã đọc. Số liệu này chỉ bao gồm dữ liệu từ Tin nhắn marketing. Giá trị có thể sử dụng cho `breakdowns`: `messaging_channel` `recurring_notifications_topic` Số liệu này đang phát triển.
`page_messages_order_count`	Số lần bạn tạo đơn đặt hàng trong cuộc trò chuyện qua tin nhắn hoặc trong ứng dụng/trang web bên thứ ba dùng để quản lý cuộc trò chuyện qua tin nhắn. Số liệu này đang phát triển.
`page_messages_paid_order_earnings`	Số tiền ước tính bạn kiếm được từ đơn đặt hàng đã tạo trong cuộc trò chuyện qua tin nhắn hoặc ứng dụng/trang web bên thứ ba dùng để quản lý cuộc trò chuyện qua tin nhắn. Thu nhập cuối cùng có thể chênh lệch do quy đổi tiền tệ. Số liệu này đang phát triển.
`page_messages_with_business_outcomes`	Số người kết nối qua tin nhắn đã tạo ít nhất một đơn đặt hàng. Số liệu này đang phát triển.
`page_messages_blocked_conversations_unique`	Số cuộc trò chuyện với Trang đã bị chặn.
`page_messages_new_conversations_unique`	Số cuộc trò chuyện qua tin nhắn trên Messenger bắt đầu với người trước đây chưa từng nhắn tin với doanh nghiệp bạn.
`page_messages_reported_conversations_unique`	Số cuộc trò chuyện từ Trang đã bị mọi người báo cáo vì các lý do như spam hoặc chứa nội dung không phù hợp.
`page_messages_total_messaging_connections`	Số người doanh nghiệp của bạn có thể gửi tin nhắn. Số liệu này thể hiện số người đã từng gửi tin nhắn cho doanh nghiệp của bạn trên Messenger, ngoại trừ những người đã chặn hoặc báo cáo doanh nghiệp của bạn trên Messenger. Có thể có một số hạn chế về khả năng gửi tin nhắn đến các quan hệ kết nối của bạn, chẳng hạn như giới hạn số lượng tin nhắn bạn có thể gửi trong những khung thời gian nhất định. Số liệu này cũng chỉ bao gồm các quan hệ kết nối được thiết lập từ tháng 10/2016, khi dữ liệu có sẵn.

Thuộc tính phản hồi

Thuộc tính	Mô tả
`data` mảng đối tượng	Danh sách các đối tượng của số liệu
`name` chuỗi	Tên số liệu
`period` chuỗi	Khoảng thời gian thu thập dữ liệu
`values` mảng đối tượng	Danh sách dữ liệu cho một số liệu
`value` mảng đối tượng	Số lượng của số liệu được yêu cầu mỗi ngày. Đối với số liệu chia nhỏ theo loại, hệ thống sẽ trả về một đối tượng chứa số lượng của từng loại.
`end_time` nhãn thời gian unix	Nhãn thời gian UTC của thời gian kết thúc lấy số liệu.

Xem thêm

Để biết thêm thông tin về cách sử dụng API Thông tin chi tiết nhắn tin, hãy truy cập vào hướng dẫn Cách sử dụng API Thông tin chi tiết nhắn tin.