Ghi sự kiện bằng API Sự kiện dành cho tính năng Nhắn tin cho doanh nghiệp

Hướng dẫn này mô tả cách bạn có thể ghi sự kiện trong ứng dụng và sự kiện trên Trang Facebook để phân tích xem người dùng tương tác với trải nghiệm Messenger của họ như thế nào.

Trước khi bạn bắt đầu

Bạn sẽ cần có:

• Quyền page_events

  • Quyền truy cập nâng cao sẽ tự động được cấp cho quyền này khi bạn gửi đi Xét duyệt ứng dụng nếu ứng dụng đó đã được cấp Quyền truy cập nâng cao cho quyền pages_messaging và ứng dụng không có bất kỳ lỗi vi phạm chính sách nào trong 90 ngày qua
• Mã truy cập Trang do một người có thể thực hiện tác vụ ANALYZE trên Trang đang được truy vấn yêu cầu

Giới hạn

Hiện tại, doanh nghiệp hoặc khách hàng tại châu Âu hoặc Nhật Bản chưa sử dụng được API này.

Chính sách và điều khoản

• Điều khoản về Công cụ kinh doanh trên Facebook
• Chính sách về Trang, Nhóm và Sự kiện

Ghi sự kiện

Bạn có thể ghi sự kiện bằng cách gửi yêu cầu POST đến cạnh page_activities của một ứng dụng:

https://graph.facebook.com/

Yêu cầu mẫu:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Bảng dưới đây mô tả các thuộc tính và giá trị bạn phải cung cấp cho điểm cuối để ghi sự kiện trên Messenger:

Báo cáo khách hàng tiềm năng bằng API Sự kiện nhắn tin

Các ứng dụng hiện có thể bắt đầu báo cáo lượt gửi khách hàng tiềm năng trên chuỗi trò chuyện. Thông qua sự kiện lead_submitted, các ứng dụng có thể tự động báo cáo những chuỗi trò chuyện được xem là khách hàng tiềm năng (ví dụ: người dùng chia sẻ thông tin liên hệ và yêu cầu liên hệ về việc bán hàng).

Sự kiện này thích hợp nhất khi dùng để phân biệt người dùng cụ thể là khách hàng tiềm năng, từ đó doanh nghiệp có thể ưu tiên chuỗi trò chuyện từ họ. Ví dụ: doanh nghiệp có thể thiết lập một quy trình tự động sàng lọc người dùng là khách hàng tiềm năng, sau đó kích hoạt sự kiện này khi người dùng hoàn tất quy trình đó để gắn cờ cho nhân viên biết chuỗi trò chuyện này có tiềm năng cao.

Tính năng này hiện ở phiên bản beta mở và tính năng báo cáo trong Trình quản lý quảng cáo đã được tích hợp. Vì vậy, dữ liệu khách hàng tiềm năng sẽ được báo cáo trên giao diện người dùng của Trình quản lý quảng cáo.

Lệnh gọi API mẫu để báo cáo sự kiện khách hàng tiềm năng xảy ra trên một chuỗi trò chuyện:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Báo cáo khách hàng tiềm năng bằng API Thông tin chi tiết về quảng cáo

Bạn có thể xem sự kiện khách hàng tiềm năng được báo cáo thông qua API Thông tin chi tiết về quảng cáo. Bạn có thể dùng API này để tạo một bảng điều khiển phân tích nâng cao nhằm trực quan hóa dữ liệu khách hàng tiềm năng được ghi nhận cho các chiến dịch CTX.

Điều kiện tiên quyết

Trước khi sử dụng API này, hãy đảm bảo rằng ứng dụng đã thực hiện quy trình xét duyệt ứng dụng cho quyền ads_read và có quyền truy cập nâng cao.

Thực thi

Lệnh gọi thông tin chi tiết mẫu ở cấp độ chiến dịch quảng cáo sẽ có dạng như sau:

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
    

Bạn có thể gọi API Thông tin chi tiết ở cấp độ tài khoản quảng cáo, chiến dịch và nhóm quảng cáo, tùy theo mức độ chi tiết mong muốn.

Dưới đây là lệnh gọi để lấy dữ liệu khách hàng tiềm năng:

• Khách hàng tiềm năng (được ghi nhận)

  • /<OBJECT_ID>/insights?fields=actions
  • Trong kết quả, action_type=onsite_converstion.lead_grouped

Để biết định nghĩa chi tiết về các loại hành động ở trên, hãy xem tài liệu tham khảo về Số liệu thống kê hành động cho quảng cáo.

Cách tốt nhất để phân loại khách hàng tiềm năng

1. Nhà quảng cáo là một trong những ngành dọc tìm kiếm khách hàng tiềm năng cũ (ô tô, dịch vụ chuyên nghiệp, dịch vụ tài chính, B2B, giáo dục, sức khỏe).
2. Nhà quảng cáo yêu cầu thông tin liên hệ như số điện thoại hoặc địa chỉ email và người dùng cung cấp thông tin đó.
3. Trước câu hỏi về số điện thoại hoặc địa chỉ email là một số câu hỏi sàng lọc (ví dụ: 1-2 câu hỏi bổ sung).
4. Nếu bạn cung cấp mẫu tìm kiếm khách hàng tiềm năng trong ứng dụng của mình, hãy thêm tín hiệu này ở cuối quy trình tìm kiếm khách hàng tiềm năng theo mặc định.

Xác minh hoạt động ghi sự kiện

Nếu là quản trị viên Ứng dụng hoặc Trang, bạn có thể xác thực rằng cách thiết lập của mình chính xác thông qua việc tìm kiếm sự kiện trong Trình quản lý quảng cáo.

Những cân nhắc đặc biệt về dữ liệu phân tích cho Messenger

• Một Ứng dụng có thể ghi hoạt động tương tác cho nhiều Trang. Trong trường hợp này, những sự kiện từ hoạt động tương tác với tất cả các Trang đều hiển thị trong cùng một Ứng dụng.
• Một Trang có thể liên kết với nhiều Ứng dụng. Trong trường hợp này, khi Trang bị chặn, mọi Ứng dụng được liên kết với Trang đó đều sẽ nhận được sự kiện fb_messenger_bot_stopped.
• Số Lượt xóa cuộc trò chuyện với bot Messenger có thể cao hơn số Hoạt động của người dùng mới. Lượt xóa cuộc trò chuyện với bot Messenger là số lần người dùng xóa một chuỗi trò chuyện. Trang có thể bắt đầu cuộc trò chuyện khác sau khi người dùng xóa chuỗi trò chuyện. Người dùng có thể xóa những chuỗi trò chuyện khác này, từ đó khiến số Lượt xóa cuộc trò chuyện với bot Messenger tăng lên.

Cách sử dụng dành cho nhà cung cấp nền tảng

Mục tiêu ghi

Những nền tảng cho phép mọi người xây dựng trải nghiệm Messenger thông qua giao diện trực quan thường dùng một ứng dụng trung tâm để hỗ trợ tất cả các trang được kết nối của nền tảng đó. Nếu muốn cho phép khách hàng xem sự kiện của chính họ, bạn phải ghi những sự kiện đó vào Trang của khách hàng bằng cách đặt logging_target là page hoặc app_and_page.

Giao diện người dùng

Nếu ứng dụng là một công cụ chỉnh sửa hình ảnh, bạn có thể cung cấp khối kéo được để mọi người có thể chọn sự kiện và xác định thông số bổ sung. Nhờ đó, quản trị viên Trang có thể đưa ra quy trình Messenger cùng với sự kiện phù hợp. Lý tưởng là người dùng nên có khả năng chọn tên sự kiện tiêu chuẩn từ một danh sách thả xuống, bởi vì hệ thống sẽ chỉ báo cáo sự kiện tiêu chuẩn trong Trình quản lý quảng cáo cũng như cung cấp các sự kiện này để nhắm mục tiêu và tối ưu hóa quảng cáo (nếu có). Nếu không có tên sự kiện tiêu chuẩn nào khớp với hành động của người dùng, đồng thời không cần báo cáo quảng cáo thì bạn nên cung cấp một trường dạng tự do để người dùng có thể nhập tên và thông số sự kiện tùy chỉnh.

Quyền

Bạn cần có quyền page_events bắt buộc trong quy trình Đăng nhập bằng Facebook cho ứng dụng của mình. Bạn phải thêm quyền đó vào phạm vi quyền được yêu cầu của Nút Đăng nhập, lệnh gọi Facebook SDK dành cho JavaScript hoặc quy trình đăng nhập mà bạn xây dựng theo cách thủ công như trình bày trong hướng dẫn này.

Tài nguyên khác

• Hướng dẫn về cách làm tốt nhất cho Sự kiện trong ứng dụng: Đưa ra các đề xuất về sự kiện cần dùng trong nhiều loại ứng dụng khác nhau.