- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- 试试看!
处理指定的转化调整。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadConversionAdjustments
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。执行上传的客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"conversionAdjustments": [
{
object ( |
字段 | |
---|---|
conversionAdjustments[] |
必需。将上传的转化调整。 |
partialFailure |
必需。如果为 true,则会执行成功的操作,并且无效操作将返回错误。如果为 false,则当且仅当所有操作均有效时,所有操作都将在一个事务中执行。此字段应始终设为 true。如需详细了解部分失败,请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
validateOnly |
如果为 true,则对请求进行验证,但不会执行该请求。系统只会返回错误,不会返回结果。 |
响应正文
ConversionAdjustmentUploadService.UploadConversionAdjustments
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "partialFailureError": { object ( |
字段 | |
---|---|
partialFailureError |
与部分失败模式下的转化调整失败相关的错误。当调整内发生所有错误时返回。如果在调整范围之外发生任何错误(例如身份验证错误),我们将返回 RPC 级错误。如需详细了解部分失败,请参阅 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
results[] |
已成功处理转化调整后返回。对于收到错误的行,Proto 将为空。当 verifyOnly 为 true 时,不返回结果。 |
jobId |
批量上传的作业 ID。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
ConversionAdjustment
转化调整。
JSON 表示法 |
---|
{ "gclidDateTimePair": { object ( |
字段 | |
---|---|
gclidDateTimePair |
对于调整项,用于唯一标识在未指定订单 ID 的情况下报告的转化。如果调整项类型为 ENHANCEMENT,则该值是可选的,但可以与 orderId 一同设置。 |
adjustmentType |
调整类型。 |
restatementValue |
重报转化价值所需的信息。重报时必填。不应为撤消请求提供。如果提供了用于撤消的操作,将返回错误。注意:如果您想上传具有不同调整后值的第二次重报,则必须具有较新的调整发生时间。否则,它就会被视为与之前的重报操作重复,并被忽略。 |
userIdentifiers[] |
用于提升原始转化的用户标识符。ConversionAdjustmentUploadService 仅接受增强中的用户标识符。每项增强功能的用户标识符数量上限为 5 个。 |
orderId |
要调整的转化的订单 ID。如果报告转化时指定了订单 ID,则必须在此处使用该订单 ID 作为标识符。必须提供订单 ID 才能进行增强。 |
conversionAction |
与此转化调整相关联的转化操作的资源名称。注意:虽然此资源名称由客户 ID 和转化操作 ID 组成,但验证时会忽略客户 ID,并将转化操作 ID 用作转化操作的唯一标识符。 |
adjustmentDateTime |
调整项发生的日期和时间。必须晚于 conversionDateTime。必须指定时区。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
userAgent |
用于提升原始转化的用户代理。当用户在您的网站上完成转化时,可以在其 HTTP 请求标头中找到此信息。例如“Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)”。用户代理只能在包含用户标识符的增强功能中指定。这应与发送原始转化的请求的用户代理一致,以便相应转化及其增强功能会同时归因于同一设备,或同时归因于跨设备。 |
GclidDateTimePair
可唯一标识在未指定订单 ID 的情况下报告的转化。
JSON 表示法 |
---|
{ "gclid": string, "conversionDateTime": string } |
字段 | |
---|---|
gclid |
与此调整的原始转化相关联的 Google 点击 ID (gclid)。 |
conversionDateTime |
此调整的原始转化的发生日期。必须指定时区。格式为“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 |
重报的转化价值。这是重报后的转化价值。例如,要将转化价值从 100 更改为 70,应报告调整后的价值 70。注意:如果您想上传具有不同调整后值的第二次重报,则必须具有较新的调整发生时间。否则,它就会被视为与之前的重报操作重复,并被忽略。 |
currencyCode |
重报价值的币种。如果未提供该币种,系统会使用转化操作的默认币种;如果未设置默认币种,则系统会使用帐号币种。这是由 3 个字符组成的 ISO 4217 货币代码,例如 USD 或 EUR。 |
ConversionAdjustmentResult
标识已成功处理的 Conversion 调整 的信息。
JSON 表示法 |
---|
{ "gclidDateTimePair": { object ( |
字段 | |
---|---|
gclidDateTimePair |
转化的 GCLID 和转化日期时间。 |
orderId |
要调整的转化的订单 ID。 |
adjustmentType |
调整类型。 |
conversionAction |
与此转化调整相关联的转化操作的资源名称。 |
adjustmentDateTime |
调整项发生的日期和时间。格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |