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

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.

Обзор

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