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 . Формат: [az]{4}:.+ Четыре символа перед двоеточием обозначают тип источника преобразования. Содержимое после двоеточия представляет собой идентификатор источника конверсии внутри этого типа. Идентификаторы двух разных источников конверсий могут быть одинаковыми для разных типов. Поддерживаются следующие префиксы типов: - galk: для источников GoogleAnalyticsLink. - mcdn: для источников MerchantCenterDestination.

state

enum ( State )

Только вывод. Текущее состояние этого источника конверсий. Невозможно редактировать через API.

expireTime

string ( Timestamp format)

Только вывод. Время, когда заархивированный источник конверсий удаляется без возможности восстановления и становится недоступным для восстановления.

controller

enum ( Controller )

Только вывод. Контроллер источника преобразования.

Поле объединения source_data . Необходимый. Данные источника конверсий, специфичные для каждого типа источника. source_data может быть только одним из следующих:
merchantCenterDestination

object ( MerchantCenterDestination )

Источник конверсий типа "Назначение тега Merchant Center".

Настройки атрибуции

Представляет настройки атрибуции для источников конверсий, получающих данные предварительной атрибуции.

JSON-представление
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Поля
attributionLookbackWindowDays

integer

Необходимый. Окна ретроспективного анализа (в днях), используемые для атрибуции в этом источнике. Поддерживаемые значения: 7, 30, 40.

attributionModel

enum ( AttributionModel )

Необходимый. Модель атрибуции.

conversionType[]

object ( ConversionType )

Неизменный. Неупорядоченный список. Список различных типов конверсий, к которым можно отнести событие конверсии. Стандартный тип «покупка» будет создан автоматически, если этот список пуст на момент создания.

Модель атрибуции

Модель атрибуции, использованная для этого источника. Мы поддерживаем тот же набор моделей, что и Google Analytics 4, как описано в: https://support.google.com/analytics/answer/10596866 .

Перечисления
ATTRIBUTION_MODEL_UNSPECIFIED Неуказанная модель.
CROSS_CHANNEL_LAST_CLICK Межканальная модель последнего клика.
ADS_PREFERRED_LAST_CLICK Модель последнего клика, предпочтительная для рекламы.
CROSS_CHANNEL_DATA_DRIVEN Межканальная модель, управляемая данными.
CROSS_CHANNEL_FIRST_CLICK Межканальная модель первого клика.
CROSS_CHANNEL_LINEAR Межканальная линейная модель.
CROSS_CHANNEL_POSITION_BASED Межканальная модель на основе позиции.
CROSS_CHANNEL_TIME_DECAY Межканальная модель временного распада.

Тип конверсии

Сообщение, представляющее типы событий-конверсий

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.

attributionSettings

object ( AttributionSettings )

Необходимый. Настройки атрибуции, используемые для пункта назначения Merchant Center.

displayName

string

Необходимый. Отображаемое имя пункта назначения, указанное продавцом. Это имя, которое идентифицирует источник конверсии в пользовательском интерфейсе Merchant Center. Ограничено 64 символами.

currencyCode

string

Необходимый. Трехбуквенный код валюты (ISO 4217). Код валюты определяет, в какой валюте конверсии, отправленные в этот пункт назначения, будут учитываться в Merchant Center.

Состояние

Представляет состояние источника преобразования.

Перечисления
STATE_UNSPECIFIED Источник преобразования имеет неопределенное состояние.
ACTIVE Источник конверсий полностью функционален.
ARCHIVED Источник конверсий был заархивирован за последние 30 дней и в настоящее время не работает. Можно восстановить методом восстановления.
PENDING Создание источника конверсий началось, но еще не завершено.

Контроллер

Объект, контролирующий источник конверсий.

Перечисления
CONTROLLER_UNSPECIFIED Значение по умолчанию. Это значение не используется.
MERCHANT Контролируется Продавцом, которому принадлежит Источник конверсий.
YOUTUBE_AFFILIATES Контролируется программой YT Affiliates.

Методы

create

 Создает новый источник конверсий.

delete

 Архивирует существующий источник конверсий.

get

 Получает источник конверсии.

list

 Получает список источников конверсий, к которым имеет доступ вызывающий объект.

patch

 Обновляет информацию о существующем источнике конверсий.

undelete

 Повторно включает архивный источник конверсий.