Присоединяйтесь к нам 15 октября в 17:00 по московскому времени на сервере сообщества Google по рекламе и аналитике в Discord и на YouTube. Мы обсудим новые функции, добавленные в Google Ads API версии 26.

Чтобы переводить контент на ваш предпочитаемый язык, 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

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

Хотя вы не можете создавать действия-конверсии STORE_SALES или STORE_SALES_DIRECT_UPLOAD с помощью Google Ads API, этот 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.

Обзор

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