- HTTP 请求
- 路径参数
- 请求正文
- 响应正文
- 授权范围
- ConversionAdjustment
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- GclidDateTimePair
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ConversionAdjustmentType
- RestatementValue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ConversionAdjustmentResult
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 试试看!
处理指定的转化调整。
抛出的错误列表:AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v17/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,则系统会验证该请求,但不会执行该请求。仅返回错误,不返回结果。 |
jobId |
可选。用于设置作业 ID 的可选输入。必须是小于 2^31 的非负数(如果提供)。如果未提供此字段,API 将生成 [2^31, (2^63)-1] 范围内的职位 ID。API 将在 |
响应正文
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。如果 adjustmentType 为 ENHANCEMENT,则此值是可选的,但可在 orderId 的补充之外进行设置。 |
adjustmentType |
调整类型。 |
restatementValue |
重报转化价值所需的信息。必填(用于重报)。不应提供用于撤消请求。如果提供撤消请求,系统会返回错误。注意:如果您要使用其他调整后值上传第二次重报,则必须使用较新的新调整发生时间。否则,它就会被视为与前一个重报的重复内容并被忽略。 |
userIdentifiers[] |
用于增强原始转化的用户标识符。ConversionAdjustUploadService 只接受增强中的用户标识符。每项增强功能的用户标识符数量上限为 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 请求标头中找到此 ID。例如,“Mozilla/5.0(iPhone;CPU iPhone OS 12_2,如 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
标识已成功处理的 ConversionAdjustment 的信息。
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”。 |