REST Resource: accounts.conversionSources

• Ресурс: ConversionSource
  • JSON-представление
• GoogleAnalyticsСсылка
  • JSON-представление
• Настройки атрибуции
  • JSON-представление
• Модель атрибуции
• Тип конверсии
  • JSON-представление
• MerchantCenterDestination
  • JSON-представление
• Состояние
• Контроллер
• Методы

Ресурс: 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.
expire Time	string ( Timestamp format) Только вывод. Время, когда заархивированный источник конверсий удаляется без возможности восстановления и становится недоступным для восстановления.
controller	enum ( Controller ) Только вывод. Контроллер источника преобразования.
Поле объединения source_data . Необходимый. Данные источника конверсий, специфичные для каждого типа источника. source_data может быть только одним из следующих:
google Analytics Link	object ( GoogleAnalyticsLink ) Неизменяемый. Источник конверсий типа «Ссылка на ресурс Google Analytics».
merchant Center Destination	object ( MerchantCenterDestination ) Источник конверсий типа "Назначение тега Merchant Center".

GoogleAnalyticsСсылка

Источники «Ссылка на Google Analytics» можно использовать для передачи данных о конверсиях из существующего ресурса Google Analytics в связанный аккаунт Merchant Center.

JSON-представление
{ "propertyId": string, "attributionSettings": { object (AttributionSettings) }, "property": string }

Поля
property Id	string ( int64 format) Необходимый. Неизменяемый. Идентификатор ресурса Google Analytics, с которым связан продавец.
attribution Settings	object ( AttributionSettings ) Только вывод. Настройки атрибуции для связанного ресурса Google Analytics.
property	string Только вывод. Название ресурса Google Analytics, с которым связан продавец.

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

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

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

Поля
attribution Lookback Window Days	integer Необходимый. Окна ретроспективного анализа (в днях), используемые для атрибуции в этом источнике. Поддерживаемые значения: 7, 30, 40.
attribution Model	enum ( AttributionModel ) Необходимый. Модель атрибуции.
conversion Type[]	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.
attribution Settings	object ( AttributionSettings ) Необходимый. Настройки атрибуции, используемые для пункта назначения Merchant Center.
display Name	string Необходимый. Отображаемое имя пункта назначения, указанное продавцом. Это имя, которое идентифицирует источник конверсии в пользовательском интерфейсе Merchant Center. Ограничено 64 символами.
currency Code	string Необходимый. Трехбуквенный код валюты (ISO 4217). Код валюты определяет, в какой валюте конвертации, отправленные в этот пункт назначения, будут учитываться в Merchant Center.

Состояние

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

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

Контроллер

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

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

Методы
create	Создает новый источник конверсий.
delete	Архивирует существующий источник конверсий.
get	Получает источник конверсии.
list	Получает список источников конверсий, к которым имеет доступ вызывающий объект.
patch	Обновляет информацию о существующем источнике конверсий.
undelete	Повторно включает архивный источник конверсий.