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。