API Chuyển đổi cho hoạt động nhắn tin kinh doanh

Với API Chuyển đổi, nhà quảng cáo có thể gửi cho Meta các sự kiện trên web, sự kiện trong ứng dụng, sự kiện ở cửa hàng thực và sự kiện nhắn tin kinh doanh thông qua một điểm cuối duy nhất thay vì qua nhiều nguồn. Việc hợp nhất này có thể tinh giản nhóm công nghệ của nhà quảng cáo và tạo ra chế độ xem toàn diện hơn trong Trình quản lý sự kiện trên Meta dựa trên các tập dữ liệu.

Tài liệu này hướng dẫn tích hợp sự kiện nhắn tin kinh doanh với API Chuyển đổi. Lợi ích khi sử dụng API Chuyển đổi cho hoạt động nhắn tin kinh doanh bao gồm (nhưng không giới hạn ở):

Xem kết quả trực tiếp trong báo cáo trên Trình quản lý quảng cáo: Nhà quảng cáo có thể dễ dàng nắm được kết quả chiến dịch click để nhắn tin dựa theo những kết quả quan trọng ngay trên các nền tảng của Meta, chẳng hạn như số lượt mua và chi phí trên mỗi lượt mua thay vì số cuộc trò chuyện đã bắt đầu.
Tinh giản quá trình tích hợp dữ liệu: Một API để xử lý và chia sẻ dữ liệu trên nhiều nền tảng nhắn tin (Messenger, WhatsApp) và kênh (trang web, ứng dụng, cửa hàng thực, nhắn tin).
Cải thiện kết quả đo lường cho đối tác: Cho phép phân bổ chiến dịch click để nhắn tin ngay trên bảng điều khiển đối tác thông qua API Thông tin chi tiết về quảng cáo.

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

Tập dữ liệu

Những sự kiện nhắn tin kinh doanh được gửi qua API Chuyển đổi phải được liên kết với một tập dữ liệu.

Tập dữ liệu giúp nhà quảng cáo kết nối và quản lý dữ liệu sự kiện từ các nguồn sự kiện trên web, sự kiện trong ứng dụng, sự kiện tại cửa hàng thực và sự kiện nhắn tin kinh doanh với API Chuyển đổi. Tập dữ liệu có thể hiển thị dữ liệu sự kiện từ bất kỳ tiện ích tích hợp nào trong số này mà bạn chọn thiết lập:

Meta Pixel (sự kiện trên trang web)
API Sự kiện trong ứng dụng (sự kiện trong ứng dụng, bao gồm cả Facebook SDK dành cho iOS hoặc Android, đối tác đo lường trên di động (MMP))
API Chuyển đổi offline (API cũ của Meta cho sự kiện offline)

Tập dữ liệu giúp bạn xem tất cả hoạt động của khách hàng trên một giao diện duy nhất. Bạn cũng có thể giảm bớt công sức xây dựng và duy trì nhiều tiện ích tích hợp API.

Trong Trình quản lý sự kiện, nhà quảng cáo có nhiều tùy chọn để tạo tập dữ liệu tùy theo điểm bắt đầu của họ. Hoặc bạn có thể tạo một tập dữ liệu hoàn toàn mới trong Trình quản lý sự kiện, bằng cách liên kết thông tin trong quá trình tạo nhóm sự kiện offline hoặc thông qua một ứng dụng di động hiện có hay trong quá trình tạo nhóm sự kiện nhắn tin. Lưu ý rằng bạn cần phải liên kết một tập dữ liệu với một ứng dụng trước khi gửi sự kiện trong ứng dụng di động đến API Chuyển đổi. Tuy nhiên, bạn chỉ có thể liên kết một ứng dụng với một tập dữ liệu. Hãy xem thêm chi tiết và hướng dẫn tại đây.

Quyền

Để tích hợp trực tiếp làm nhà quảng cáo, vui lòng làm theo hướng dẫn về quyền và điều kiện tiên quyết tại đây.
Để tích hợp nền tảng đối tác, bạn cần có:
- Quyền truy cập nâng cao vào các quyền ads_read, ads_management, pages_messaging, whatsapp_business_messaging, pages_show_list và instagram_manage_messages.
- Tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.
- Tùy thuộc vào loại sự kiện, bạn cần có quyền truy cập nâng cao vào quyền page_events đối với sự kiện trên Messenger/WhatsApp hoặc quyền instagram_manage_events đối với Instagram Direct.

Tích hợp đối tác

Nếu tích hợp đối tác làm nền tảng, bạn có thể sử dụng phương thức tích hợp Đăng nhập bằng Facebook cho doanh nghiệp (khuyên dùng) hoặc Tiện ích Meta Business.

Vui lòng tham khảo Cẩm nang về API Chuyển đổi cho hoạt động nhắn tin kinh doanh, trong đó có hướng dẫn tích hợp theo từng bước.

API Tập dữ liệu cho tính năng nhắn tin và WhatsApp

API Tập dữ liệu được dùng để truy xuất dataset_id đính kèm với trang cụ thể. dataset_id này được dùng trong API Chuyển đổi vào lúc khác. Để có thể sử dụng API Tập dữ liệu, bạn sẽ cần có quyền page_events đối với sự kiện trên Messenger hoặc WhatsApp do khách hàng cấp cho ứng dụng của bạn thông qua phương thức Đăng nhập bằng Facebook cho doanh nghiệp hoặc Tiện ích Meta Business.

Để truy xuất dataset_id, bạn cần thực hiện lệnh gọi GET đến API Tập dữ liệu bằng page_id và access_token. Hãy xem lệnh gọi mẫu ở bên dưới:

https://graph.facebook.com/v16.0/{PAGE_ID}/dataset?access_token={TOKEN}

Phản hồi sẽ trả về một ID biểu thị dataset_id. Với ID này và mã truy cập nhận được trước đó, giờ đây, bạn có thể gọi API Chuyển đổi để gửi sự kiện nhắn tin đến Meta.

API Tập dữ liệu cho Instagram

API Tập dữ liệu được dùng để truy xuất dataset_id đính kèm với trang cụ thể. dataset_id này được dùng trong API Chuyển đổi vào lúc khác. Để có thể sử dụng API Tập dữ liệu, bạn sẽ cần có quyền instagram_manage_events do khách hàng cấp cho ứng dụng của bạn thông qua phương thức Đăng nhập bằng Facebook cho doanh nghiệp hoặc Tiện ích Meta Business.

Để truy xuất dataset_id, bạn cần thực hiện lệnh gọi GET đến API Tập dữ liệu bằng ig_user_id và access_token. Sau đây là lệnh gọi mẫu:

https://graph.facebook.com/v16.0/{IG_USER_ID}/dataset?access_token={TOKEN}

Phản hồi sẽ trả về một ID biểu thị dataset_id. Với ID này và mã truy cập nhận được trước đó, giờ đây, bạn có thể gọi API Chuyển đổi để gửi sự kiện nhắn tin đến Meta.

Cấu hình

Thiết lập thông số sự kiện nhắn tin kinh doanh

Bạn có thể tham khảo nhóm thông số mà mình hiện có thể gửi qua API Chuyển đổi tại đây. Để gửi sự kiện nhắn tin kinh doanh, bạn có thể chia sẻ các trường sau đây trong phần tải dữ liệu Dữ liệu người dùng cho những nền tảng nhắn tin khác nhau:

Nền tảng	Thông số	Mô tả
Messenger	`page_id`	Bắt buộc đối với Messenger ID Trang Facebook được liên kết với doanh nghiệp.
Messenger	`page_scoped_user_id`	Bắt buộc đối với Messenger Người dùng tương tác với Trang được xác định theo ID người dùng trong Trang (PSID). Bạn có thể lấy PSID từ webhook này.
WhatsApp	`page_id`	Bắt buộc đối với WhatsApp ID Trang Facebook được liên kết với WhatsApp Business.
WhatsApp	`ctwa_clid`	Bắt buộc đối với WhatsApp Bạn chỉ có thể lấy `ctwa_clid` từ đối tượng giới thiệu trong webhook tin nhắn trên API Doanh nghiệp phiên bản 2.45.1 trở lên (API Tại chỗ) hoặc API Đám mây.
Instagram	`ig_account_id`	Bắt buộc đối với Instagram ID tài khoản Instagram được liên kết với doanh nghiệp.
Instagram	`ig_sid`	Bắt buộc đối với Instagram Người dùng tương tác với Instagram được xác định theo ID người dùng trong Instagram (IGSID). Bạn có thể lấy IGSID từ webhook này.

Gửi sự kiện

Để gửi sự kiện mới, hãy gửi yêu cầu POST đến API Chuyển đổi từ đường dẫn sau đây:

https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}

Khi bạn gửi đến cạnh này, Meta sẽ tạo sự kiện nhắn tin kinh doanh mới. Để biết thêm chi tiết, vui lòng tham khảo tài liệu dành cho nhà phát triển dưới đây.

Sau đây là thông tin tổng quan về cách sắp xếp thông số theo lược đồ chung trong phần tải dữ liệu.

Đối với sự kiện trên Messenger:

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "messenger",
      "user_data": {
        "page_id": <PAGE_ID>,
        "page_scoped_user_id": <PSID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

Đối với sự kiện trên WhatsApp:

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "page_id": <PAGE_ID>,
        "ctwa_clid": "ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a", // <CLICK_TO_WHATSAPP_CLICK_ID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

Đối với sự kiện trên Instagram:

Yêu cầu CTD CAPI mẫu

POST /{dataset_id}/events

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1675999999,
      "action_source": "business_messaging",
      "messaging_channel": "instagram",
      "user_data": {
        "ig_account_id": <IG_ACCOUNT_ID>,
        "ig_sid": <IGSID>
      },
      "custom_data": {
        "currency": "USD",
        "value": 123
      }
    }
  ],
  "partner_agent": "<PARTNER_NAME>"
}

Khắc phục sự cố

Sử dụng công cụ Thử nghiệm sự kiện trong Trình quản lý sự kiện để thử nghiệm:

Truy cập vào Trình quản lý sự kiện, chọn tập dữ liệu được liên kết với trang
Nhấp vào tab Thử nghiệm sự kiện
Chọn kênh marketing và kênh nhắn tin
Nhấp vào nút Trình khám phá API Đồ thị
Hệ thống sẽ nhập phần tải dữ liệu điền sẵn vào Trình khám phá API Đồ thị
Nhấp vào nút Gửi

Video hướng dẫn

Xem video sau để được hướng dẫn từng bước tích hợp.

Đã xảy ra lỗi

Chúng tôi đã gặp sự cố khi phát video này.

Tìm hiểu thêm

Câu hỏi thường gặp

API Chuyển đổi cho hoạt động nhắn tin kinh doanh hỗ trợ những loại sự kiện nhắn tin nào?

Đáp: API Chuyển đổi cho hoạt động nhắn tin kinh doanh hiện chỉ hỗ trợ sự kiện mua hàng và gửi dữ liệu khách hàng tiềm năng cho hoạt động nhắn tin kinh doanh. Hãy lưu ý rằng sự kiện nhắn tin sẽ chỉ biểu thị hoạt động tương tác của khách hàng trong chuỗi tin nhắn, chứ không phải lượt chuyển đổi diễn ra trên các kênh khác như trang web. Bạn có thể dễ dàng phân biệt sự kiện của mình bằng cách chọn nguồn hành động tương ứng trong quá trình tích hợp.

Meta có đưa ra hướng dẫn giữ nguyên ứng dụng hay dùng ứng dụng khác cho quá trình tích hợp API Chuyển đổi khác không?

Đáp: Cách tốt nhất là đối tác nên dùng 1 ứng dụng để Meta có thể xác định tất cả sự kiện mà đối tác gửi. Nếu bạn là đối tác và có nhiều ứng dụng, hãy đảm bảo đặt partner_agent thành tên đại lý đối tác mà Meta chỉ định cho bạn. Nếu bạn không chắc chắn, hãy liên hệ với đại diện của Meta.

Nếu lượt chuyển đổi diễn ra bên ngoài chuỗi tin nhắn (ví dụ: trên trang web hoặc ứng dụng của tôi), làm cách nào để chuyển sự kiện cho Meta?

Đáp: Nếu lượt chuyển đổi diễn ra bên ngoài chuỗi tin nhắn, bạn vẫn nên gửi trả lại sự kiện đó cho Meta bằng sản phẩm API Chuyển đổi phù hợp. Ví dụ: nếu lượt chuyển đổi diễn ra trên trang web của bạn, hãy dùng API Chuyển đổi cho web. Nếu lượt chuyển đổi diễn ra trên ứng dụng của bạn, hãy dùng API Chuyển đổi cho sự kiện trong ứng dụng. Hệ thống vẫn sẽ phân bổ sự kiện này cho ID lượt click của API Chuyển đổi cho web. Bạn có thể xem danh sách thông số đầy đủ tại đây.

API Chuyển đổi có hỗ trợ tối ưu hóa quảng cáo click để nhắn tin không?

Đáp: Hiện tại, API Chuyển đổi chỉ hỗ trợ tối ưu hóa lượt mua cho quảng cáo click đến Messenger, chứ chưa hỗ trợ tối ưu hóa quảng cáo trên WhatsApp. Đối với quảng cáo click đến WhatsApp, bạn có thể tối ưu hóa chiến dịch quảng cáo của mình để tăng lượt chuyển đổi.

Tôi có thể dùng lại tập dữ liệu hiện có cho API Chuyển đổi cho hoạt động nhắn tin kinh doanh không?

Đáp: Có, chúng tôi hỗ trợ liên kết với tập dữ liệu hiện có. Bạn có thể xem các tùy chọn có sẵn để quyết định tùy chọn phù hợp cho doanh nghiệp của mình.

Nếu tôi đang dùng API Chuyển đổi cho trang web, việc thêm tùy chọn nhắn tin kinh doanh vào tiện ích tích hợp hiện tại có ảnh hưởng gì không?

Đáp: Việc thêm tùy chọn nhắn tin kinh doanh vào tiện ích tích hợp CAPI hiện tại không có rủi ro gì. Hoạt động phân bổ sẽ dựa trên ID trang/tập dữ liệu, chứ không liên quan đến ID ứng dụng.

Một trang có thể liên kết với bao nhiêu tập dữ liệu?

Đáp: Bạn chỉ có thể liên kết 1 tập dữ liệu với 1 trang.

Tôi có cần loại bỏ sự kiện trùng lặp trước khi gửi sự kiện qua API Chuyển đổi cho hoạt động nhắn tin kinh doanh không?

Đáp: Meta không hỗ trợ loại bỏ sự kiện trùng lặp đối với API Chuyển đổi cho hoạt động nhắn tin kinh doanh. Vì vậy, nhà quảng cáo nên loại bỏ trùng lặp trước khi gửi sự kiện qua API này.

Xem thêm

Tổng quan về API Chuyển đổi
Sử dụng API Chuyển đổi
Thông số API Chuyển đổi
Cách làm tốt nhất
Nền tảng WhatsApp Business (API Tại chỗ hoặc API Đám mây) với API Doanh nghiệp phiên bản 2.45.1 trở lên
API Nhắn tin trên Instagram