Method: customers.uploadConversionAdjustments

处理指定的转化调整。

抛出的错误列表：AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。执行上传的客户 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
字段
conversionAdjustments[]

object (ConversionAdjustment)

必需。上传的转化调整。
partialFailure

boolean

必需。如果值为 true，则系统将执行成功的操作，而无效操作将返回错误。如果为 false，则当且仅当所有操作都有效时，才会在一个事务中执行所有操作。此字段应始终设置为 true。如需详细了解部分失败的操作，请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。
validateOnly

boolean

如果为 true，则系统会验证该请求，但不会执行该请求。仅返回错误，不返回结果。
jobId

integer

可选。用于设置作业 ID 的可选输入。必须是小于 2^31 的非负数（如果提供）。如果未提供此字段，API 将生成 [2^31, (2^63)-1] 范围内的职位 ID。API 将在 UploadConversionAdjustmentsResponse 的 jobId 字段中返回此请求的值。

响应正文

ConversionAdjustmentUploadService.UploadConversionAdjustments 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
字段
partialFailureError

object (Status)

与部分失败模式下的转化调整失败相关的错误。当调整内发生所有错误时返回。如果调整范围外出现任何错误（例如身份验证错误），我们将返回 RPC 级别的错误。如需详细了解部分失败的操作，请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。
results[]

object (ConversionAdjustmentResult)

针对成功处理的转化调整返回。如果行收到错误，Proto 将为空。当 VerifyOnly 为 true 时，不返回结果。
jobId

string (int64 format)

批量上传的作业 ID。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/adwords

如需了解详情，请参阅 OAuth 2.0 概览。

ConversionAdjustment

转化调整。

JSON 表示法 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
字段
gclidDateTimePair

object (GclidDateTimePair)

对于调整项，此属性可唯一标识报告的转化，但未指定订单 ID。如果 adjustmentType 为 ENHANCEMENT，则此值是可选的，但可在 orderId 的补充之外进行设置。
adjustmentType

enum (ConversionAdjustmentType)

调整类型。
restatementValue

object (RestatementValue)

重报转化价值所需的信息。必填（用于重报）。不应提供用于撤消请求。如果提供撤消请求，系统会返回错误。注意：如果您要使用其他调整后值上传第二次重报，则必须使用较新的新调整发生时间。否则，它就会被视为与前一个重报的重复内容并被忽略。
userIdentifiers[]

object (UserIdentifier)

用于增强原始转化的用户标识符。ConversionAdjustUploadService 只接受增强中的用户标识符。每项增强功能的用户标识符数量上限为 5 个。
orderId

string

要调整的转化的订单 ID。如果报告转化时指定了订单 ID，则必须将订单 ID 用作此处的标识符。必须提供订单 ID 才能实现增强。
conversionAction

string

与此转化调整相关联的转化操作的资源名称。注意：尽管此资源名称由客户 ID 和转化操作 ID 组成，但在验证过程中，系统会忽略客户 ID，而将转化操作 ID 用作转化操作的唯一标识符。
adjustmentDateTime

string

调整项发生的日期时间。必须晚于 conversionDateTime。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。
userAgent

string

用于增强原始转化的用户代理。用户在网页上完成转化时，可以在其 HTTP 请求标头中找到此 ID。例如，“Mozilla/5.0（iPhone；CPU iPhone OS 12_2，如 Mac OS X）”。只能在带有用户标识符的增强功能中指定用户代理。这应与发送原始转化的请求的用户代理一致，因此该转化及其增强选项要么都归因于同一设备，要么都归因于跨设备。

GclidDateTimePair

用于唯一标识报告的转化，但未指定订单 ID。

JSON 表示法 
{
  "gclid": string,
  "conversionDateTime": string
}
字段
gclid

string

与此调整对应的原始转化相关联的 Google 点击 ID (gclid)。
conversionDateTime

string

此调整对应的原始转化发生的日期时间。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。

ConversionAdjustmentType

广告客户可以采取的不同操作来调整已报告的转化。撤消会让转化无效。重报会改变转化价值。

枚举
UNSPECIFIED 未指定。
UNKNOWN 表示此版本中未知的值。
RETRACTION 对转化进行求反，使其总价值和计数均为零。
RESTATEMENT 更改转化价值。
ENHANCEMENT 使用提供的用户标识符和用户代理对现有转化进行补充，Google 可以使用这些信息来提高转化次数。

RestatementValue

包含重报转化价值所需的信息。

JSON 表示法 
{
  "adjustedValue": number,
  "currencyCode": string
}
字段
adjustedValue

number

重申的转化价值。这是重报后的转化价值。例如，要将转化价值从 100 改为 70，应报告调整后的值 70。注意：如果您要使用其他调整后值上传第二次重报，则必须使用较新的新调整发生时间。否则，它就会被视为与前一个重报的重复内容并被忽略。
currencyCode

string

重报值的币种。如果未提供此项，则系统会使用转化操作中的默认币种；如果未设置，则使用账号中的币种。这是由 3 个字符组成的 ISO 4217 货币代码，例如 USD 或 EUR。

ConversionAdjustmentResult

标识已成功处理的 ConversionAdjustment 的信息。

JSON 表示法 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
字段
gclidDateTimePair

object (GclidDateTimePair)

转化的 GCLID 和转化日期时间。
orderId

string

要调整的转化的订单 ID。
adjustmentType

enum (ConversionAdjustmentType)

调整类型。
conversionAction

string

与此转化调整相关联的转化操作的资源名称。
adjustmentDateTime

string

调整项发生的日期时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。