API Chuyển đổi là gì? API Chuyển đổi (Conversion API) là một công nghệ được cung cấp bởi Meta (trước đây là Facebook) cho phép các nhà quảng cáo chuyển dữ liệu sự kiện từ trang web, ứng dụng di động, cửa hàng thực, và các kênh nhắn tin kinh doanh (như Messenger) trực tiếp đến nền tảng quảng cáo của họ. Thay vì dựa vào việc trình duyệt web hoặc ứng dụng di động gửi dữ liệu trực tiếp cho nền tảng quảng cáo thông qua pixel hoặc SDK, API Chuyển đổi cho phép gửi dữ liệu trực tiếp từ máy chủ của bạn đến nền tảng quảng cáo.
Với API Chuyển đổi, nhà quảng cáo có thể gửi các sự kiện từ nhiều nguồn khác nhau đến Meta thông qua một điểm cuối duy nhất. Việc này giúp tối ưu hóa quá trình thu thập dữ liệu và giảm bớt sự phức tạp cho nhóm công nghệ của nhà quảng cáo. Hơn nữa, việc hợp nhất dữ liệu này cung cấp một cái nhìn toàn diện hơn về các hoạt động trên nền tảng Meta, từ các sự kiện trên web đến sự kiện trong ứng dụng và cửa hàng thực.
Bằng cách sử dụng API Chuyển đổi, nhà quảng cáo có thể tăng cường hiệu suất của hoạt động nhắn tin kinh doanh. Chúng ta hãy cùng DC Ba Độ Agency khám phá chi tiết về cách sử dụng API Chuyển đổi để tối ưu hóa chiến lược nhắn tin kinh doanh trong bài viết này.
Lợi ích khi sử dụng API Chuyển đổi cho hoạt động nhắn tin kinh doanh
Việc sử dụng API Chuyển đổi mang lại nhiều lợi ích quan trọng cho hoạt động nhắn tin kinh doanh, vượt ra ngoài các ứng dụng cụ thể. Dưới đây là một số điểm đáng chú ý:
- 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 không chỉ có khả năng theo dõi số lượng cuộc trò chuyện đã bắt đầu, mà còn có thể tiếp cận những thông tin chi tiết hơn. Thông qua API Chuyển đổi, họ có thể dễ dàng theo dõi và phân tích kết quả chiến dịch click để nhắn tin trên các nền tảng của Meta. Điều này bao gồm số lượng lượt mua, chi phí trung bình trên mỗi lượt mua và các chỉ số quan trọng khác, giúp họ đưa ra các quyết định chiến lược thông minh hơn.
- Tinh giản quá trình tích hợp dữ liệu: Sử dụng một API duy nhất cho phép nhà quảng cáo dễ dàng xử lý và chia sẻ dữ liệu trên nhiều nền tảng nhắn tin và kênh khác nhau. Không còn phải lo lắng về việc tích hợp từng nguồn dữ liệu riêng biệt, họ có thể tập trung vào việc tối ưu hóa chiến lược và phát triển kế hoạch kinh doanh hiệu quả hơn.
- Cải thiện kết quả đo lường cho đối tác: API Chuyển đổi cung cấp cơ hội cho nhà quảng cáo cải thiện quá trình phân bổ chiến dịch click để nhắn tin trực tiếp trên bảng điều khiển của đối tác. Thông qua API Thông tin chi tiết về quảng cáo, họ có thể chia sẻ thông tin chi tiết và chính xác với đối tác, tạo điều kiện thuận lợi cho việc hợp tác và tăng cường hiệu quả của chiến dịch.
Điều kiện tiên quyết
Tập dữ liệu
Các sự kiện nhắn tin kinh doanh được gửi qua API Chuyển đổi phải được kết nối với một tập dữ liệu. Tập dữ liệu này giúp nhà quảng cáo quản lý và liên kết dữ liệu sự kiện từ nhiều nguồn khác nhau như 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. Các nguồn dữ liệu này có thể bao gồm:
- Meta Pixel (sự kiện trên trang web)
- API 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)
- API Chuyển đổi offline (API cũ của Meta cho sự kiện offline)
Tập dữ liệu cho phép nhà quảng cáo xem tất cả hoạt động của khách hàng trên một giao diện duy nhất, đồng thời giảm bớt công sức cần thiết để 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 phù hợp với nhu cầu của họ. Họ có thể tạo một tập dữ liệu mới hoàn toàn, hoặc liên kết thông tin từ các nguồn sự kiện offline hoặc từ ứng dụng di động hiện có. Lưu ý rằng để gửi sự kiện trong ứng dụng di động đến API Chuyển đổi, cần phải liên kết một tập dữ liệu với một ứng dụng. Tuy nhiên, mỗi ứng dụng chỉ có thể liên kết với một tập dữ liệu duy nhất.
Quyền
Để tích hợp trực tiếp làm nhà quảng cáo, vui lòng tuân 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 đảm bảo có các yêu cầu sau:
- 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 bạn muốn tích hợp đối tác làm nền tảng, có hai phương thức tích hợp khả dụng là:
- Đăng nhập bằng Facebook cho doanh nghiệp (khuyến nghị): Đây là phương pháp được khuyến nghị, cung cấp sự thuận tiện và tính bảo mật cao khi tích hợp với các đối tác làm nền tảng.
- Tiện ích Meta Business: Đây cũng là một phương thức tích hợp, nhưng có thể không được khuyến nghị như phương pháp đăng nhập bằng Facebook cho doanh nghiệp. Tuy nhiên, nó vẫn cung cấp một cách tiếp cận để tích hợp đối tác của bạn vào nền tảng Meta.
API Tập dữ liệu cho tính năng nhắn tin và WhatsApp
API Tập dữ liệu được sử dụng để truy xuất dataset_id được gắn liền với một trang cụ thể. dataset_id này sau đó được sử dụng trong API Chuyển đổi và các hoạt động 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 các sự kiện trên Messenger hoặc WhatsApp, được khách hàng cấp cho ứng dụng của bạn thông qua phương pháp Đă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
. Sử dụng ID này và mã truy cập đã nhận được trước đó, bạn có thể sử dụng API Chuyển đổi để gửi các sự kiện nhắn tin đến Meta.
API Tập dữ liệu cho Instagram
API Tập dữ liệu được sử dụng để truy xuất dataset_id liên kết với một trang cụ thể. dataset_id này sau đó được sử dụng trong API Chuyển đổi và các hoạt động khác. Để có thể sử dụng API Tập dữ liệu, bạn cần có quyền instagram_manage_events, được khách hàng cấp cho ứng dụng của bạn thông qua phương pháp Đă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ể xem các thông số mà bạ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 trong phần tải dữ liệu Dữ liệu người dùng cho các 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 bằng ID người dùng Trang (PSID). Bạn có thể nhận PSID từ webhook này. |
page_id | Bắt buộc đối với WhatsApp ID Trang Facebook được liên kết với WhatsApp Business. | |
ctwa_clid | Bắt buộc đối với WhatsApp Bạn chỉ có thể thu thập 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. | |
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. | |
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 bằng ID người dùng trong Instagram (IGSID). Bạn có thể nhận IGSID từ webhook này. |
Gửi sự kiện
Để gửi một sự kiện mới, vui lòng gửi yêu cầu POST đến API Chuyển đổi từ đường dẫn dưới đây:
https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}
Khi bạn gửi yêu cầu đến đường dẫn này, Meta sẽ tạo một sự kiện nhắn tin kinh doanh mới. Để biết thêm thông tin chi tiết, vui lòng tham khảo tài liệu dành cho nhà phát triển dưới đây.
Dưới đây là một tổng quan về cách sắp xếp các 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ố
Dùng công cụ Thử nghiệm sự kiện trong Trình quản lý sự kiện để kiểm tra:
- Truy cập vào Trình quản lý sự kiện, chọn tập dữ liệu liên kết với trang.
- Click 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ẽ điền thông tin tải dữ liệu vào Trình khám phá API Đồ thị tự động.
- Nhấp vào nút Gửi để hoàn tất.
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 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. Lưu ý rằng các sự kiện nhắn tin chỉ đại diện cho tương tác của khách hàng trong chuỗi tin nhắn, không phải là số chuyển đổi xảy 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: Đối tác nên sử dụng một ứng dụng duy nhất để Meta có thể xác định tất cả các sự kiện mà đối tác gửi. Nếu bạn là đối tác và sở hữu nhiều ứng dụng, hãy đảm bảo thiết lập 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 có lượt chuyển đổi diễn ra bên ngoài chuỗi tin nhắn, bạn nên vẫn gửi lại sự kiện đó cho Meta bằng sản phẩm API Chuyển đổi phù hợp. Ví dụ, nếu chuyển đổi xảy ra trên trang web của bạn, hãy sử dụng API Chuyển đổi cho web. Nếu chuyển đổi xảy ra trên ứng dụng của bạn, hãy sử 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, và 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ó, API Chuyển đổi hỗ trợ việc liên kết với các tập dữ liệu hiện có. Bạn có thể xem các tùy chọn có sẵn để đưa ra quyết định về lựa 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: 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. Hoạt động phân bổ sẽ dựa trên ID trang/tập dữ liệu, 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 cung cấp hỗ trợ cho việc loại bỏ sự kiện trùng lặp trong API Chuyển đổi cho hoạt động nhắn tin kinh doanh. Do đó, nhà quảng cáo nên tự loại bỏ các sự kiện trùng lặp trước khi gửi chúng qua API này.
API Chuyển đổi là công cụ hỗ trợ đắc lực cho doanh nghiệp trong việc tối ưu hóa hoạt động nhắn tin kinh doanh, gia tăng hiệu quả chiến dịch và thúc đẩy doanh số. Doanh nghiệp nên cân nhắc áp dụng giải pháp này để nâng tầm hoạt động nhắn tin kinh doanh và đạt được mục tiêu kinh doanh đề ra.