Method: customers.uploadConversionAdjustments

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/v14/customers/{customerId}:uploadConversionAdjustments

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

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 (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Các trường
conversionAdjustments[]

object (ConversionAdjustment)

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

boolean

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

boolean

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ả.

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 (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Các trường
partialFailureError

object (Status)

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[]

object (ConversionAdjustmentResult)

Đượ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

string (int64 format)

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 (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Các trường
gclidDateTimePair

object (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

enum (ConversionAdjustmentType)

Loại mức điều chỉnh.
restatementValue

object (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[]

object (UserIdentifier)

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

string

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

string

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

string

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

string

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

string

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

string

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

number

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

string

Đơ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 (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Các trường
gclidDateTimePair

object (GclidDateTimePair)

GCLID và thời gian ngày chuyển đổi của lượt chuyển đổi.
orderId

string

Mã đơn hàng của lượt chuyển đổi cần điều chỉnh.
adjustmentType

enum (ConversionAdjustmentType)

Loại mức điều chỉnh.
conversionAction

string

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

string

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".