REST Resource: accounts.conversionSources

资源：ConversionSource

表示商家帐号拥有的转化来源。一个商家帐号最多可以包含 200 个转化来源。

JSON 表示法 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
字段
name

string

仅限输出。标识符。在创建新的 ConversionSource 时由 Content API 生成。格式：[a-z]{4}:.+ 冒号前的四个字符表示转化来源的类型。冒号后面的内容表示相应类型中转化来源的 ID。两个不同的转化来源的 ID 在不同的类型中可能相同。支持以下类型前缀：- galk：适用于 GoogleAnalyticsLink 来源。- mcdn：适用于 MerchantCenterDestination 来源。
state

enum (State)

仅限输出。此转化来源的当前状态。无法通过 API 修改。
expireTime

string (Timestamp format)

仅限输出。已归档的转化来源被永久删除且无法再取消删除的时间。
controller

enum (Controller)

仅限输出。转化来源的控制方。
联合字段 source_data。必需。特定于每个不同类型的来源的转化来源数据。source_data 只能是下列其中一项：
merchantCenterDestination

object (MerchantCenterDestination)

“Merchant Center 代码目标账号”类型的转化来源。

AttributionSettings

表示接收预归因数据的转化来源的归因设置。

JSON 表示法 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
字段
attributionLookbackWindowDays

integer

必需。此来源中用于归因的回溯期（以天为单位）。支持的值包括 7、30、40。
attributionModel

enum (AttributionModel)

必需。归因模型。
conversionType[]

object (ConversionType)

不可变。无序列表。列出了转化事件可归为的不同转化类型。如果创建时此列表为空，系统会自动创建一个标准的“purchase”类型。

AttributionModel

此来源所用的归因模型。我们支持 Google Analytics（分析）4 提供的一组模型，详见 https://support.google.com/analytics/answer/10596866。

枚举
ATTRIBUTION_MODEL_UNSPECIFIED 未指定模型。
CROSS_CHANNEL_LAST_CLICK 跨渠道最终点击模型。
ADS_PREFERRED_LAST_CLICK 首选 Google Ads 最终点击模型。
CROSS_CHANNEL_DATA_DRIVEN 以数据为依据的跨渠道模型。
CROSS_CHANNEL_FIRST_CLICK 跨渠道首次点击模型。
CROSS_CHANNEL_LINEAR 跨渠道线性模型。
CROSS_CHANNEL_POSITION_BASED 根据位置跨渠道模型。
CROSS_CHANNEL_TIME_DECAY 跨渠道时间衰减模型。

ConversionType

表示转化事件类型的消息

JSON 表示法 
{
  "name": string,
  "report": boolean
}
字段
name

string

仅限输出。转化事件名称，由客户端报告。
report

boolean

仅限输出。指示是否应在 Merchant Center 报告中纳入相应类型的选项。

MerchantCenterDestination

“Merchant Center 目标账号”来源可用于将使用 Google 代码从网店直接发送到创建该来源的 Merchant Center 帐号。

JSON 表示法 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
字段
destination

string

仅限输出。Merchant Center 目标 ID。
attributionSettings

object (AttributionSettings)

必需。用于 Merchant Center 目标页面的归因设置。
displayName

string

必需。商家指定的平台显示名称。此名称用于在 Merchant Center 界面中标识转化来源。上限为 64 个字符。
currencyCode

string

必需。由 3 个字母组成的货币代码 (ISO 4217)。币种代码用于指定发送到此目标平台的转化数据在 Merchant Center 中报告时所使用的币种。

状态

表示转化来源的状态。

枚举
STATE_UNSPECIFIED 转化来源处于未指定状态。
ACTIVE 转化来源功能完全正常。
ARCHIVED 转化来源已在过去 30 天内归档，目前无法正常使用。可以使用恢复删除方法恢复。
PENDING 转化来源创建已开始，但尚未完全完成。

控制器

控制转化来源的实体。

枚举
CONTROLLER_UNSPECIFIED 默认值。此值未使用。
MERCHANT 由拥有转化来源的商家控制。
YOUTUBE_AFFILIATES 由 YouTube 联属营销计划控制。

方法

create

 创建新的转化来源。

delete

 归档现有转化来源。

get

 获取转化来源。

list

 检索调用者有权访问的转化来源列表。

patch

 更新现有转化来源的信息。

undelete

 重新启用已归档的转化来源。