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

仅限输出。标识符。由 Content API 在创建新的 ConversionSource 时生成。格式：[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

必需。由三个字母组成的货币代码 (ISO 4217)。货币代码用于定义在 Merchant Center 中报告发送到此目标页面的转化时所使用的货币。

州

表示转化来源的状态。

枚举
STATE_UNSPECIFIED 转化来源处于不明状态。
ACTIVE 转化来源完全正常运转。
ARCHIVED 转化来源在过去 30 天内归档，目前无法正常使用。可以使用 undelete 方法进行恢复。
PENDING 转化来源创建过程已开始，但尚未完全完成。

控制器

控制转化来源的实体。

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

方法

create

 创建新的转化来源。

delete

 归档现有转化来源。

get

 获取转化来源。

list

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

patch

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

undelete

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