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)

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

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

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