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)

仅限输出。上传的目标客户匹配用户名单的匹配率。描述作业状态为“正在运行”时的估算匹配率，以及作业状态为“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。