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

Sử dụng phương thức IngestEvents để điều chỉnh các lượt chuyển đổi trước đây được ghi lại trên Google Ads. Trong Data Manager API, một đ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ừ API Google Ads, hãy xem phần Nâng cấp từ API Google Ads để so sánh cách xử lý các mức điều chỉnh trong từng 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:

Cách hoạt động của hệ số đ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 này 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 Sự kiện không khớp.

Gửi yêu cầu đ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 như sự kiện ban đầu.
  • Cùng đích đến và hành động chuyển đổi với 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.

Bạn nên gửi những giá trị nhận dạng mà bạn đã gửi hoặc thu thập được cùng với 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 mà bạn cung cấp.

Để biết thêm thông tin về cách gửi yêu cầu tiếp nhận, 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 Bị ghi đè. Giá trị mới sẽ thay thế giá trị đã ghi.
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 bằng sự kiện ban đầu. Bạn vẫn phải điền 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 lại giá trị của một lượt chuyển đổi đã ghi. Giá trị mới sẽ ghi đè giá trị đã được ghi nhận trước đó trong báo cáo và chiến lược đặt giá thầu mà không làm tăng số lượt chuyển đổi.

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ì mức điều chỉnh sẽ đính kèm dữ liệu người dùng để cải thiện hoạt động phân bổ.

  • Bị bỏ qua nếu có: Nếu thẻ Google hoặc một lượt 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 thêm vào.

Các trường khác

Bạn không thể cập nhật các 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 được so khớp. Google Ads giữ lại các giá trị được ghi lại bằng sự kiện ban đầu.

Bạn vẫn phải thêm mọi trường bắt buộc trong số này, chẳng hạn như ít nhất một giá trị nhận dạng. Data Manager API sẽ xác thực các thông số 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 sẽ được coi là một lượt tải lên lượt chuyển đổi mới thay vì một mức đ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.