Method: customers.uploadClickConversions

处理指定的点击转化。

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

HTTP 请求

POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadClickConversions

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

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

请求正文

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

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

object (ClickConversion)

必需。要上传的转化数据。
partialFailure

boolean

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

boolean

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

boolean

如果为 true，该 API 将执行所有上传检查，如果发现错误，则返回错误。如果为 false，它将仅执行基本的输入验证，跳过后续的上传检查，并且即使未找到提供的 userIdentifiers 的任何点击，也会返回成功。

此设置只会影响使用 userIdentifiers（而非 GCLID、GBRAID 或 WBRAID）的潜在客户上传的增强型转化。上传增强型潜在客户转化时，您应将所有转化事件都上传到该 API，包括可能并非来自 Google Ads 广告系列的转化事件。如果此字段设为“true”，那么上传并非来自 Google Ads 广告系列的事件将导致 CLICK_NOT_FOUND 错误。由于这些错误在发生此类事件时会出现，因此将此字段设置为 false，以便确认上传内容的格式是否正确，同时忽略所有并非来自 Google Ads 广告系列的所有转化中的 CLICK_NOT_FOUND 错误。这样，您就可以只关注您能够解决的错误。

默认值为 false。
jobId

integer

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

响应正文

ConversionUploadService.UploadClickConversions 的响应消息。

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

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

object (Status)

与部分失败模式下的转化失败相关的错误。当转化中的所有错误都发生时，系统会返回此错误代码。如果转化之外发生任何错误（例如身份验证错误），我们将返回 RPC 级错误。如需详细了解部分失败，请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。
results[]

object (ClickConversionResult)

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

string (int64 format)

批量上传的作业 ID。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。

ClickConversion

点击转化。

JSON 表示法 
{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "consent": {
    object (Consent)
  },
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
字段
gbraid

string

与应用转化相关联且来自 iOS 设备的点击（从 iOS14 开始）的点击标识符。
wbraid

string

与网站转化相关联且来自 iOS 设备的点击（从 iOS14 开始）的点击标识符。
externalAttributionData

object (ExternalAttributionData)

有关外部归因转化的其他数据。对于包含外部归因的转化操作的转化，此字段是必填字段，但不应另外设置此字段。
customVariables[]

object (CustomVariable)

与此转化相关联的自定义变量。
cartData

object (CartData)

与此转化相关联的购物车数据。
userIdentifiers[]

object (UserIdentifier)

与此转化相关联的用户标识符。转化数据上传仅支持 hashedEmail 和 hashedPhoneNumber。每次转化的用户标识符不能超过 5 个。
conversionEnvironment

enum (ConversionEnvironment)

记录此次转化的环境，例如“应用”或“网站”。
consent

object (Consent)

事件的用户意见征求设置。
gclid

string

与此转化相关联的 Google 点击 ID (gclid)。
conversionAction

string

与此转化相关联的转化操作的资源名称。注意：虽然此资源名称由客户 ID 和转化操作 ID 组成，但验证时会忽略客户 ID，并将转化操作 ID 用作转化操作的唯一标识符。
conversionDateTime

string

转化的发生日期。必须晚于点击时间。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。
conversionValue

number

广告客户的转化价值。
currencyCode

string

与转化价值相关联的币种。这是由 3 个字符组成的 ISO 4217 货币代码。例如：USD、EUR。
orderId

string

与转化相关联的订单 ID。对于每项转化操作，一个订单 ID 只能用于一次转化。

ExternalAttributionData

包含有关外部归因转化的更多信息。

JSON 表示法 
{
  "externalAttributionCredit": number,
  "externalAttributionModel": string
}
字段
externalAttributionCredit

number

表示归因于 Google Ads 点击的转化所占的比例。
externalAttributionModel

string

指定归因模型名称。

CartData

包含有关购物车数据的其他信息。

JSON 表示法 
{
  "merchantId": string,
  "feedCountryCode": string,
  "feedLanguageCode": string,
  "localTransactionCost": number,
  "items": [
    {
      object (Item)
    }
  ]
}
字段
merchantId

string (int64 format)

上传内容的 Merchant Center ID。
feedCountryCode

string

您用来上传商品数据的 Feed 所关联的国家/地区代码。
feedLanguageCode

string

您用来上传商品数据的 Feed 所关联的语言代码。
localTransactionCost

number

所有交易级折扣的总和，例如适用于整个购物车的免运费和优惠券折扣。货币代码与 ClickConversion 消息中的货币代码相同。
items[]

object (Item)

所购商品的数据。

商品

包含所购商品的数据。

JSON 表示法 
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
字段
productId

string

商品的购物 ID。必须等于 Merchant Center 商品标识码。
quantity

integer

售出的商品数量。
unitPrice

number

单价（不含税、运费及任何交易级折扣）。货币代码与 ClickConversion 消息中的货币代码相同。

ConversionEnvironment

上传的转化数据的转化环境。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
APP 这次转化是在一款应用中记录的。
WEB 这次转化被记录在一个网站上。

ClickConversionResult

成功处理的 ClickConversion 的标识信息。

JSON 表示法 
{
  "gbraid": string,
  "wbraid": string,
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
字段
gbraid

string

与应用转化相关联且来自 iOS 设备的点击（从 iOS14 开始）的点击标识符。
wbraid

string

与网站转化相关联且来自 iOS 设备的点击（从 iOS14 开始）的点击标识符。
userIdentifiers[]

object (UserIdentifier)

与此转化相关联的用户标识符。转化数据上传仅支持 hashedEmail 和 hashedPhoneNumber。每次转化的用户标识符不能超过 5 个。
gclid

string

与此转化相关联的 Google 点击 ID (gclid)。
conversionAction

string

与此转化相关联的转化操作的资源名称。
conversionDateTime

string

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