Đ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 đã ghi trước đó 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 mức đ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:

  • Cùng transactionId với sự kiện gốc.
  • Cùng đích đến và hành động chuyển đổi với sự kiện ban đầu.
  • Các giá trị mới cho những trường mà bạn muốn điều chỉnh.

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 truyền dữ liệu, hãy xem phần Gửi sự kiện.

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

Bảng sau đây liệt kê những trường bạn có thể điều chỉnh và cách áp dụng nội dung cập nhật:

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 Bị bỏ qua

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

Gửi conversionValuecurrency mới để sửa đổi lại giá trị của một lượt chuyển đổi đã ghi lại. 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.

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 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 bỏ qua các trường này và giữ lại các giá trị được ghi lại cùng với sự kiện ban đầu.

Sự kiện không trù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 nội dung đ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.