Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Категории действий-конверсий

В этом руководстве приведен список различных типов действий-конверсий, которые можно создавать с помощью Google Ads API, а также информация о том, как они соотносятся с веб-интерфейсом Google Рекламы.

Как выбрать подходящий тип действия-конверсии

Чтобы выбрать подходящий тип действия-конверсии и руководство по настройке интеграции, следуйте инструкциям ниже.

Где происходит событие-конверсия?
- В офлайн-режиме (например, в офисе, магазине или по телефону): перейдите к шагу 2.
- На вашем сайте (например, покупки, регистрации или отправка форм). Перейдите к шагу 3.
- В мобильном приложении перейдите к шагу 4.
- По телефону, номер которого указан в объявлении. Используйте Звонки по объявлениям (AD_CALL) (с помощью CallAsset).
Офлайн-конверсии
- Это телефонный звонок?
  - Да. Используйте
    
    Импорт звонков-конверсий (UPLOAD_CALLS) для отслеживания результатов звонков.
- Это продажа в обычном магазине?
  - Да. Используйте
    
    Конверсии – продажи в магазинах (STORE_SALES).
- Это офлайн-продажа или переход на следующий этап воронки продаж, вызванный посещением сайта?
  - Да. Используйте расширенное отслеживание конверсий лидов с помощью Data Manager API (рекомендуется) или управляйте офлайн-конверсиями кликов с помощью существующих интеграций Google Ads API. Примечание. С 15 июня 2026 г. загружать конверсии по кликам с помощью UploadClickConversions смогут только те токены разработчика, которые ранее использовались для загрузки офлайн-конверсий по кликам.
Онлайн-конверсии (на сайте)
- Хотите отслеживать загрузки страниц (покупки, чеки) или клики пользователей?
  - Да. Используйте конверсии на сайте с фрагментом тега, для которого задано значение WEBPAGE или WEBPAGE_ONCLICK.
- Хотите ли вы отслеживать звонки, инициированные по номеру телефона, указанному на вашем сайте?
  - Как отслеживать фактическую продолжительность звонков?
    - Да. Используйте
      
      Звонки с сайта (WEBSITE_CALL) с динамическим номером Google для переадресации и фрагментом кода тега события.
    - Нет (только клики по кнопкам и ссылкам на мобильном сайте)? Использовать
      
      Клики по номеру мобильного телефона (CLICK_TO_CALL).
Конверсии в мобильном приложении
- Достаточно ли отслеживать установки и покупки из Google Play?
  - Да. Используйте конверсии в приложении (GOOGLE_PLAY_DOWNLOAD или GOOGLE_PLAY_IN_APP_PURCHASE).
- Отслеживаете ли вы действия в приложении с помощью Google Аналитики (GA4) или сторонних сервисов аналитики приложений?
  - Да. Используйте
    
    Firebase и сторонние сервисы аналитики приложений (путем включения действий-конверсий FIREBASE_* или THIRD_PARTY_*).

Офлайн-конверсии

Офлайн-конверсии помогают отслеживать события-конверсии, которые происходят вне интернета, например в офисе, по адресу компании или по телефону.

В таблице ниже приведены эквивалентные параметры API ConversionActionType, которые можно использовать для каждого источника в веб-интерфейсе Google Рекламы, а также ссылки на документацию по каждому типу действий-конверсий:

Тип действия-конверсии	Источник данных "Google Реклама"	Руководство по настройке API
`UPLOAD_CLICKS`	Отслеживание конверсий по кликам и расширенного отслеживания конверсий потенциальных клиентов	Используйте Data Manager API (рекомендуется) или управляйте офлайн-конверсиями кликов с помощью существующих интеграций Google Ads API.
`UPLOAD_CALLS`	Отслеживание конверсий по звонкам	Руководство по импорту звонков-конверсий
`STORE_SALES`	Как отслеживать конверсии, связанные с продажами в магазине	Подробнее об импорте данных о продажах в магазинах в действия-конверсии с отчетами…

Онлайн-конверсии (на сайте)

Конверсии на сайте позволяют отслеживать действия пользователей на сайте, например онлайн-продажи, клики по ссылкам, просмотры страниц и регистрации.

Чтобы отслеживать конверсии на сайте, создайте ConversionAction с параметром ConversionActionType, установленным на значение WEBPAGE, и добавьте на страницу конверсии фрагмент кода, который называется тегом.

ConversionAction включает несколько типов конверсий на сайте, которые различаются в API по полю type в каждом TagSnippet, перечисленном в поле tag_snippets объекта ConversionAction.

TagSnippet содержит код отслеживания, который необходимо добавить на сайт, чтобы отслеживать действия-конверсии. Для конверсий на сайте и по клику на номер телефона требуется тег event_snippet, который нужно разместить на веб-страницах, указывающих на действие-конверсию, например на странице подтверждения покупки или отправки формы для потенциальных клиентов, а также тег global_site_tag, который необходимо установить на каждой странице сайта. Оба этих атрибута можно получить с помощью ConversionActionService. Подробнее о том, как добавлять теги на страницы, рассказывается в Справочном центре.

В таблице ниже приведены параметры API, которые соответствуют каждому источнику в веб-интерфейсе Google Рекламы.

Тип кода отслеживания	Источник данных "Google Реклама"
`WEBPAGE`	Сайт, сайт (Google Аналитика (GA4))
`WEBPAGE_ONCLICK`	Сайт, сайт (Google Аналитика (GA4))
`CLICK_TO_CALL`	Клики по номеру телефона

Конверсии в приложении

Конверсия в приложении позволяет отслеживать установки мобильного приложения или покупки в нем, совершенные через Google Play.

В таблице ниже приведены параметры API ConversionActionType, которые соответствуют каждому источнику в веб-интерфейсе Google Рекламы.

Тип действия-конверсии	Источник данных "Google Реклама"
`GOOGLE_PLAY_DOWNLOAD`	Google Play > Установки
`GOOGLE_PLAY_IN_APP_PURCHASE`	Google Play > Покупки в приложении

Чтобы отслеживать другие действия в мобильных приложениях с помощью ресурсов Google Аналитики 4 или сторонних сервисов аналитики приложений, ознакомьтесь с дополнительными типами действий-конверсий.

Звонки-конверсии

Отслеживание звонков-конверсий позволяет отслеживать звонки по объявлениям, звонки по номеру телефона, указанному на сайте, и клики по номеру телефона на мобильном сайте.

Тип действия-конверсии	Источник данных "Google Реклама"
`AD_CALL`	Звонки по объявлениям с номерами телефонов
`WEBSITE_CALL`	Звонки по номеру телефона на сайте
`CLICK_TO_CALL`	Клик по телефонному номеру на вашем мобильном веб-сайте

`AD_CALL`

Действие-конверсия AD_CALL в веб-интерфейсе Google Рекламы отображается как конверсия Звонки из объявлений. После создания действия-конверсии AD_CALL укажите его название ресурса в поле call_conversion_action при создании CallAsset. Объекты звонков позволяют показывать номер телефона прямо в объявлении.

Звонок засчитывается как конверсия, если его длительность превышает заданную величину (по умолчанию – 60 секунд).

`WEBSITE_CALL`

Действие-конверсия WEBSITE_CALL в веб-интерфейсе Google Рекламы отображается как конверсия Звонки с сайта.

В отличие от AD_CALL, этот регистратор требует, чтобы на сайт были добавлены event_snippet и global_site_tag, чтобы получить динамический номер Google для переадресации для отслеживания звонков по номерам, указанным на сайте. Кроме того, вам необходимо настроить объект звонка и

связать его на уровне клиента, кампании или группы объявлений.

`CLICK_TO_CALL`

Действие-конверсия CLICK_TO_CALL в веб-интерфейсе Google Рекламы будет называться Клики по номеру телефона на мобильном сайте.

Тип CLICK_TO_CALL отличается от типа AD_CALL тем, что не отслеживает фактические звонки. CLICK_TO_CALL отслеживает только клики по номеру телефона с мобильного устройства. Это полезно, если вы не можете использовать номер Google для переадресации, чтобы отслеживать звонки.

Расширенное отслеживание конверсий

Расширенное отслеживание конверсий позволяет повысить точность отслеживания конверсий, дополняя существующие теги конверсий собственными данными о конверсиях, такими как адрес электронной почты, имя, домашний адрес и номер телефона.

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

Тип действия-конверсии	Тип расширенной конверсии	Руководство по настройке API
`UPLOAD_CLICKS`	Расширенное отслеживание конверсий лидов Повышает точность регистрации офлайн-транзакций, совершаемых потенциальными клиентами или посетителями сайта.	Используйте Data Manager API (рекомендуется) или управляйте офлайн-конверсиями кликов с помощью существующих интеграций Google Ads API.
`WEBPAGE`	Расширенное отслеживание конверсий на сайтах Повышает точность регистрации онлайн-конверсий.	Руководство по настройке API

Дополнительные типы действий-конверсий

Google Ads API позволяет добавлять в отчеты дополнительные типы действий-конверсий, но может ограничивать или запрещать создание или изменение этих действий. Вы можете запросить действия-конверсии и их типы с помощью GoogleAdsService:

SELECT
  conversion_action.id,
  conversion_action.name,
  conversion_action.type,
  conversion_action.status
FROM conversion_action

Конверсии SKAdNetwork

Если вы проводите кампании для приложений iOS и реализовали SKAdNetwork, то можете получить доступ к данным SKAdNetwork, предоставленным Google, на уровне Customer и Campaign, используя следующие ресурсы:

Поле отчета	Описание
`metrics.sk_ad_network_installs`	Количество установок, зарегистрированных Apple. Этот показатель можно сегментировать только по любым сочетаниям сегментов `segments.sk_ad_network_conversion_value` и сегментов, связанных с датами.
`metrics.sk_ad_network_total_conversions`	Общее количество конверсий, включая установки и другие типы конверсий, зарегистрированных Apple. Этот показатель можно сегментировать только по сегментам, связанным с SKAdNetwork, и сегментам, связанным с датой.
`segments.sk_ad_network_ad_event_type`	Тип события, которое произошло в рамках определенной конверсии.
`segments.sk_ad_network_attribution_credit`	Как атрибуция присваивается определенной конверсии.
`segments.sk_ad_network_fine_conversion_value`	Ценность конверсии, зарегистрированная Apple. Этот сегмент можно применить только к показателям `metrics.sk_ad_network_installs` и `metrics.sk_ad_network_total_conversions`, а также комбинировать только с сегментами, связанными с датами. Если Apple сообщает значение `0`, то возвращается значение `0`, в противном случае возвращается значение "Нет". Чтобы различать эти случаи, проверьте наличие поля.
`segments.sk_ad_network_coarse_conversion_value`	Приблизительное значение для отдельной конверсии.
`segments.sk_ad_network_postback_sequence_index`	Позиция постбэка в последовательности для определенной конверсии.
`segments.sk_ad_network_source_app.sk_ad_network_source_app_id`	Идентификатор приложения, в котором было показано объявление, которое привело к установке из рекламной сети StoreKit для iOS.
`segments.sk_ad_network_source_domain`	Сайт, на котором было показано объявление, которое привело к установке из рекламной сети StoreKit для iOS. Нулевое значение означает, что сегмент неприменим (например, для кампании не для iOS) или не был указан в возвратах данных, отправленных Apple.
`segments.sk_ad_network_source_type`	Тип источника, в котором было показано объявление, которое привело к установке из рекламной сети StoreKit для iOS. Нулевое значение означает, что сегмент неприменим (например, для кампании не для iOS) или что ни исходный домен, ни исходное приложение не были указаны ни в одном из обратных вызовов, отправленных Apple.
`segments.sk_ad_network_user_type`	Тип пользователя, который совершил определенную конверсию.
`segments.sk_ad_network_redistributed_fine_conversion_value`	Ценности конверсий в этом сегменте включают нулевые значения, которые были перераспределены в ценности конверсий. Этот сегмент представляет собой сумму наблюдаемых детализированных ценностей конверсий, возвращенных Apple, и смоделированных Google пустых значений.
`segments.sk_ad_network_version`	Версия API рекламной сети Store Kit для iOS, которая использовалась.

Google Аналитика

Конверсии из связанного ресурса Google Аналитики имеют одно из следующих значений type:

Конверсия в ресурсе GA4:
- GOOGLE_ANALYTICS_4_CUSTOM
- GOOGLE_ANALYTICS_4_PURCHASE
Идентификатор ресурса GA4, название ресурса и название события также можно получить из поля google_analytics_4_settings.

Вы можете изменить следующие параметры конверсии ресурса GA4:

Импортируйте конверсию из ресурса GA4 в аккаунт Google Рекламы, изменив значение поля status с HIDDEN на ENABLED.
Измените поля primary_for_goal и category, чтобы указать, как это должно повлиять на назначение ставок и отчеты в Google Рекламе.
изменились name или value_settings.
Удалите конверсию из аккаунта Google Рекламы с помощью операции remove.

При попытке изменить другие атрибуты импортированной конверсии GA4 или любые атрибуты импортированной конверсии Universal Analytics возникает ошибка MUTATE_NOT_ALLOWED. Изменить их можно только в интерфейсе Google Рекламы.

Firebase и сторонние сервисы аналитики приложений

Чтобы импортировать конверсии из сторонних сервисов аналитики приложений или Firebase, измените status элемента ConversionAction с HIDDEN на ENABLED, используя метод mutate объекта ConversionActionService. Изменение значения app_id для этих действий-конверсий не поддерживается.

FIREBASE_ANDROID_APP_AD_IMPRESSION
FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_APP_AD_IMPRESSION
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Продажи в магазинах: импорт в действие-конверсию с отчетами

Хотя с помощью Google Ads API нельзя создавать действия-конверсии STORE_SALES или STORE_SALES_DIRECT_UPLOAD, этот API поддерживает импорт транзакций в магазинах.

STORE_SALES
STORE_SALES_DIRECT_UPLOAD

Типы действий-конверсий, доступные только для чтения

Следующие типы действий-конверсий доступны в Google Ads API только для чтения и используются для создания отчетов.

ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS

Неизвестно

Если в вашем аккаунте Google Рекламы есть другие типы действий-конверсий, то в запросах и отчетах могут возвращаться действия-конверсии, для которых параметр ConversionAction.type имеет значение UNKNOWN. API не поддерживает управление этими действиями-конверсиями, но возвращает их в отчетах, чтобы предоставить полные результаты для ключевых показателей конверсий, таких как metrics.conversions и metrics.conversions_value.

Обзор

Начало работы с конверсиями