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

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

Выберите правильный тип действия конверсии

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

  1. Где происходит событие конверсии?

    • В офлайн-мире (например, в вашем офисе, офисе или по телефону): перейдите к шагу 2 .
    • Непосредственно на вашем веб-сайте (например, при совершении покупок, регистрации или заполнении форм): перейдите к шагу 3 .
    • В мобильном приложении : перейдите к шагу 4 .
    • При телефонном звонке, совершенном непосредственно из ваших объявлений : используйте звонки из объявлений ( AD_CALL ) (с помощью CallAsset ).

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

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

  4. Конверсии мобильных приложений:

    • Достаточно ли отслеживания установок или покупок в Google Play Store?
    • Вы отслеживаете действия в приложении с помощью Google Analytics (GA4) или сторонних сервисов аналитики приложений?

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

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

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

Тип действия конверсии Источник рекламы Google Руководство по настройке API
UPLOAD_CLICKS Отслеживайте конверсии от кликов и улучшенные конверсии для лидов. Используйте API менеджера данных.
UPLOAD_CALLS Отслеживайте конверсии звонков Руководство по импорту данных о конверсиях звонков
STORE_SALES Отслеживание конверсий, продаж в магазине. См. раздел «Продажи в магазине: импорт в конверсию с отчетностью» для получения подробной информации.

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

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

Для отслеживания конверсий на вашем веб-сайте необходимо создать объект ConversionAction с ConversionActionType , установленным на WEBPAGE , и добавить фрагмент кода, называемый тегом, на страницу конверсии на вашем веб-сайте.

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

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

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

Тип кода отслеживания Источник рекламы Google
WEBPAGE Веб-сайт, Веб-сайт (Google Analytics (GA4))
WEBPAGE_ONCLICK Веб-сайт, Веб-сайт (Google Analytics (GA4))
CLICK_TO_CALL клики по номеру телефона

конверсии приложений

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

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

Тип действия конверсии Источник рекламы Google
GOOGLE_PLAY_DOWNLOAD Google Play > Установки
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > Встроенные покупки

Чтобы отслеживать другие действия в мобильном приложении с помощью функций Google Analytics 4 или сторонних инструментов аналитики приложений , см. раздел «Дополнительные типы действий конверсии» .

Конверсии телефонных звонков

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

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

Тип действия конверсии Источник рекламы Google
AD_CALL Звонки с рекламных объявлений, использующих расширения для звонков или объявления только для звонков.
WEBSITE_CALL Звонки на номер телефона, указанный на вашем сайте.
CLICK_TO_CALL Нажатия на цифру на вашем мобильном сайте

AD_CALL

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

Звонок считается конверсией, если он длится дольше указанного времени. По умолчанию это 60 секунд.

WEBSITE_CALL

Действие конверсии WEBSITE_CALL отображается в веб-интерфейсе Google Ads как « Звонки с веб-сайта» .

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

CLICK_TO_CALL

Действие конверсии CLICK_TO_CALL отображается в веб-интерфейсе Google Ads как «Клик по вашему номеру на мобильном сайте» .

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

Улучшенная конверсия

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

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

Тип действия конверсии Расширенный тип преобразования Руководство по настройке API
UPLOAD_CLICKS Повышение конверсии лидов
Улучшает измерение офлайн-транзакций, совершенных пользователями сайта (потенциальными клиентами или посетителями).		 Используйте API менеджера данных.
WEBPAGE Повышение конверсии для веб-сайта
Улучшает измерение онлайн-конверсий.		 Руководство по настройке API

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

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

конверсии 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 Идентификатор приложения, в котором была показана реклама, которая привела к установке рекламного комплекта iOS Store Kit.
segments.sk_ad_network_source_domain Веб-сайт, где была показана реклама, которая привела к установке рекламного комплекта iOS Store Kit Ad Network. Значение null означает, что этот сегмент неприменим — например, кампания не для iOS — или отсутствовал в каких-либо обратных сообщениях, отправленных Apple.
segments.sk_ad_network_source_type Тип источника, в котором была показана реклама, приведшая к установке iOS Store Kit Ad Network. Значение null означает, что этот сегмент неприменим — например, кампания не для 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 Analytics, имеют одно из следующих значений type :

  • Преобразование свойств GA4:

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    Также вы можете получить идентификатор свойства GA4, название свойства и название события из поля google_analytics_4_settings .

В преобразование свойств в GA4 можно внести следующие изменения:

Любая попытка изменить другие атрибуты импортированной конверсии GA4 или любые атрибуты импортированной конверсии Universal Analytics приводит к ошибке MUTATE_NOT_ALLOWED . Вносить эти изменения можно только через пользовательский интерфейс Google Ads.

Аналитика приложений Firebase и сторонних разработчиков

Для импорта данных из сторонних сервисов App Analytics или конверсий Firebase измените status ConversionAction с HIDDEN на ENABLED , используя метод mutate ConversionActionService . Обновление app_id для этих действий конверсии не поддерживается.

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • 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 с помощью API Google Ads, API поддерживает импорт транзакций продаж магазина .

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

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

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

  • 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 Ads присутствуют другие типы действий конверсии, вы можете обнаружить, что запросы и отчеты возвращают действия конверсии, где ConversionAction.type имеет значение UNKNOWN . API не поддерживает управление этими действиями конверсии, но возвращает их в отчетах для предоставления полных результатов по ключевым показателям конверсии, таким как metrics.conversions и metrics.conversions_value .

,

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

Выберите правильный тип действия конверсии

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

  1. Где происходит событие конверсии?

    • В офлайн-мире (например, в вашем офисе, офисе или по телефону): перейдите к шагу 2 .
    • Непосредственно на вашем веб-сайте (например, при совершении покупок, регистрации или заполнении форм): перейдите к шагу 3 .
    • В мобильном приложении : перейдите к шагу 4 .
    • При телефонном звонке, совершенном непосредственно из ваших объявлений : используйте звонки из объявлений ( AD_CALL ) (с помощью CallAsset ).

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

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

  4. Конверсии мобильных приложений:

    • Достаточно ли отслеживания установок или покупок в Google Play Store?
    • Вы отслеживаете действия в приложении с помощью Google Analytics (GA4) или сторонних сервисов аналитики приложений?

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

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

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

Тип действия конверсии Источник рекламы Google Руководство по настройке API
UPLOAD_CLICKS Отслеживайте конверсии от кликов и улучшенные конверсии для лидов. Используйте API менеджера данных.
UPLOAD_CALLS Отслеживайте конверсии звонков Руководство по импорту данных о конверсиях звонков
STORE_SALES Отслеживание конверсий, продаж в магазине. См. раздел «Продажи в магазине: импорт в конверсию с отчетностью» для получения подробной информации.

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

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

Для отслеживания конверсий на вашем веб-сайте необходимо создать объект ConversionAction с ConversionActionType , установленным на WEBPAGE , и добавить фрагмент кода, называемый тегом, на страницу конверсии на вашем веб-сайте.

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

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

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

Тип кода отслеживания Источник рекламы Google
WEBPAGE Веб-сайт, Веб-сайт (Google Analytics (GA4))
WEBPAGE_ONCLICK Веб-сайт, Веб-сайт (Google Analytics (GA4))
CLICK_TO_CALL клики по номеру телефона

конверсии приложений

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

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

Тип действия конверсии Источник рекламы Google
GOOGLE_PLAY_DOWNLOAD Google Play > Установки
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > Встроенные покупки

Чтобы отслеживать другие действия в мобильном приложении с помощью функций Google Analytics 4 или сторонних инструментов аналитики приложений , см. раздел «Дополнительные типы действий конверсии» .

Конверсии телефонных звонков

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

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

Тип действия конверсии Источник рекламы Google
AD_CALL Звонки с рекламных объявлений, использующих расширения для звонков или объявления только для звонков.
WEBSITE_CALL Звонки на номер телефона, указанный на вашем сайте.
CLICK_TO_CALL Нажатия на цифру на вашем мобильном сайте

AD_CALL

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

Звонок считается конверсией, если он длится дольше указанного времени. По умолчанию это 60 секунд.

WEBSITE_CALL

Действие конверсии WEBSITE_CALL отображается в веб-интерфейсе Google Ads как « Звонки с веб-сайта» .

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

CLICK_TO_CALL

Действие конверсии CLICK_TO_CALL отображается в веб-интерфейсе Google Ads как «Клик по вашему номеру на мобильном сайте» .

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

Улучшенная конверсия

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

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

Тип действия конверсии Расширенный тип преобразования Руководство по настройке API
UPLOAD_CLICKS Повышение конверсии лидов
Улучшает измерение офлайн-транзакций, совершенных пользователями сайта (потенциальными клиентами или посетителями).		 Используйте API менеджера данных.
WEBPAGE Повышение конверсии для веб-сайта
Улучшает измерение онлайн-конверсий.		 Руководство по настройке API

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

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

конверсии 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 Идентификатор приложения, в котором была показана реклама, которая привела к установке рекламного комплекта iOS Store Kit.
segments.sk_ad_network_source_domain Веб-сайт, где была показана реклама, которая привела к установке рекламного комплекта iOS Store Kit Ad Network. Значение null означает, что этот сегмент неприменим — например, кампания не для iOS — или отсутствовал в каких-либо обратных сообщениях, отправленных Apple.
segments.sk_ad_network_source_type Тип источника, в котором была показана реклама, приведшая к установке iOS Store Kit Ad Network. Значение null означает, что этот сегмент неприменим — например, кампания не для 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 Analytics, имеют одно из следующих значений type :

  • Преобразование свойств GA4:

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    Также вы можете получить идентификатор свойства GA4, название свойства и название события из поля google_analytics_4_settings .

В преобразование свойств в GA4 можно внести следующие изменения:

Любая попытка изменить другие атрибуты импортированной конверсии GA4 или любые атрибуты импортированной конверсии Universal Analytics приводит к ошибке MUTATE_NOT_ALLOWED . Вносить эти изменения можно только через пользовательский интерфейс Google Ads.

Аналитика приложений Firebase и сторонних разработчиков

Для импорта данных из сторонних сервисов App Analytics или конверсий Firebase измените status ConversionAction с HIDDEN на ENABLED , используя метод mutate ConversionActionService . Обновление app_id для этих действий конверсии не поддерживается.

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • 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 с помощью API Google Ads, API поддерживает импорт транзакций продаж магазина .

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

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

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

  • 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 Ads присутствуют другие типы действий конверсии, вы можете обнаружить, что запросы и отчеты возвращают действия конверсии, где ConversionAction.type имеет значение UNKNOWN . API не поддерживает управление этими действиями конверсии, но возвращает их в отчетах для предоставления полных результатов по ключевым показателям конверсии, таким как metrics.conversions и metrics.conversions_value .

,

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

Выберите правильный тип действия конверсии

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

  1. Где происходит событие конверсии?

    • В офлайн-мире (например, в вашем офисе, офисе или по телефону): перейдите к шагу 2 .
    • Непосредственно на вашем веб-сайте (например, при совершении покупок, регистрации или заполнении форм): перейдите к шагу 3 .
    • В мобильном приложении : перейдите к шагу 4 .
    • При телефонном звонке, совершенном непосредственно из ваших объявлений : используйте звонки из объявлений ( AD_CALL ) (с помощью CallAsset ).

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

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

  4. Конверсии мобильных приложений:

    • Достаточно ли отслеживания установок или покупок в Google Play Store?
    • Вы отслеживаете действия в приложении с помощью Google Analytics (GA4) или сторонних сервисов аналитики приложений?

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

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

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

Тип действия конверсии Источник рекламы Google Руководство по настройке API
UPLOAD_CLICKS Отслеживайте конверсии от кликов и улучшенные конверсии для лидов. Используйте API менеджера данных.
UPLOAD_CALLS Отслеживайте конверсии звонков Руководство по импорту данных о конверсиях звонков
STORE_SALES Отслеживание конверсий, продаж в магазине. См. раздел «Продажи в магазине: импорт в конверсию с отчетностью» для получения подробной информации.

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

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

Для отслеживания конверсий на вашем веб-сайте необходимо создать объект ConversionAction с ConversionActionType , установленным на WEBPAGE , и добавить фрагмент кода, называемый тегом, на страницу конверсии на вашем веб-сайте.

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

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

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

Тип кода отслеживания Источник рекламы Google
WEBPAGE Веб-сайт, Веб-сайт (Google Analytics (GA4))
WEBPAGE_ONCLICK Веб-сайт, Веб-сайт (Google Analytics (GA4))
CLICK_TO_CALL клики по номеру телефона

конверсии приложений

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

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

Тип действия конверсии Источник рекламы Google
GOOGLE_PLAY_DOWNLOAD Google Play > Установки
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > Встроенные покупки

Чтобы отслеживать другие действия в мобильном приложении с помощью функций Google Analytics 4 или сторонних инструментов аналитики приложений , см. раздел «Дополнительные типы действий конверсии» .

Конверсии телефонных звонков

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

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

Тип действия конверсии Источник рекламы Google
AD_CALL Звонки с рекламных объявлений, использующих расширения для звонков или объявления только для звонков.
WEBSITE_CALL Звонки на номер телефона, указанный на вашем сайте.
CLICK_TO_CALL Нажатия на цифру на вашем мобильном сайте

AD_CALL

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

Звонок считается конверсией, если он длится дольше указанного времени. По умолчанию это 60 секунд.

WEBSITE_CALL

Действие конверсии WEBSITE_CALL отображается в веб-интерфейсе Google Ads как « Звонки с веб-сайта» .

Unlike AD_CALL , this tracker requires event_snippet and global_site_tag to be added to your website to retrieve the dynamic Google forwarding number for call tracking on numbers listed on your website. In addition, you must set up a call asset and link it at the customer, campaign, or ad group level .

CLICK_TO_CALL

A CLICK_TO_CALL conversion action appears as a Clicks on your number on your mobile website conversion in the Google Ads web interface.

The CLICK_TO_CALL type differs from the AD_CALL type in that it does not track actual phone calls. Instead, CLICK_TO_CALL only tracks clicks on a phone number from a mobile device. This is useful when you're unable to use a Google forwarding number for tracking phone calls.

Enhanced conversions

Enhanced conversions help you to improve the accuracy of your conversion measurement by supplementing your existing conversion tags with first-party conversion data, like email address, name, home address, and phone number.

The following table shows the equivalent API parameters to use for each Enhanced Conversion Type :

Conversion Action Type Enhanced Conversion Type API Setup Guide
UPLOAD_CLICKS Enhanced conversions for leads
Improves measurement of offline transactions that came from a website lead or visitor		 Use the Data Manager API
WEBPAGE Enhanced conversions for web
Improves measurement of online conversions		 API Setup Guide

Additional conversion action types

The Google Ads API makes additional types of conversion actions available in reports, but may limit or prohibit creation or modification of those actions.

SKAdNetwork conversions

If you run iOS App campaigns and have implemented SKAdNetwork , you can access SKAdNetwork data provided to Google at the Customer and Campaign level using the following resources:

Report field Описание
metrics.sk_ad_network_installs The number of installs reported by Apple. This metric can only be segmented by any combination of segments.sk_ad_network_conversion_value and date-related segments.
metrics.sk_ad_network_total_conversions The total number of conversions, including installs and other types of conversions reported by Apple. This metric can only be segmented by SKAdNetwork-related segments and date-related segments.
segments.sk_ad_network_ad_event_type The type of event that occurred for a particular conversion.
segments.sk_ad_network_attribution_credit How attribution is credited for a particular conversion.
segments.sk_ad_network_fine_conversion_value

The value of a conversion reported by Apple. This segment cannot be applied to any metrics other than metrics.sk_ad_network_installs , metrics.sk_ad_network_total_conversions , and can only be combined with date-related segments.

A value of 0 is returned if Apple reports a value of 0 and no value otherwise. Check the field presence to distinguish between the two cases.

segments.sk_ad_network_coarse_conversion_value The coarse value for an individual conversion.
segments.sk_ad_network_postback_sequence_index The position of the postback, in sequence, for a particular conversion.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id The app id where the ad that drove the iOS Store Kit Ad Network install was shown.
segments.sk_ad_network_source_domain The website where the ad that drove the iOS Store Kit Ad Network install was shown. A null value means this segment is not applicable--for example, a non-iOS campaign--or was not present in any postbacks sent by Apple.
segments.sk_ad_network_source_type The source type where the ad that drove the iOS Store Kit Ad Network install was shown. A null value means this segment is not applicable — for example, non-iOS campaign — or that neither the source domain nor source app were present in any postbacks sent by Apple.
segments.sk_ad_network_user_type The type of user that generated a particular conversion.
segments.sk_ad_network_redistributed_fine_conversion_value The conversion values in this segment include null values that were redistributed to conversion values. This segment represents the sum of observed fine conversion values returned by Apple and modeled null values from Google.
segments.sk_ad_network_version The iOS Store Kit Ad Network API version that was used.

Google Аналитика

Conversions from a linked Google Analytics property have one of the following type values:

  • GA4 property conversion:

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    You can also retrieve the GA4 property ID, property name, and event name from the google_analytics_4_settings field.

You can make the following changes to a GA4 property conversion:

  • Import the conversion from your GA4 property into your Google Ads account by modifying its status field from HIDDEN to ENABLED .
  • Modify its primary_for_goal and category fields to indicate how it should impact Google Ads bidding and reports .
  • Update its name or value_settings .
  • Remove the conversion from your Google Ads account using a remove operation.

Any attempt to modify other attributes of an imported GA4 conversion or any attributes of an imported Universal Analytics conversion results in a MUTATE_NOT_ALLOWED error. You can only make those changes using the Google Ads UI.

Firebase and third-party app analytics

To import third-party app analytics or Firebase conversions, change the status of the ConversionAction from HIDDEN to ENABLED using the mutate method of ConversionActionService . Updating the app_id is not supported for these conversion actions.

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • 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: import to conversion action with reporting

Although you cannot create STORE_SALES or STORE_SALES_DIRECT_UPLOAD conversion actions using the Google Ads API, the API does support importing store sales transactions .

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

Read-only conversion action types

The following conversion action types are read-only in the Google Ads API and provided for reporting purposes.

  • 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

Неизвестный

If your Google Ads account includes other types of conversion actions, you may find that queries and reports return conversion actions where the ConversionAction.type is UNKNOWN . The API does not support managing these conversion actions, but returns them in reports in order to provide complete results for key conversion metrics such as metrics.conversions and metrics.conversions_value .

Назад
Обзор
Далее
Начните работу с конверсиями