Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.

Cập nhật bằng tiếng Anh: Hôm nay

Cách làm tốt nhất - API Chuyển đổi

Hãy dùng những cách làm tốt nhất dưới đây làm đề xuất chung để tích hợp thành công API Chuyển đổi. Các đề xuất này được thiết kế nhằm hỗ trợ bạn tận dụng API Chuyển đổi hiệu quả nhất. Hãy làm theo các đề xuất triển khai và sau khi triển khai để đảm bảo quá trình tích hợp diễn ra suôn sẻ và hoạt động chia sẻ dữ liệu với Meta mang lại kết quả tối ưu.

Ngoài những cách làm tốt nhất dưới đây, bạn nên xem video này để được hướng dẫn thực tế hơn về cách dùng API Chuyển đổi. Video này hướng dẫn bạn cách:

Gửi yêu cầu
Xử lý Sự kiện bỏ dở, Thời gian giao dịch của sự kiện và Yêu cầu hàng loạt
Xác minh sự kiện
Sử dụng Công cụ Thử nghiệm sự kiện

Những sự kiện trên web, trong ứng dụng và ở cửa hàng thực được chia sẻ bằng API Chuyển đổi cần có các thông số cụ thể. Bạn có thể xem danh sách các thông số bắt buộc ở đây.

Triển khai

Khi bạn thiết lập chiến dịch của mình, hãy đơn giản hóa cấu trúc tài khoản và áp dụng những cách làm tốt nhất đã định dưới đây dành cho chiến dịch:

Triển khai những cách làm tốt nhất dành cho Giai đoạn máy học
Tránh thực hiện các chỉnh sửa quan trọng đối với chiến dịch
Giảm thiểu tình trạng chồng chéo đấu giá
Chọn Vị trí quảng cáo tự động và Tối ưu hóa ngân sách chiến dịch
Chọn chiến lược giá thầu phù hợp dựa trên mục tiêu kinh doanh của bạn

Thiết lập sự kiện dự phòng

Bạn nên dùng cả API Chuyển đổi lẫn Meta Pixel và nên chia sẻ các sự kiện tương tự bằng cả hai công cụ này. Chúng tôi gọi đây là quy trình thiết lập sự kiện dự phòng. Ví dụ: nếu chia sẻ các sự kiện Purchase, Initiate Checkout và Contact bằng Meta Pixel, bạn cũng nên chia sẻ những sự kiện này từ máy chủ của mình bằng API Chuyển đổi.

Với API Chuyển đổi, bạn có thể chia sẻ các sự kiện trên trang web mà Pixel có thể bị mất do sự cố kết nối mạng hoặc lỗi tải trang. Bạn cũng có thể dùng API Chuyển đổi để chia sẻ các loại sự kiện và dữ liệu quan trọng khác diễn ra offline hoặc vào thời điểm khác khi Pixel không thể chia sẻ.

Đảm bảo có thể loại bỏ trùng lặp cho các sự kiện dự phòng

Khi bạn gửi các sự kiện dự phòng bằng Meta Pixel và API Chuyển đổi, hãy đảm bảo rằng cả hai sự kiện này đều sử dụng event_name giống nhau và đã thêm event_id hoặc tổ hợp external_id và fbp. Bạn nên thêm tất cả những thông số này để Meta có thể loại bỏ trùng lặp cho các sự kiện một cách chính xác và hạn chế tình trạng báo cáo hai lần các sự kiện giống nhau. Tìm hiểu thêm về tính năng loại bỏ trùng lặp, trường hợp cần dùng và cách thiết lập.

Gửi các thông số bắt buộc và được đề xuất

Các thông số sự kiện trên máy chủ và thông tin khách hàng dưới đây là bắt buộc:

Thông số	Loại	Trường hợp cần dùng
`action_source`	Sự kiện trên máy chủ	Tất cả sự kiện
`event_source_url`	Sự kiện trên máy chủ	Tất cả sự kiện trên trang web
`client_user_agent`	Thông tin khách hàng	Tất cả sự kiện trên trang web

Bằng việc sử dụng API Chuyển đổi, bạn đồng ý rằng thông số action_source là chính xác theo hiểu biết của bạn. Bạn cũng nên thêm các thông số sự kiện external_id và event_id cho mọi sự kiện.

Bạn có thể gửi thêm các thông số thông tin khách hàng để tăng Chất lượng so khớp sự kiện. Bạn chỉ có thể dùng những sự kiện đã so khớp để tối ưu hóa hiệu quả phân bổ và phân phối quảng cáo. Ngoài ra, chất lượng so khớp càng cao thì hiệu quả càng tăng. Mặc dù bạn không thể dùng những sự kiện chưa so khớp để tối ưu hóa hiệu quả phân bổ hoặc phân phối quảng cáo, bạn vẫn có thể dùng những sự kiện này để đo lường cơ bản. Dưới đây là ví dụ về các thông số thông tin khách hàng có chất lượng cao:

địa chỉ email (em)
địa chỉ IP (client_ip_address)
tên (fn và ln)
số điện thoại (ph)

Yêu cầu so khớp cơ bản

Sau khi phát hành API Đồ thị phiên bản 13.0, chúng tôi sẽ cập nhật yêu cầu cơ bản về những cách kết hợp thông số thông tin khách hàng được xem là hợp lệ đối với một sự kiện API Chuyển đổi. Những thay đổi này sẽ giúp chúng tôi đưa ra ý kiến đóng góp tốt hơn khi một sự kiện kết hợp quá nhiều thông số thông tin khách hàng dẫn đến việc không thể so khớp hiệu quả.

Một sự kiện được xem là không hợp lệ nếu sự kiện này chỉ có các thông số thông tin khách hàng bao gồm một trong những cách kết hợp dưới đây (hoặc một nhóm nhỏ trong đó).

ct + country + st + zp + ge + client_user_agent
db + client_user_agent
fn + ge
ln + ge

Ví dụ: nếu một sự kiện chỉ có các thông số thông tin khách hàng ge, ct, st và country (thông số này có thể tương ứng với một người đàn ông ở Menlo Park, California, Hoa Kỳ), sự kiện đó sẽ bị từ chối vì những thông số thông tin khách hàng này là một nhóm nhỏ của một trong những cách kết hợp trên.

Đảm bảo làm mới các thông số `fbp` và `fbc`

Các thông số fbp và fbc là giá trị cookie thường được đặt trên trình duyệt của khách truy cập trang web liên quan đến giải pháp cookie bên thứ nhất của Meta và có thể thay đổi. Nếu bạn gửi các thông số này dưới dạng thông số người dùng, hãy thường xuyên làm mới giá trị của chúng.

Những giá trị này sẽ được đặt làm cookie bên thứ nhất khi bạn triển khai Meta Pixel trên trang web của mình và có thể được truy xuất để dùng trong các yêu cầu API Chuyển đổi.

Việc chia sẻ sự kiện ngay khi diễn ra có thể giúp chiến dịch của bạn đạt được kết quả tốt nhất. Bạn có thể chia sẻ các sự kiện trên máy chủ bằng API Chuyển đổi trong thời gian thực hoặc theo lô gần với thời gian thực.

Sử dụng sự kiện thử nghiệm

Bạn nên dùng công cụ Thử nghiệm sự kiện để xác thực kết nối API Chuyển đổi của mình. Thông thường, nhà phát triển nên sử dụng các thông số thông tin khách hàng của riêng họ (ví dụ: tên, địa chỉ email, số điện thoại) cho sự kiện thử nghiệm, vì hệ thống có thể loại bỏ những sự kiện này nếu chúng không khớp với tài khoản Facebook hay Meta nào.

Bạn có thể sử dụng công cụ Thử nghiệm sự kiện để:

Xác minh rằng bạn đã thiết lập đúng cách các sự kiện trên máy chủ và chúng tôi đã nhận được những sự kiện này.
Xác minh rằng bạn đã loại bỏ sự kiện trùng lặp đúng cách bằng việc xem những sự kiện nào đã được xử lý và loại bỏ trùng lặp.
Gỡ lỗi mọi hoạt động bất thường.

Tìm hiểu cách thử nghiệm sự kiện trên máy chủ bằng công cụ Thử nghiệm sự kiện.

Sử dụng Công cụ hỗ trợ phần tải dữ liệu

Hãy điền vào các trường thông số dữ liệu bắt buộc và được đề xuất trong Công cụ hỗ trợ phần tải dữ liệu để biết cách cấu trúc phần tải dữ liệu của bạn, cũng như nhận đề xuất về những thông số cần thêm vào.

Sử dụng Business SDK của chúng tôi

Các mã mẫu trong tài liệu của chúng tôi có ví dụ về Business SDK bằng Python, Java, Ruby, PHP và Node. Business SDK có thể giúp giảm bớt một số hoạt động phát triển - chẳng hạn như băm thông số người dùng - nhờ quá trình thực hiện tự động.

Nếu không định sử dụng Business SDK, bạn nên thực hiện quá trình băm.

Sử dụng API Chuyển đổi cho sự kiện offline

API Chuyển đổi hỗ trợ tất cả sự kiện offline và nên được dùng làm vùng chứa toàn diện cho các loại sự kiện này. Ví dụ về các loại sự kiện này bao gồm doanh số tại cửa hàng thực, cuộc gọi điện thoại, hành động được thực hiện trên thiết bị (chẳng hạn như TV thông minh hoặc máy chơi game cầm tay) và lượt đăng ký offline.

Khi bạn gửi sự kiện offline, hãy nhớ thêm thông số sự kiện action_source và chọn giá trị thích hợp (không nên chọn website). Bạn cần phải thêm nguồn hành động để xác định các mục tiêu chiến dịch mà sự kiện này hướng đến.

Bằng việc sử dụng API Chuyển đổi, bạn đồng ý rằng thông số action_source là chính xác theo hiểu biết của bạn.

Những cách làm tốt nhất khác dành cho đối tác

Agency: Gửi chuỗi `partner_agent`

Những đối tác hoặc agency chia sẻ sự kiện thay mặt cho nhà quảng cáo phải gửi một chuỗi partner_agent duy nhất, bao gồm cả tên nền tảng như đã nêu. Nếu có thể, bạn nên liên hệ với đại diện Meta riêng của mình để chọn một chuỗi tác nhân phù hợp.

Nền tảng trang web: Tích hợp nhà quảng cáo

Theo mặc định, các đối tác nền tảng trang web có thể cân nhắc xem sẽ cung cấp API Chuyển đổi một cách chọn lọc hay chọn các nhà quảng cáo. Meta Pixel và API Chuyển đổi có cùng điều khoản kinh doanh. Bạn nên chọn những khách hàng cũng cần chia sẻ dữ liệu của họ bằng API Chuyển đổi khi họ thiết lập Meta Pixel. Mặc dù chúng tôi tin rằng việc sử dụng cả hai công cụ sẽ củng cố và bảo mật hoạt động chia sẻ dữ liệu của họ trong thời gian dài, bạn cũng nên cung cấp cho khách hàng thông tin về cả API Chuyển đổi lẫn Meta Pixel để họ có thể đưa ra quyết định sáng suốt.

Sau khi triển khai

Kiểm tra chất lượng so khớp sự kiện

Nếu chia sẻ sự kiện trên máy chủ bằng API Chuyển đổi, bạn có thể xem Chất lượng so khớp sự kiện (EMQ) cho từng sự kiện trong Trình quản lý sự kiện. Điểm EMQ (trên 10) của sự kiện cho biết mức độ hiệu quả của thông tin khách hàng trong sự kiện trên máy chủ khi so khớp thông tin đó với tài khoản Facebook hay Meta. Tìm hiểu thêm về cách làm tốt nhất cho EMQ tại đây.

Chất lượng so khớp sự kiện hiện chỉ dùng được cho sự kiện trên web. Đối với các loại sự kiện khác như sự kiện offline và sự kiện tại cửa hàng thực, sự kiện trong ứng dụng, khách hàng có tiềm năng chuyển đổi hay bất kỳ tiện ích tích hợp nào ở giai đoạn alpha hoặc beta, hãy liên hệ với người đại diện của Meta để được hướng dẫn về cách cải thiện chất lượng so khớp sự kiện.

Chạy thử nghiệm

Khi dùng API Chuyển đổi, bạn nên thử nghiệm và tối ưu hóa chiến lược quảng cáo của mình trên Meta. Dưới đây là một số tùy chọn thử nghiệm:

Nghiên cứu mức tăng chuyển đổi: Hiểu được tác động gia tăng đến hiệu quả khi sử dụng các sự kiện trên máy chủ.
Thử nghiệm phân tách: Biết được chiến lược chiến dịch nào đạt được kết quả tốt nhất và hiệu quả nhất khi tối ưu hóa hiệu quả.