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 đã gửi: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Yêu cầu HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments

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

Tham số đường dẫn

Tham số
customerId

string

Bắt buộc. Mã của khách hàng thực hiện việc 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,
  "jobId": integer
}
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 khi 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 (đúng). Hãy tham khảo 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, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả.
jobId

integer

Không bắt buộc. Mục nhập tùy chọn để đặt mã công việc. Phải là một số không âm và nhỏ hơn 2^31 nếu cho sẵn. Nếu trường này không được cung cấp, API sẽ tạo một mã công việc trong phạm vi [2^31, (2^63)-1]. API sẽ trả về giá trị cho yêu cầu này trong trường jobId của UploadConversionAdjustmentsResponse.

Nội dung phản hồi

Tin nhắn phản hồ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
}
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. Được trả về khi tất cả lỗi xảy ra trong các mức điều chỉnh. Nếu có bất kỳ lỗi nào xảy ra 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 tham khảo 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 được xử lý thành công. Proto sẽ trống đối với các hàng nhận được lỗi. Kết quả không được trả về khi AuthenticationOnly 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
}
Trường
gclidDateTimePair

object (GclidDateTimePair)

Đối với mức điều chỉnh, giá trị này 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. Nếu AdjustType là ENHANCEMENT, 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 điều chỉnh.
restatementValue

object (RestatementValue)

Thông tin cần thiết để phục hồi giá trị của lượt chuyển đổi. Bắt buộc để sửa đổi. Không nên cung cấp thông tin 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 lần sửa đổi thứ hai có giá trị điều chỉnh khác, lần 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, giá trị này sẽ được coi là bản sao 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. ConversionAdjustUploadService 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 sẽ được điều chỉnh. Nếu lượt chuyển đổi được báo cáo bằng mã đơn hàng đã 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 phải 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 tháng xảy ra điều chỉnh. Phải sau conversionDateTime. 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ể tìm thấy mã 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 có giá trị nhận dạng người dùng. Đối tượng 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. Như vậy, lượt chuyển đổi và tính năng nâng cao đều phải được phân bổ trên cùng một thiết bị hoặc được phân bổ 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
}
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 xảy ra lượt chuyển đổi ban đầu cho hoạt động điều chỉnh này. 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 các lượt chuyển đổi mà họ đã báo cáo. Rút lại phủ định chuyển đổi. Sửa đổi lại thay đổi giá trị của chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ đị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 để nâng cao số lượt chuyển đổi.

RestatementValue

Chứa thông tin cần thiết để phục hồi giá trị của một lượt chuyển đổi.

Biểu diễn dưới dạng JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
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 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 lần sửa đổi thứ hai có giá trị điều chỉnh khác, lần 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, giá trị này sẽ được coi là bản sao 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 đặt đơn vị tiền tệ này thì hệ thống sẽ sử dụng đơn vị tiền tệ mặc định của hành động chuyển đổi. Nếu bạn không đặt đơn vị tiền tệ này, thì hệ thống sẽ sử dụng đơn vị tiền tệ của tài khoản. Đâ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 Lượt điều chỉnh 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
}
Trường
gclidDateTimePair

object (GclidDateTimePair)

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

string

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

enum (ConversionAdjustmentType)

Loại đ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 tháng xảy ra đ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".