Triển khai đầu cuối API Chuyển đổi

Với API Chuyển đổi, nhà quảng cáo có thể cung cấp cho người tiêu dùng khả năng kiểm soát và tính minh bạch dữ liệu thích hợp, trong khi vẫn tiếp tục mang đến trải nghiệm cá nhân. Với API này, bạn có thể chia sẻ dữ liệu trực tiếp từ máy chủ thay vì thông qua trình duyệt.

Lợi ích của tiện ích tích hợp

• Nắm bắt thông tin sâu hơn trong phễu: So với Meta Pixel, API Chuyển đổi cho phép bạn chia sẻ mảng dữ liệu rộng hơn. Với API này, bạn có thể xem xét thêm nhiều thông tin để đưa ra quyết định, chẳng hạn như dữ liệu CRM, sự kiện trong phần dưới phễu (bao gồm khách hàng tiềm năng đủ điều kiện) cũng như lộ trình chuyển đổi nhiều trang web trên một trang web và một vị trí thực.

• Kiểm soát dữ liệu: Khi được sử dụng thông qua cách triển khai Chỉ phía máy chủ (ví dụ: không có Meta Pixel), API Chuyển đổi sẽ cung cấp cho bạn thêm quyền kiểm soát đối với dữ liệu mình chia sẻ. Bạn có thể chọn thêm thông tin chi tiết vào sự kiện của mình, cung cấp dữ liệu như lợi nhuận sản phẩm hoặc thông tin trước đây, chẳng hạn như điểm giá trị khách hàng.

• Tăng độ tin cậy và khả năng phục hồi tín hiệu: Việc chia sẻ dữ liệu thông qua API Chuyển đổi có thể đáng tin cậy hơn so với các phương pháp chỉ dựa trên trình duyệt, như Meta Pixel. API này được thiết kế để hạn chế rủi ro từ các vấn đề như lỗi trình duyệt hoặc sự cố kết nối. Những hạn chế mới trong ngành về việc truyền dữ liệu có thể giới hạn tính hiệu quả của cookie và khả năng theo dõi Pixel. Vì thế, API Chuyển đổi sẽ hỗ trợ bạn kiểm soát việc chia sẻ tín hiệu mà Pixel có thể không còn thu thập.

Tổng quan

Bạn có thể cân nhắc tích hợp API Chuyển đổi theo 2 giai đoạn chính:

• Chuẩn bị - Chọn loại tích hợp phù hợp với bạn, xác định sự kiện sẽ gửi và xem xét các tùy chọn tối ưu hóa có sẵn.

• Thực thi - Tìm hiểu cách triển khai API này. Trong giai đoạn này, bạn cũng có thể sử dụng tiện ích tích hợp đối tác.

Sau đây là thông tin ngắn gọn về quy trình tích hợp hoàn chỉnh:

Người dùng pixel hiện có

Nếu bạn đang dùng tiện ích tích hợp Meta Pixel, tiện ích tích hợp API Chuyển đổi nên được xây dựng dưới dạng phần mở rộng của tiện ích tích hợp Pixel, thay vì dưới dạng một kết nối hoàn toàn khác.

Sự chấp thuận chung

Nếu bạn có logic để kiểm soát sự chấp thuận đối với việc chia sẻ dữ liệu Pixel, hãy sử dụng chính logic này đối với việc chia sẻ dữ liệu qua API Chuyển đổi.

Phương pháp thay thế

• Nếu bạn muốn tối ưu hóa quảng cáo cho sự kiện trong ứng dụng, vui lòng sử dụng API Sự kiện trong ứng dụng.

Chuẩn bị

Chọn loại tích hợp

Để bắt đầu, hãy chọn tùy chọn tích hợp bạn muốn triển khai:

Xác định sự kiện sẽ gửi

Sau khi chọn phương pháp tích hợp, bạn có thể xác định sự kiện mình muốn gửi. Tín hiệu sẽ hữu ích nhất nếu được so khớp với ID người dùng Meta. Vì vậy, bạn cần phải cân nhắc kỹ xem nên gửi cho chúng tôi thông số nào kèm sự kiện và tần suất gửi như thế nào.

Tùy chọn sự kiện

Gửi sự kiện phù hợp với doanh nghiệp bạn nhất. Hãy xem toàn bộ danh sách sự kiện tiêu chuẩn và tùy chỉnh được hỗ trợ trên Meta.

Thông số sự kiện

Bạn có thể gửi nhiều thông số bên trong mỗi sự kiện. Hãy xem các thông số được API Chuyển đổi sử dụng để tìm hiểu thêm về những trường đó.

Bạn có thể thêm nhiều loại ID vào sự kiện của mình, bao gồm event_id, external_id và order_id. Bạn cần phải biết rõ sự khác biệt giữa các thông số này:

Độ mới của dữ liệu

Bạn nên gửi sự kiện theo thời gian thực hoặc theo lô dựa trên lịch trình cụ thể thông qua API Chuyển đổi. Việc gửi sự kiện theo thời gian thực hoặc trong vòng 1 giờ sẽ đảm bảo rằng sự kiện có thể được dùng để phân bổ và được tối ưu hóa cho hoạt động phân phối quảng cáo.

Việc gửi sự kiện sau hơn 2 giờ kể từ khi sự kiện diễn ra có thể làm giảm đáng kể hiệu quả của quảng cáo được tối ưu hóa cho sự kiện đó. Những sự kiện gửi sau 24 giờ trở lên có thể dẫn đến các vấn đề đáng kể về phân bổ và hoạt động phân phối quảng cáo được tối ưu hóa.

Nếu bạn gửi sự kiện có khoảng thời gian chuyển đổi dài, hãy gửi sự kiện gần với thời gian thực nhất có thể, kể từ thời điểm hoàn tất toàn bộ quá trình chuyển đổi.

Chuyển sang bước tiếp theo sau khi bạn có:

• Danh sách sự kiện sẽ gửi.
• Trường cụ thể mà bạn muốn gửi kèm mỗi sự kiện.
• Tần suất gửi sự kiện.

Các loại tối ưu hóa có sẵn

API Chuyển đổi cung cấp các loại tối ưu hóa sau đây:

Thực thi

Bạn có thể triển khai tiện ích tích hợp theo 2 cách:

• Tích hợp trực tiếp - Bạn trực tiếp triển khai API chuyển đổi với vai trò là nhà quảng cáo.
• Tích hợp dưới dạng nền tảng - Với vai trò là đối tác marketing, bạn cung cấp API chuyển đổi như một dịch vụ cho khách hàng của mình.

Tích hợp trực tiếp

Bước 1: Thiết lập yêu cầu

Trước khi sử dụng API Chuyển đổi, hãy thiết lập các tài sản sau đây:

Chuyển sang Triển khai API sau khi tài sản đã sẵn sàng. Hãy nhớ lưu ID cho tài sản của bạn, vì bạn sẽ sử dụng ID đó trong các lệnh gọi API.

Bước 2: Triển khai API

Sau khi hoàn thành các yêu cầu, hãy bắt đầu quá trình triển khai. Trong khi xây dựng trên API Chuyển đổi, hãy luôn tham khảo tài liệu dành cho nhà phát triển.

Lệnh gọi thử nghiệm (không bắt buộc)

Nếu đây là lần đầu tiên bạn sử dụng API này, hãy bắt đầu bằng lệnh gọi thử nghiệm. Để làm việc đó, bạn cần có phần tải dữ liệu và phương thức thực hiện lệnh gọi API. Sau khi lệnh gọi hoàn tất, hãy kiểm tra Trình quản lý sự kiện để xác minh rằng lệnh gọi hoạt động như dự kiến.

{
  "data": [
   {
    "event_name": "Purchase",
    "event_time": 1601673450,
    "user_data": {
      "em": "7b17fb0bd173f625b58636fb796407c22b3d16fc78302d79f0fd30c2fc2fc068",
      "ph": null
     },
    "custom_data": {
      "currency": "USD",
      "value": "142.52"
    }
   }
  ]
}

{
  "events_received": 1,
  "messages": [],
  "fbtrace_id": <FB-TRACE-ID>
}

Sau khi bạn hoàn tất lệnh gọi đầu tiên, hãy xác minh sự kiện trên Trình quản lý sự kiện > Pixel của bạn > Tổng quan.

Chuyển sang Gửi và xác minh sự kiện sau khi bạn kiểm tra sự kiện thử nghiệm trong Trình quản lý sự kiện.

Gửi và xác minh sự kiện

Để bắt đầu gửi sự kiện, hãy gửi yêu cầu POST đến cạnh /events của API. Đính kèm phần tải dữ liệu vào lệnh gọi - nếu bạn cần hỗ trợ tạo phần tải dữ liệu, hãy truy cập Trình trợ giúp phần tải dữ liệu. Hãy tham khảo các thông tin và nguồn lực sau đây để biết thêm thông tin và mã mẫu:

• Sử dụng API > Gửi yêu cầu
• Sự kiện bỏ dở
• Thời gian tải lên so với thời gian giao dịch của sự kiện
• Yêu cầu hàng loạt
• Băm dữ liệu

Sau khi bạn bắt đầu gửi sự kiện, hãy chuyển đến Trình quản lý sự kiện và xác nhận rằng chúng tôi đã nhận được sự kiện bạn gửi. Tìm hiểu cách Xác minh sự kiện.

Nếu việc triển khai của bạn bổ sung cho Pixel trình duyệt, hãy chuyển đến phần cài đặt loại bỏ trùng lặp. Còn nếu không, bạn đã hoàn tất! Tham khảo phần Hỗ trợ nếu bạn vẫn còn thắc mắc.

Bước 3: Thêm thông số để loại bỏ trùng lặp

Nếu gửi các sự kiện giống nhau qua Pixel và API Chuyển đổi, bạn cần thiết lập tính năng loại bỏ trùng lặp cho sự kiện được gửi qua cả hai kênh. Đầu tiên, hãy đọc tài liệu dành cho nhà phát triển để hiểu logic loại bỏ trùng lặp.

Loại bỏ trùng lặp dựa trên sự kiện

Nếu phát hiện cùng một tổ hợp khóa máy chủ (event_id, event_name) và tổ hợp khóa trình duyệt (eventID, event) được gửi đến cùng ID Pixel trong vòng 48 giờ, chúng tôi sẽ bỏ sự kiện trùng lặp gửi sau.

Cách đảm bảo loại bỏ trùng lặp sự kiện:

• Đối với những sự kiện tương ứng, hãy nhớ đặt cùng một giá trị cho các thông số sau đây:

  • event_id từ sự kiện máy chủ và eventID từ sự kiện trình duyệt
  • event_name từ sự kiện trình duyệt và máy chủ
• Sau khi gửi sự kiện trùng lặp, hãy kiểm tra Trình quản lý sự kiện để xem bạn có bỏ đúng sự kiện hay không.
• Đảm bảo rằng mỗi sự kiện duy nhất được gửi qua cả Pixel và API Chuyển đổi đều có event_id của riêng mình. Không nên dùng chung ID này với các sự kiện khác.

Phương pháp thay thế cho cách loại bỏ trùng lặp dựa trên sự kiện

Mặc dù ID sự kiện sẽ luôn là cách tốt nhất để loại bỏ trùng lặp sự kiện, nhưng việc triển khai lại khá phức tạp. Bạn có thể tận dụng giải pháp thay thế bằng cách sử dụng thông số external_id hoặc fbp. Nếu bạn đặt cấu hình để chuyển thông số external_id hoặc fbp qua cả trình duyệt và máy chủ, chúng tôi sẽ tự động loại bỏ trùng lặp sự kiện nếu phát hiện một sự kiện có thông số external_id hoặc fbp giống nhau trong vòng 48 giờ.

Bước 4 (không bắt buộc): Khám phá Tính năng của Business SDK

Meta Business SDK có các tính năng nâng cao được thiết kế đặc biệt cho người dùng API Chuyển đổi:

• Yêu cầu không đồng bộ - Sử dụng tính năng này nếu bạn không muốn chặn thực thi chương trình để chờ hoàn tất một yêu cầu. Với phương pháp này, bạn gửi yêu cầu và nhận lại tín hiệu từ máy chủ sau khi yêu cầu hoàn tất. Trong khi bạn chờ phản hồi, chương trình có thể tiếp tục thực thi.
• Xử lý hàng loạt đồng thời - Tận dụng các yêu cầu không đồng bộ để tăng thông lượng bằng cách sử dụng tài nguyên hiệu quả hơn. Tạo yêu cầu hàng loạt để hỗ trợ các trường hợp sử dụng như trình xử lý yêu cầu sự kiện, lệnh chạy ngầm theo thời gian định trước và hơn thế nữa.
• Giao diện dịch vụ HTTP - Ghi đè dịch vụ HTTP mặc định của Business SDK và triển khai dịch vụ tùy chỉnh của riêng bạn bằng phương thức hoặc thư viện bạn ưu tiên.

Tích hợp dưới dạng nền tảng

Hướng dẫn sau đây dành cho các đối tác cung cấp API chuyển đổi dưới dạng dịch vụ cho nhà quảng cáo.

Bước 1: Thiết lập yêu cầu

Ứng dụng của bạn sẽ có các tính năng và quyền sau đây:

• Cấp độ truy cập: Quyền truy cập nâng cao
• Tính năng: Quyền quản lý quảng cáo tiêu chuẩn
• Quyền: ads_management và pages_read_engagement và ads_read.

Bước 2: Thay mặt khách hàng gửi sự kiện

Trước tiên, hãy làm theo các bước tích hợp trực tiếp và thử nghiệm tiện ích tích hợp của bạn. Sau đó, bạn có thể yêu cầu ủy quyền để thay mặt khách hàng gửi sự kiện. Bạn có các tùy chọn xác thực sau đây:

Thông qua Tiện ích Meta Business (Khuyên dùng)

Tiện ích Meta Business trả về tất cả thông tin cần thiết để thay mặt khách hàng gửi sự kiện thông qua quy trình sau. Tiện ích Meta Business cung cấp một điểm cuối để truy xuất mã truy cập dành cho người dùng hệ thống được tạo trong Trình quản lý kinh doanh của khách hàng. Quy trình này bao gồm quyền gửi sự kiện từ máy chủ. Quy trình này được thực hiện tự động và theo cách bảo mật.

Điểm cuối này cần có mã truy cập dành cho người dùng làm thông số đầu vào. Đối với người dùng Tiện ích Meta Business mới, hãy gọi điểm cuối này để tìm nạp mã truy cập dành cho người dùng hệ thống sau khi thiết lập xong Tiện ích Meta Business. Người dùng hiện tại cần yêu cầu xác thực lại trước khi gọi điểm cuối API mới.

Mã truy cập dành cho người dùng hệ thống của khách hàng

Yêu cầu khách hàng tạo Mã truy cập dành cho người dùng hệ thống theo cách thủ công thông qua API Chuyển đổi bên trong Cài đặt Pixel. Sau đó, gửi sự kiện đến Pixel của nhà quảng cáo bằng mã đó.

Người dùng hệ thống hoặc người dùng hệ thống là quản trị viên phải cài đặt ứng dụng sẽ được dùng để tạo mã truy cập. Cách thiết lập này cho phép ứng dụng của bạn gọi API thay mặt người dùng hệ thống hoặc người dùng hệ thống là quản trị viên này.

Khách hàng chia sẻ Pixel với Trình quản lý kinh doanh của đối tác

Với tùy chọn này, khách hàng chia sẻ Pixel với đối tác thông qua cài đặt Trình quản lý kinh doanh hoặc qua API. Sau đó, bạn có thể chỉ định người dùng hệ thống đối tác cho Pixel của khách hàng và tạo mã truy cập để gửi sự kiện từ máy chủ.

Bước 3: Phân bổ sự kiện cho nền tảng

Để phân bổ sự kiện API chuyển đổi cho nền tảng của bạn, hãy sử dụng trường partner_agent. Việc này cho phép bạn thiết lập thông tin nhận dạng nền tảng của mình khi thay mặt khách hàng gửi sự kiện. Nếu bạn là đối tác được quản lý, hãy làm việc với Đại diện Meta để thống nhất về thông tin nhận dạng cho nền tảng của mình. Giá trị này phải ở định dạng có ít hơn 23 ký tự và chứa ít nhất 2 ký tự chữ cái. Sau đó, hãy gửi giá trị này kèm theo mỗi sự kiện từ máy chủ.

Hỗ trợ

Dành cho tất cả đối tác

Xem thông tin về cách gỡ lỗi và bài viết trên Trung tâm trợ giúp doanh nghiệp.

Dành cho đối tác được quản lý

Cung cấp thông tin sau đây cho Đại diện Meta của bạn để họ có thể hỗ trợ thử nghiệm tiện ích tích hợp và khắc phục sự cố: ID Trình quản lý kinh doanh, ID ứng dụng, ID Pixel.

Tài liệu về API

• Bắt đầu - Thử nghiệm API từ Trình quản lý kinh doanh của chính bạn
• Sử dụng API
• Cách làm tốt nhất - API Chuyển đổi
• Thiết lập API Chuyển đổi dưới dạng nền tảng
• Sự kiện tiêu chuẩn trên Meta
• Sự kiện tùy chỉnh trên Meta
• Thông số
• Trình trợ giúp phần tải dữ liệu
• Tùy chọn xử lý dữ liệu cho API Chuyển đổi và API Chuyển đổi offline
• Nếu bạn muốn tối ưu hóa cho sự kiện trong ứng dụng, hãy sử dụng API Sự kiện trong ứng dụng
• Nếu sự kiện là doanh số tại cửa hàng, hãy sử dụng API Chuyển đổi offline - Nếu sự kiện offline không phải là doanh số tại cửa hàng, sự kiện đó sẽ đủ điều kiện dùng API Chuyển đổi