OfflineUserDataJob

包含将要异步处理的用户名单成员的离线用户数据的作业。无法读取上传的数据，作业的处理结果只能使用 GoogleAdsService.Search/SearchStream 读取。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}
字段
resourceName

string

不可变。离线用户数据作业的资源名称。离线用户数据作业资源名称采用以下格式：

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}
type

enum (OfflineUserDataJobType)

不可变。作业的类型。
status

enum (OfflineUserDataJobStatus)

仅供输出。作业的状态。
failureReason

enum (OfflineUserDataJobFailureReason)

仅供输出。处理失败的原因（如果状态为 FAILED）。
operationMetadata

object (OfflineUserDataJobMetadata)

仅供输出。描述匹配率范围的线下用户数据作业的元数据。
id

string (int64 format)

仅供输出。此离线用户数据作业的 ID。
externalId

string (int64 format)

不可变。用户指定的作业 ID。
联合字段 metadata。作业的元数据。metadata 只能是下列其中一项：
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

不可变。用于对基于 CRM 的用户名单进行数据更新的元数据。
storeSalesMetadata

object (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 (OfflineUserDataJobMatchRateRange)
}
字段
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

仅供输出。上传的目标客户匹配用户名单的匹配率。描述当职位状态为“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 (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
字段
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

第三方实体店销售上传的元数据。
loyaltyFraction

number

这是所有可识别的交易（例如，与任何形式的客户信息关联的交易）所占的比例。必需。该比例必须介于 0 到 1 之间（不包括 0）。
transactionUploadFraction

number

这是您上传的销售额与可与客户相关联的总销售额的比率。必需。该比例必须介于 0 到 1 之间（不包括 0）。例如，如果您上传的销售额占可以与某个客户相关联的总销售额的一半，则该值将为 0.5。
customKey

string

实体店销售自定义变量键的名称。可以先应用于交易，稍后再在报告中用于自定义细分的预定义键。只有许可名单中的客户才能访问。

StoreSalesThirdPartyMetadata

第三方实体店销售的元数据。此产品仅面向许可名单中的客户。如需详细了解上传配置，请与您的 Google 业务发展代表联系。

JSON 表示法 
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
字段
advertiserUploadDateTime

string

广告客户将数据上传到合作伙伴的时间。必需。其格式为“YYYY-MM-DD HH:MM:SS”。示例：“2018-03-05 09:15:00”或“2018-02-01 14:34:30”
validTransactionFraction

number

有效交易所占的比例。无效交易可能包含无效的格式或值无效。必需。该比例必须介于 0 到 1 之间（不包括 0）。
partnerMatchFraction

number

与合作伙伴端的第三方分配的用户 ID 匹配的有效交易所占的比例。必需。该比例必须介于 0 到 1 之间（不包括 0）。
partnerUploadFraction

number

合作伙伴上传到 Google 的有效交易所占的比例。必需。该比例必须介于 0 到 1 之间（不包括 0）。
bridgeMapVersionId

string

用于上传的合作伙伴 ID 的版本。必填。
partnerId

string (int64 format)

更新交易 Feed 的第三方合作伙伴的 ID。