Customer

客户。

JSON 表示法
{
  "resourceName": string,
  "callReportingSetting": {
    object (CallReportingSetting)
  },
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "remarketingSetting": {
    object (RemarketingSetting)
  },
  "payPerConversionEligibilityFailureReasons": [
    enum (CustomerPayPerConversionEligibilityFailureReason)
  ],
  "optimizationScoreWeight": number,
  "status": enum (CustomerStatus),
  "offlineConversionClientSummaries": [
    {
      object (OfflineConversionClientSummary)
    }
  ],
  "customerAgreementSetting": {
    object (CustomerAgreementSetting)
  },
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "hasPartnersBadge": boolean,
  "manager": boolean,
  "testAccount": boolean,
  "optimizationScore": number,
  "locationAssetAutoMigrationDone": boolean,
  "imageAssetAutoMigrationDone": boolean,
  "locationAssetAutoMigrationDoneDateTime": string,
  "imageAssetAutoMigrationDoneDateTime": string
}
字段
resourceName

string

不可变。客户的资源名称。客户资源名称采用以下格式:

customers/{customerId}

callReportingSetting

object (CallReportingSetting)

客户的广告来电统计报告设置。只有在 update 操作中才是可变的。

conversionTrackingSetting

object (ConversionTrackingSetting)

仅供输出。客户的转化跟踪设置。

remarketingSetting

object (RemarketingSetting)

仅供输出。客户的再营销设置。

payPerConversionEligibilityFailureReasons[]

enum (CustomerPayPerConversionEligibilityFailureReason)

仅供输出。客户无法使用 PaymentMode.CONVERSIONS 的原因。如果列表为空,则表示客户符合条件。此字段为只读字段。

optimizationScoreWeight

number

仅供输出。客户的优化得分权重。

优化得分权重可用于比较/汇总多个非经理客户的优化得分。某位经理账号的总体优化得分的计算方法是,对其所有 Customer.optimization_score * Customer.optimization_score_weight 客户的总和进行计算。对于所有经理客户和未评分的非经理客户,此字段均为 0。

此字段为只读字段。

status

enum (CustomerStatus)

仅供输出。客户的状态。

offlineConversionClientSummaries[]

object (OfflineConversionClientSummary)

仅供输出。线下转化数据上传诊断信息。

customerAgreementSetting

object (CustomerAgreementSetting)

仅供输出。客户的客户协议设置。

id

string (int64 format)

仅供输出。客户的 ID。

descriptiveName

string

(可选)客户的非唯一描述性名称。

currencyCode

string

不可变。账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。

timeZone

string

不可变。客户的当地时区 ID。

trackingUrlTemplate

string

用于根据参数构建跟踪网址的网址模板。只有在 update 操作中才是可变的。

finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。只有在 update 操作中才是可变的。

autoTaggingEnabled

boolean

是否为客户启用了自动标记功能。

hasPartnersBadge

boolean

仅供输出。客户是否拥有合作伙伴计划徽章。如果客户未参与合作伙伴计划,此 ID 为 false。如需了解详情,请参阅 https://support.google.com/partners/answer/3125774

manager

boolean

仅供输出。客户是否为经理。

testAccount

boolean

仅供输出。客户使用的账号是否为测试账号。

optimizationScore

number

仅供输出。客户的优化得分。

优化得分是一个估算的分值,反映了客户的广告系列在设置方面的优化程度。范围是 0% (0.0) 到 100% (1.0)。对于所有经理客户和未评分的非经理客户,此字段均为 null。

请参阅“优化得分简介”,网址为 https://support.google.com/google-ads/answer/9061546

此字段为只读字段。

locationAssetAutoMigrationDone

boolean

仅供输出。如果基于 Feed 的地理位置已迁移到基于素材资源的地理位置,则为 True。

imageAssetAutoMigrationDone

boolean

仅供输出。如果基于 Feed 的图片已迁移到基于素材资源的图片,则为 true。

locationAssetAutoMigrationDoneDateTime

string

仅供输出。从基于 Feed 的位置到资产基准位置的迁移时间戳,采用 yyyy-MM-dd HH:mm:ss 格式。

imageAssetAutoMigrationDoneDateTime

string

仅供输出。从基于 Feed 的图片到素材资源基础图片的迁移时间戳(采用 yyyy-MM-dd HH:mm:ss 格式)。

CallReportingSetting

客户的广告来电统计报告设置。只有在 update 操作中才是可变的。

JSON 表示法
{
  "callReportingEnabled": boolean,
  "callConversionReportingEnabled": boolean,
  "callConversionAction": string
}
字段
callReportingEnabled

boolean

通过 Google 系统对来电事件进行重定向,以启用来电报告。

callConversionReportingEnabled

boolean

是否启用来电转化报告。

callConversionAction

string

可归因于来电转化的客户级来电转化操作。如果未设置,系统会使用默认转化操作。仅当 callConversionReportingEnabled 设置为 true 时才会生效。

ConversionTrackingSetting

与 Google Ads 转化跟踪相关的一系列客户设置。

JSON 表示法
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
字段
acceptedCustomerDataTerms

boolean

仅供输出。客户是否已接受客户数据条款。如果您使用的是跨帐号转化跟踪,则系统会从经理帐号沿用此值。此字段是只读字段。有关详情,请参阅 https://support.google.com/adspolicy/answer/7475709

conversionTrackingStatus

enum (ConversionTrackingStatus)

仅供输出。转化跟踪状态。它可表明客户是否在使用转化跟踪,以及此客户的转化跟踪所有者是谁。如果此客户使用的是跨帐号转化跟踪,则返回的值会因请求的 login-customer-id 而异。

enhancedConversionsForLeadsEnabled

boolean

仅供输出。客户是否启用了增强型潜在客户转化。如果您使用的是跨帐号转化跟踪,则系统会从经理帐号沿用此值。此字段为只读字段。

googleAdsConversionCustomer

string

仅供输出。在其中创建和管理转化的客户的资源名称。此字段为只读字段。

conversionTrackingId

string (int64 format)

仅供输出。用于此账号的转化跟踪 ID。此 ID 无法指明客户是否在使用转化跟踪(conversionTrackingStatus 表示)。此字段为只读字段。

crossAccountConversionTrackingId

string (int64 format)

仅供输出。客户的经理的转化跟踪 ID。这是在客户选择启用跨帐号转化跟踪时设置的,并且会覆盖 conversionTrackingId。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。

ConversionTrackingStatus

客户的转化跟踪状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NOT_CONVERSION_TRACKED 客户未使用任何转化跟踪。
CONVERSION_TRACKING_MANAGED_BY_SELF 转化操作由此客户创建和管理。
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER 转化操作由请求的 login-customer-id 中指定的经理创建和管理。
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER 转化操作由与请求的 login-customer-id 中指定的客户或经理不同的经理创建和管理。

RemarketingSetting

客户的再营销设置。

JSON 表示法
{
  "googleGlobalSiteTag": string
}
字段
googleGlobalSiteTag

string

仅供输出。Google 代码。

CustomerPayPerConversionEligibilityFailureReason

枚举描述客户无法使用 PaymentMode.CONVERSIONS 的可能原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
NOT_ENOUGH_CONVERSIONS 客户获得的转化次数不足。
CONVERSION_LAG_TOO_HIGH 客户的转化延迟时间过长。
HAS_CAMPAIGN_WITH_SHARED_BUDGET 客户使用的是共享预算。
HAS_UPLOAD_CLICKS_CONVERSION 客户有 ConversionActionType.UPLOAD_clicks 对应的转化。
AVERAGE_DAILY_SPEND_TOO_HIGH 客户的平均每日支出过高。
ANALYSIS_NOT_COMPLETE Google Ads 后端尚未计算客户是否符合条件。请稍后回来查看。
OTHER 客户因其他原因而不符合条件。

OfflineConversionClientSummary

客户总结的线下转化数据上传诊断信息。此 proto 包含一般信息(按日期/作业细分),以及有关线下转化数据上传结果的提醒。

JSON 表示法
{
  "client": enum (OfflineEventUploadClient),
  "status": enum (OfflineConversionDiagnosticStatus),
  "totalEventCount": string,
  "successfulEventCount": string,
  "successRate": number,
  "lastUploadDateTime": string,
  "dailySummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "jobSummaries": [
    {
      object (OfflineConversionUploadSummary)
    }
  ],
  "alerts": [
    {
      object (OfflineConversionUploadAlert)
    }
  ]
}
字段
client

enum (OfflineEventUploadClient)

仅供输出。上传事件的客户端类型。

status

enum (OfflineConversionDiagnosticStatus)

仅供输出。线下转化客户端的总体状态摘要。状态是根据最近一个日历日和上传统计信息生成的。

totalEventCount

string (int64 format)

仅供输出。上传的事件总数。

successfulEventCount

string (int64 format)

仅供输出。成功上传的事件总数。

successRate

number

仅供输出。成功率。

lastUploadDateTime

string

仅供输出。最近一次批量上传的日期。

dailySummaries[]

object (OfflineConversionUploadSummary)

仅供输出。按过去 N 天显示的历史统计信息摘要。

jobSummaries[]

object (OfflineConversionUploadSummary)

仅供输出。按最后 N 个作业汇总的历史统计信息摘要。

alerts[]

object (OfflineConversionUploadAlert)

仅供输出。每个错误代码的详情。提醒是根据最近日历日和上传统计信息生成的。

OfflineEventUploadClient

客户端类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
GOOGLE_ADS_API Google Ads API。
GOOGLE_ADS_WEB_CLIENT Google Ads 网页客户端,其中可能包括多个来源,例如 Google Ads 界面、SFTP 等。
ADS_DATA_CONNECTOR 连接平台。

OfflineConversionDiagnosticStatus

线下数据提取设置的可能状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
EXCELLENT 您的线下数据注入设置已启用,并且最适合进行下游处理。
GOOD 您的线下数据提取设置已启用,但还可以做出进一步改进。查看提醒。
NEEDS_ATTENTION 您的线下数据提取设置已启用,但存在一些错误需要您注意。查看提醒。
NO_RECENT_UPLOAD 您的线下数据提取设置在过去 28 天内未收到数据,其中可能存在问题。

OfflineConversionUploadSummary

历史上传摘要,按上传日期或作业分组。

JSON 表示法
{
  "successfulCount": string,
  "failedCount": string,

  // Union field dimension_key can be only one of the following:
  "jobId": string,
  "uploadDate": string
  // End of list of possible types for union field dimension_key.
}
字段
successfulCount

string (int64 format)

仅供输出。成功事件的总数。

failedCount

string (int64 format)

仅供输出。失败事件的总数。

联合字段 dimension_key。摘要的维度键。dimension_key 只能是下列其中一项:
jobId

string (int64 format)

仅供输出。最近 N 个作业的维度键。

uploadDate

string

仅供输出。过去 N 天的维度键。

OfflineConversionUploadAlert

关于线下转化客户端摘要的提醒。

JSON 表示法
{
  "error": {
    object (OfflineConversionUploadError)
  },
  "errorPercentage": number
}
字段
error

object (OfflineConversionUploadError)

仅供输出。线下转化客户端提醒出错。

errorPercentage

number

仅供输出。错误百分比。

OfflineConversionUploadError

线下转化客户端摘要中可能存在的错误。

JSON 表示法
{

  // Union field error_code can be only one of the following:
  "collectionSizeError": enum (CollectionSizeError),
  "conversionAdjustmentUploadError": enum (ConversionAdjustmentUploadError),
  "conversionUploadError": enum (ConversionUploadError),
  "dateError": enum (DateError),
  "distinctError": enum (DistinctError),
  "fieldError": enum (FieldError),
  "mutateError": enum (MutateError),
  "notAllowlistedError": enum (NotAllowlistedError),
  "stringFormatError": enum (StringFormatError),
  "stringLengthError": enum (StringLengthError)
  // End of list of possible types for union field error_code.
}
字段
联合字段 error_code。说明有误。error_code 只能是下列其中一项:
collectionSizeError

enum (CollectionSizeError)

仅供输出。集合大小错误。

conversionAdjustmentUploadError

enum (ConversionAdjustmentUploadError)

仅供输出。上传转化调整项时出错。

conversionUploadError

enum (ConversionUploadError)

仅供输出。转化数据上传错误。

dateError

enum (DateError)

仅供输出。日期错误。

distinctError

enum (DistinctError)

仅供输出。明显错误。

fieldError

enum (FieldError)

仅供输出。字段错误。

mutateError

enum (MutateError)

仅供输出。Mutate 错误。

notAllowlistedError

enum (NotAllowlistedError)

仅供输出。“未列入许可名单”错误。

stringFormatError

enum (StringFormatError)

仅供输出。字符串格式错误。

stringLengthError

enum (StringLengthError)

仅供输出。字符串长度错误。

CollectionSizeError

描述可能的集合大小错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
TOO_FEW 过少。
TOO_MANY 太多了。

ConversionAdjustmentUploadError

描述可能的转化调整项上传错误的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
INVALID_CONVERSION_ACTION 请务必指定可调整的有效转化操作。
CONVERSION_ALREADY_RETRACTED 该转化已撤消。此调整项未处理。
CONVERSION_NOT_FOUND 找不到与此转化操作和转化标识符对应的转化。请确保您的转化标识符与正确的转化操作相关联,然后重试。
CONVERSION_EXPIRED 无法对早于 54 天前发生的转化进行调整。
ADJUSTMENT_PRECEDES_CONVERSION 调整中有 adjustmentDateTime,发生在关联的转化之前。请确保您的adjustmentDateTime正确无误,然后重试。
MORE_RECENT_RESTATEMENT_FOUND 已报告相关转化的最新调整 adjustmentDateTime。请确保您的调整 adjustmentDateTime 正确无误,然后重试。
TOO_RECENT_CONVERSION 转化时间过近,因此无法记录调整项。请尝试调整至少 24 小时前发生的转化。
CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE 无法对设置为使用默认价值的转化进行调整。请检查您的转化操作价值设置,然后重试。
TOO_MANY_ADJUSTMENTS_IN_REQUEST 请尝试在单个 API 请求中上传少于 2,001 个调整项。
TOO_MANY_ADJUSTMENTS 已调整转化的次数上限。请确保您仅对现有转化做出必要的调整。
RESTATEMENT_ALREADY_EXISTS 转化之前有相同的 adjustmentDateTime 重报。请确保您的调整项包含正确且唯一的 adjustmentDateTime,然后重试。
DUPLICATE_ADJUSTMENT_IN_REQUEST 导入的调整项包含重复的转化调整项,但其adjustmentDateTime相同。请确保您的调整项包含正确的adjustmentDateTime,然后重试。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您在转化设置中同意客户数据处理条款,然后重试。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 无法将增强型转化与指定的转化操作搭配使用。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保按照指南进行标准化处理。
UNSUPPORTED_USER_IDENTIFIER 请使用用户提供的数据(例如使用 SHA-256 算法进行哈希处理的电子邮件地址或电话号码),然后重试。
GCLID_DATE_TIME_PAIR_AND_ORDER_ID_BOTH_SET 无法同时设置 gclidDateTimePair 和 orderId。请仅使用 1 种类型,然后重试。
CONVERSION_ALREADY_ENHANCED 转化已经有包含相同订单 ID 和转化操作的增强功能。请确保您的数据配置正确无误,然后重试。
DUPLICATE_ENHANCEMENT_IN_REQUEST 多项增强功能具有相同的转化操作和订单 ID。请确保您的数据配置正确无误,然后重试。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCEMENT 由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。
MISSING_ORDER_ID_FOR_WEBPAGE 调整网站转化需要提供订单 ID(即交易 ID)。请确保您的网站代码能够获取订单 ID,并且您在进行调整时发送相同的订单 ID。
ORDER_ID_CONTAINS_PII 无法对包含个人身份信息 (PII) 的订单 ID 进行调整。

ConversionUploadError

描述可能出现的转化数据上传错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
TOO_MANY_CONVERSIONS_IN_REQUEST 在单个请求中上传的事件应少于 2,001 个。
UNPARSEABLE_GCLID 无法对导入的 GCLID 进行解码。请确保您未修改点击 ID。
CONVERSION_PRECEDES_EVENT 导入的事件点击前有一个 conversionDateTime。请确保您的conversionDateTime正确无误,然后重试。
EXPIRED_EVENT 此项转化的点击时间早于其点击型转化时间范围,因此无法记录导入的事件。请确保您导入的是最新数据。
TOO_RECENT_EVENT 与给定标识符或 iOS 网址参数关联的点击是在不到 6 小时前发生的。请在 6 小时后重试。
EVENT_NOT_FOUND 导入的事件无法归因于某个点击。导致这种情况的原因可能是:该事件不是由 Google Ads 广告系列带来的。
UNAUTHORIZED_CUSTOMER 点击 ID 或调用与您无权访问的 Google Ads 账号相关联。请务必导入由您的经理账号管理的账号的转化数据。
INVALID_CONVERSION_ACTION 请确保为线下导入指定有效的转化操作设置。
TOO_RECENT_CONVERSION_ACTION 无法将事件导入刚刚创建的转化操作。请在 6 小时后再次尝试导入。
CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME 发生点击时,与点击对应的 Google Ads 帐号的有效转化帐号未启用转化跟踪。
EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 导入的事件包含外部归因数据,但相应转化操作未设置为使用外部归因模型。请确保转化操作配置正确无误,然后重试。
EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 转化操作已设置为使用外部归因模型,但导入的事件缺少数据。请确保导入的事件包含外部归因功劳和所有必填字段。
ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION 订单 ID 无法用于通过外部归因模型衡量的转化。请确保该转化配置正确无误,并且导入的事件仅包含必要的数据,然后重试。
ORDER_ID_ALREADY_IN_USE 导入的事件包含之前记录的订单 ID,因此未处理该事件。
DUPLICATE_ORDER_ID 导入的事件包含多个具有相同订单 ID 的转化,因而未能得到处理。请确保订单 ID 是唯一的,然后重试。
TOO_RECENT_CALL 无法导入不到 6 小时前的通话。请在 6 小时后尝试重新上传。
EXPIRED_CALL 无法记录此次来电,因为此次来电的发生时间早于此转化操作的回溯期。确保您的导入已配置为获取最新数据。
CALL_NOT_FOUND 找不到指向导入事件的调用或点击。确保您的数据源已设置为包含正确的标识符。
CONVERSION_PRECEDES_CALL 该调用在关联的点击之前有一个 conversionDateTime。请确保您的conversionDateTime正确无误。
CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME 在导入的来电时,相应点击对应的 Google Ads 帐号的有效转化帐号中未启用转化跟踪。
UNPARSEABLE_CALLERS_PHONE_NUMBER 确保电话号码格式为 E.164 (+16502531234)、国际号码 (+64 3-331 6005) 或美国国内号码 (6502531234)。
CLICK_CONVERSION_ALREADY_EXISTS 导入的事件与现有转化具有相同的点击和conversionDateTime。请针对每个唯一身份事件使用唯一的 conversionDateTime 或订单 ID,然后重试。
CALL_CONVERSION_ALREADY_EXISTS 导入的来电与现有转化的 conversionDateTime 相同。请确保您的conversionDateTime配置正确无误,然后重试。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST 多个事件具有相同的点击和 conversionDateTime。请确保您的conversionDateTime配置正确无误,然后重试。
DUPLICATE_CALL_CONVERSION_IN_REQUEST 多个事件具有相同的调用和 conversionDateTime。请确保您的conversionDateTime配置正确无误,然后重试。
CUSTOM_VARIABLE_NOT_ENABLED 请在转化设置中启用该自定义变量,然后重试。
CUSTOM_VARIABLE_VALUE_CONTAINS_PII 事件中的自定义变量包含个人身份信息 (PII),因此无法导入。请移除这些变量,然后重试。
INVALID_CUSTOMER_FOR_CLICK 导入的事件带来的点击与其他 Google Ads 账号相关联。请确保要导入的账号正确无误。
INVALID_CUSTOMER_FOR_CALL 来自通话的点击与其他 Google Ads 帐号相关联。请确保要导入的账号正确无误。查询客户的 conversionTrackingSetting.google_ads_conversion_customer,以确定正确的帐号。
CONVERSION_NOT_COMPLIANT_WITH_ATT_POLICY 无法导入此转化,因为转化来源不符合 Apple 应用透明度跟踪 (ATT) 政策,或者客户未同意跟踪。
CLICK_NOT_FOUND 此事件的电子邮件地址或电话号码无法与点击相匹配。这可能是因为该事件不是由 Google Ads 广告系列促成,您可以放心地忽略此警告。如果包含的导入事件数量超出预期,您可能需要检查设置。
INVALID_USER_IDENTIFIER 请务必使用 SHA-256 算法对用户提供的数据进行哈希处理,并确保按照指南进行标准化处理。
EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION_NOT_PERMITTED_WITH_USER_IDENTIFIER 用户提供的数据无法用于外部归因模型。请使用其他归因模型或省略用户标识符,然后重试。
UNSUPPORTED_USER_IDENTIFIER 所提供的用户标识符不受支持。请仅使用经过哈希处理的电子邮件地址或电话号码,然后重试。
GBRAID_WBRAID_BOTH_SET 无法同时使用 gbraid 和 wbraid 参数。请仅使用其中一个,然后重试。
UNPARSEABLE_WBRAID 无法解析事件导入数据。请检查您的 wbraid 参数是否未修改,然后重试。
UNPARSEABLE_GBRAID 无法解析事件导入数据。请检查您的 gbraid 参数是否未修改,然后重试。
ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID 使用每次点击统计为一次转化设置的转化操作无法与 gbraid 或 wbraid 参数配合使用。
CUSTOMER_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS 由于 Google 客户数据政策,此账号无法使用增强型转化。请与您的 Google 代表联系。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 请确保您在转化设置中同意客户数据处理条款,然后重试。您可以通过查询客户的 conversionTrackingSetting.accepted_customer_data_terms 检查您的设置。
ORDER_ID_CONTAINS_PII 事件的订单 ID 包含个人身份信息 (PII),因此无法导入事件。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 请确保您已在转化设置中启用增强型潜在客户转化,然后重试。您可以通过在客户上查询 conversionTrackingSetting.enhanced_conversions_for_leads_enabled 检查您的设置。

DateError

描述可能的日期错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
INVALID_FIELD_VALUES_IN_DATE 指定的字段值与有效日期不符。
INVALID_FIELD_VALUES_IN_DATE_TIME 给定的字段值与有效的日期时间不符。
INVALID_STRING_DATE 字符串日期的格式应为 yyyy-mm-dd。
INVALID_STRING_DATE_TIME_MICROS 该字符串日期时间格式应为 yyyy-mm-dd hh:mm:ss.ssssss。
INVALID_STRING_DATE_TIME_SECONDS 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 字符串日期时间的格式应为 yyyy-mm-dd hh:mm:ss+|-hh:mm。
EARLIER_THAN_MINIMUM_DATE 日期早于允许的最早日期。
LATER_THAN_MAXIMUM_DATE 日期晚于允许的最晚日期。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 构成日期范围的下限日期晚于相应的上限日期。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 构成日期范围的上限与下限日期都为 Null。

DistinctError

描述可能出现的不同错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
DUPLICATE_ELEMENT 元素重复。
DUPLICATE_TYPE 类型重复。

FieldError

描述可能的字段错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
REQUIRED 必填字段不存在。
IMMUTABLE_FIELD 尝试更改的字段不可变。
INVALID_VALUE 此字段的值无效。
VALUE_MUST_BE_UNSET 无法设置该字段。
REQUIRED_NONEMPTY_LIST 必需的重复字段为空。
FIELD_CANNOT_BE_CLEARED 此字段无法清除。
BLOCKED_VALUE 此字段的值在此字段的拒绝名单中。
FIELD_CAN_ONLY_BE_CLEARED 除非清除,否则无法修改此字段的值。

MutateError

描述可能的 mutate 错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
RESOURCE_NOT_FOUND 找不到所请求的资源。
ID_EXISTS_IN_MULTIPLE_MUTATES 无法在一个请求中对同一资源进行两次更改。
INCONSISTENT_FIELD_VALUES 该字段的内容与表示相同数据的其他字段不匹配。
MUTATE_NOT_ALLOWED 不允许对所请求的资源执行 mutate 操作。
RESOURCE_NOT_IN_GOOGLE_ADS 相应资源不在 Google Ads 中。属于其他广告系统。
RESOURCE_ALREADY_EXISTS 要创建的资源已存在。
RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY 此资源不能与“validateOnly”搭配使用。
OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE 此操作无法与“partialFailure”结合使用。
RESOURCE_READ_ONLY 尝试写入只读字段。

NotAllowlistedError

描述可能的未列入许可名单的错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE 客户未列入可使用该功能的许可名单。

StringFormatError

描述可能的字符串格式错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
ILLEGAL_CHARS 输入的字符串值包含不允许使用的字符。
INVALID_FORMAT 对于关联字段,输入的字符串值无效。

StringLengthError

描述可能的字符串长度错误的枚举。

枚举
UNSPECIFIED 未指定枚举。
UNKNOWN 此版本中不知道收到的错误代码。
EMPTY 指定字段中应至少有一个非空白字符。
TOO_SHORT 名称过短。
TOO_LONG 名称过长。

CustomerAgreementSetting

客户的客户协议设置。

JSON 表示法
{
  "acceptedLeadFormTerms": boolean
}
字段
acceptedLeadFormTerms

boolean

仅供输出。客户是否已接受潜在客户表单的服务条款。