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

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

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

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

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

Где происходит событие-конверсия?
- В офлайне (например, в офисе, магазине или по телефону). Перейдите к шагу 2.
- Непосредственно на сайте (например, покупки, регистрации или отправка форм). Перейдите к шагу 3.
- В мобильном приложении. Перейдите к шагу 4.
- Звонки по номеру, указанному в объявлении. Используйте Звонки по объявлениям (AD_CALL) (с помощью CallAsset).
- В продуктах и сервисах Google, связанных с местоположением (например, просмотр маршрута, звонки или клики в Google Картах). Подробнее о местных действиях-конверсиях (GOOGLE_HOSTED)…
Офлайн-конверсии
- Это телефонный звонок?
  - Да. Используйте
    
    Импорт звонков-конверсий (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.origin,
  conversion_action.category,
  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 Реклама автоматически создает местные действия-конверсии, чтобы отслеживать действия в продуктах и сервисах Google, связанных с местоположением (например, на Google Картах), после взаимодействия с объявлением.

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

Поля name (локализованное на язык аккаунта) и category идентифицируют каждое местное действие-конверсию, как показано в таблице ниже. Местные действия – посещения сайта и Местные действия – просмотры меню относятся к категории PAGE_VIEW и различаются в отчетах по conversion_action.name или conversion_action.id.

Название действия-конверсии в Google Рекламе	Поле `ConversionAction.category`	Описание
Клики-звонки	`CONTACT`	Нажатия на кнопку Позвонить в объявлении Google с указанием местоположения или в сервисе Google.
Местные действия: маршруты	`GET_DIRECTIONS`	Нажатия на кнопку Проложить маршрут в объявлении или сервисе Google на базе местоположения.
Местные действия: посещения сайта	`PAGE_VIEW`	Нажатия на ссылку на сайт в объявлении Google с указанием местоположения или в сервисе Google.
Местные действия: просмотры меню	`PAGE_VIEW`	Нажатия на ссылку на меню в объявлении Google с указанием местоположения или в сервисе Google.
Местные действия: заказы	`BEGIN_CHECKOUT`	Нажатия на кнопку Заказать в объявлении или сервисе Google на базе местоположения.
Местные действия: другие взаимодействия	`ENGAGEMENT`	Нажатия на другие отслеживаемые действия (например, поделиться местоположением или сохранить его) в объявлении или сервисе Google на основе местоположения.

По умолчанию для всех целей конверсий GOOGLE_HOSTED ставки не назначаются (для biddable задано значение false). Назначение ставок можно включить только для следующих целей по местным действиям:

Местные действия – маршруты (category – GET_DIRECTIONS, origin – GOOGLE_HOSTED):
- На уровне аккаунта. Задайте для поля biddable значение true в ресурсе CustomerConversionGoal для категории GET_DIRECTIONS и источника GOOGLE_HOSTED или включите действие-конверсию в CustomConversionGoal.
- Уровень кампании (только для кампаний с максимальной эффективностью, поисковых и торговых кампаний). Задайте для поля biddable значение true в ресурсе CampaignConversionGoal для категории GET_DIRECTIONS и источника GOOGLE_HOSTED.
Клики-звонки (category – CONTACT, origin – GOOGLE_HOSTED):
- Уровень кампании (только для кампаний с максимальной эффективностью). Задайте для поля biddable значение true в ресурсе CampaignConversionGoal для категории CONTACT и источника GOOGLE_HOSTED. Назначение ставок на уровне аккаунта с помощью CustomerConversionGoal не поддерживается для этой цели.

Все остальные категории GOOGLE_HOSTED (PAGE_VIEW, BEGIN_CHECKOUT и ENGAGEMENT) без назначения ставок. Подробнее о целях конверсий…

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

Перечисленные ниже типы действий-конверсий доступны в 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.

Обзор

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