- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- Hãy làm thử!
Xử lý các mức điều chỉnh lượt chuyển đổi nhất định.
Danh sách các lỗi được gửi: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Yêu cầu HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
customerId |
Bắt buộc. Mã của khách hàng thực hiện quá trình tải lên. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"conversionAdjustments": [
{
object ( |
Các trường | |
---|---|
conversionAdjustments[] |
Bắt buộc. Các mức điều chỉnh cho lượt chuyển đổi đang được tải lên. |
partialFailure |
Bắt buộc. Nếu đúng, các thao tác thành công sẽ được thực hiện và các thao tác không hợp lệ sẽ trả về lỗi. Nếu giá trị là false, tất cả các thao tác sẽ được thực hiện trong một giao dịch với điều kiện và chỉ khi tất cả các thao tác đó đều hợp lệ. Bạn phải luôn đặt giá trị này thành true. Hãy truy cập https://developers.google.com/google-ads/api/docs/best-practices/partial-failures để biết thêm thông tin về lỗi một phần. |
validateOnly |
Nếu đúng thì yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ có lỗi được trả về, chứ không phải kết quả. |
jobId |
Không bắt buộc. Giá trị đầu vào không bắt buộc để đặt mã công việc. Phải là số không âm và nhỏ hơn 2^31 nếu được cung cấp. Nếu trường này không được cung cấp, API sẽ tạo mã công việc trong phạm vi [2^31, (2^63)-1]. API sẽ trả về giá trị của yêu cầu này trong trường |
Nội dung phản hồi
Tin nhắn trả lời cho ConversionAdjustmentUploadService.UploadConversionAdjustments
.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "partialFailureError": { object ( |
Các trường | |
---|---|
partialFailureError |
Lỗi liên quan đến lỗi điều chỉnh lượt chuyển đổi ở chế độ lỗi một phần. Giá trị này được trả về khi tất cả lỗi xảy ra trong các lần điều chỉnh. Nếu xảy ra lỗi ngoài quá trình điều chỉnh (ví dụ: lỗi xác thực), chúng tôi sẽ trả về lỗi cấp RPC. Hãy truy cập https://developers.google.com/google-ads/api/docs/best-practices/partial-failures để biết thêm thông tin về lỗi một phần. |
results[] |
Được trả về cho các mức điều chỉnh lượt chuyển đổi đã xử lý thành công. Proto sẽ trống đối với các hàng nhận lỗi. Kết quả không được trả về khi validationOnly là true. |
jobId |
Mã công việc cho lô tải lên. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/adwords
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
ConversionAdjustment
Mức điều chỉnh cho lượt chuyển đổi.
Biểu diễn dưới dạng JSON |
---|
{ "gclidDateTimePair": { object ( |
Các trường | |
---|---|
gclidDateTimePair |
Đối với mức điều chỉnh, mã này xác định duy nhất một lượt chuyển đổi được báo cáo mà không có mã đơn hàng được chỉ định. Nếu AdjustType là NÂNG CAO, thì giá trị này là không bắt buộc nhưng có thể được đặt ngoài mã đơn hàng. |
adjustmentType |
Loại mức điều chỉnh. |
restatementValue |
Thông tin cần thiết để khôi phục giá trị của lượt chuyển đổi. Bắt buộc đối với việc sửa đổi. Không được cung cấp thông tin cho yêu cầu rút lại. Chúng tôi sẽ trả lại lỗi nếu yêu cầu rút lại đơn khiếu nại. LƯU Ý: Nếu bạn muốn tải lên nội dung sửa đổi thứ hai có giá trị được điều chỉnh khác, thì nội dung sửa đổi đó phải có thời gian xuất hiện điều chỉnh mới hơn gần đây hơn. Nếu không, chính sách này sẽ được xem là trùng lặp của lần sửa đổi lại trước đó và bị bỏ qua. |
userIdentifiers[] |
Giá trị nhận dạng người dùng để cải thiện lượt chuyển đổi gốc. ConvertTermsUploadService chỉ chấp nhận giá trị nhận dạng người dùng trong các tính năng nâng cao. Số lượng giá trị nhận dạng người dùng tối đa cho mỗi tính năng nâng cao là 5. |
orderId |
Mã đơn hàng của lượt chuyển đổi cần điều chỉnh. Nếu lượt chuyển đổi được báo cáo với một mã đơn hàng được chỉ định, thì bạn phải sử dụng mã đơn hàng đó làm giá trị nhận dạng tại đây. Bạn cần có mã đơn hàng để áp dụng các tính năng nâng cao. |
conversionAction |
Tên tài nguyên của hành động chuyển đổi được liên kết với mức điều chỉnh lượt chuyển đổi này. Lưu ý: Mặc dù tên tài nguyên này bao gồm mã khách hàng và mã hành động chuyển đổi, nhưng việc xác thực sẽ bỏ qua mã khách hàng và sử dụng mã hành động chuyển đổi làm giá trị nhận dạng duy nhất của hành động chuyển đổi đó. |
adjustmentDateTime |
Ngày giờ xảy ra hoạt động điều chỉnh. Phải sau conversionDateTime. Bạn phải chỉ định múi giờ. Định dạng là "yyyy-mm-dd hh:mm:ss+|-hh:mm", ví dụ: "2019-01-01 12:32:45-08:00". |
userAgent |
Tác nhân người dùng để cải thiện lượt chuyển đổi ban đầu. Bạn có thể xem thông tin này trong tiêu đề của yêu cầu HTTP của người dùng khi họ chuyển đổi trên trang web của bạn. Ví dụ: " Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". Bạn chỉ có thể chỉ định tác nhân người dùng trong các tính năng nâng cao bằng giá trị nhận dạng người dùng. URL này phải khớp với tác nhân người dùng của yêu cầu đã gửi lượt chuyển đổi ban đầu để lượt chuyển đổi và tính năng nâng cao của nó đều được phân bổ dưới dạng trên cùng một thiết bị hoặc đều được phân bổ dưới dạng trên nhiều thiết bị. |
GclidDateTimePair
Xác định duy nhất một lượt chuyển đổi được báo cáo mà không chỉ định mã đơn hàng.
Biểu diễn dưới dạng JSON |
---|
{ "gclid": string, "conversionDateTime": string } |
Các trường | |
---|---|
gclid |
Mã lượt nhấp của Google (gclid) được liên kết với lượt chuyển đổi ban đầu cho mức điều chỉnh này. |
conversionDateTime |
Ngày giờ xảy ra lượt chuyển đổi ban đầu cho nội dung điều chỉnh này. Bạn phải chỉ định múi giờ. Định dạng là "yyyy-mm-dd hh:mm:ss+|-hh:mm", ví dụ: "2019-01-01 12:32:45-08:00". |
ConversionAdjustmentType
Các hành động khác nhau mà nhà quảng cáo có thể thực hiện để điều chỉnh số lượt chuyển đổi mà họ đã báo cáo. Rút lại phủ định một chuyển đổi. Phần sửa đổi thay đổi giá trị của lượt chuyển đổi.
Enum | |
---|---|
UNSPECIFIED |
Chưa xác định. |
UNKNOWN |
Đại diện cho giá trị không xác định trong phiên bản này. |
RETRACTION |
Phủ định một lượt chuyển đổi sao cho tổng giá trị và số lượng của lượt chuyển đổi đó đều bằng 0. |
RESTATEMENT |
Thay đổi giá trị của một lượt chuyển đổi. |
ENHANCEMENT |
Bổ sung một lượt chuyển đổi hiện có bằng giá trị nhận dạng người dùng và tác nhân người dùng được cung cấp mà Google có thể sử dụng để cải thiện số lượt chuyển đổi. |
RestatementValue
Chứa thông tin cần thiết để khôi phục giá trị của lượt chuyển đổi.
Biểu diễn dưới dạng JSON |
---|
{ "adjustedValue": number, "currencyCode": string } |
Các trường | |
---|---|
adjustedValue |
Giá trị lượt chuyển đổi được khôi phục. Đây là giá trị của lượt chuyển đổi sau khi sửa đổi. Ví dụ: để thay đổi giá trị của một lượt chuyển đổi từ 100 thành 70, bạn phải báo cáo giá trị đã điều chỉnh là 70. LƯU Ý: Nếu bạn muốn tải lên nội dung sửa đổi thứ hai có giá trị được điều chỉnh khác, thì nội dung sửa đổi đó phải có thời gian xuất hiện điều chỉnh mới hơn gần đây hơn. Nếu không, chính sách này sẽ được xem là trùng lặp của lần sửa đổi lại trước đó và bị bỏ qua. |
currencyCode |
Đơn vị tiền tệ của giá trị được khôi phục. Nếu bạn không cung cấp đơn vị tiền tệ thì đơn vị tiền tệ mặc định của hành động chuyển đổi sẽ được sử dụng. Nếu bạn không đặt đơn vị tiền tệ đó, thì đơn vị tiền tệ của tài khoản sẽ được sử dụng. Đây là mã đơn vị tiền tệ gồm 3 ký tự theo tiêu chuẩn ISO 4217, ví dụ: USD hoặc EUR. |
ConversionAdjustmentResult
Thông tin xác định một Mức điều chỉnh cho lượt chuyển đổi đã được xử lý thành công.
Biểu diễn dưới dạng JSON |
---|
{ "gclidDateTimePair": { object ( |
Các trường | |
---|---|
gclidDateTimePair |
GCLID và thời gian ngày chuyển đổi của lượt chuyển đổi. |
orderId |
Mã đơn hàng của lượt chuyển đổi cần điều chỉnh. |
adjustmentType |
Loại mức điều chỉnh. |
conversionAction |
Tên tài nguyên của hành động chuyển đổi được liên kết với mức điều chỉnh lượt chuyển đổi này. |
adjustmentDateTime |
Ngày giờ xảy ra hoạt động điều chỉnh. Định dạng là "yyyy-mm-dd hh:mm:ss+|-hh:mm", ví dụ: "2019-01-01 12:32:45-08:00". |