- JSON 表示法
- OfflineUserDataJobType
- OfflineUserDataJobStatus
- OfflineUserDataJobFailureReason
- OfflineUserDataJobMetadata
- OfflineUserDataJobMatchRateRange
- StoreSalesMetadata
- StoreSalesThirdPartyMetadata
包含将要异步处理的用户名单成员的离线用户数据的作业。无法读取上传的数据,作业的处理结果只能使用 GoogleAdsService.Search/SearchStream 读取。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
不可变。离线用户数据作业的资源名称。离线用户数据作业资源名称采用以下格式:
|
type |
不可变。作业的类型。 |
status |
仅供输出。作业的状态。 |
failureReason |
仅供输出。处理失败的原因(如果状态为 FAILED)。 |
operationMetadata |
仅供输出。描述匹配率范围的线下用户数据作业的元数据。 |
id |
仅供输出。此离线用户数据作业的 ID。 |
externalId |
不可变。用户指定的作业 ID。 |
联合字段 metadata 。作业的元数据。metadata 只能是下列其中一项: |
|
customerMatchUserListMetadata |
不可变。用于对基于 CRM 的用户名单进行数据更新的元数据。 |
storeSalesMetadata |
不可变。用于更新实体店销售数据的元数据。 |
OfflineUserDataJobType
离线用户数据作业的类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
STORE_SALES_UPLOAD_FIRST_PARTY |
用于自助服务的实体店销售直接数据。 |
STORE_SALES_UPLOAD_THIRD_PARTY |
第三方的实体店销售直接数据。 |
CUSTOMER_MATCH_USER_LIST |
目标客户匹配用户名单数据。 |
CUSTOMER_MATCH_WITH_ATTRIBUTES |
使用属性数据的目标客户匹配。 |
OfflineUserDataJobStatus
离线用户数据作业的状态。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
PENDING |
该作业已成功创建,正在等待上传。 |
RUNNING |
上传内容已被接受,数据正在处理中。 |
SUCCESS |
已成功处理上传的数据。 |
FAILED |
未能处理上传的数据。 |
OfflineUserDataJobFailureReason
离线用户数据作业失败的原因。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
INSUFFICIENT_MATCHED_TRANSACTIONS |
匹配的交易次数不足。 |
INSUFFICIENT_TRANSACTIONS |
上传的交易次数不足。 |
HIGH_AVERAGE_TRANSACTION_VALUE |
您账号的平均交易金额异常高。如果确实如此,请与支持团队联系,申请破例。有关详情,请访问 https://support.google.com/google-ads/answer/10018944#transaction_value |
LOW_AVERAGE_TRANSACTION_VALUE |
您账号的平均交易金额异常低。如果确实如此,请与支持团队联系,申请破例。有关详情,请访问 https://support.google.com/google-ads/answer/10018944#transaction_value |
NEWLY_OBSERVED_CURRENCY_CODE |
有一种您以前没有在上传内容中使用过的货币代码。如果确实如此,请与支持团队联系,申请破例。有关详情,请访问 https://support.google.com/google-ads/answer/10018944#Unrecognized_currency |
OfflineUserDataJobMetadata
离线用户数据作业的元数据。
JSON 表示法 |
---|
{
"matchRateRange": enum ( |
字段 | |
---|---|
matchRateRange |
仅供输出。上传的目标客户匹配用户名单的匹配率。描述当职位状态为“RUNNING”时的估算匹配率,以及当职位状态为“SUCCESS/FAILED”后有最终匹配率时,预计匹配率。 |
OfflineUserDataJobMatchRateRange
线下用户数据作业的匹配率范围。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
匹配率范围的默认值。 |
MATCH_RANGE_LESS_THAN_20 |
线下数据上传实体的匹配率范围介于 0% 到 19% 之间。 |
MATCH_RANGE_20_TO_30 |
线下数据上传实体的匹配率范围介于 20% 到 30% 之间。 |
MATCH_RANGE_31_TO_40 |
线下数据上传实体的匹配率范围介于 31% 到 40% 之间。 |
MATCH_RANGE_41_TO_50 |
线下数据上传实体的匹配率范围介于 41% 到 50% 之间。 |
MATCH_RANGE_51_TO_60 |
线下数据上传实体的匹配率范围在 51% 到 60% 之间。 |
MATCH_RANGE_61_TO_70 |
线下数据上传实体的匹配率范围介于 61% 到 70% 之间。 |
MATCH_RANGE_71_TO_80 |
线下数据上传实体的匹配率范围介于 71% 到 80% 之间。 |
MATCH_RANGE_81_TO_90 |
线下数据上传实体的匹配率范围在 81% 到 90% 之间。 |
MATCH_RANGE_91_TO_100 |
线下数据上传实体的匹配率范围大于或等于 91%。 |
StoreSalesMetadata
实体店销售(直接上传)的元数据。
JSON 表示法 |
---|
{
"thirdPartyMetadata": {
object ( |
字段 | |
---|---|
thirdPartyMetadata |
第三方实体店销售上传的元数据。 |
loyaltyFraction |
这是所有可识别的交易(例如,与任何形式的客户信息关联的交易)所占的比例。必需。该比例必须介于 0 到 1 之间(不包括 0)。 |
transactionUploadFraction |
这是您上传的销售额与可与客户相关联的总销售额的比率。必需。该比例必须介于 0 到 1 之间(不包括 0)。例如,如果您上传的销售额占可以与某个客户相关联的总销售额的一半,则该值将为 0.5。 |
customKey |
实体店销售自定义变量键的名称。可以先应用于交易,稍后再在报告中用于自定义细分的预定义键。只有许可名单中的客户才能访问。 |
StoreSalesThirdPartyMetadata
第三方实体店销售的元数据。此产品仅面向许可名单中的客户。如需详细了解上传配置,请与您的 Google 业务发展代表联系。
JSON 表示法 |
---|
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string } |
字段 | |
---|---|
advertiserUploadDateTime |
广告客户将数据上传到合作伙伴的时间。必需。其格式为“YYYY-MM-DD HH:MM:SS”。示例:“2018-03-05 09:15:00”或“2018-02-01 14:34:30” |
validTransactionFraction |
有效交易所占的比例。无效交易可能包含无效的格式或值无效。必需。该比例必须介于 0 到 1 之间(不包括 0)。 |
partnerMatchFraction |
与合作伙伴端的第三方分配的用户 ID 匹配的有效交易所占的比例。必需。该比例必须介于 0 到 1 之间(不包括 0)。 |
partnerUploadFraction |
合作伙伴上传到 Google 的有效交易所占的比例。必需。该比例必须介于 0 到 1 之间(不包括 0)。 |
bridgeMapVersionId |
用于上传的合作伙伴 ID 的版本。必填。 |
partnerId |
更新交易 Feed 的第三方合作伙伴的 ID。 |