Индекс
-
ConversionSourcesService
(интерфейс) -
AttributionSettings
(сообщение) -
AttributionSettings.AttributionModel
(перечисление) -
AttributionSettings.ConversionType
(сообщение) -
ConversionSource
(сообщение) -
ConversionSource.Controller
(перечисление) -
ConversionSource.State
(перечисление) -
CreateConversionSourceRequest
(сообщение) -
DeleteConversionSourceRequest
(сообщение) -
GetConversionSourceRequest
(сообщение) -
GoogleAnalyticsLink
(сообщение) -
ListConversionSourcesRequest
(сообщение) -
ListConversionSourcesResponse
(сообщение) -
MerchantCenterDestination
(сообщение) -
UndeleteConversionSourceRequest
(сообщение) -
UpdateConversionSourceRequest
(сообщение)
ConversionSourcesService
Сервис для управления источниками конверсий для мерчант-аккаунта.
CreateConversionSource |
---|
Создает новый источник конверсий.
|
Удалитьконверсиюсаурце |
---|
Архивирует существующий источник конверсий. Если источником конверсии является пункт назначения Merchant Center, его можно будет восстановить в течение 30 дней. Если источником конверсии является ссылка Google Analytics, она будет немедленно удалена и ее можно будет восстановить, создав новую.
|
GetConversionSource |
---|
Получает источник конверсии.
|
Список источников конверсий |
---|
Получает список источников конверсий, к которым имеет доступ вызывающий объект.
|
UndeleteConversionSource |
---|
Повторно включает архивный источник конверсий. Доступно только для целевых источников конверсий Merchant Center.
|
UpdateConversionSource |
---|
Обновляет информацию о существующем источнике конверсий. Доступно только для целевых источников конверсий Merchant Center.
|
Настройки атрибуции
Представляет настройки атрибуции для источников конверсий, получающих данные предварительной атрибуции.
Поля | |
---|---|
attribution_lookback_window_days | Необходимый. Окна ретроспективного анализа (в днях), используемые для атрибуции в этом источнике. Поддерживаемые значения: 7, 30, 40. |
attribution_model | Необходимый. Модель атрибуции. |
conversion_type[] | Неизменный. Неупорядоченный список. Список различных типов конверсий, к которым можно отнести событие конверсии. Стандартный тип «покупка» будет создан автоматически, если этот список пуст на момент создания. |
Модель атрибуции
Модель атрибуции, использованная для этого источника. Мы поддерживаем тот же набор моделей, что и 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 | Межканальная модель временного распада. |
Тип конверсии
Сообщение, представляющее типы событий-конверсий
Поля | |
---|---|
name | Только вывод. Название события конверсии, как оно будет сообщено клиентом. |
report | Только вывод. Опция, указывающая, следует ли включать этот тип в отчеты Merchant Center. |
Источник конверсии
Представляет источник конверсий, принадлежащий учетной записи продавца. Мерчант-аккаунт может иметь до 200 источников конверсий.
Поля | |
---|---|
name | Только вывод. Идентификатор. Создается Content API при создании нового |
state | Только вывод. Текущее состояние этого источника конверсий. Невозможно редактировать через API. |
expire_time | Только вывод. Время, когда заархивированный источник конверсий удаляется без возможности восстановления и становится недоступным для восстановления. |
controller | Только вывод. Контроллер источника преобразования. |
Поле объединения source_data . Необходимый. Данные источника конверсий, специфичные для каждого типа источника. source_data может быть только одним из следующих: | |
google_analytics_link | Неизменный. Источник конверсий типа «Ссылка на ресурс Google Analytics». |
merchant_center_destination | Источник конверсий типа "Назначение тега Merchant Center". |
Контроллер
Объект, контролирующий источник конверсий.
Перечисления | |
---|---|
CONTROLLER_UNSPECIFIED | Значение по умолчанию. Это значение не используется. |
MERCHANT | Контролируется Продавцом, которому принадлежит Источник конверсий. |
YOUTUBE_AFFILIATES | Контролируется программой YT Affiliates. |
Состояние
Представляет состояние источника преобразования.
Перечисления | |
---|---|
STATE_UNSPECIFIED | Источник преобразования имеет неопределенное состояние. |
ACTIVE | Источник конверсий полностью функционален. |
ARCHIVED | Источник конверсий был заархивирован за последние 30 дней и в настоящее время не работает. Можно восстановить методом восстановления. |
PENDING | Создание источника конверсий началось, но еще не завершено. |
CreateConversionSourceRequest
Сообщение запроса для метода CreateConversionSource.
Поля | |
---|---|
parent | Необходимый. Торговый аккаунт, которому будет принадлежать новый источник конверсий. Формат: аккаунты/{аккаунт} |
conversion_source | Необходимый. Описание источника конверсии. При создании ему автоматически будет присвоен новый идентификатор. |
Удалениеконверсиисаурцерекуест
Сообщение запроса для метода DeleteConversionSource.
Поля | |
---|---|
name | Необходимый. Имя источника конверсии, который нужно удалить. Формат: аккаунты/{аккаунт}/conversionSources/{conversion_source} |
GetConversionSourceRequest
Сообщение запроса для метода GetConversionSource.
Поля | |
---|---|
name | Необходимый. Имя источника конверсий, который нужно получить. Формат: account/{account}/conversionsources/{conversion_source}. |
GoogleAnalyticsСсылка
Источники «Ссылка на Google Analytics» можно использовать для передачи данных о конверсиях из существующего ресурса Google Analytics в связанный аккаунт Merchant Center.
Поля | |
---|---|
property_id | Необходимый. Неизменный. Идентификатор ресурса Google Analytics, с которым связан продавец. |
attribution_settings | Только вывод. Настройки атрибуции для связанного ресурса Google Analytics. |
property | Только вывод. Название ресурса Google Analytics, с которым связан продавец. |
Запрос ListConversionSourcesRequest
Сообщение запроса для метода ListConversionSources.
Поля | |
---|---|
parent | Необходимый. Торговый аккаунт, которому принадлежит коллекция источников конверсий. Формат: аккаунты/{аккаунт} |
page_size | Необязательный. Максимальное количество источников конверсий, возвращаемых на странице. Если |
page_token | Необязательный. Токен страницы. |
show_deleted | Необязательный. Показать удаленную (заархивированную) опцию. |
ListConversionSourcesResponse
Ответное сообщение для метода ListConversionSources.
Поля | |
---|---|
conversion_sources[] | Список источников конверсий. |
next_page_token | Токен, который будет использоваться для получения следующей страницы результатов. |
MerchantCenterDestination
Источники "Назначение Merchant Center" можно использовать для отправки событий конверсии из интернет-магазина с помощью тега Google непосредственно в аккаунт Merchant Center, где создан источник.
Поля | |
---|---|
destination | Только вывод. Идентификатор места назначения Merchant Center. |
attribution_settings | Необходимый. Настройки атрибуции, используемые для пункта назначения Merchant Center. |
display_name | Необходимый. Отображаемое имя пункта назначения, указанное продавцом. Это имя, которое идентифицирует источник конверсии в пользовательском интерфейсе Merchant Center. Ограничено 64 символами. |
currency_code | Необходимый. Трехбуквенный код валюты (ISO 4217). Код валюты определяет, в какой валюте конвертации, отправленные в этот пункт назначения, будут учитываться в Merchant Center. |
Восстановить конверсиюсаурцереквест
Сообщение запроса для метода UndeleteConversionSource.
Поля | |
---|---|
name | Необходимый. Имя источника конверсии, удаление которого требуется восстановить. Формат: аккаунты/{аккаунт}/conversionSources/{conversion_source} |
UpdateConversionSourceRequest
Сообщение запроса для метода UpdateConversionSource.
Поля | |
---|---|
conversion_source | Необходимый. Новая версия исходных данных конверсий. Формат: аккаунты/{аккаунт}/conversionSources/{conversion_source} |
update_mask | Необходимый. Список полей обновляется. |