Đo lường hiệu quả của chiến dịch bằng API Tin nhắn marketing dành cho Messenger

Tài liệu này giải thích cách lấy thông tin chi tiết về chiến dịch tin nhắn marketing, bao gồm cả:

Số lượng tin nhắn đã đến
Tỷ lệ đọc và click vào tin nhắn
Chi phí trên mỗi lượt phân phối và lượt click

Thông tin chi tiết về tin nhắn đã đến

Gửi yêu cầu GET đến điểm cuối <MESSAGE_CAMPAIGN_ID>/insights để lấy thông tin chi tiết về chiến dịch tin nhắn marketing với thông số fields được đặt thành một hoặc nhiều trường sau:

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

Yêu cầu mẫu

Được định dạng để dễ đọc.

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"

Tài liệu tham khảo về trường

Thuộc tính	Mô tả
`marketing_messages_cost_per_delivered`	Chi phí trung bình trên mỗi tin nhắn đã gửi. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_cost_per_link_btn_click`	Chi phí trung bình cho mỗi lượt click vào liên kết tin nhắn. Số liệu này không bao gồm các tin nhắn được gửi đến Châu Âu, Argentina, Thổ Nhĩ Kỳ, Hàn Quốc và Nhật Bản. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_delivered`	Số lượng tin nhắn mà doanh nghiệp đã gửi đến người dùng thành công. Một số tin nhắn có thể không gửi đi được, chẳng hạn như khi thiết bị của khách hàng không hoạt động. Số liệu này không bao gồm các tin nhắn được gửi đến Châu Âu và Nhật Bản. Trong một số trường hợp, số liệu này chỉ mang tính ước lượng và có thể khác với thông tin hiển thị trên hóa đơn do có những khác biệt nhỏ trong quá trình xử lý dữ liệu. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_link_btn_click`	Số lượt click hoặc nhấn trong tin nhắn marketing dẫn tới đích đến do nhà quảng cáo chỉ định, trên hoặc bên ngoài Facebook. Số liệu này không bao gồm các tin nhắn được gửi đến Châu Âu, Argentina, Thổ Nhĩ Kỳ, Hàn Quốc và Nhật Bản. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_link_btn_click_rate`	Phần trăm tin nhắn đã gửi có lượt click vào liên kết trên tổng số tin nhắn đã gửi. Số liệu này không bao gồm các tin nhắn được gửi đến Châu Âu, Argentina, Thổ Nhĩ Kỳ, Hàn Quốc và Nhật Bản. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_read_rate`	Số tin nhắn đã đọc chia cho số tin nhắ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 không bao gồm các tin nhắn được gửi đến Châu Âu và Nhật Bản. Số liệu này vẫn đang trong quá trình phát triển.
`marketing_messages_spend`	Tổng số tiền bạn đã chi tiêu cho chiến dịch, nhóm quảng cáo hoặc tin nhắn trong suốt thời gian chạy. Số liệu này vẫn đang trong quá trình phát triển.

Nếu thành công, ứng dụng của bạn sẽ nhận được một đối tượng JSON chứa số lượng tin nhắn đã đến, tỷ lệ đọc, ngày bắt đầu và kết thúc của chiến dịch nhắn tin.

Phản hồi mẫu

{
  "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"
    }
  }
}

Ngoài ra, bạn có thể lấy thông tin chi tiết trong tài khoản quảng cáo bằng điểm cuối act_<AD_ACCOUNT_ID>/insights

Bạn cũng có thể truy vấn vào khoảng thời gian và ngày đặt sẵn cho các chiến dịch được tạo từ ngày 01/03 trở đi. Dưới đây là các lựa chọn thông số truy vấn mà bạn có thể dùng để truy vấn vào những ngày cụ thể:

Tên thông số Mô tả

Tên thông số	Mô tả
`time_range` {'since':YYYY-MM-DD,'until':YYYY-MM-DD}	Một đối tượng `time range` duy nhất. Không hỗ trợ mốc thời gian UNIX.
`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}	Giá trị mặc định: `last_30d` Biểu thị một khoảng thời gian tương đối. Trường này sẽ bị bỏ qua nếu bạn chỉ định time_range.

time_range

{'since':YYYY-MM-DD,'until':YYYY-MM-DD}

Một đối tượng time range duy nhất. Không hỗ trợ mốc thời gian UNIX.

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}

Giá trị mặc định: last_30d

Biểu thị một khoảng thời gian tương đối. Trường này sẽ bị bỏ qua nếu bạn chỉ định time_range.

Bước tiếp theo

Giờ bạn đã biết cách lấy thông tin chi tiết về chiến dịch của mình, hãy tìm hiểu cách tăng số lượng người đăng ký cho doanh nghiệp.