Điều chỉnh lượt chuyển đổi

Sử dụng phương thức IngestEvents để thực hiện điều chỉnh cho các lượt chuyển đổi từ quảng cáo đã ghi nhận trước đó trên Google Ads. Trong Data Manager API, một mức điều chỉnh có thể sửa đổi giá trị lượt chuyển đổi hoặc bổ sung dữ liệu người dùng.

Nếu bạn đang di chuyển từ Google Ads API, hãy xem bài viết Nâng cấp từ Google Ads API để so sánh cách xử lý các mức điều chỉnh trong mỗi API.

Các loại lượt chuyển đổi được hỗ trợ

Bạn có thể điều chỉnh các loại lượt chuyển đổi sau đây trên Google Ads:

• Lượt chuyển đổi từ nhiều nguồn: Lượt chuyển đổi được ghi nhận bằng thẻ Google trên trang web của bạn cho một hành động chuyển đổi WEBSITE.
• Lượt chuyển đổi ngoại tuyến và lượt chuyển đổi nâng cao cho khách hàng tiềm năng: Các sự kiện ngoại tuyến đã tải lên trước đó cho một hành động chuyển đổi UPLOAD_CLICKS.

Lưu ý: Chúng tôi không hỗ trợ việc điều chỉnh lượt chuyển đổi dạng lượt bán hàng tại cửa hàng thực tế.

Cách hoạt động của tính năng điều chỉnh

Trong cùng một hành động chuyển đổi, Google Ads so khớp các sự kiện bằng cách sử dụng transactionId:

• Nếu transactionId khớp với một lượt chuyển đổi hiện có cho cùng một hành động chuyển đổi, thì Data Manager API sẽ coi yêu cầu đó là một mức điều chỉnh lượt chuyển đổi.
• Nếu transactionId không khớp với một lượt chuyển đổi hiện có, Google Ads sẽ tạo một lượt chuyển đổi mới. Xem phần Sự kiện không khớp.

Gửi thông tin điều chỉnh

Để điều chỉnh một lượt chuyển đổi hiện có, hãy gửi yêu cầu IngestEvents bao gồm:

• transactionId giống với sự kiện ban đầu.
• Cùng một đích đến và hành động chuyển đổi như sự kiện ban đầu.
• Giá trị mới cho các trường mà bạn muốn điều chỉnh.
• Tất cả các trường bắt buộc cho một sự kiện, bao gồm ít nhất một giá trị nhận dạng, chẳng hạn như adIdentifiers hoặc userData. Xem các yêu cầu về sự kiện và giá trị nhận dạng đối với lượt chuyển đổi ngoại tuyến hoặc lượt chuyển đổi từ nhiều nguồn.

Lưu ý quan trọng: Data Manager API xác thực từng sự kiện khi nhận được yêu cầu, trước khi tìm transactionId phù hợp. Một lượt điều chỉnh phải đáp ứng các yêu cầu về trường và giá trị nhận dạng giống như một sự kiện mới. Nếu không, yêu cầu sẽ không thành công và có lỗi như NO_IDENTIFIERS_PROVIDED.

Bạn nên gửi cùng một giá trị nhận dạng mà bạn đã gửi hoặc thu thập bằng sự kiện ban đầu. Nếu transactionId không khớp với một lượt chuyển đổi hiện có, thì Google Ads sẽ sử dụng các giá trị nhận dạng này để phân bổ lượt chuyển đổi mới.

Bạn không cần chỉ định loại điều chỉnh. Data Manager API suy luận cách xử lý yêu cầu dựa trên transactionId và các trường bạn cung cấp.

Để biết thêm thông tin về cách gửi yêu cầu nhập, hãy xem hướng dẫn gửi sự kiện cho lượt chuyển đổi ngoại tuyến hoặc lượt chuyển đổi từ nhiều nguồn.

Các trường được hỗ trợ

Bảng sau đây liệt kê cách Google Ads áp dụng từng trường khi một sự kiện khớp với một lượt chuyển đổi hiện có:

Trường	Hành vi
conversionValue, currency	Đã ghi đè. Giá trị mới sẽ thay thế giá trị đã ghi lại.
userData	Bổ sung nếu sự kiện ban đầu không có dữ liệu người dùng, nếu không thì bỏ qua.
Tất cả các trường khác, chẳng hạn như adIdentifiers.gclid	Chưa cập nhật. Google Ads giữ lại các giá trị được ghi lại cùng với sự kiện ban đầu. Bạn vẫn phải cung cấp các trường bắt buộc.

Giá trị lượt chuyển đổi

Gửi conversionValue và currency mới để sửa đổi giá trị của một lượt chuyển đổi đã ghi nhận. Giá trị mới sẽ ghi đè giá trị đã ghi nhận trước đó trong báo cáo và hoạt động đặt giá thầu mà không làm tăng số lượt chuyển đổi.

Lưu ý: Trong thời gian dùng thử 14 ngày ban đầu cho lượt chuyển đổi từ nhiều nguồn, tính năng cập nhật giá trị sẽ bị tắt. Giá trị của thẻ sẽ không bị ghi đè trong báo cáo của Google Ads cho đến khi hết thời gian dùng thử.

Dữ liệu người dùng

Sau đây là cách Google Ads xử lý userData, chẳng hạn như địa chỉ email hoặc số điện thoại:

• Bổ sung nếu thiếu: Nếu sự kiện ban đầu được ghi nhận mà không có dữ liệu người dùng, thì thông tin điều chỉnh sẽ đính kèm dữ liệu người dùng để cải thiện mô hình phân bổ.

  Lưu ý: Bạn nên tải dữ liệu ngoại tuyến bổ sung lên trong vòng 24 giờ kể từ khi sự kiện ban đầu diễn ra để đạt được hiệu suất tối ưu.

• Bỏ qua nếu có: Nếu thẻ Google hoặc một tệp tải lên trước đó đã thu thập dữ liệu người dùng, thì dữ liệu người dùng mới sẽ bị bỏ qua. Dữ liệu người dùng hiện có sẽ không bị ghi đè hoặc bổ sung.

Các trường khác

Bạn không thể cập nhật giá trị nhận dạng và siêu dữ liệu khác ngoài giá trị lượt chuyển đổi, đơn vị tiền tệ và dữ liệu người dùng (chẳng hạn như adIdentifiers.gclid) cho các sự kiện trùng khớp. Google Ads sẽ giữ lại các giá trị được ghi lại cùng với sự kiện ban đầu.

Bạn vẫn phải thêm bất kỳ trường nào trong số này nếu trường đó bắt buộc, chẳng hạn như ít nhất một giá trị nhận dạng. API Trình quản lý dữ liệu sẽ xác thực các giá trị này cho mọi sự kiện.

Sự kiện không khớp

Nếu transactionId không khớp với một sự kiện hiện có, thì yêu cầu này sẽ được coi là yêu cầu tải lượt chuyển đổi mới lên thay vì yêu cầu điều chỉnh.

Google Ads cố gắng phân bổ lượt chuyển đổi mới cho một lượt nhấp vào quảng cáo bằng cách sử dụng các giá trị nhận dạng mà bạn cung cấp, chẳng hạn như adIdentifiers.gclid hoặc userData.

Lưu ý: Trong thời gian dùng thử ban đầu là 14 ngày đối với lượt chuyển đổi từ nhiều nguồn, các lượt chuyển đổi mới tạo sẽ xuất hiện trong báo cáo nhưng không được dùng để đặt giá thầu. Sau khi thời gian dùng thử kết thúc, các lượt chuyển đổi này sẽ tự động trở thành lượt chuyển đổi có thể đặt giá thầu.