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)

仅限输出。上传的目标客户匹配用户名单的匹配率。描述作业状态为“正在运行”时的估算匹配率，以及作业状态为“已成功/已失败”且可用最终匹配率时的最终匹配率。

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。