ConversionAction

Конверсионное действие.

JSON-представление
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Поля
resourceName

string

Неизменный. Название ресурса действия-конверсии. Названия ресурсов действия-конверсии имеют следующий вид:

customers/{customerId}/conversionActions/{conversion_action_id}

status

enum ( ConversionActionStatus )

Статус этого действия-конверсии для начисления событий-конверсий.

type

enum ( ConversionActionType )

Неизменный. Тип этого действия-конверсии.

origin

enum ( ConversionOrigin )

Только вывод. Источник конверсии этого действия-конверсии.

category

enum ( ConversionActionCategory )

Категория конверсий, зарегистрированных для этого действия-конверсии.

valueSettings

object ( ValueSettings )

Настройки, связанные с ценностью событий-конверсий, связанных с этим действием-конверсией.

countingType

enum ( ConversionActionCountingType )

Как подсчитывать события-конверсии для действия-конверсии.

attributionModelSettings

object ( AttributionModelSettings )

Настройки, связанные с моделью атрибуции этого действия-конверсии.

tagSnippets[]

object ( TagSnippet )

Только вывод. Фрагменты, используемые для отслеживания конверсий.

mobileAppVendor

enum ( MobileAppVendor )

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

firebaseSettings

object ( FirebaseSettings )

Только вывод. Настройки Firebase для типов конверсий Firebase.

thirdPartyAppAnalyticsSettings

object ( ThirdPartyAppAnalyticsSettings )

Только вывод. Настройки сторонней аналитики приложений для сторонних типов конверсий.

googleAnalytics4Settings

object ( GoogleAnalytics4Settings )

Только вывод. Настройки Google Аналитики 4 для типов конверсий Google Аналитики 4.

id

string ( int64 format)

Только вывод. Идентификатор действия-конверсии.

name

string

Название действия-конверсии.

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

primaryForGoal

boolean

Если бит primeForGoal действия-конверсии имеет значение false, действие-конверсия не подлежит назначению ставок для всех кампаний, независимо от цели конверсии клиента или цели конверсии кампании. Однако специальные цели конверсии не учитывают PrimaryForGoal, поэтому, если в кампании есть специальная цель конверсии, настроенная с действием-конверсией PrimaryForGoal = false, это действие-конверсия по-прежнему может быть назначено для назначения ставки. По умолчанию PrimaryForGoal будет иметь значение true, если не установлено. В версии V9 для параметра PrimaryForGoal можно установить значение false только после создания с помощью операции обновления, поскольку оно не объявлено как необязательное.

ownerCustomer

string

Только вывод. Имя ресурса клиента-владельца действия-конверсии или значение NULL, если это действие-конверсия, определяемое системой.

includeInConversionsMetric

boolean

Следует ли включать это действие-конверсию в показатель "Конверсии".

clickThroughLookbackWindowDays

string ( int64 format)

Максимальное количество дней, которое может пройти между взаимодействием (например, кликом) и событием конверсии.

viewThroughLookbackWindowDays

string ( int64 format)

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

phoneCallDurationSeconds

string ( int64 format)

Продолжительность телефонного звонка в секундах, после которой следует сообщить о конверсии для этого действия-конверсии.

Значение должно находиться в диапазоне от 0 до 10 000 включительно.

appId

string

Идентификатор приложения для действия-конверсии.

Статус конверсионного действия

Возможные статусы действия-конверсии.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Конверсии будут записываться.
REMOVED Конверсии не будут регистрироваться.
HIDDEN Конверсии не будут записываться, а действие-конверсия не будет отображаться в пользовательском интерфейсе.

Тип действия конверсии

Возможные типы конверсионного действия.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AD_CALL Конверсии, которые происходят, когда пользователь нажимает на номер телефона в объявлении.
CLICK_TO_CALL Конверсии, которые происходят, когда пользователь на мобильном устройстве нажимает на номер телефона.
GOOGLE_PLAY_DOWNLOAD Конверсии, происходящие, когда пользователь загружает мобильное приложение из Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Конверсии, которые происходят, когда пользователь совершает покупку в приложении через биллинг Android.
UPLOAD_CALLS Конверсии по звонкам, которые отслеживаются и загружаются рекламодателем.
UPLOAD_CLICKS Конверсии, которые отслеживаются рекламодателем и загружаются с атрибуцией кликов.
WEBPAGE Конверсии, происходящие на веб-странице.
WEBSITE_CALL Конверсии, происходящие, когда пользователь звонит на динамически созданный номер телефона с сайта рекламодателя.
STORE_SALES_DIRECT_UPLOAD Конверсия продаж в магазине на основе загрузки данных собственных или сторонних продавцов. Только клиенты из белого списка могут использовать типы загрузки для прямых продаж в магазине.
STORE_SALES Конверсия продаж в магазине на основе загрузки данных собственных или сторонних продавцов и/или покупок в магазине с использованием карт платежных сетей. Только клиенты из белого списка могут использовать типы продаж в магазине. Только чтение.
FIREBASE_ANDROID_FIRST_OPEN Приложение Android впервые открывает конверсии, отслеживаемые через Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Конверсии в покупке приложений для Android, отслеживаемые через Firebase.
FIREBASE_ANDROID_CUSTOM Пользовательские конверсии в приложениях Android, отслеживаемые через Firebase.
FIREBASE_IOS_FIRST_OPEN Приложение iOS впервые открывает конверсии, отслеживаемые через Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Конверсии в покупке приложения для iOS, отслеживаемые через Firebase.
FIREBASE_IOS_CUSTOM Пользовательские конверсии приложений iOS, отслеживаемые через Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Первые открытые конверсии в приложении Android, отслеживаемые с помощью сторонней аналитики приложений.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Конверсии в покупках приложений Android, отслеживаемые с помощью сторонней аналитики приложений.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Пользовательские конверсии в приложениях Android, отслеживаемые с помощью сторонней аналитики приложений.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Первые открытые конверсии в приложении iOS, отслеживаемые с помощью сторонней аналитики приложений.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Конверсии в покупках приложений для iOS, отслеживаемые с помощью сторонней аналитики приложений.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Пользовательские конверсии в приложениях iOS, отслеживаемые с помощью сторонней аналитики приложений.
ANDROID_APP_PRE_REGISTRATION Конверсии, которые происходят, когда пользователь предварительно регистрирует мобильное приложение в Google Play Store. Только чтение.
ANDROID_INSTALLS_ALL_OTHER_APPS Конверсии, отслеживающие все загрузки из Google Play, которые не отслеживаются по типу приложения. Только чтение.
FLOODLIGHT_ACTION Действия Floodlight, подсчитывающие количество раз, когда пользователи посетили определенную веб-страницу после просмотра или нажатия на одно из объявлений рекламодателя. Только чтение.
FLOODLIGHT_TRANSACTION Действие Floodlight, отслеживающее количество совершенных продаж или количество приобретенных товаров. Также можно фиксировать общую стоимость каждой продажи. Только чтение.
GOOGLE_HOSTED Конверсии, отслеживающие локальные действия продуктов и сервисов Google после взаимодействия с рекламой. Только чтение.
LEAD_FORM_SUBMIT Конверсии регистрируются, когда пользователь отправляет форму для потенциальных клиентов. Только чтение.
SALESFORCE Конверсии, полученные от Salesforce. Только чтение.
SEARCH_ADS_360 Конверсии, импортированные из данных Search Ads 360 Floodlight. Только чтение.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Звонки-конверсии, которые происходят в объявлениях умной кампании без настройки отслеживания звонков, с использованием пользовательских критериев умной кампании. Только чтение.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Пользователь нажимает на элемент вызова на Картах Google. Только умная кампания. Только чтение.
SMART_CAMPAIGN_MAP_DIRECTIONS Пользователь запрашивает маршрут к местоположению компании на Картах Google. Только умная кампания. Только чтение.
SMART_CAMPAIGN_TRACKED_CALLS Звонки-конверсии, которые происходят в объявлениях умной кампании с настройкой отслеживания звонков и использованием пользовательских критериев умной кампании. Только чтение.
STORE_VISITS Конверсии, происходящие при посещении пользователем розничного магазина рекламодателя. Только чтение.
WEBPAGE_CODELESS Конверсии, созданные на основе событий веб-сайта (например, отправки форм или загрузки страниц), которые не используют индивидуально закодированные фрагменты событий. Только чтение.
UNIVERSAL_ANALYTICS_GOAL Конверсии, полученные благодаря связанным целям Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Конверсии, полученные в результате связанных транзакций Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Конверсии, полученные в результате связанных конверсий по специальным событиям Google Аналитики 4.
GOOGLE_ANALYTICS_4_PURCHASE Конверсии, полученные в результате связанных покупок-конверсий Google Аналитики 4.

Настройки значений

Настройки, связанные с ценностью событий-конверсий, связанных с этим действием-конверсией.

JSON-представление
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Поля
defaultValue

number

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

defaultCurrencyCode

string

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

alwaysUseDefaultValue

boolean

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

Конверсионное действиеCountingType

Указывает, как будут учитываться конверсии для этого действия. Дополнительную информацию см. на странице https://support.google.com/google-ads/answer/3438531 .

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ONE_PER_CLICK Засчитывайте только одну конверсию за клик.
MANY_PER_CLICK Подсчитайте все конверсии за клик.

Настройки модели атрибуции

Настройки, связанные с моделью атрибуции этого действия-конверсии.

JSON-представление
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Поля
attributionModel

enum ( AttributionModel )

Тип модели атрибуции этого действия-конверсии.

dataDrivenModelStatus

enum ( DataDrivenModelStatus )

Только вывод. Статус модели атрибуции на основе данных для действия-конверсии.

Модель атрибуции

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
EXTERNAL Использует внешнюю атрибуцию.
GOOGLE_ADS_LAST_CLICK Приписывает всю ценность конверсии последнему клику.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Приписывает всю ценность конверсии первому клику с помощью атрибуции поиска Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Приписывает ценность конверсии одинаково для всех кликов с помощью атрибуции Google Поиска.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Приписывает экспоненциально большую ценность конверсии недавним кликам с помощью атрибуции поиска Google (период полураспада составляет 1 неделю).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Приписывает 40 % ценности конверсии первому и последнему кликам. Остальные 20% равномерно распределяются по всем остальным кликам. При этом используется атрибуция Google Поиска.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Гибкая модель, использующая машинное обучение для определения надлежащего распределения ценности между кликами с помощью атрибуции Google Поиска.

Статус DataDrivenModelStatus

Перечисляет статусы модели, управляемой данными.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AVAILABLE Доступна модель, управляемая данными.
STALE Модель, управляемая данными, устарела. Он не обновлялся как минимум 7 дней. Он все еще используется, но срок его действия устареет, если он не будет обновлен в течение 30 дней.
EXPIRED Срок действия модели, управляемой данными, истек. Он не обновлялся как минимум 30 дней и не может быть использован. Чаще всего это происходит потому, что за последние 30 дней не произошло необходимого количества событий.
NEVER_GENERATED Модель, управляемая данными, никогда не была создана. Чаще всего это происходит потому, что ни за один 30-дневный период никогда не было необходимого количества событий.

Настройки Firebase

Настройки, связанные с действием-конверсией Firebase.

JSON-представление
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Поля
propertyId

string ( int64 format)

Только вывод. Идентификатор свойства GA конверсии.

propertyName

string

Только вывод. Имя свойства GA преобразования.

eventName

string

Только вывод. Имя события конверсии Firebase.

projectId

string

Только вывод. Идентификатор проекта Firebase конверсии.

Настройки ThirdPartyAppAnalytics

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

JSON-представление
{
  "providerName": string,
  "eventName": string
}
Поля
providerName

string

Только вывод. Название стороннего поставщика аналитики приложений.

eventName

string

Только вывод. Имя события конверсии сторонней аналитики приложений.

GoogleAnalytics4Настройки

Настройки, связанные с действием-конверсией Google Аналитики 4.

JSON-представление
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Поля
eventName

string

Только вывод. Название события GA 4.

propertyName

string

Только вывод. Имя свойства GA 4.

propertyId

string ( int64 format)

Только вывод. Идентификатор свойства GA 4.