SearchAds360Row

Возвращенная строка из запроса.

JSON-представление 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Поля
adGroup

object ( AdGroup )

Группа объявлений, указанная в запросе.

adGroupAd

object ( AdGroupAd )

Объявление, упомянутое в запросе.

adGroupAdEffectiveLabel

object ( AdGroupAdEffectiveLabel )

Метка "эффективное действие объявления" для группы объявлений, указанная в запросе.

adGroupAdLabel

object ( AdGroupAdLabel )

Метка группы объявлений, указанная в запросе.

adGroupAsset

object ( AdGroupAsset )

Указанный в запросе ресурс группы объявлений.

adGroupAssetSet

object ( AdGroupAssetSet )

Набор ресурсов группы объявлений, на который ссылается запрос.

adGroupAudienceView

object ( AdGroupAudienceView )

Представление аудитории группы объявлений, на которое ссылается запрос.

adGroupBidModifier

object ( AdGroupBidModifier )

Модификатор ставки, указанный в запросе.

adGroupCriterion

object ( AdGroupCriterion )

Критерий, указанный в запросе.

adGroupCriterionEffectiveLabel

object ( AdGroupCriterionEffectiveLabel )

Метка эффективности критерия рекламной группы, указанная в запросе.

adGroupCriterionLabel

object ( AdGroupCriterionLabel )

Метка критерия группы объявлений, указанная в запросе.

adGroupEffectiveLabel

object ( AdGroupEffectiveLabel )

Метка, обозначающая эффективную группу объявлений, указанная в запросе.

adGroupLabel

object ( AdGroupLabel )

Метка группы объявлений, указанная в запросе.

ageRangeView

object ( AgeRangeView )

Представление возрастного диапазона, на которое ссылается запрос.

asset

object ( Asset )

Актив, указанный в запросе.

assetGroupAsset

object ( AssetGroupAsset )

Группа активов, на которую ссылается запрос.

assetGroupSignal

object ( AssetGroupSignal )

Сигнал группы активов, указанный в запросе.

assetGroupListingGroupFilter

object ( AssetGroupListingGroupFilter )

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

assetGroupTopCombinationView

object ( AssetGroupTopCombinationView )

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

assetGroup

object ( AssetGroup )

Группа активов, указанная в запросе.

assetSetAsset

object ( AssetSetAsset )

Набор активов, на который ссылается запрос.

assetSet

object ( AssetSet )

Набор активов, на который ссылается запрос.

biddingStrategy

object ( BiddingStrategy )

Стратегия назначения ставок, указанная в запросе.

campaignBudget

object ( CampaignBudget )

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

campaign

object ( Campaign )

Кампания, упомянутая в запросе.

campaignAsset

object ( CampaignAsset )

Материал кампании, упомянутый в запросе.

campaignAssetSet

object ( CampaignAssetSet )

Набор ресурсов кампании, на который ссылается запрос.

campaignAudienceView

object ( CampaignAudienceView )

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

campaignCriterion

object ( CampaignCriterion )

Критерий кампании, указанный в запросе.

campaignEffectiveLabel

object ( CampaignEffectiveLabel )

Эффективная метка кампании, указанная в запросе.

campaignLabel

object ( CampaignLabel )

Метка кампании, указанная в запросе.

cartDataSalesView

object ( CartDataSalesView )

Представление данных о продажах в корзине, на которое ссылается запрос.

audience

object ( Audience )

Целевая аудитория, указанная в запросе.

conversionAction

object ( ConversionAction )

Действие преобразования, указанное в запросе.

conversionCustomVariable

object ( ConversionCustomVariable )

Пользовательская переменная преобразования, на которую ссылается запрос.

customer

object ( Customer )

Клиент, упомянутый в запросе.

customerAsset

object ( CustomerAsset )

Актив клиента, указанный в запросе.

customerAssetSet

object ( CustomerAssetSet )

Набор активов клиента, на который ссылается запрос.

accessibleBiddingStrategy

object ( AccessibleBiddingStrategy )

Доступная стратегия назначения ставок, упомянутая в запросе.

customerClient

object ( CustomerClient )

Объект CustomerClient, указанный в запросе.

dynamicSearchAdsSearchTermView

object ( DynamicSearchAdsSearchTermView )

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

genderView

object ( GenderView )

Гендерная точка зрения, упомянутая в запросе.

geoTargetConstant

object ( GeoTargetConstant )

Константа целевого географического местоположения, указанная в запросе.

keywordView

object ( KeywordView )

Ключевое слово view, на которое ссылается запрос.

label

object ( Label )

Метка, указанная в запросе.

languageConstant

object ( LanguageConstant )

Языковая константа, указанная в запросе.

locationView

object ( LocationView )

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

productBiddingCategoryConstant

object ( ProductBiddingCategoryConstant )

Категория ставок на товар, указанная в запросе.

productGroupView

object ( ProductGroupView )

Представление группы товаров, на которое ссылается запрос.

shoppingPerformanceView

object ( ShoppingPerformanceView )

Представление показателей эффективности покупок, на которое ссылается запрос.

userList

object ( UserList )

Список пользователей, на который ссылается запрос.

userLocationView

object ( UserLocationView )

Представление местоположения пользователя, на которое ссылается запрос.

webpageView

object ( WebpageView )

Страница веб-сайта, указанная в запросе.

visit

object ( Visit )

В запросе указан визит на уровне события.

conversion

object ( Conversion )

Преобразование на уровне события, указанное в запросе.

metrics

object ( Metrics )

Показатели.

segments

object ( Segments )

Сегменты.

customColumns[]

object ( Value )

Пользовательские столбцы.

AdGroup

Группа рекламных объявлений.

JSON-представление 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Поля
resourceName

string

Имя ресурса группы объявлений. Имена ресурсов группы объявлений имеют следующий формат:

customers/{customerId}/adGroups/{adGroupId}

status

enum ( AdGroupStatus )

Статус группы объявлений.

type

enum ( AdGroupType )

Тип группы объявлений.

adRotationMode

enum ( AdGroupAdRotationMode )

Режим ротации объявлений в группе объявлений.

creationTime

string

Отметка времени создания этой группы объявлений. Отметка времени указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

targetingSetting

object ( TargetingSetting )

Настройки для целевых функций.

labels[]

string

Названия ресурсов меток, прикрепленных к этой группе объявлений.

effectiveLabels[]

string

Названия ресурсов эффективных меток, прикрепленных к этой группе объявлений. Эффективная метка — это метка, унаследованная или непосредственно присвоенная этой группе объявлений.

engineId

string

Идентификатор группы объявлений во внешнем аккаунте рекламной системы. Это поле предназначено только для аккаунтов, не относящихся к Google Ads, например, Yahoo Japan, Microsoft, Baidu и т. д. Для сущностей Google Ads используйте вместо этого "adGroup.id".

startDate

string

Дата начала показа рекламы в этой группе объявлений. По умолчанию показ начинается сейчас или в дату начала показа, в зависимости от того, какая дата позже. Если это поле задано, показ рекламы начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook Gateway.

Формат: ГГГГ-ММ-ДД. Пример: 2019-03-14

endDate

string

Дата окончания показа объявлений в группе объявлений. По умолчанию группа объявлений завершает свою работу в указанную дату. Если это поле задано, то группа объявлений завершает свою работу в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и Facebook Gateway.

Формат: ГГГГ-ММ-ДД. Пример: 2019-03-14

languageCode

string

Язык объявлений и ключевых слов в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Подробнее: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Дата и время последнего изменения этой группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

id

string ( int64 format)

Идентификатор группы объявлений.

name

string

Название группы объявлений.

Это обязательное поле, и его нельзя оставлять пустым при создании групп объявлений.

Оно должно содержать менее 255 символов полной ширины в кодировке UTF-8.

В тексте не должно содержаться нулевых символов (код 0x0), символов перевода строки (код 0xA) или возврата каретки (код 0xD).

trackingUrlTemplate

string

Шаблон URL для создания URL-адреса отслеживания.

cpcBidMicros

string ( int64 format)

Максимальная ставка CPC (стоимость за клик). Это поле используется, если эффективная стратегия назначения ставок для группы объявлений — «Ручная CPC». Это поле неприменимо и будет проигнорировано, если в кампании группы объявлений используется стратегия назначения ставок «Портфолио».

engineStatus

enum ( AdGroupEngineStatus )

Статус поисковой системы для группы объявлений.

finalUrlSuffix

string

Шаблон URL-адреса для добавления параметров к итоговому URL-адресу.

AdGroupStatus

Возможные статусы группы объявлений.

Перечисления
UNSPECIFIED Статус не указан.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

ENABLED Группа объявлений активирована.
PAUSED Работа группы объявлений приостановлена.
REMOVED Группа объявлений удалена.

AdGroupType

Перечисление возможных типов группы объявлений.

Перечисления
UNSPECIFIED Тип не указан.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

SEARCH_STANDARD Тип группы объявлений по умолчанию для поисковых кампаний.
DISPLAY_STANDARD Тип группы объявлений по умолчанию для медийных кампаний.
SHOPPING_PRODUCT_ADS Тип группы объявлений для торговых кампаний, в которых показываются стандартные товарные объявления.
HOTEL_ADS Тип группы объявлений по умолчанию для кампаний, посвященных отелям.
SHOPPING_SMART_ADS Тип данных для групп объявлений в кампаниях Smart Shopping.
VIDEO_BUMPER Короткие рекламные видеоролики, которые нельзя пропустить, прямо в потоке.
VIDEO_TRUE_VIEW_IN_STREAM Рекламные объявления TrueView (с возможностью пропуска) в видеопотоке.
VIDEO_TRUE_VIEW_IN_DISPLAY Видеореклама TrueView, размещаемая на экране.
VIDEO_NON_SKIPPABLE_IN_STREAM Неотключаемая рекламная вставка в видеопотоке.
VIDEO_OUTSTREAM Видеореклама вне потока.
SEARCH_DYNAMIC_ADS Тип группы объявлений для групп объявлений динамического поиска.
SHOPPING_COMPARISON_LISTING_ADS Тип данных для групп объявлений в кампаниях сравнения товаров.
PROMOTED_HOTEL_ADS Тип группы объявлений для групп объявлений «Рекламируемые отели».
VIDEO_RESPONSIVE Видеорекламные группы с адаптивным дизайном.
VIDEO_EFFICIENT_REACH Видеорекламные группы с эффективным охватом.
SMART_CAMPAIGN_ADS Тип группы объявлений для интеллектуальных кампаний.
TRAVEL_ADS Тип группы объявлений для рекламных кампаний в сфере туризма.

AdGroupAdRotationMode

Возможные режимы ротации объявлений в группе объявлений.

Перечисления
UNSPECIFIED Режим ротации рекламы не указан.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

OPTIMIZE Оптимизируйте объявления в группах объявлений на основе кликов или конверсий.
ROTATE_FOREVER Вращаться равномерно бесконечно.

AdGroupEngineStatus

Состояние механизма группировки объявлений.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
AD_GROUP_ELIGIBLE

Устарело. Не использовать.

AD_GROUP_EXPIRED В данной группе объявлений реклама не показывается, поскольку срок действия группы объявлений истек.
AD_GROUP_REMOVED Группа объявлений удалена.
AD_GROUP_DRAFT Для этой группы объявлений объявления не отображаются, поскольку связанная с ней группа объявлений все еще находится в черновике.
AD_GROUP_PAUSED Работа рекламной группы приостановлена.
AD_GROUP_SERVING Группа рекламодателей активна и в настоящее время размещает рекламу.
AD_GROUP_SUBMITTED Группа объявлений отправлена ​​(устаревший статус Microsoft Bing Ads).
CAMPAIGN_PAUSED В этой группе объявлений реклама не показывается, поскольку кампания приостановлена.
ACCOUNT_PAUSED В этой группе объявлений реклама не показывается, поскольку аккаунт приостановлен.

Настройки таргетинга

Настройки функций таргетинга на уровне кампаний и групп объявлений. Для получения более подробной информации о настройках таргетинга посетите https://support.google.com/google-ads/answer/7365594

JSON-представление 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Поля
targetRestrictions[]

object ( TargetRestriction )

Параметр таргетинга для ограничения охвата вашей кампании или группы объявлений.

TargetRestriction

Список настроек таргетинга по каждому параметру.

JSON-представление 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Поля
targetingDimension

enum ( TargetingDimension )

Параметр таргетинга, к которому применяются эти настройки.

bidOnly

boolean

Указывает, следует ли ограничивать показ ваших объявлений только критериями, выбранными для этого параметра таргетинга, или же нацеливаться на все значения этого параметра и показывать объявления на основе таргетинга в других параметрах таргетинга. Значение true означает, что эти критерии будут применять только модификаторы ставок и не будут влиять на таргетинг. Значение false означает, что эти критерии будут ограничивать таргетинг, а также применять модификаторы ставок.

Целевое измерение

Перечисление, описывающее возможные параметры целевого воздействия.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
KEYWORD Критерии ключевых слов, например, «марсианский круиз». KEYWORD может использоваться в качестве пользовательского параметра назначения ставок. Ключевые слова всегда являются параметром таргетинга, поэтому их нельзя установить в качестве целевого параметра «ВСЕ» с помощью TargetRestriction.
AUDIENCE Критерии целевой аудитории, включающие список пользователей, интересы пользователей, предпочтения пользователей и заинтересованность пользователей в определенном сегменте рынка.
TOPIC Критерии тематики для таргетирования категорий контента, например, 'category::Animals>Pets', используются для таргетирования на медийную и видеорекламу.
GENDER Критерии для определения гендерного аспекта.
AGE_RANGE Критерии для определения целевых возрастных групп.
PLACEMENT Критерии размещения включают веб-сайты, такие как 'www.flowers4sale.com', а также мобильные приложения, категории мобильных приложений, видеоролики на YouTube и каналы на YouTube.
PARENTAL_STATUS Критерии для определения целевого статуса родителя.
INCOME_RANGE Критерии для определения целевого диапазона доходов.

AdGroupAd

Объявление группы объявлений.

JSON-представление 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Поля
resourceName

string

Имя ресурса объявления. Имена ресурсов объявлений в группах объявлений имеют следующий формат:

customers/{customerId}/adGroupAds/{adGroupId}~{adId}

status

enum ( AdGroupAdStatus )

Статус объявления.

ad

object ( Ad )

Реклама.

creationTime

string

Отметка времени создания этой группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

labels[]

string

Названия ресурсов меток, прикрепленных к этому объявлению группы.

effectiveLabels[]

string

Названия ресурсов эффективных меток, прикрепленных к этому объявлению. Эффективная метка — это метка, унаследованная или непосредственно присвоенная этому объявлению.

engineId

string

Идентификатор объявления во внешнем аккаунте поисковой системы. Это поле предназначено только для аккаунтов Search Ads 360, например, Yahoo Japan, Microsoft, Baidu и т. д. Для организаций, не входящих в Search Ads 360, используйте вместо этого "adGroupAd.ad.id".

engineStatus

enum ( AdGroupAdEngineStatus )

Дополнительный статус объявления во внешнем аккаунте поисковой системы. Возможные статусы (в зависимости от типа внешнего аккаунта): активно, подходит, ожидает проверки и т. д.

lastModifiedTime

string

Дата и время последнего изменения данного объявления в группе объявлений. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

AdGroupAdStatus

Возможные статусы объявления AdGroupAd.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

ENABLED Группа объявлений включена.
PAUSED Показ рекламной группы приостановлен.
REMOVED Объявление из группы объявлений удалено.

FinalAppUrl

URL-адрес для прямой ссылки на приложение для данной операционной системы.

JSON-представление 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Поля
osType

enum ( AppUrlOperatingSystemType )

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

url

string

URL-адрес прямой ссылки приложения. Глубокие ссылки указывают местоположение в приложении, соответствующее контенту, который вы хотите отобразить, и должны иметь вид {схема}://{путь_хоста}. Схема определяет, какое приложение следует открыть. Для вашего приложения вы можете использовать пользовательскую схему, начинающуюся с имени приложения. Хост и путь указывают уникальное местоположение в приложении, где находится ваш контент. Пример: "exampleapp://productid_1234". Обязательно.

AppUrlOperatingSystemType

Операционная система

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
IOS Операционная система Apple iOS.
ANDROID Операционная система Android.

AdType

Возможные типы рекламы.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

TEXT_AD Это текстовое объявление.
EXPANDED_TEXT_AD Это рекламное объявление с расширенным текстом. Рекламные объявления с расширенным текстом устарели.
CALL_ONLY_AD Это объявление предназначено только для телефонных звонков.
EXPANDED_DYNAMIC_SEARCH_AD Это расширенное динамическое поисковое объявление.
HOTEL_AD Это реклама отеля.
SHOPPING_SMART_AD Это реклама, ориентированная на разумные покупки.
SHOPPING_PRODUCT_AD Это стандартная рекламная кампания для покупок.
VIDEO_AD Это видеоролик.
GMAIL_AD Это объявление относится к Gmail.
IMAGE_AD Это графическая реклама.
RESPONSIVE_SEARCH_AD Это адаптивное объявление для поисковой выдачи.
LEGACY_RESPONSIVE_DISPLAY_AD Это устаревшее адаптивное баннерное объявление.
APP_AD Это реклама приложения.
LEGACY_APP_INSTALL_AD Это реклама, относящаяся к устаревшему приложению, предназначенному для установки.
RESPONSIVE_DISPLAY_AD Это адаптивная баннерная реклама.
LOCAL_AD Это местная реклама.
HTML5_UPLOAD_AD Это рекламное объявление с возможностью загрузки файла, относящееся к типу продукта HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Это рекламное объявление с возможностью загрузки файла, содержащее один из типов товаров DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Это рекламное объявление, направленное на повышение вовлеченности пользователей в приложение.
SHOPPING_COMPARISON_LISTING_AD Это объявление представляет собой сравнительный список товаров в интернет-магазине.
VIDEO_BUMPER_AD Видеоролик-заставка.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Неотключаемая внутрипотоковая реклама в видео.
VIDEO_OUTSTREAM_AD Видеореклама вне потока.
VIDEO_TRUEVIEW_DISCOVERY_AD Видеореклама TrueView, размещаемая на экране.
VIDEO_TRUEVIEW_IN_STREAM_AD Видеореклама TrueView в потоковом режиме.
VIDEO_RESPONSIVE_AD Видеореклама с адаптивным дизайном.
SMART_CAMPAIGN_AD Умная рекламная кампания.
APP_PRE_REGISTRATION_AD Реклама предварительной регистрации в универсальном приложении.
TRAVEL_AD Реклама путешествия.
MULTIMEDIA_AD Мультимедийная реклама.

SyntheticContentInfo

Контейнер для подтверждения наличия синтетического контента из различных источников, таких как системы рекламодателя и Google.

JSON-представление 
{
  "advertiserAttestation": {
    object (SyntheticContentAttestation)
  },
  "systemAttestation": {
    object (SyntheticContentAttestation)
  }
}
Поля
advertiserAttestation

object ( SyntheticContentAttestation )

Информация предоставлена ​​рекламодателем.

systemAttestation

object ( SyntheticContentAttestation )

Информация о синтетическом контенте, созданном системами Google.

SyntheticContentAttestation

Представляет собой подтверждение наличия синтетических компонентов из одного источника.

JSON-представление 
{
  "status": enum (SyntheticContentAttestationStatus),
  "source": enum (SyntheticContentSource)
}
Поля
status

enum ( SyntheticContentAttestationStatus )

Указывает, считается ли данный контент синтетическим по мнению этого источника.

source

enum ( SyntheticContentSource )

Источник подтверждения наличия синтетического содержимого.

SyntheticContentAttestationStatus

Статус аттестации синтетического контента.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемых значений. В данной версии представляет собой значение, неизвестное.
NOT_SYNTHETIC Подтверждено, что данный продукт не является синтетическим.
IS_SYNTHETIC Содержание подтверждено как синтетическое.

SyntheticContentSource

Источник обозначения синтетического состава.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемых значений. В данной версии представляет собой значение, неизвестное.
ADVERTISER_ATTESTED Подтверждение предоставлено рекламодателем.
GOOGLE_GENERATED_ADVERTISER_REVIEWED Контент, созданный Google с учетом пожеланий или отзывов рекламодателей.
GOOGLE_GENERATED_FULLY_AUTOMATED Контент, автоматически сгенерированный Google без проверки рекламодателями.

SearchAds360TextAdInfo

Текстовая реклама в рамках проекта Search Ads 360.

JSON-представление 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Поля
headline

string

Заголовок объявления.

description1

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

displayUrl

string

Отображаемый URL-адрес объявления.

displayMobileUrl

string

Отображаемая мобильная версия URL-адреса объявления.

adTrackingId

string ( int64 format)

Идентификатор отслеживания объявления.

SearchAds360ExpandedTextAdInfo

Расширенное текстовое объявление Search Ads 360. Расширенные текстовые объявления устарели. Используйте вместо них SearchAds360ResponsiveSearchAd.

JSON-представление 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Поля
headline

string

Заголовок объявления.

headline2

string

Второй заголовок объявления.

headline3

string

Третий заголовок объявления.

description1

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

path1

string

К автоматически сгенерированному видимому URL-адресу добавляется текст с разделителем.

path2

string

Текст, добавленный к path1 с разделителем.

adTrackingId

string ( int64 format)

Идентификатор отслеживания объявления.

SearchAds360ResponsiveSearchAdInfo

Адаптивное поисковое объявление от Search Ads 360.

JSON-представление 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Поля
headlines[]

object ( AdTextAsset )

Список текстовых элементов для заголовков. При показе объявления заголовки будут выбраны из этого списка.

descriptions[]

object ( AdTextAsset )

Список текстовых элементов для описаний. При показе объявления описания будут выбираться из этого списка.

path1

string

К автоматически сгенерированному видимому URL-адресу добавляется текст с разделителем.

path2

string

Текст, добавленный к path1 с разделителем.

adTrackingId

string ( int64 format)

Идентификатор отслеживания объявления.

AdTextAsset

Текстовый элемент, используемый в рекламе.

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

string

Текст ресурса.

SearchAds360ProductAdInfo

Этот тип не содержит полей.

Рекламное объявление товара в рамках системы Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Расширенное динамическое поисковое объявление.

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

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

adTrackingId

string ( int64 format)

Идентификатор отслеживания объявления.

AdGroupAdEngineStatus

Перечисляет статусы поисковых систем AdGroupAd.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
AD_GROUP_AD_ELIGIBLE

Устарело. Не использовать.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Рекламный текст не был одобрен.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: Мобильная версия URL находится в процессе проверки.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Рекламное объявление недействительно на мобильных устройствах, но действительно на настольных компьютерах.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Креативный контент готов к реализации.
AD_GROUP_AD_NOT_REVIEWED Baidu: Креативная информация не проверена.
AD_GROUP_AD_ON_HOLD

Устарело. Не использовать. Ранее использовалось компанией Gemini.

AD_GROUP_AD_PAUSED Рекламная кампания приостановлена.
AD_GROUP_AD_REMOVED Рекламный материал удален.
AD_GROUP_AD_PENDING_REVIEW Работа над креативным проектом находится на стадии проверки.
AD_GROUP_AD_UNDER_REVIEW Разработка креативной концепции находится на стадии рассмотрения.
AD_GROUP_AD_APPROVED Креативная концепция одобрена.
AD_GROUP_AD_DISAPPROVED Креативная идея была отклонена.
AD_GROUP_AD_SERVING Творчество – это служение.
AD_GROUP_AD_ACCOUNT_PAUSED Работа над рекламным материалом приостановлена, поскольку учетная запись заблокирована.
AD_GROUP_AD_CAMPAIGN_PAUSED Работа над рекламной кампанией приостановлена, поскольку сама кампания приостановлена.
AD_GROUP_AD_AD_GROUP_PAUSED Показ рекламного ролика приостановлен, поскольку показ группы объявлений приостановлен.

AdGroupAdEffectiveLabel

Взаимосвязь между объявлением в группе объявлений и эффективной меткой. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данному объявлению в группе объявлений.

JSON-представление 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса эффективной метки объявления группы объявлений. Имена ресурсов эффективной метки объявления группы объявлений имеют вид: customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{adGroupId}~{adId}~{label_id}

adGroupAd

string

Группа объявлений, к которой прикреплена соответствующая метка.

label

string

Эффективная метка, присвоенная объявлению в группе объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит действующая этикетка.

AdGroupAdLabel

Взаимосвязь между рекламным объявлением в группе объявлений и меткой.

JSON-представление 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса метки объявления группы объявлений. Имена ресурсов меток объявлений группы объявлений имеют вид: customers/{ownerCustomerId}/adGroupAdLabels/{adGroupId}~{adId}~{label_id}

adGroupAd

string

Группа объявлений, к которой прикреплена метка.

label

string

Метка, присвоенная объявлению в группе объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит этикетка.

AdGroupAsset

Связь между группой объявлений и ресурсом.

JSON-представление 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Поля
resourceName

string

Имя ресурса группы объявлений. Имена ресурсов AdGroupAsset имеют следующий формат:

customers/{customerId}/adGroupAssets/{adGroupId}~{assetId}~{fieldType}

adGroup

string

Обязательно. Группа объявлений, к которой привязан данный ресурс.

asset

string

Обязательно. Объект, связанный с группой объявлений.

status

enum ( AssetLinkStatus )

Статус актива группы объявлений.

AssetLinkStatus

Перечисление, описывающее статусы связи актива.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
ENABLED Ссылка на актив включена.
REMOVED Ссылка на ресурс удалена.
PAUSED Ссылка на ресурс приостановлена.

AdGroupAssetSet

AdGroupAssetSet — это связующее звено между группой объявлений и набором ресурсов. Создание AdGroupAssetSet связывает набор ресурсов с группой объявлений.

JSON-представление 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Поля
resourceName

string

Имя ресурса набора ресурсов группы объявлений. Имена ресурсов набора ресурсов группы объявлений имеют следующий формат:

customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}

adGroup

string

Группа объявлений, к которой привязан данный набор ресурсов.

assetSet

string

Набор ресурсов, связанный с группой объявлений.

status

enum ( AssetSetLinkStatus )

Статус набора ресурсов группы объявлений. Только для чтения.

AssetSetLinkStatus

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

Перечисления
UNSPECIFIED Статус не указан.
UNKNOWN Полученное значение в этой версии неизвестно. Это значение, предоставляемое только в ответе.
ENABLED Включена связь между набором ресурсов и его контейнером.
REMOVED Связь между набором ресурсов и его контейнером удалена.

AdGroupAudienceView

Представление аудитории для группы объявлений. Включает данные об эффективности на основе интересов и списков ремаркетинга для объявлений в контекстно-медийной сети и сети YouTube, а также списков ремаркетинга для поисковых объявлений (RLSA), агрегированные на уровне аудитории.

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

string

Имя ресурса представления аудитории группы объявлений. Имена ресурсов представления аудитории группы объявлений имеют следующий формат:

customers/{customerId}/adGroupAudienceViews/{adGroupId}~{criterionId}

AdGroupBidModifier

Представляет собой модификатор ставки для группы объявлений.

JSON-представление 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Поля
resourceName

string

Имя ресурса модификатора ставок группы объявлений. Имена ресурсов модификатора ставок группы объявлений имеют следующий формат:

customers/{customerId}/adGroupBidModifiers/{adGroupId}~{criterionId}

bidModifier

number

Модификатор для ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 - 10,0. Используйте 0, чтобы отказаться от типа устройства.

criterion поля объединения. Критерий модификатора ставок для этой группы объявлений.

criterion обязательный для операций создания, начиная с версии V5, может принимать только одно из следующих значений:

device

object ( DeviceInfo )

Критерий устройства.

Информация об устройстве

Критерий устройства.

JSON-представление 
{
  "type": enum (Device)
}
Поля
type

enum ( Device )

Тип устройства.

Устройство

Перечисляет доступные для таргетинга инструменты Google Ads.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Значение в этой версии неизвестно.
MOBILE Мобильные устройства с полнофункциональными браузерами.
TABLET Планшеты с полнофункциональными браузерами.
DESKTOP Компьютеры.
CONNECTED_TV Смарт-телевизоры и игровые приставки.
OTHER Другие типы устройств.

AdGroupCriterion

Критерий для группы объявлений. Отчет adGroupCriterion возвращает только те критерии, которые были явно добавлены в группу объявлений.

JSON-представление 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Поля
resourceName

string

Имя ресурса критерия группы объявлений. Имена ресурсов критериев группы объявлений имеют следующий формат:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}

creationTime

string

Временная метка момента создания этого критерия для группы объявлений. Временная метка указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

status

enum ( AdGroupCriterionStatus )

Статус критерия.

Это статус сущности критерия группы объявлений, установленный клиентом. Примечание: отчеты пользовательского интерфейса могут содержать дополнительную информацию, влияющую на возможность запуска критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, может по-прежнему отображаться как включенный в пользовательском интерфейсе. Например, кампании по умолчанию показываются пользователям всех возрастных групп, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку она имеет право видеть объявления; но AdGroupCriterion.status будет отображаться как «удаленная», поскольку положительный критерий не был добавлен.

qualityInfo

object ( QualityInfo )

Информация о качестве критерия.

type

enum ( CriterionType )

Тип критерия.

labels[]

string

Названия ресурсов меток, прикрепленных к этому критерию группы объявлений.

effectiveLabels[]

string

Названия ресурсов эффективных меток, присвоенных данному критерию группы объявлений. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данному критерию группы объявлений.

positionEstimates

object ( PositionEstimates )

Оценки критериев для заявок на различных позициях.

finalUrls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений для рекламы.

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

Список сопоставлений, используемых для замены пользовательских параметров в тегах trackingUrlTemplate , finalUrls или mobile_final_urls .

engineId

string

Идентификатор критерия группы объявлений во внешнем аккаунте рекламной системы. Это поле предназначено только для аккаунтов, отличных от Google Ads, например, Yahoo Japan, Microsoft, Baidu и т. д. Для сущности Google Ads используйте вместо этого "adGroupCriterion.criterion_id".

lastModifiedTime

string

Дата и время последнего изменения данного критерия группы объявлений. Дата и время указаны в часовом поясе клиента и в формате "yyyy-MM-dd HH:mm:ss.ssssss".

criterionId

string ( int64 format)

Идентификатор критерия.

adGroup

string

Группа объявлений, к которой относится данный критерий.

negative

boolean

Следует ли применять данный критерий в качестве целевого ( false ) или исключать ( true ).

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

bidModifier

number

Модификатор для ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 - 10,0. Большинство целевых типов критериев поддерживают модификаторы.

cpcBidMicros

string ( int64 format)

Ставка CPC (стоимость за клик).

effectiveCpcBidMicros

string ( int64 format)

Эффективная ставка CPC (стоимость за клик).

engineStatus

enum ( AdGroupCriterionEngineStatus )

Критерий «Статус движка для группы объявлений».

finalUrlSuffix

string

Шаблон URL-адреса для добавления параметров к итоговому URL-адресу.

trackingUrlTemplate

string

Шаблон URL для создания URL-адреса отслеживания.

criterion объединения полей. Критерий рекламной группы.

Необходимо установить ровно один критерий. criterion может быть только одним из следующих:

keyword

object ( KeywordInfo )

Ключевое слово.

listingGroup

object ( ListingGroupInfo )

Группа объявлений.

ageRange

object ( AgeRangeInfo )

Возрастной диапазон.

gender

object ( GenderInfo )

Пол.

userList

object ( UserListInfo )

Список пользователей.

webpage

object ( WebpageInfo )

Веб-страница

location

object ( LocationInfo )

Расположение.

AdGroupCriterionStatus

Возможные статусы AdGroupCriterion.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

ENABLED Критерий "группа объявлений" включен.
PAUSED Критерий группировки объявлений приостановлен.
REMOVED Критерий "группа объявлений" удален.

QualityInfo

Контейнер для информации о качестве критериев рекламной группы.

JSON-представление 
{
  "qualityScore": integer
}
Поля
qualityScore

integer

Оценка качества.

Это поле может быть незаполнено, если у Google недостаточно информации для определения значения.

Тип критерия

Перечисление, описывающее возможные типы критериев.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
KEYWORD Ключевое слово, например, «марсианский крейсер».
PLACEMENT Размещение, также известное как веб-сайт, например, 'www.flowers4sale.com'.
MOBILE_APP_CATEGORY Целевые категории мобильных приложений.
MOBILE_APPLICATION Целевые мобильные приложения.
DEVICE Целевые устройства.
LOCATION Места, на которые следует обратить внимание.
LISTING_GROUP Список целевых групп.
AD_SCHEDULE График показа рекламы.
AGE_RANGE Возрастной диапазон.
GENDER Пол.
INCOME_RANGE Диапазон доходов.
PARENTAL_STATUS Родительский статус.
YOUTUBE_VIDEO Видео на YouTube.
YOUTUBE_CHANNEL YouTube-канал.
USER_LIST Список пользователей.
PROXIMITY Близость.
TOPIC Тематический объект в контекстно-медийной сети (например, «Домашние животные»).
LISTING_SCOPE Указание целевой области для составления списка.
LANGUAGE Язык.
IP_BLOCK IPBlock.
CONTENT_LABEL Метка контента для исключения категории.
CARRIER Перевозчик.
USER_INTEREST Категория, которая интересует пользователя.
WEBPAGE Критерии веб-страницы для динамической поисковой рекламы.
OPERATING_SYSTEM_VERSION Версия операционной системы.
APP_PAYMENT_MODEL Модель оплаты через приложение.
MOBILE_DEVICE Мобильное устройство.
CUSTOM_AFFINITY Пользовательская привязка.
CUSTOM_INTENT Пользовательский запрос.
LOCATION_GROUP Группа местоположений.
CUSTOM_AUDIENCE Пользовательская аудитория
COMBINED_AUDIENCE Объединенная аудитория
KEYWORD_THEME Тема ключевых слов для интеллектуальной кампании
AUDIENCE Аудитория
LOCAL_SERVICE_ID Идентификатор службы рекламы локальных сервисов.
BRAND Бренд
BRAND_LIST Список брендов
LIFE_EVENT Жизненное событие

Оценки положения

Оценки критериев для заявок на различных позициях.

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

string ( int64 format)

Расчетная ставка CPC, необходимая для отображения объявления в верхней части первой страницы результатов поиска.

AdGroupCriterionEngineStatus

Перечисляет статусы движка AdGroupCriterion.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
AD_GROUP_CRITERION_ELIGIBLE

Устарело. Не использовать.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Предложение или качество слишком низкие для отображения.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Поиск приостановлен компанией Baidu из-за низкого объема поисковых запросов.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: Мобильная версия URL находится в процессе проверки.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Целевая страница для одного устройства недействительна, а целевая страница для другого устройства действительна.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Ключевое слово было создано и приостановлено службой управления аккаунтом Baidu, и теперь вы можете его активировать.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Находится в процессе проверки компанией Baidu. Gemini: Criteria находится на стадии проверки.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: Критерий подлежит пересмотру.
AD_GROUP_CRITERION_ON_HOLD

Устарело. Не использовать. Ранее использовалось компанией Gemini.

AD_GROUP_CRITERION_PENDING_REVIEW Y!J: Criterion ожидает рецензирования.
AD_GROUP_CRITERION_PAUSED Реализация проекта Criterion приостановлена.
AD_GROUP_CRITERION_REMOVED Критерий был удален.
AD_GROUP_CRITERION_APPROVED Критерий утвержден.
AD_GROUP_CRITERION_DISAPPROVED Критерий был отклонен.
AD_GROUP_CRITERION_SERVING Компания Criterion ведет активную деятельность и оказывает услуги.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Сервис Criterion приостановлен, так как учетная запись заблокирована.

Пользовательский параметр

Сопоставление, которое может использоваться пользовательскими тегами параметров в trackingUrlTemplate , finalUrls или mobile_final_urls .

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

string

Ключ, соответствующий имени тега параметра.

value

string

Значение, которое необходимо подставить.

KeywordInfo

Критерий ключевого слова.

JSON-представление 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Поля
matchType

enum ( KeywordMatchType )

Тип соответствия ключевого слова.

text

string

Текст ключевого слова (не более 80 символов и 10 слов).

KeywordMatchType

Возможные типы соответствия ключевым словам.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
EXACT Точное совпадение.
PHRASE Сопоставление фраз.
BROAD Широкий совпадение.

ListingGroupInfo

Критерий для включения в список.

JSON-представление 
{
  "type": enum (ListingGroupType)
}
Поля
type

enum ( ListingGroupType )

Тип группы объявлений.

ListingGroupType

Тип группы объявлений.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
SUBDIVISION Разделение товаров по некоторому параметру списка. Эти узлы не используются для показа целевых записей в списке, а служат исключительно для определения структуры дерева.
UNIT Групповая единица объявления, определяющая условия ставки.

AgeRangeInfo

Критерий возрастного диапазона.

JSON-представление 
{
  "type": enum (AgeRangeType)
}
Поля
type

enum ( AgeRangeType )

Тип возрастной группы.

AgeRangeType

Тип демографического возрастного диапазона (например, от 18 до 24 лет).

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
AGE_RANGE_18_24 В возрасте от 18 до 24 лет.
AGE_RANGE_25_34 В возрасте от 25 до 34 лет.
AGE_RANGE_35_44 В возрасте от 35 до 44 лет.
AGE_RANGE_45_54 В возрасте от 45 до 54 лет.
AGE_RANGE_55_64 В возрасте от 55 до 64 лет.
AGE_RANGE_65_UP 65 лет и старше.
AGE_RANGE_UNDETERMINED Возрастной диапазон не определен.

Гендерная информация

Гендерный критерий.

JSON-представление 
{
  "type": enum (GenderType)
}
Поля
type

enum ( GenderType )

Тип пола.

Тип пола

Тип демографического пола (например, женский).

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
MALE Мужской.
FEMALE Женский.
UNDETERMINED Пол не определен.

UserListInfo

Критерий «Список пользователей». Представляет собой список пользователей, определенный рекламодателем для таргетирования.

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

string

Название ресурса «Список пользователей».

Информация о веб-странице

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

JSON-представление 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Поля
conditions[]

object ( WebpageConditionInfo )

Условия, или логические выражения, для таргетирования веб-страниц. Список условий таргетирования веб-страниц объединяется с помощью логического оператора И при оценке. Пустой список условий означает, что таргетированию подлежат все страницы веб-сайта кампании.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

coveragePercentage

number

Процент охвата критериев веб-сайта. Это вычисленный процент охвата веб-сайта на основе целевого веб-сайта, минус-слов целевого веб-сайта и минус-слов в группе объявлений и кампании. Например, если значение охвата равно 1, это означает 100% охват. Это поле доступно только для чтения.

criterionName

string

Название критерия, определяемого этим параметром. Значение названия будет использоваться для идентификации, сортировки и фильтрации критериев с параметрами этого типа.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

WebpageConditionInfo

Логическое выражение для таргетирования веб-страниц сайта рекламодателя.

JSON-представление 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Поля
operand

enum ( WebpageConditionOperand )

Действие условия таргетирования веб-страницы.

operator

enum ( WebpageConditionOperator )

Оператор условия таргетирования веб-страницы.

argument

string

Аргумент условия таргетирования веб-страницы.

Условия веб-страницы

Условие веб-страницы, являющееся операндом в критерии веб-страницы.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
URL Операнд, обозначающий условие таргетинга по URL-адресу веб-страницы.
CATEGORY Операнд, обозначающий условие таргетинга по категории веб-страницы.
PAGE_TITLE Операнд, обозначающий условие для выбора заголовка веб-страницы.
PAGE_CONTENT Операнд, обозначающий условие таргетирования контента веб-страницы.
CUSTOM_LABEL Операнд, обозначающий условие таргетинга пользовательской метки веб-страницы.

Оператор условий веб-страницы

Оператор условия веб-страницы в критерии веб-страницы.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
EQUALS Аргумент «условие веб-сайта» равен сравниваемому условию веб-сайта.
CONTAINS Условие наличия веб-сайта является частью условия наличия сравниваемого веб-сайта.

Информация о местоположении

Критерий местоположения.

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

string

Название ресурса константы географической цели.

AdGroupCriterionEffectiveLabel

Взаимосвязь между критерием группы объявлений и эффективной меткой. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данному критерию группы объявлений.

JSON-представление 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса эффективной метки критерия группы объявлений. Имена ресурсов эффективной метки критерия группы объявлений имеют вид: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{adGroupId}~{criterionId}~{label_id}

adGroupCriterion

string

Критерий группы объявлений, к которому относится эффективная метка.

label

string

Эффективная метка, присвоенная критерию группы объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит действующая этикетка.

AdGroupCriterionLabel

Взаимосвязь между критерием группы объявлений и меткой.

JSON-представление 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса метки критерия группы объявлений. Имена ресурсов меток критерия группы объявлений имеют вид: customers/{ownerCustomerId}/adGroupCriterionLabels/{adGroupId}~{criterionId}~{label_id}

adGroupCriterion

string

Критерий рекламной группы, к которому относится метка.

label

string

Метка, присвоенная критерию группы объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит этикетка.

AdGroupEffectiveLabel

Взаимосвязь между группой объявлений и эффективной меткой. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данной группе объявлений.

JSON-представление 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса эффективной метки группы объявлений. Имена ресурсов эффективных меток групп объявлений имеют вид: customers/{ownerCustomerId}/adGroupEffectiveLabels/{adGroupId}~{label_id}

adGroup

string

Группа объявлений, к которой относится соответствующая метка.

label

string

Эффективная метка, присвоенная группе объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит действующая этикетка.

AdGroupLabel

Взаимоотношения между рекламной группой и лейблом.

JSON-представление 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Имя ресурса метки группы объявлений. Имена ресурсов меток групп объявлений имеют вид: customers/{ownerCustomerId}/adGroupLabels/{adGroupId}~{label_id}

adGroup

string

Группа объявлений, к которой относится данная метка.

label

string

Метка, присвоенная группе объявлений.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит этикетка.

AgeRangeView

Представлен обзор возрастных групп.

Отображает показатели эффективности работы клиента (например, показы и клики), агрегированные по возрастным группам. Вся статистика агрегируется на уровне группы объявлений.

Примечание: Хотя вы можете сегментировать метрики по возрастному диапазону с помощью ageRangeView или по полу с помощью genderView , API Search Ads 360 не поддерживает одновременную сегментацию метрик по возрастному диапазону и полу в одном запросе. Анализ производительности по обоим параметрам одновременно не поддерживается в API Search Ads 360.

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

string

Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют следующий формат:

customers/{customerId}/ageRangeViews/{adGroupId}~{criterionId}

Объект

Ресурс — это часть рекламного объявления, которая может использоваться в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Ресурсы неизменяемы и не могут быть удалены. Чтобы остановить показ ресурса, удалите его из сущности, которая его использует.

JSON-представление 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "syntheticContentInfo": {
    object (SyntheticContentInfo)
  },
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Поля
resourceName

string

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

customers/{customerId}/assets/{assetId}

type

enum ( AssetType )

Тип актива.

finalUrls[]

string

Список возможных конечных URL-адресов после всех междоменных перенаправлений.

finalMobileUrls[]

string

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

urlCustomParameters[]

object ( CustomParameter )

Список сопоставлений, используемых для замены пользовательских параметров URL-адресов в тегах trackingUrlTemplate, finalUrls и/или finalMobileUrls.

status

enum ( AssetStatus )

Состояние актива.

creationTime

string

Отметка времени создания данного актива. Отметка времени указана в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс".

lastModifiedTime

string

Дата и время последнего изменения данного актива. Дата и время указаны в часовом поясе клиента и в формате "гггг-мм-дд чч:мм:сс.сссссс".

syntheticContentInfo

object ( SyntheticContentInfo )

Информация о синтетическом содержимом ресурса. Обновление с помощью поля syntheticContentInfo возможно только для ресурсов определенных типов.

Допустимые значения AssetType : * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

id

string ( int64 format)

Идентификатор актива.

name

string

Необязательное название актива.

trackingUrlTemplate

string

Шаблон URL для создания URL-адреса отслеживания.

finalUrlSuffix

string

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

engineStatus

enum ( AssetEngineStatus )

Состояние двигателя для данного актива.

Поле объединения asset_data . Конкретный тип актива. asset_data может принимать только одно из следующих значений:
youtubeVideoAsset

object ( YoutubeVideoAsset )

Видеоматериал для YouTube.

imageAsset

object ( ImageAsset )

Графический ресурс.

textAsset

object ( TextAsset )

Текстовый ресурс.

calloutAsset

object ( UnifiedCalloutAsset )

Единый элемент всплывающей подсказки.

pageFeedAsset

object ( UnifiedPageFeedAsset )

Единый ресурс ленты новостей.

mobileAppAsset

object ( MobileAppAsset )

Ресурс для мобильного приложения.

callAsset

object ( UnifiedCallAsset )

Единый актив для колл-опционов.

callToActionAsset

object ( CallToActionAsset )

Призыв к действию.

locationAsset

object ( UnifiedLocationAsset )

Единый объект местоположения.

Тип актива

Перечисление, описывающее возможные типы активов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
YOUTUBE_VIDEO Видеоматериал для YouTube.
MEDIA_BUNDLE Медиа-пакет.
IMAGE Изображение.
TEXT Текстовый ресурс.
LEAD_FORM Форма заявки.
BOOK_ON_GOOGLE Забронировать на Google-ресурсе.
PROMOTION Рекламный материал.
CALLOUT Выноска.
STRUCTURED_SNIPPET Структурированный фрагмент кода.
PAGE_FEED Элемент ленты новостей.
DYNAMIC_EDUCATION Динамичный образовательный ресурс.
MOBILE_APP Ресурс мобильного приложения.
HOTEL_CALLOUT Изображение выноски отеля.
CALL Вызовите актив.
PRICE Оценка стоимости актива.
CALL_TO_ACTION Призыв к действию.
DYNAMIC_REAL_ESTATE Динамичный объект недвижимости.
DYNAMIC_CUSTOM Динамический пользовательский ресурс.
DYNAMIC_HOTELS_AND_RENTALS Динамично развивающийся объект недвижимости в сфере гостиничного бизнеса и аренды жилья.
DYNAMIC_FLIGHTS Динамический ресурс для отображения расписания полетов.
DYNAMIC_TRAVEL Динамичный туристический актив.
DYNAMIC_LOCAL Динамический локальный актив.
DYNAMIC_JOBS Динамический ресурс для поиска работы.
LOCATION Местоположение.
HOTEL_PROPERTY Объект недвижимости, представляющий собой гостиничный комплекс.

AssetStatus

Возможные статусы актива.

Перечисления
UNSPECIFIED Статус не указан.
UNKNOWN Полученное значение в этой версии неизвестно. Это значение, предоставляемое только в ответе.
ENABLED Данный ресурс активирован.
REMOVED Объект демонтирован.
ARCHIVED Данный объект находится в архиве.
PENDING_SYSTEM_GENERATED Данный ресурс создан системой и ожидает проверки пользователем.

AssetEngineStatus

Перечисление, описывающее возможные статусы механизма управления активами.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
SERVING Актив находится в рабочем состоянии.
SERVING_LIMITED Данный актив является активным, но ограниченным.
DISAPPROVED Данный актив отклонен (не соответствует требованиям).
DISABLED Актив неактивен (в ожидании).
REMOVED Объект был удалён.

YoutubeVideoAsset

Материал с YouTube.

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

string

Название видео на YouTube.

youtubeVideoId

string

Идентификатор видео на YouTube. Это строковое значение из 11 символов, используемое в URL-адресе видео на YouTube.

ImageAsset

Изображение.

JSON-представление 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Поля
mimeType

enum ( MimeType )

MIME-тип графического ресурса.

fullSize

object ( ImageDimension )

Метаданные для этого изображения в исходном размере.

fileSize

string ( int64 format)

Размер файла изображения в байтах.

MIME-тип

Тип мима

Перечисления
UNSPECIFIED MIME-тип не указан.
UNKNOWN

Полученное значение в этой версии неизвестно.

Это значение, которое принимается только в ответ на запрос.

IMAGE_JPEG MIME-тип изображения: image/jpeg.
IMAGE_GIF MIME-тип изображения/gif.
IMAGE_PNG MIME-тип изображения: image/png.
FLASH MIME-тип application/x-shockwave-flash.
TEXT_HTML MIME-тип text/html.
PDF MIME-тип application/pdf.
MSWORD MIME-тип application/msword.
MSEXCEL MIME-тип application/vnd.ms-excel.
RTF MIME-тип application/rtf.
AUDIO_WAV MIME-тип аудио/файла.
AUDIO_MP3 MIME-тип audio/mp3.
HTML5_AD_ZIP MIME-тип application/x-html5-ad-zip.

Размерность изображения

Метаданные для изображения определенного размера, как исходного, так и измененного.

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

string ( int64 format)

Высота изображения.

widthPixels

string ( int64 format)

Ширина изображения.

url

string

URL-адрес, возвращающий изображение с указанными высотой и шириной.

TextAsset

Текстовый ресурс.

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

string

Текстовое содержимое текстового ресурса.

UnifiedCalloutAsset

Единый элемент всплывающей подсказки.

JSON-представление 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Поля
calloutText

string

Текст выноски. Длина этой строки должна быть от 1 до 25 включительно.

startDate

string

Дата начала действия данного актива и начала его обслуживания, в формате гггг-мм-дд.

endDate

string

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

adScheduleTargets[]

object ( AdScheduleInfo )

Список непересекающихся графиков, указывающий все временные интервалы, в течение которых может использоваться данное оборудование. Максимальное количество графиков в день — 6, всего — 42.

useSearcherTimeZone

boolean

Показывать ли рекламное объявление в часовом поясе пользователя, выполнившего поиск. Применяется к Microsoft Ads.

AdScheduleInfo

Представляет собой критерий AdSchedule.

В параметре AdSchedule указывается день недели и временной интервал, в течение которого будут показываться объявления.

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

JSON-представление 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Поля
startMinute

enum ( MinuteOfHour )

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

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

endMinute

enum ( MinuteOfHour )

Минуты после окончания часа, в который заканчивается данное расписание. Расписание не включает последнюю минуту.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

dayOfWeek

enum ( DayOfWeek )

День недели, к которому относится расписание.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

startHour

integer

Начальное время в 24-часовом формате. Значение в этом поле должно быть от 0 до 23 включительно.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

endHour

integer

Час окончания дня в 24-часовом формате; 24 означает конец дня. Это поле должно принимать значения от 0 до 24 включительно.

Это поле обязательно для операций CREATE и запрещено для операций UPDATE.

МинутаЧаса

Перечисление четвертей часа. Например, "ПЯТНАДЦАТЬ".

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Значение в этой версии неизвестно.
ZERO Ноль минут после начала часа.
FIFTEEN Пятнадцать минут после начала часа.
THIRTY Тридцать минут после начала часа.
FORTY_FIVE Сорок пять минут после начала часа.

День недели

Указывает дни недели, например, "понедельник".

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Значение в этой версии неизвестно.
MONDAY Понедельник.
TUESDAY Вторник.
WEDNESDAY Среда.
THURSDAY Четверг.
FRIDAY Пятница.
SATURDAY Суббота.
SUNDAY Воскресенье.

UnifiedSitelinkAsset

Единый ресурс для создания ссылок на сайт.

JSON-представление 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Поля
linkText

string

Текст, отображаемый в качестве ссылки на сайт. Длина этой строки должна быть от 1 до 25 включительно.

description1

string

Первая строка описания для ссылки на сайт. Если задано, длина должна быть от 1 до 35 включительно, а также необходимо задать параметр description2.

description2

string

Вторая строка описания для ссылки на сайт. Если задано, длина должна быть от 1 до 35 включительно, а также необходимо задать параметр description1.

startDate

string

Дата начала действия данного актива и начала его обслуживания, в формате гггг-мм-дд.

endDate

string

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

adScheduleTargets[]

object ( AdScheduleInfo )

Список непересекающихся графиков, указывающий все временные интервалы, в течение которых может использоваться данное оборудование. Максимальное количество графиков в день — 6, всего — 42.

trackingId

string ( int64 format)

Идентификатор, используемый для отслеживания кликов по ссылке на сайт. Это поле доступно только в Yahoo! Japan.

useSearcherTimeZone

boolean

Отображать ли ссылку на сайт в часовом поясе пользователя, выполнившего поиск. Применяется к Microsoft Ads.

mobilePreferred

boolean

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

UnifiedPageFeedAsset

Единый элемент ленты новостей.

JSON-представление 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Поля
pageUrl

string

Веб-страница, на которую хотят ориентироваться рекламодатели.

labels[]

string

Метки, используемые для группировки URL-адресов страниц.

MobileAppAsset

Объект, представляющий мобильное приложение.

JSON-представление 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Поля
appId

string

Обязательный параметр. Строка, однозначно идентифицирующая мобильное приложение. Она должна содержать только собственный идентификатор платформы, например, "com.android.ebay" для Android или "12345689" для iOS.

appStore

enum ( MobileAppVendor )

Обязательно. Магазин приложений, распространяющий данное приложение.

Поставщик мобильных приложений

Тип поставщика мобильных приложений

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
APPLE_APP_STORE Разработчик мобильных приложений для магазина приложений Apple.
GOOGLE_APP_STORE Разработчик мобильных приложений для магазина приложений Google.

UnifiedCallAsset

Единый актив для колл-опционов.

JSON-представление 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Поля
countryCode

string

Двухбуквенный код страны, указанный в телефонном номере. Примеры: 'US', 'us'.

phoneNumber

string

Исходный номер телефона рекламодателя. Примеры: '1234567890', '(123)456-7890'

callConversionReportingState

enum ( CallConversionReportingState )

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

callConversionAction

string

Действие преобразования, к которому следует привязать преобразование вызова. Если не задано, используется действие преобразования по умолчанию. Это поле действует только в том случае, если для параметра callConversionReportingState установлено значение USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object ( AdScheduleInfo )

Список непересекающихся графиков, указывающий все временные интервалы, в течение которых может использоваться данное оборудование. Максимальное количество графиков в день — 6, всего — 42.

callOnly

boolean

Отображается ли в звонке только номер телефона без ссылки на веб-сайт. Применяется к рекламе Microsoft.

callTrackingEnabled

boolean

Следует ли включать отслеживание звонков для этой функции. Применимо к Microsoft Ads.

useSearcherTimeZone

boolean

Показывать ли добавочный номер телефона в часовом поясе пользователя, выполнившего поиск. Применяется к рекламе Microsoft.

startDate

string

Дата начала действия данного актива и начала его обслуживания, в формате гггг-мм-дд.

endDate

string

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

CallConversionReportingState

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
DISABLED Функция конвертации вызова отключена.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Для преобразования вызова в конверсию будет использоваться тип преобразования вызова, заданный на уровне учетной записи.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Для преобразования вызова в конверсию будет использоваться тип конверсии вызова, заданный на уровне ресурса (реклама только для звонков/расширения для звонков).

CallToActionAsset

Призыв к действию.

JSON-представление 
{
  "callToAction": enum (CallToActionType)
}
Поля
callToAction

enum ( CallToActionType )

Призыв к действию.

CallToActionType

Перечисление возможных типов призывов к действию.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
LEARN_MORE Тип призыва к действию — «Узнать больше».
GET_QUOTE Тип призыва к действию: получить предложение.
APPLY_NOW Тип призыва к действию: подать заявку прямо сейчас.
SIGN_UP Тип призыва к действию — регистрация.
CONTACT_US Тип призыва к действию: свяжитесь с нами.
SUBSCRIBE Тип призыва к действию — подписаться.
DOWNLOAD Тип призыва к действию — загрузка.
BOOK_NOW Тип призыва к действию: Забронируйте сейчас.
SHOP_NOW Тип призыва к действию: «Купить сейчас».
BUY_NOW Тип призыва к действию: «Купить сейчас».
DONATE_NOW Тип призыва к действию: пожертвовать сейчас.
ORDER_NOW Тип призыва к действию: «Заказать сейчас».
PLAY_NOW Тип призыва к действию: играть сейчас.
SEE_MORE Тип призыва к действию — «Посмотреть больше».
START_NOW Тип призыва к действию: начать прямо сейчас.
VISIT_SITE Тип призыва к действию: посетить сайт.
WATCH_NOW Тип призыва к действию — «смотреть сейчас».

UnifiedLocationAsset

Единый объект местоположения.

JSON-представление 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Поля
placeId

string

Идентификаторы мест (Place ID) однозначно идентифицируют место в базе данных Google Places и на Google Maps. Это поле уникально для каждого идентификатора клиента и типа объекта. Подробнее об идентификаторах мест см. на странице https://developers.google.com/places/web-service/place-id .

businessProfileLocations[]

object ( BusinessProfileLocation )

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

locationOwnershipType

enum ( LocationOwnershipType )

Тип владения местоположением. Если тип — BUSINESS_OWNER, то местоположение будет отображаться как расширение местоположения. Если тип — AFFILIATE, то местоположение будет отображаться как филиал.

БизнесПрофильМестоположение

Данные о местоположении бизнес-профиля синхронизируются из связанной учетной записи бизнес-профиля.

JSON-представление 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Поля
labels[]

string

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

storeCode

string

Код хранилища для данного местоположения в рамках бизнес-профиля. Он синхронизируется из учетной записи бизнес-профиля.

listingId

string ( int64 format)

Идентификатор объявления для данного местоположения бизнес-профиля. Он синхронизируется из связанной учетной записи бизнес-профиля.

Тип владения местоположением

Возможные типы владения недвижимостью.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
BUSINESS_OWNER Владелец бизнеса, использующего данное местоположение (устаревшее расширение местоположения - LE).
AFFILIATE Местоположение партнера (расширение местоположения третьей стороны - ALE).

AssetGroupAset

AssetGroupAsset — это связующее звено между активом и группой активов. Добавление AssetGroupAsset связывает актив с группой активов.

JSON-представление 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Поля
resourceName

string

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

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Группа активов, с которой связана данная группа активов.

asset

string

Актив, с которым связана данная группа активов.

fieldType

enum ( AssetFieldType )

Описание места размещения актива в группе активов. Например: ЗАГОЛОВОК, ВИДЕО НА YOUTUBE и т. д.

status

enum ( AssetLinkStatus )

Состояние связи между активом и группой активов.

AssetFieldType

Перечисление, описывающее возможные варианты размещения актива.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
HEADLINE Данный материал используется в качестве заголовка.
DESCRIPTION Данный объект представлен в виде ссылки для использования в качестве описания.
MANDATORY_AD_TEXT Данный ресурс доступен для использования в качестве обязательного рекламного текста.
MARKETING_IMAGE Данный ресурс предназначен для использования в качестве маркетингового изображения.
MEDIA_BUNDLE Данный ресурс предназначен для использования в качестве медиапакета.
YOUTUBE_VIDEO Данный ресурс доступен для использования в качестве видеоролика на YouTube.
BOOK_ON_GOOGLE Данный ресурс связан с другой функцией, указывающей на то, что в рекламной кампании отелей включена опция «Бронировать в Google».
LEAD_FORM Данный ресурс предназначен для использования в качестве расширения формы заявки.
PROMOTION Данный ресурс предназначен для использования в качестве расширения рекламной кампании.
CALLOUT Данный ресурс предназначен для использования в качестве расширения для входящих вызовов.
STRUCTURED_SNIPPET Данный ресурс предназначен для использования в качестве расширения для структурированных фрагментов кода.
MOBILE_APP Данный ресурс предназначен для использования в качестве расширения мобильного приложения.
HOTEL_CALLOUT Данный ресурс предназначен для использования в качестве расширения для вызова информации об отеле.
CALL Данный актив предназначен для использования в качестве дополнительного номера для звонков.
PRICE Данный актив предназначен для использования в качестве расширения цены.
LONG_HEADLINE Данный материал предназначен для использования в качестве длинного заголовка.
BUSINESS_NAME Данный актив предназначен для использования в качестве названия компании.
SQUARE_MARKETING_IMAGE Данный ресурс предназначен для использования в качестве квадратного маркетингового изображения.
PORTRAIT_MARKETING_IMAGE Данный ресурс предназначен для использования в качестве маркетингового изображения в портретном формате.
VIDEO Данный ресурс предназначен для использования в качестве логотипа, не относящегося к YouTube.
CALL_TO_ACTION_SELECTION Данный ресурс связан с возможностью выбора призыва к действию.
AD_IMAGE Данный ресурс связан с возможностью выбора изображения для рекламы.
HOTEL_PROPERTY Данный объект недвижимости включен в рекламную кампанию Performance Max, направленную на достижение целей в сфере путешествий, и может использоваться в качестве гостиничного объекта.
LONG_DESCRIPTION Данный актив представлен в виде подробного описания.
CALL_TO_ACTION Данный ресурс предназначен для использования в качестве призыва к действию.

AssetGroupSignal

AssetGroupSignal представляет собой сигнал в группе ресурсов. Наличие сигнала сообщает Performance Max, кто с наибольшей вероятностью совершит конверсию. Performance Max использует сигнал для поиска новых пользователей со схожими или более сильными намерениями, чтобы обеспечить конверсии в поисковой выдаче, контекстной рекламе, видеорекламе и других областях.

JSON-представление 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Поля
resourceName

string

Имя ресурса сигнала группы активов. Имя ресурса сигнала группы активов имеет следующий формат:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Группа активов, к которой относится данный сигнал группы активов.

signal месторождения Юнион. Сигнал группы активов. signal может принимать только одно из следующих значений:
audience

object ( AudienceInfo )

Сигнал аудитории, который будет использоваться в рамках рекламной кампании Performance Max.

AudienceInfo

Критерий оценки целевой аудитории.

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

string

Название ресурса "Аудитория".

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter представляет собой узел дерева фильтров группы объявлений в группе активов.

JSON-представление 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Поля
resourceName

string

Имя ресурса фильтра группы списка активов. Имя ресурса фильтра группы списка активов имеет следующий формат:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Группа активов, к которой относится данный фильтр группы активов.

id

string ( int64 format)

Идентификатор ListingGroupFilter.

type

enum ( ListingGroupFilterType )

Тип узла фильтра группы объявлений.

vertical

enum ( ListingGroupFilterVertical )

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

caseValue

object ( ListingGroupFilterDimension )

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

parentListingGroupFilter

string

Имя ресурса подразделения родительской группы объявлений. Для корневого узла фильтра группы объявлений значение равно null.

path

object ( ListingGroupFilterDimensionPath )

Путь измерений, определяющий фильтр для этой группы объявлений.

ListingGroupFilterType

Тип фильтра для группы объявлений.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только в качестве возвращаемого значения. В данной версии представляет собой значение, неизвестное.
SUBDIVISION Разделение товаров по некоторым параметрам списка.
UNIT_INCLUDED Включенный в список конечный узел фильтра группы объявлений.
UNIT_EXCLUDED Конечный узел фильтра исключенной группы списка.

ListingGroupFilterVertical

Тип фильтра группы объявлений — вертикальный.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
SHOPPING Represents the shopping vertical. The vertical is allowed only in Performance Max for Retail campaigns.

ListingGroupFilterDimension

Listing dimensions for the asset group listing group filter.

JSON representation 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Поля
Union field dimension . Dimension of one of the types below is always present. dimension can be only one of the following:
productBiddingCategory

object ( ProductBiddingCategory )

Bidding category of a product offer.

productBrand

object ( ProductBrand )

Brand of a product offer.

productChannel

object ( ProductChannel )

Locality of a product offer.

productCondition

object ( ProductCondition )

Condition of a product offer.

productCustomAttribute

object ( ProductCustomAttribute )

Custom attribute of a product offer.

productItemId

object ( ProductItemId )

Item id of a product offer.

productType

object ( ProductType )

Type of a product offer.

ProductBiddingCategory

One element of a bidding category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level).

JSON representation 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Поля
level

enum ( ListingGroupFilterBiddingCategoryLevel )

Indicates the level of the category in the taxonomy.

id

string ( int64 format)

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

The level of the listing group filter bidding category.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Уровень 1.
LEVEL2 Level 2.
LEVEL3 Уровень 3.
LEVEL4 Уровень 4.
LEVEL5 Уровень 5.

ПродуктБренд

Brand of the product.

JSON representation 
{
  "value": string
}
Поля
value

string

String value of the product brand.

ProductChannel

Locality of a product offer.

JSON representation 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Поля
channel

enum ( ListingGroupFilterProductChannel )

Value of the locality.

ListingGroupFilterProductChannel

Enum describing the locality of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ONLINE The item is sold online.
LOCAL The item is sold in local stores.

Состояние продукта

Condition of a product offer.

JSON representation 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Поля
condition

enum ( ListingGroupFilterProductCondition )

Value of the condition.

ListingGroupFilterProductCondition

Enum describing the condition of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
NEW The product condition is new.
REFURBISHED The product condition is refurbished.
USED The product condition is used.

ProductCustomAttribute

Custom attribute of a product offer.

JSON representation 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Поля
index

enum ( ListingGroupFilterCustomAttributeIndex )

Indicates the index of the custom attribute.

value

string

String value of the product custom attribute.

ListingGroupFilterCustomAttributeIndex

The index of customer attributes.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
INDEX0 First listing group filter custom attribute.
INDEX1 Second listing group filter custom attribute.
INDEX2 Third listing group filter custom attribute.
INDEX3 Fourth listing group filter custom attribute.
INDEX4 Fifth listing group filter custom attribute.

ProductItemId

Item id of a product offer.

JSON representation 
{
  "value": string
}
Поля
value

string

Value of the id.

ProductType

Type of a product offer.

JSON representation 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Поля
level

enum ( ListingGroupFilterProductTypeLevel )

Level of the type.

value

string

Value of the type.

ListingGroupFilterProductTypeLevel

Enum describing the level of the type of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Уровень 1.
LEVEL2 Level 2.
LEVEL3 Уровень 3.
LEVEL4 Уровень 4.
LEVEL5 Уровень 5.

ListingGroupFilterDimensionPath

The path defining of dimensions defining a listing group filter.

JSON representation 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Поля
dimensions[]

object ( ListingGroupFilterDimension )

The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.

AssetGroupTopCombinationView

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

JSON representation 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Поля
resourceName

string

The resource name of the asset group top combination view. AssetGroup Top Combination view resource names have the form: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"

assetGroupTopCombinations[]

object ( AssetGroupAssetCombinationData )

Наилучшие сочетания активов, которые действовали сообща.

AssetGroupAssetCombinationData

Данные о сочетании активов в рамках группы активов

JSON representation 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Поля
assetCombinationServedAssets[]

object ( AssetUsage )

Обслуживаемые активы.

Использование активов

Содержит информацию об использовании актива.

JSON representation 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Поля
asset

string

Название ресурса актива.

servedAssetFieldType

enum ( ServedAssetFieldType )

Тип обслуживаемого поля актива.

ServedAssetFieldType

The possible asset field types.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

HEADLINE_1 The asset is used in headline 1.
HEADLINE_2 The asset is used in headline 2.
HEADLINE_3 The asset is used in headline 3.
DESCRIPTION_1 The asset is used in description 1.
DESCRIPTION_2 The asset is used in description 2.
HEADLINE The asset was used in a headline. Use this only if there is only one headline in the ad. Otherwise, use the HEADLINE_1, HEADLINE_2 or HEADLINE_3 enums
HEADLINE_IN_PORTRAIT The asset was used as a headline in portrait image.
LONG_HEADLINE The asset was used in a long headline (used in MultiAssetResponsiveAd).
DESCRIPTION The asset was used in a description. Use this only if there is only one description in the ad. Otherwise, use the DESCRIPTION_1 or DESCRIPTION_@ enums
DESCRIPTION_IN_PORTRAIT The asset was used as description in portrait image.
BUSINESS_NAME_IN_PORTRAIT The asset was used as business name in portrait image.
BUSINESS_NAME The asset was used as business name.
MARKETING_IMAGE The asset was used as a marketing image.
MARKETING_IMAGE_IN_PORTRAIT The asset was used as a marketing image in portrait image.
SQUARE_MARKETING_IMAGE The asset was used as a square marketing image.
PORTRAIT_MARKETING_IMAGE The asset was used as a portrait marketing image.
CALL_TO_ACTION The asset was used as a call-to-action.
YOU_TUBE_VIDEO The asset was used as a YouTube video.
CALL This asset is used as a call.
MOBILE_APP This asset is used as a mobile app.
CALLOUT This asset is used as a callout.
STRUCTURED_SNIPPET This asset is used as a structured snippet.
PRICE This asset is used as a price.
PROMOTION This asset is used as a promotion.
AD_IMAGE This asset is used as an image.
LEAD_FORM The asset is used as a lead form.
DESCRIPTION_PREFIX The asset is used as a description prefix.

AssetGroup

Группа активов. AssetGroupAsset используется для привязки актива к группе активов. AssetGroupSignal используется для связывания сигнала с группой активов.

JSON representation 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Поля
resourceName

string

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

customers/{customerId}/assetGroups/{asset_group_id}

id

string ( int64 format)

Идентификатор группы активов.

campaign

string

Кампания, с которой связана данная группа активов. Актив, который связан с данной группой активов.

name

string

Обязательно. Название группы активов. Обязательно. Минимальная длина должна составлять 1, максимальная — 128 символов. Название должно быть уникальным в рамках одной кампании.

finalUrls[]

string

Список конечных URL-адресов после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отключена соответствующая опция.

finalMobileUrls[]

string

Список конечных мобильных URL-адресов после всех междоменных перенаправлений. В режиме максимальной производительности по умолчанию URL-адреса могут быть расширены, если не отключена соответствующая опция.

status

enum ( AssetGroupStatus )

Состояние группы активов.

path1

string

Первая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в рекламе.

path2

string

Вторая часть текста, которая может быть добавлена ​​к URL-адресу, отображаемому в рекламе. Это поле можно задать только в том случае, если задан параметр path1.

adStrength

enum ( AdStrength )

Общая эффективность рекламы в этой группе активов.

AssetGroupStatus

The possible statuses of an asset group.

Перечисления
UNSPECIFIED The status has not been specified.
UNKNOWN The received value is not known in this version.
ENABLED The asset group is enabled.
PAUSED The asset group is paused.
REMOVED The asset group is removed.

AdStrength

Enum listing the possible ad strengths.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
PENDING The ad strength is currently pending.
NO_ADS No ads could be generated.
POOR Poor strength.
AVERAGE Average strength.
GOOD Хорошая сила.
EXCELLENT Excellent strength.

AssetSetAsset

AssetSetAsset — это связь между активом и набором активов. Добавление AssetSetAsset связывает актив с набором активов.

JSON representation 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Поля
resourceName

string

Имя ресурса набора активов. Имена ресурсов набора активов имеют следующий вид:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

Набор активов, к которому привязан данный набор активов.

asset

string

Актив, к которому привязан данный набор активов.

status

enum ( AssetSetAssetStatus )

Статус набора активов. Только для чтения.

AssetSetAssetStatus

The possible statuses of an asset set asset.

Перечисления
UNSPECIFIED The status has not been specified.
UNKNOWN The received value is not known in this version. This is a response-only value.
ENABLED The asset set asset is enabled.
REMOVED The asset set asset is removed.

AssetSet

Набор активов, представляющий собой совокупность активов. Используйте AssetSetAsset для привязки актива к набору активов.

JSON representation 
{
  "id": string,
  "resourceName": string
}
Поля
id

string ( int64 format)

Идентификатор набора активов.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

Стратегия торгов

Стратегия торгов.

JSON representation 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Поля
resourceName

string

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

customers/{customerId}/biddingStrategies/{biddingStrategyId}

status

enum ( BiddingStrategyStatus )

Состояние стратегии участия в тендере.

Это поле доступно только для чтения.

type

enum ( BiddingStrategyType )

Тип стратегии назначения ставок. Создайте стратегию назначения ставок, задав схему назначения ставок.

Это поле доступно только для чтения.

currencyCode

string

Валюта, используемая в стратегии торгов (трехбуквенный код ISO 4217).

For bidding strategies in manager customers, this currency can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effectiveCurrencyCode field returns the currency used by the strategy.

id

string ( int64 format)

Идентификатор стратегии торгов.

name

string

Название стратегии назначения ставок. Все стратегии назначения ставок в рамках одного аккаунта должны иметь разные названия.

Длина этой строки должна быть в диапазоне от 1 до 255 байт в кодировке UTF-8 (без обрезки).

effectiveCurrencyCode

string

Валюта, используемая в стратегии торгов (трехбуквенный код ISO 4217).

For bidding strategies in manager customers, this is the currency set by the advertiser when creating the strategy. For serving customers, this is the customer's currencyCode.

Показатели стратегии назначения ставок приводятся в этой валюте.

Это поле доступно только для чтения.

campaignCount

string ( int64 format)

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

Это поле доступно только для чтения.

nonRemovedCampaignCount

string ( int64 format)

Количество неудалённых кампаний, связанных с данной стратегией торгов.

Это поле доступно только для чтения.

scheme распределения рабочих мест в рамках Союза. Схема проведения торгов.

Можно установить только одну схему. scheme может быть только одной из следующих:

enhancedCpc

object ( EnhancedCpc )

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

maximizeConversionValue

object ( MaximizeConversionValue )

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

maximizeConversions

object ( MaximizeConversions )

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

targetCpa

object ( TargetCpa )

Стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

targetImpressionShare

object ( TargetImpressionShare )

Стратегия назначения ставок, которая автоматически оптимизирует показ в соответствии с выбранным процентом показов.

targetOutrankShare

object ( TargetOutrankShare )

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

targetRoas

object ( TargetRoas )

Стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

targetSpend

object ( TargetSpend )

Стратегия назначения ставок, которая позволяет установить ставки таким образом, чтобы получить максимальное количество кликов в рамках вашего бюджета.

BiddingStrategyStatus

The possible statuses of a BiddingStrategy.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The bidding strategy is enabled.
REMOVED The bidding strategy is removed.

BiddingStrategyType

Enum describing possible bidding strategy types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
COMMISSION Commission is an automatic bidding strategy in which the advertiser pays a certain portion of the conversion value.
ENHANCED_CPC Enhanced CPC is a bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
INVALID Used for return value only. Indicates that a campaign does not have a bidding strategy. This prevents the campaign from serving. For example, a campaign may be attached to a manager bidding strategy and the serving account is subsequently unlinked from the manager account. In this case the campaign will automatically be detached from the now inaccessible manager bidding strategy and transition to the INVALID bidding strategy type.
MANUAL_CPA Стратегия ручного назначения ставок, позволяющая рекламодателю устанавливать ставку для каждого действия, указанного рекламодателем.
MANUAL_CPC Manual click based bidding where user pays per click.
MANUAL_CPM Manual impression based bidding where user pays per thousand impressions.
MANUAL_CPV A bidding strategy that pays a configurable amount per video view.
MAXIMIZE_CONVERSIONS A bidding strategy that automatically maximizes number of conversions given a daily budget.
MAXIMIZE_CONVERSION_VALUE An automated bidding strategy that automatically sets bids to maximize revenue while spending your budget.
PAGE_ONE_PROMOTED Page-One Promoted bidding scheme, which sets max cpc bids to target impressions on page one or page one promoted slots on google.com. This enum value is deprecated.
PERCENT_CPC Percent Cpc is bidding strategy where bids are a fraction of the advertised price for some good or service.
TARGET_CPA Target CPA is an automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
TARGET_CPM Target CPM is an automated bid strategy that sets bids to help get as many impressions as possible at the target cost per one thousand impressions (CPM) you set.
TARGET_IMPRESSION_SHARE Автоматизированная стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы определенный процент поисковых объявлений отображался в верхней части первой страницы (или в другом целевом месте).
TARGET_OUTRANK_SHARE Target Outrank Share is an automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This enum value is deprecated.
TARGET_ROAS Target ROAS is an automated bidding strategy that helps you maximize revenue while averaging a specific target Return On Average Spend (ROAS).
TARGET_SPEND Target Spend is an automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

EnhancedCpc

Этот тип не содержит полей.

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

This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhancedCpcEnabled set to true for equivalent functionality.

Максимизировать значение конверсии

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

JSON representation 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Поля
cpcBidCeilingMicros

string ( int64 format)

Максимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле.

cpcBidFloorMicros

string ( int64 format)

Минимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле.

targetRoas

number

Параметр «Целевая рентабельность рекламных расходов» (ROAS). Если он установлен, стратегия назначения ставок будет максимизировать доход, усредняя при этом целевую рентабельность рекламных расходов. Если целевой показатель ROAS высок, стратегия назначения ставок может не позволить потратить весь бюджет. Если целевой показатель ROAS не установлен, стратегия назначения ставок будет стремиться достичь максимально возможного показателя ROAS для бюджета.

Максимизировать конверсии

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

JSON representation 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Поля
cpcBidCeilingMicros

string ( int64 format)

Максимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле.

cpcBidFloorMicros

string ( int64 format)

Минимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле.

targetCpaMicros

string ( int64 format)

Параметр целевой стоимости за действие (CPA). Это средняя сумма, которую вы хотели бы потратить на одно действие по конверсии, указанная в микроединицах валюты стратегии назначения ставок. Если этот параметр установлен, стратегия назначения ставок обеспечит максимально возможное количество конверсий по цене, равной или ниже целевой стоимости за действие. Если целевая стоимость за действие не установлена, стратегия назначения ставок будет стремиться достичь минимально возможной стоимости за действие с учетом бюджета.

TargetCpa

Автоматизированная стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

JSON representation 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Поля
targetCpaMicros

string ( int64 format)

Средний целевой показатель CPA. Этот показатель должен быть больше или равен минимальному количеству оплачиваемых единиц в зависимости от валюты счета.

cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

cpcBidFloorMicros

string ( int64 format)

Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

ЦелеваяПоказПоказПоделить

Автоматизированная стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы определенный процент поисковых объявлений отображался в верхней части первой страницы (или в другом целевом месте).

JSON representation 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
location

enum ( TargetImpressionShareLocation )

Целевое местоположение на странице результатов поиска.

locationFractionMicros

string ( int64 format)

Выбранная доля рекламных объявлений, которые будут показаны в целевом местоположении, в микросекундах. Например, 1% равен 10 000.

cpcBidCeilingMicros

string ( int64 format)

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

TargetImpressionShareLocation

Enum describing possible goals.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ANYWHERE_ON_PAGE Any location on the web page.
TOP_OF_PAGE Top box of ads.
ABSOLUTE_TOP_OF_PAGE Top slot in the top box of ads.

TargetOutrankShare

An automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This strategy is deprecated.

JSON representation 
{
  "cpcBidCeilingMicros": string
}
Поля
cpcBidCeilingMicros

string ( Int64Value format)

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

TargetRoas

Автоматизированная стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

JSON representation 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Поля
targetRoas

number

Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.

cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

cpcBidFloorMicros

string ( int64 format)

Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies.

Целевые расходы

Автоматизированная стратегия назначения ставок, которая устанавливает ваши ставки таким образом, чтобы получить как можно больше кликов в рамках вашего бюджета.

JSON representation 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
targetSpendMicros
(deprecated)

string ( int64 format)

Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.

cpcBidCeilingMicros

string ( int64 format)

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

CampaignBudget

A campaign budget.

JSON representation 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Поля
resourceName

string

The resource name of the campaign budget. Campaign budget resource names have the form:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum ( BudgetDeliveryMethod )

The delivery method that determines the rate at which the campaign budget is spent.

Defaults to STANDARD if unspecified in a create operation.

period

enum ( BudgetPeriod )

Period over which to spend the budget. Defaults to DAILY if not specified.

amountMicros

string ( int64 format)

The average daily amount to be spent by the campaign. This field is used when the CampaignBudget period is set to DAILY , which is the default.

Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount.

This field is mutually exclusive with 'totalAmountMicros'. Only one of 'amountMicros' or 'totalAmountMicros' should be set.

BudgetDeliveryMethod

Possible delivery methods of a Budget.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
STANDARD The budget server will throttle serving evenly across the entire time period.
ACCELERATED The budget server will not throttle serving, and ads will serve as fast as possible.

BudgetPeriod

Possible period of a Budget.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
DAILY Daily budget.
FIXED_DAILY Fixed daily budget.
CUSTOM_PERIOD Custom budget can be used with total_amount to specify lifetime budget limit.

Кампания

Кампания.

JSON representation 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Поля
resourceName

string

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

customers/{customerId}/campaigns/{campaignId}

status

enum ( CampaignStatus )

Текущее состояние кампании.

При добавлении новой кампании ее статус по умолчанию устанавливается на «ВКЛЮЧЕНО».

servingStatus

enum ( CampaignServingStatus )

Статус показа рекламы в рамках кампании.

biddingStrategySystemStatus

enum ( BiddingStrategySystemStatus )

Системный статус стратегии назначения ставок в рамках кампании.

adServingOptimizationStatus

enum ( AdServingOptimizationStatus )

Статус оптимизации показа рекламы в рамках кампании.

advertisingChannelType

enum ( AdvertisingChannelType )

The primary serving target for ads within the campaign. The targeting options can be refined in networkSettings .

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

Этот параметр можно установить только при создании кампаний. После создания кампании изменить это поле невозможно.

advertisingChannelSubType

enum ( AdvertisingChannelSubType )

Optional refinement to advertisingChannelType . Must be a valid sub-type of the parent channel type.

Этот параметр можно установить только при создании кампаний. После создания кампании изменить это поле невозможно.

urlCustomParameters[]

object ( CustomParameter )

The list of mappings used to substitute custom parameter tags in a trackingUrlTemplate , finalUrls , or mobile_final_urls .

realTimeBiddingSetting

object ( RealTimeBiddingSetting )

Настройки для торгов в реальном времени — функция, доступная только для кампаний, ориентированных на рекламную сеть Ad Exchange.

networkSettings

object ( NetworkSettings )

Настройки сети для кампании.

dynamicSearchAdsSetting

object ( DynamicSearchAdsSetting )

Настройки для управления динамической поисковой рекламой (DSA).

shoppingSetting

object ( ShoppingSetting )

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

geoTargetTypeSetting

object ( GeoTargetTypeSetting )

Настройки геотаргетинга рекламы.

effectiveLabels[]

string

Названия ресурсов эффективных меток, присвоенных данной кампании. Эффективная метка — это метка, унаследованная или непосредственно присвоенная данной кампании.

labels[]

string

Названия ресурсов этикеток, прикрепленных к этой кампании.

biddingStrategyType

enum ( BiddingStrategyType )

Тип стратегии торгов.

A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the biddingStrategy field to create a portfolio bidding strategy.

Это поле доступно только для чтения.

accessibleBiddingStrategy

string

Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'biddingStrategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource.

frequencyCaps[]

object ( FrequencyCapEntry )

Список, ограничивающий частоту показа рекламы данной кампании каждому пользователю.

selectiveOptimization

object ( SelectiveOptimization )

Выборочная настройка оптимизации для этой кампании, включающая набор действий по конверсии, на основе которых будет производиться оптимизация кампании. Эта функция применяется только к кампаниям приложений, в которых в качестве AdvertisingChannelType используется MULTI_CHANNEL, а в качестве AdvertisingChannelSubType — APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT.

optimizationGoalSetting

object ( OptimizationGoalSetting )

Настройка целей оптимизации для данной кампании, включающая набор типов целей оптимизации.

trackingSetting

object ( TrackingSetting )

Настройки отслеживания информации на уровне кампании.

engineId

string

ID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.

excludedParentAssetFieldTypes[]

enum ( AssetFieldType )

The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.

createTime

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. createTime will be deprecated in v1. Use creationTime instead.

creationTime

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

lastModifiedTime

string

The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

feedTypes[]

enum ( AssetSetType )

Types of feeds that are attached directly to this campaign.

id

string ( int64 format)

The ID of the campaign.

name

string

The name of the campaign.

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

В тексте не должно содержаться нулевых символов (код 0x0), символов перевода строки (код 0xA) или возврата каретки (код 0xD).

trackingUrlTemplate

string

Шаблон URL для создания URL-адреса отслеживания.

campaignBudget

string

The resource name of the campaign budget of the campaign.

startDate

string

The date when campaign started in serving customer's timezone in YYYY-MM-DD format.

endDate

string

The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.

finalUrlSuffix

string

Suffix used to append query parameters to landing pages that are served with parallel tracking.

urlExpansionOptOut

boolean

Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.

Union field campaign_bidding_strategy . The bidding strategy for the campaign.

Must be either portfolio (created through BiddingStrategy service) or standard, that is embedded into the campaign. campaign_bidding_strategy can be only one of the following:

biddingStrategy

string

The resource name of the portfolio bidding strategy used by the campaign.

manualCpa

object ( ManualCpa )

Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.

manualCpc

object ( ManualCpc )

Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.

manualCpm

object ( ManualCpm )

Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.

maximizeConversions

object ( MaximizeConversions )

Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.

maximizeConversionValue

object ( MaximizeConversionValue )

Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.

targetCpa

object ( TargetCpa )

Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

targetImpressionShare

object ( TargetImpressionShare )

Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.

targetRoas

object ( TargetRoas )

Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).

targetSpend

object ( TargetSpend )

Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.

percentCpc

object ( PercentCpc )

Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.

targetCpm

object ( TargetCpm )

A bidding strategy that automatically optimizes cost per thousand impressions.

CampaignStatus

Possible statuses of a campaign.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Campaign is active and can show ads.
PAUSED Campaign has been paused by the user.
REMOVED Campaign has been removed.

CampaignServingStatus

Possible serving statuses of a campaign.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

SERVING Подача.
NONE Никто.
ENDED Завершено.
PENDING В ожидании.
SUSPENDED Приостановленный.

BiddingStrategySystemStatus

The possible system statuses of a BiddingStrategy.

Перечисления
UNSPECIFIED Signals that an unexpected error occurred, for example, no bidding strategy type was found, or no status information was found.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The bid strategy is active, and AdWords cannot find any specific issues with the strategy.
LEARNING_NEW The bid strategy is learning because it has been recently created or recently reactivated.
LEARNING_SETTING_CHANGE The bid strategy is learning because of a recent setting change.
LEARNING_BUDGET_CHANGE The bid strategy is learning because of a recent budget change.
LEARNING_COMPOSITION_CHANGE The bid strategy is learning because of recent change in number of campaigns, ad groups or keywords attached to it.
LEARNING_CONVERSION_TYPE_CHANGE The bid strategy depends on conversion reporting and the customer recently modified conversion types that were relevant to the bid strategy.
LEARNING_CONVERSION_SETTING_CHANGE The bid strategy depends on conversion reporting and the customer recently changed their conversion settings.
LIMITED_BY_CPC_BID_CEILING The bid strategy is limited by its bid ceiling.
LIMITED_BY_CPC_BID_FLOOR The bid strategy is limited by its bid floor.
LIMITED_BY_DATA The bid strategy is limited because there was not enough conversion traffic over the past weeks.
LIMITED_BY_BUDGET A significant fraction of keywords in this bid strategy are limited by budget.
LIMITED_BY_LOW_PRIORITY_SPEND The bid strategy cannot reach its target spend because its spend has been de-prioritized.
LIMITED_BY_LOW_QUALITY A significant fraction of keywords in this bid strategy have a low Quality Score.
LIMITED_BY_INVENTORY The bid strategy cannot fully spend its budget because of narrow targeting.
MISCONFIGURED_ZERO_ELIGIBILITY Missing conversion tracking (no pings present) and/or remarketing lists for SSC.
MISCONFIGURED_CONVERSION_TYPES The bid strategy depends on conversion reporting and the customer is lacking conversion types that might be reported against this strategy.
MISCONFIGURED_CONVERSION_SETTINGS The bid strategy depends on conversion reporting and the customer's conversion settings are misconfigured.
MISCONFIGURED_SHARED_BUDGET There are campaigns outside the bid strategy that share budgets with campaigns included in the strategy.
MISCONFIGURED_STRATEGY_TYPE The campaign has an invalid strategy type and is not serving.
PAUSED The bid strategy is not active. Either there are no active campaigns, ad groups or keywords attached to the bid strategy. Or there are no active budgets connected to the bid strategy.
UNAVAILABLE This bid strategy currently does not support status reporting.
MULTIPLE_LEARNING There were multiple LEARNING_* system statuses for this bid strategy during the time in question.
MULTIPLE_LIMITED There were multiple LIMITED_* system statuses for this bid strategy during the time in question.
MULTIPLE_MISCONFIGURED There were multiple MISCONFIGURED_* system statuses for this bid strategy during the time in question.
MULTIPLE There were multiple system statuses for this bid strategy during the time in question.

AdServingOptimizationStatus

Enum describing possible serving statuses.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

OPTIMIZE Ad serving is optimized based on CTR for the campaign.
CONVERSION_OPTIMIZE Ad serving is optimized based on CTR * Conversion for the campaign. If the campaign is not in the conversion optimizer bidding strategy, it will default to OPTIMIZED.
ROTATE Ads are rotated evenly for 90 days, then optimized for clicks.
ROTATE_INDEFINITELY Show lower performing ads more evenly with higher performing ads, and do not optimize.
UNAVAILABLE Ad serving optimization status is not available.

AdvertisingChannelType

Enum describing the various advertising channel types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
SEARCH Search Network. Includes display bundled, and Search+ campaigns.
DISPLAY Google Display Network only.
SHOPPING Shopping campaigns serve on the shopping property and on google.com search results.
HOTEL Hotel Ads campaigns.
VIDEO Video campaigns.
MULTI_CHANNEL App Campaigns, and App Campaigns for Engagement, that run across multiple channels.
LOCAL Local ads campaigns.
SMART Smart campaigns.
PERFORMANCE_MAX Performance Max campaigns.
LOCAL_SERVICES Local services campaigns.
DISCOVERY Discovery campaigns.
TRAVEL Travel campaigns.
SOCIAL Social campaigns.

AdvertisingChannelSubType

Enum describing the different channel subtypes.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used as a return value only. Represents value unknown in this version.
SEARCH_MOBILE_APP Mobile app campaigns for Search.
DISPLAY_MOBILE_APP Mobile app campaigns for Display.
SEARCH_EXPRESS AdWords express campaigns for search.
DISPLAY_EXPRESS AdWords Express campaigns for display.
SHOPPING_SMART_ADS Smart Shopping campaigns.
DISPLAY_GMAIL_AD Gmail Ad campaigns.
DISPLAY_SMART_CAMPAIGN Smart display campaigns. New campaigns of this sub type cannot be created.
VIDEO_OUTSTREAM Video Outstream campaigns.
VIDEO_ACTION Video TrueView for Action campaigns.
VIDEO_NON_SKIPPABLE Video campaigns with non-skippable video ads.
APP_CAMPAIGN App Campaign that lets you easily promote your Android or iOS app across Google's top properties including Search, Play, YouTube, and the Google Display Network.
APP_CAMPAIGN_FOR_ENGAGEMENT App Campaign for engagement, focused on driving re-engagement with the app across several of Google's top properties including Search, YouTube, and the Google Display Network.
LOCAL_CAMPAIGN Campaigns specialized for local advertising.
SHOPPING_COMPARISON_LISTING_ADS Shopping Comparison Listing campaigns.
SMART_CAMPAIGN Standard Smart campaigns.
VIDEO_SEQUENCE Video campaigns with sequence video ads.
APP_CAMPAIGN_FOR_PRE_REGISTRATION App Campaign for pre registration, specialized for advertising mobile app pre-registration, that targets multiple advertising channels across Google Play, YouTube and Display Network.
VIDEO_REACH_TARGET_FREQUENCY Video reach campaign with Target Frequency bidding strategy.
TRAVEL_ACTIVITIES Travel Activities campaigns.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook tracking only social campaigns.

RealTimeBiddingSetting

Настройки для торгов в реальном времени — функция, доступная только для кампаний, ориентированных на рекламную сеть Ad Exchange.

JSON representation 
{
  "optIn": boolean
}
Поля
optIn

boolean

Whether the campaign is opted in to real-time bidding.

NetworkSettings

Настройки сети для кампании.

JSON representation 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Поля
targetSearchNetwork

boolean

Whether ads will be served on sites in the Google Search Partners Network (requires targetGoogleSearch to also be true ).

targetContentNetwork

boolean

Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.

targetPartnerSearchNetwork

boolean

Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use targetSearchNetwork for that instead.

DynamicSearchAdsSetting

Настройки для управления динамической поисковой рекламой (DSA).

JSON representation 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Поля
domainName

string

Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

languageCode

string

Required. The language code specifying the language of the domain, for example, "en".

useSuppliedUrlsOnly

boolean

Whether the campaign uses advertiser supplied URLs exclusively.

ShoppingSetting

The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns.

JSON representation 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Поля
feedLabel

string

Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated salesCountry in the two-letter country code ( XX ) format, the feedLabel field should be used instead. For more information see the feed label support article.

useVehicleInventory

boolean

Whether to target Vehicle Listing inventory.

merchantId

string ( int64 format)

ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.

salesCountry

string

Sales country of products to include in the campaign.

campaignPriority

integer

Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.

enableLocal

boolean

Whether to include local products.

GeoTargetTypeSetting

Represents a collection of settings related to ads geotargeting.

JSON representation 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Поля
positiveGeoTargetType

enum ( PositiveGeoTargetType )

The setting used for positive geotargeting in this particular campaign.

negativeGeoTargetType

enum ( NegativeGeoTargetType )

The setting used for negative geotargeting in this particular campaign.

PositiveGeoTargetType

The possible positive geo target types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
PRESENCE_OR_INTEREST Specifies that an ad is triggered if the user is in, or shows interest in, advertiser's targeted locations.
SEARCH_INTEREST Specifies that an ad is triggered if the user searches for advertiser's targeted locations. This can only be used with Search and standard Shopping campaigns.
PRESENCE Specifies that an ad is triggered if the user is in or regularly in advertiser's targeted locations.

NegativeGeoTargetType

The possible negative geo target types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
PRESENCE_OR_INTEREST Specifies that a user is excluded from seeing the ad if they are in, or show interest in, advertiser's excluded locations.
PRESENCE Specifies that a user is excluded from seeing the ad if they are in advertiser's excluded locations.

FrequencyCapEntry

Этот тип не содержит полей.

Правило, определяющее максимальное количество показов объявления (или набора объявлений) пользователю за определенный период времени.

SelectiveOptimization

Выборочная настройка оптимизации для этой кампании, включающая набор действий по конверсии, на основе которых будет производиться оптимизация кампании. Эта функция применяется только к кампаниям приложений, в которых в качестве AdvertisingChannelType используется MULTI_CHANNEL, а в качестве AdvertisingChannelSubType — APP_CAMPAIGN или APP_CAMPAIGN_FOR_ENGAGEMENT.

JSON representation 
{
  "conversionActions": [
    string
  ]
}
Поля
conversionActions[]

string

The selected set of resource names for conversion actions for optimizing this campaign.

OptimizationGoalSetting

Настройка целей оптимизации для данной кампании, включающая набор типов целей оптимизации.

JSON representation 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Поля
optimizationGoalTypes[]

enum ( OptimizationGoalType )

The list of optimization goal types.

OptimizationGoalType

The type of optimization goal

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used as a return value only. Represents value unknown in this version.
CALL_CLICKS Optimize for call clicks. Call click conversions are times people selected 'Call' to contact a store after viewing an ad.
DRIVING_DIRECTIONS Optimize for driving directions. Driving directions conversions are times people selected 'Get directions' to navigate to a store after viewing an ad.
APP_PRE_REGISTRATION Optimize for pre-registration. Pre-registration conversions are the number of pre-registration signups to receive a notification when the app is released.

TrackingSetting

Настройки отслеживания информации на уровне кампании.

JSON representation 
{
  "trackingUrl": string
}
Поля
trackingUrl

string

The url used for dynamic tracking.

AssetSetType

Possible types of an asset set.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
PAGE_FEED Page asset set.
DYNAMIC_EDUCATION Dynamic education asset set.
MERCHANT_CENTER_FEED Google Merchant Center asset set.
DYNAMIC_REAL_ESTATE Dynamic real estate asset set.
DYNAMIC_CUSTOM Dynamic custom asset set.
DYNAMIC_HOTELS_AND_RENTALS Dynamic hotels and rentals asset set.
DYNAMIC_FLIGHTS Dynamic flights asset set.
DYNAMIC_TRAVEL Dynamic travel asset set.
DYNAMIC_LOCAL Dynamic local asset set.
DYNAMIC_JOBS Dynamic jobs asset set.
LOCATION_SYNC Location sync level asset set.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Business Profile location group asset set.
CHAIN_DYNAMIC_LOCATION_GROUP Chain location group asset set which can be used for both owned locations and affiliate locations.
STATIC_LOCATION_GROUP Static location group asset set which can be used for both owned locations and affiliate locations.
HOTEL_PROPERTY Hotel Property asset set which is used to link a hotel property feed to Performance Max for travel goals campaigns.
TRAVEL_FEED Travel Feed asset set type. Can represent either a Hotel feed or a Things to Do (activities) feed.

ManualCpa

Этот тип не содержит полей.

Стратегия ручного назначения ставок, позволяющая рекламодателю устанавливать ставку для каждого действия, указанного рекламодателем.

ManualCpc

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

JSON representation 
{
  "enhancedCpcEnabled": boolean
}
Поля
enhancedCpcEnabled

boolean

Следует ли повышать ставки на основе данных оптимизатора конверсии?

Ручной Cpm

Этот тип не содержит полей.

Ручное назначение ставок на основе показов, при котором пользователь платит за тысячу показов.

PercentCpc

A bidding strategy where bids are a fraction of the advertised price for some good or service.

JSON representation 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Поля
cpcBidCeilingMicros

string ( int64 format)

Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined.

enhancedCpcEnabled

boolean

Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpcBidCeilingMicros, but the average bid amount for a campaign should not.

TargetCpm

Этот тип не содержит полей.

Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.

CampaignAsset

A link between a Campaign and an Asset.

JSON representation 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Поля
resourceName

string

The resource name of the campaign asset. CampaignAsset resource names have the form:

customers/{customerId}/campaignAssets/{campaignId}~{assetId}~{fieldType}

status

enum ( AssetLinkStatus )

Status of the campaign asset.

campaign

string

The campaign to which the asset is linked.

asset

string

The asset which is linked to the campaign.

CampaignAssetSet

CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.

JSON representation 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Поля
resourceName

string

The resource name of the campaign asset set. Asset set asset resource names have the form:

customers/{customerId}/campaignAssetSets/{campaignId}~{asset_set_id}

campaign

string

The campaign to which this asset set is linked.

assetSet

string

The asset set which is linked to the campaign.

status

enum ( AssetSetLinkStatus )

The status of the campaign asset set asset. Read-only.

CampaignAudienceView

A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the campaign audience view. Campaign audience view resource names have the form:

customers/{customerId}/campaignAudienceViews/{campaignId}~{criterionId}

CampaignCriterion

A campaign criterion.

JSON representation 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Поля
resourceName

string

The resource name of the campaign criterion. Campaign criterion resource names have the form:

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}

displayName

string

The display name of the criterion.

This field is ignored for mutates.

type

enum ( CriterionType )

Тип критерия.

status

enum ( CampaignCriterionStatus )

Статус критерия.

lastModifiedTime

string

The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

criterionId

string ( int64 format)

Идентификатор критерия.

This field is ignored during mutate.

bidModifier

number

The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.

negative

boolean

Следует ли применять данный критерий в качестве целевого ( false ) или исключать ( true ).

Union field criterion . The campaign criterion.

Необходимо установить ровно один критерий. criterion может быть только одним из следующих:

keyword

object ( KeywordInfo )

Ключевое слово.

location

object ( LocationInfo )

Расположение.

device

object ( DeviceInfo )

Устройство.

ageRange

object ( AgeRangeInfo )

Возрастной диапазон.

gender

object ( GenderInfo )

Пол.

userList

object ( UserListInfo )

Список пользователей.

language

object ( LanguageInfo )

Язык.

webpage

object ( WebpageInfo )

Веб-страница.

locationGroup

object ( LocationGroupInfo )

Location Group

CampaignCriterionStatus

The possible statuses of a CampaignCriterion.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The campaign criterion is enabled.
PAUSED The campaign criterion is paused.
REMOVED The campaign criterion is removed.

LanguageInfo

Критерий владения языком.

JSON representation 
{
  "languageConstant": string
}
Поля
languageConstant

string

Имя ресурса языковой константы.

LocationGroupInfo

Радиус вокруг списка местоположений, указанных в потоке данных.

JSON representation 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Поля
geoTargetConstants[]

string

Константы географической цели ограничивают область охвата в ленте. В настоящее время допускается только одна константа географической цели.

radiusUnits

enum ( LocationGroupRadiusUnits )

Единица измерения радиуса. Для констант географических целей поддерживаются мили и метры. Для наборов элементов ленты поддерживаются миллимили и метры. Это обязательное значение, которое необходимо задать в операциях CREATE.

feedItemSets[]

string

FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geoTargetConstants. This is optional and can only be set in CREATE operations.

radius

string ( int64 format)

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

LocationGroupRadiusUnits

The unit of radius distance in location group (for example, MILES)

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
METERS Метры
MILES Miles
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Represents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.

JSON representation 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Name of the resource. CampaignEffectivelabel resource names have the form: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaignId}~{label_id}

campaign

string

The campaign to which the effective label is attached.

label

string

The effective label assigned to the campaign.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит действующая этикетка.

CampaignLabel

Represents a relationship between a campaign and a label.

JSON representation 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Поля
resourceName

string

Name of the resource. Campaign label resource names have the form: customers/{ownerCustomerId}/campaignLabels/{campaignId}~{label_id}

campaign

string

The campaign to which the label is attached.

label

string

The label assigned to the campaign.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит этикетка.

CartDataSalesView

Cart data sales view.

Provides information about the products which were purchased if conversions with cart data is implemented. Performance metrics like revenue, gross profit, lead/cross-sell metrics etc. and Merchant Center attributes such as brand, category etc. are available for products defined in an inventory feed and sold as a result of Google ads. For purchases attributed to clicks on Shopping ads, dimensions of both clicked and sold products can be viewed together.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the Cart data sales view. Cart data sales view resource names have the form: customers/{customerId}/cartDataSalesView

Аудитория

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

JSON representation 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Поля
resourceName

string

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

customers/{customerId}/audiences/{audience_id}

id

string ( int64 format)

Идентификация аудитории.

name

string

Обязательно. Название целевой аудитории. Оно должно быть уникальным для всех целевых аудиторий. Минимальная длина — 1, максимальная — 255 символов.

description

string

Описание целевой аудитории.

ConversionAction

A conversion action.

JSON representation 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Поля
resourceName

string

The resource name of the conversion action. Conversion action resource names have the form:

customers/{customerId}/conversionActions/{conversionActionId}

creationTime

string

Timestamp of the Floodlight activity's creation, formatted in ISO 8601.

status

enum ( ConversionActionStatus )

The status of this conversion action for conversion event accrual.

type

enum ( ConversionActionType )

The type of this conversion action.

category

enum ( ConversionActionCategory )

The category of conversions reported for this conversion action.

valueSettings

object ( ValueSettings )

Settings related to the value for conversion events associated with this conversion action.

attributionModelSettings

object ( AttributionModelSettings )

Settings related to this conversion action's attribution model.

floodlightSettings

object ( FloodlightSettings )

Floodlight settings for Floodlight conversion types.

id

string ( int64 format)

The ID of the conversion action.

name

string

The name of the conversion action.

This field is required and should not be empty when creating new conversion actions.

primaryForGoal

boolean

If a conversion action's primaryForGoal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primaryForGoal, so if a campaign has a custom conversion goal configured with a primaryForGoal = false conversion action, that conversion action is still biddable. By default, primaryForGoal will be true if not set. In V9, primaryForGoal can only be set to false after creation through an 'update' operation because it's not declared as optional.

ownerCustomer

string

The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.

includeInClientAccountConversionsMetric

boolean

Whether this conversion action should be included in the "clientAccountConversions" metric.

includeInConversionsMetric

boolean

Whether this conversion action should be included in the "conversions" metric.

clickThroughLookbackWindowDays

string ( int64 format)

The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.

appId

string

App ID for an app conversion action.

ConversionActionStatus

Possible statuses of a conversion action.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Conversions will be recorded.
REMOVED Conversions will not be recorded.
HIDDEN Conversions will not be recorded and the conversion action will not appear in the UI.

ConversionActionType

Possible types of a conversion action.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
AD_CALL Conversions that occur when a user clicks on an ad's call extension.
CLICK_TO_CALL Conversions that occur when a user on a mobile device clicks a phone number.
GOOGLE_PLAY_DOWNLOAD Conversions that occur when a user downloads a mobile app from the Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions that occur when a user makes a purchase in an app through Android billing.
UPLOAD_CALLS Call conversions that are tracked by the advertiser and uploaded.
UPLOAD_CLICKS Conversions that are tracked by the advertiser and uploaded with attributed clicks.
WEBPAGE Conversions that occur on a webpage.
WEBSITE_CALL Conversions that occur when a user calls a dynamically-generated phone number from an advertiser's website.
STORE_SALES_DIRECT_UPLOAD Store Sales conversion based on first-party or third-party merchant data uploads. Only customers on the allowlist can use store sales direct upload types.
STORE_SALES Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Only customers on the allowlist can use store sales types. Read only.
FIREBASE_ANDROID_FIRST_OPEN Android app first open conversions tracked through Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Firebase.
FIREBASE_ANDROID_CUSTOM Android app custom conversions tracked through Firebase.
FIREBASE_IOS_FIRST_OPEN iOS app first open conversions tracked through Firebase.
FIREBASE_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Firebase.
FIREBASE_IOS_CUSTOM iOS app custom conversions tracked through Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Android app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Android app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Android app custom conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN iOS app first open conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE iOS app in app purchase conversions tracked through Third Party App Analytics.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM iOS app custom conversions tracked through Third Party App Analytics.
ANDROID_APP_PRE_REGISTRATION Conversions that occur when a user pre-registers a mobile app from the Google Play Store. Read only.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions that track all Google Play downloads which aren't tracked by an app-specific type. Read only.
FLOODLIGHT_ACTION Floodlight activity that counts the number of times that users have visited a particular webpage after seeing or clicking on one of an advertiser's ads. Read only.
FLOODLIGHT_TRANSACTION Floodlight activity that tracks the number of sales made or the number of items purchased. Can also capture the total value of each sale. Read only.
GOOGLE_HOSTED Conversions that track local actions from Google's products and services after interacting with an ad. Read only.
LEAD_FORM_SUBMIT Conversions reported when a user submits a lead form. Read only.
SALESFORCE

Deprecated: The Salesforce integration ended on May 31, 2025. See Legacy Salesforce integration for conversions upgrade FAQ .

SEARCH_ADS_360 Conversions imported from Search Ads 360 Floodlight data. Read only.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Call conversions that occur on Smart campaign Ads without call tracking setup, using Smart campaign custom criteria. Read only.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL The user clicks on a call element within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_MAP_DIRECTIONS The user requests directions to a business location within Google Maps. Smart campaign only. Read only.
SMART_CAMPAIGN_TRACKED_CALLS Call conversions that occur on Smart campaign Ads with call tracking setup, using Smart campaign custom criteria. Read only.
STORE_VISITS Conversions that occur when a user visits an advertiser's retail store. Read only.
WEBPAGE_CODELESS Conversions created from website events (such as form submissions or page loads), that don't use individually coded event snippets. Read only.
UNIVERSAL_ANALYTICS_GOAL Conversions that come from linked Universal Analytics goals.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions that come from linked Universal Analytics transactions.
GOOGLE_ANALYTICS_4_CUSTOM Conversions that come from linked Google Analytics 4 custom event conversions.
GOOGLE_ANALYTICS_4_PURCHASE Conversions that come from linked Google Analytics 4 purchase conversions.

ConversionActionCategory

The category of conversions that are associated with a ConversionAction.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
DEFAULT Default category.
PAGE_VIEW User visiting a page.
PURCHASE Purchase, sales, or "order placed" event.
SIGNUP Signup user action.
LEAD Lead-generating action.
DOWNLOAD Software download action (as for an app).
ADD_TO_CART The addition of items to a shopping cart or bag on an advertiser site.
BEGIN_CHECKOUT When someone enters the checkout flow on an advertiser site.
SUBSCRIBE_PAID The start of a paid subscription for a product or service.
PHONE_CALL_LEAD A call to indicate interest in an advertiser's offering.
IMPORTED_LEAD A lead conversion imported from an external source into Google Ads.
SUBMIT_LEAD_FORM A submission of a form on an advertiser site indicating business interest.
BOOK_APPOINTMENT A booking of an appointment with an advertiser's business.
REQUEST_QUOTE A quote or price estimate request.
GET_DIRECTIONS A search for an advertiser's business location with intention to visit.
OUTBOUND_CLICK A click to an advertiser's partner's site.
CONTACT A call, SMS, email, chat or other type of contact to an advertiser.
ENGAGEMENT A website engagement event such as long site time or a Google Analytics (GA) Smart Goal. Intended to be used for GA, Firebase, GA Gold goal imports.
STORE_VISIT A visit to a physical store location.
STORE_SALE A sale occurring in a physical store.
QUALIFIED_LEAD A lead conversion imported from an external source into Google Ads, that has been further qualified by the advertiser (marketing/sales team). In the lead-to-sale journey, advertisers get leads, then act on them by reaching out to the consumer. If the consumer is interested and may end up buying their product, the advertiser marks such leads as "qualified leads".
CONVERTED_LEAD A lead conversion imported from an external source into Google Ads, that has further completed a chosen stage as defined by the lead gen advertiser.

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

JSON representation 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Поля
defaultValue

number

The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.

defaultCurrencyCode

string

The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.

alwaysUseDefaultValue

boolean

Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.

AttributionModelSettings

Settings related to this conversion action's attribution model.

JSON representation 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Поля
attributionModel

enum ( AttributionModel )

The attribution model type of this conversion action.

dataDrivenModelStatus

enum ( DataDrivenModelStatus )

The status of the data-driven attribution model for the conversion action.

AttributionModel

The attribution model that describes how to distribute credit for a particular conversion across potentially many prior interactions.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
EXTERNAL Uses external attribution.
GOOGLE_ADS_LAST_CLICK Attributes all credit for a conversion to its last click.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Attributes all credit for a conversion to its first click using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attributes credit for a conversion equally across all of its clicks using Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attributes exponentially more credit for a conversion to its more recent clicks using Google Search attribution (half-life is 1 week).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attributes 40% of the credit for a conversion to its first and last clicks. Remaining 20% is evenly distributed across all other clicks. This uses Google Search attribution.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Flexible model that uses machine learning to determine the appropriate distribution of credit among clicks using Google Search attribution.

DataDrivenModelStatus

Enumerates data driven model statuses.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
AVAILABLE The data driven model is available.
STALE The data driven model is stale. It hasn't been updated for at least 7 days. It is still being used, but will become expired if it does not get updated for 30 days.
EXPIRED The data driven model expired. It hasn't been updated for at least 30 days and cannot be used. Most commonly this is because there hasn't been the required number of events in a recent 30-day period.
NEVER_GENERATED The data driven model has never been generated. Most commonly this is because there has never been the required number of events in any 30-day period.

FloodlightSettings

Settings related to a Floodlight conversion action.

JSON representation 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Поля
activityGroupTag

string

String used to identify a Floodlight activity group when reporting conversions.

activityTag

string

String used to identify a Floodlight activity when reporting conversions.

activityId

string ( int64 format)

ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857

JSON representation 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Поля
resourceName

string

The resource name of the conversion custom variable. Conversion custom variable resource names have the form:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string ( int64 format)

The ID of the conversion custom variable.

name

string

Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.

tag

string

Required. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".

status

enum ( ConversionCustomVariableStatus )

The status of the conversion custom variable for conversion event accrual.

ownerCustomer

string

The resource name of the customer that owns the conversion custom variable.

family

enum ( ConversionCustomVariableFamily )

Family of the conversion custom variable.

cardinality

enum ( ConversionCustomVariableCardinality )

Cardinality of the conversion custom variable.

floodlightConversionCustomVariableInfo

object ( FloodlightConversionCustomVariableInfo )

Fields for Search Ads 360 floodlight conversion custom variables.

customColumnIds[]

string ( int64 format)

The IDs of custom columns that use this conversion custom variable.

ConversionCustomVariableStatus

Possible statuses of a conversion custom variable.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVATION_NEEDED

The conversion custom variable is pending activation and will not accrue stats until set to ENABLED.

This status can't be used in CREATE and UPDATE requests.

ENABLED The conversion custom variable is enabled and will accrue stats.
PAUSED The conversion custom variable is paused and will not accrue stats until set to ENABLED again.

ConversionCustomVariableFamily

Family of a conversion custom variable.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
STANDARD The standard conversion custom variable. Customers are required to activate before use.
FLOODLIGHT The conversion custom variable imported from a custom floodlight variable.

ConversionCustomVariableCardinality

Cardinality of a conversion custom variable.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_ALL_LIMITS The conversion custom variable has cardinality below all limits. The variable can be used for segmentation, and stats can accrue for new values if the variable is enabled.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT The conversion custom variable has cardinality that exceeds the segmentation limit, but does not exceed the stats limit. Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
APPROACHES_STATS_LIMIT The conversion custom variable has exceeded the segmentation limits, and is approaching the stats limits (> 90%). Segmentation will be disabled, but stats can accrue for new values if the variable is enabled.
EXCEEDS_STATS_LIMIT The conversion custom variable has exceeded both the segmentation limits and stats limits. Segmentation will be disabled, and stats for enabled variables can accrue only if the existing values do not increase the cardinality of the variable any further.

FloodlightConversionCustomVariableInfo

Information for Search Ads 360 Floodlight Conversion Custom Variables.

JSON representation 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Поля
floodlightVariableType

enum ( FloodlightVariableType )

Floodlight variable type defined in Search Ads 360.

floodlightVariableDataType

enum ( FloodlightVariableDataType )

Floodlight variable data type defined in Search Ads 360.

FloodlightVariableType

Type of the floodlight variable, as defined in the Search Ads 360. See https://support.google.com/searchads/answer/4397154?hl=en to learn more.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
DIMENSION Dimension floodlight variable type.
METRIC Metric floodlight variable type.
UNSET Floodlight variable type is unset.

FloodlightVariableDataType

The data type of the floodlight variable, as defined in Search Ads 360. See https://support.google.com/searchads/answer/4397154?hl=en to learn more.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
NUMBER Represents a floodlight variable of "Number" type. This variable may be assigned to floodlight variables of DIMENSION or METRIC types.
STRING Represents a floodlight variable of "String" type. This variable may be assigned to floodlight variables of DIMENSION type.

Клиент

A customer.

JSON representation 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Поля
resourceName

string

The resource name of the customer. Customer resource names have the form:

customers/{customerId}

conversionTrackingSetting

object ( ConversionTrackingSetting )

Conversion tracking setting for a customer.

accountType

enum ( AccountType )

Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.

doubleClickCampaignManagerSetting

object ( DoubleClickCampaignManagerSetting )

DoubleClick Campaign Manager (DCM) setting for a manager customer.

accountStatus

enum ( AccountStatus )

Account status, for example, Enabled, Paused, Removed, etc.

lastModifiedTime

string

The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

engineId

string

ID of the account in the external engine account.

status

enum ( CustomerStatus )

The status of the customer.

creationTime

string

The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

managerId

string ( int64 format)

The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.

managerDescriptiveName

string

The descriptive name of the manager.

subManagerId

string ( int64 format)

The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.

subManagerDescriptiveName

string

The descriptive name of the sub manager.

associateManagerId

string ( int64 format)

The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.

associateManagerDescriptiveName

string

The descriptive name of the associate manager.

accountLevel

enum ( AccountLevelType )

The account level of the customer: Manager, Sub-manager, Associate manager, Service account.

id

string ( int64 format)

The ID of the customer.

descriptiveName

string

Optional, non-unique descriptive name of the customer.

currencyCode

string

The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.

timeZone

string

The local timezone ID of the customer.

trackingUrlTemplate

string

The URL template for constructing a tracking URL out of parameters.

finalUrlSuffix

string

The URL template for appending params to the final URL.

autoTaggingEnabled

boolean

Whether auto-tagging is enabled for the customer.

manager

boolean

Whether the customer is a manager.

ConversionTrackingSetting

A collection of customer-wide settings related to Search Ads 360 Conversion Tracking.

JSON representation 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Поля
acceptedCustomerDataTerms

boolean

Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709 .

conversionTrackingStatus

enum ( ConversionTrackingStatus )

Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.

enhancedConversionsForLeadsEnabled

boolean

Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.

googleAdsConversionCustomer

string

The resource name of the customer where conversions are created and managed. This field is read-only.

conversionTrackingId

string ( int64 format)

The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversionTrackingStatus does). This field is read-only.

googleAdsCrossAccountConversionTrackingId

string ( int64 format)

The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversionTrackingId. This field can only be managed through the Google Ads UI. This field is read-only.

crossAccountConversionTrackingId

string ( int64 format)

The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversionTrackingId.

ConversionTrackingStatus

Conversion Tracking status of the customer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
NOT_CONVERSION_TRACKED Customer does not use any conversion tracking.
CONVERSION_TRACKING_MANAGED_BY_SELF The conversion actions are created and managed by this customer.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER The conversion actions are created and managed by the manager specified in the request's login-customer-id .
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER The conversion actions are created and managed by a manager different from the customer or manager specified in the request's login-customer-id .

AccountType

Possible engine account types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BAIDU Baidu account.
ENGINE_TRACK Engine track account.
FACEBOOK Facebook account.
FACEBOOK_GATEWAY Facebook account managed through gateway.
GOOGLE_ADS Google Ads account.
MICROSOFT Microsoft Advertising account.
SEARCH_ADS_360 Search Ads 360 manager account.
YAHOO_JAPAN Yahoo Japan account.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

JSON representation 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Поля
advertiserId

string ( int64 format)

ID of the Campaign Manager advertiser associated with this customer.

networkId

string ( int64 format)

ID of the Campaign Manager network associated with this customer.

timeZone

string

Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

AccountStatus

Possible statuses of an account.

Перечисления
UNSPECIFIED Default value.
UNKNOWN Unknown value.
ENABLED Account is able to serve ads.
PAUSED Account is deactivated by the user.
SUSPENDED Account is deactivated by an internal process.
REMOVED Account is irrevocably deactivated.
DRAFT Account is still in the process of setup, not ENABLED yet.

CustomerStatus

Possible statuses of a customer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Indicates an active account able to serve ads.
CANCELED Indicates a canceled account unable to serve ads. Can be reactivated by an admin user.
SUSPENDED Indicates a suspended account unable to serve ads. May only be activated by Google support.
CLOSED Indicates a closed account unable to serve ads. Test account will also have CLOSED status. Status is permanent and may not be reopened.

AccountLevelType

Enum describing possible account levels.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLIENT_ACCOUNT_FACEBOOK Client account (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Client account (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Client account (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Client account (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK Client account (Engine Track)
MANAGER Top-level manager.
SUB_MANAGER Sub manager.
ASSOCIATE_MANAGER Associate manager.

CustomerAsset

A link between a customer and an asset.

JSON representation 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Поля
resourceName

string

The resource name of the customer asset. CustomerAsset resource names have the form:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Required. The asset which is linked to the customer.

status

enum ( AssetLinkStatus )

Status of the customer asset.

CustomerAssetSet

CustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.

JSON representation 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Поля
resourceName

string

The resource name of the customer asset set. Asset set asset resource names have the form:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

The asset set which is linked to the customer.

customer

string

The customer to which this asset set is linked.

status

enum ( AssetSetLinkStatus )

The status of the customer asset set asset. Read-only.

Доступная стратегия торгов

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

В отличие от BiddingStrategy, этот ресурс включает стратегии, принадлежащие менеджерам клиента и доступные этому клиенту, а также стратегии, принадлежащие самому клиенту. Этот ресурс не предоставляет метрик и отображает лишь ограниченный набор атрибутов BiddingStrategy.

JSON representation 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Поля
resourceName

string

Название ресурса стратегии доступных ставок. Названия ресурсов AccessibleBiddingStrategy имеют следующий формат:

customers/{customerId}/accessibleBiddingStrategies/{biddingStrategyId}

id

string ( int64 format)

Идентификатор стратегии торгов.

name

string

Название стратегии торгов.

type

enum ( BiddingStrategyType )

Тип стратегии торгов.

ownerCustomerId

string ( int64 format)

Идентификатор клиента, которому принадлежит стратегия назначения ставок.

ownerDescriptiveName

string

descriptiveName of the Customer which owns the bidding strategy.

scheme распределения рабочих мест в рамках Союза. Схема проведения торгов.

Можно установить только одну схему. scheme может быть только одной из следующих:

maximizeConversionValue

object ( MaximizeConversionValue )

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

maximizeConversions

object ( MaximizeConversions )

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

targetCpa

object ( TargetCpa )

Стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

targetImpressionShare

object ( TargetImpressionShare )

Стратегия назначения ставок, которая автоматически оптимизирует показ в соответствии с выбранным процентом показов.

targetRoas

object ( TargetRoas )

Стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

targetSpend

object ( TargetSpend )

Стратегия назначения ставок, которая позволяет установить ставки таким образом, чтобы получить максимальное количество кликов в рамках вашего бюджета.

Максимизировать значение конверсии

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

JSON representation 
{
  "targetRoas": number
}
Поля
targetRoas

number

Параметр «Целевая рентабельность рекламных расходов» (ROAS). Если он установлен, стратегия назначения ставок будет максимизировать доход, усредняя при этом целевую рентабельность рекламных расходов. Если целевой показатель ROAS высок, стратегия назначения ставок может не позволить потратить весь бюджет. Если целевой показатель ROAS не установлен, стратегия назначения ставок будет стремиться достичь максимально возможного показателя ROAS для бюджета.

Максимизировать конверсии

Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.

JSON representation 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Поля
targetCpa

string ( int64 format)

Вариант целевой стоимости привлечения клиента (CPA). Это средняя сумма, которую вы хотели бы потратить на одно привлечение клиента.

targetCpaMicros

string ( int64 format)

Вариант целевой стоимости привлечения клиента (CPA). Это средняя сумма, которую вы хотели бы потратить на одно привлечение клиента.

TargetCpa

Автоматизированная стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы обеспечить максимально возможное количество конверсий при целевой стоимости привлечения клиента (CPA), которую вы задали.

JSON representation 
{
  "targetCpaMicros": string
}
Поля
targetCpaMicros

string ( int64 format)

Средний целевой показатель CPA. Этот показатель должен быть больше или равен минимальному количеству оплачиваемых единиц в зависимости от валюты счета.

ЦелеваяПоказПоказПоделить

Автоматизированная стратегия назначения ставок, которая устанавливает ставки таким образом, чтобы определенный процент поисковых объявлений отображался в верхней части первой страницы (или в другом целевом месте).

JSON representation 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
location

enum ( TargetImpressionShareLocation )

Целевое местоположение на странице результатов поиска.

locationFractionMicros

string ( int64 format)

Выбранная доля рекламных объявлений, которые будут показаны в целевом местоположении, в микросекундах. Например, 1% равен 10 000.

cpcBidCeilingMicros

string ( int64 format)

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

TargetRoas

Автоматизированная стратегия назначения ставок, которая помогает максимизировать доход при достижении целевого показателя рентабельности инвестиций в рекламу (ROAS).

JSON representation 
{
  "targetRoas": number
}
Поля
targetRoas

number

Выбранный показатель выручки (на основе данных о конверсии) на единицу потраченных средств.

Целевые расходы

Автоматизированная стратегия назначения ставок, которая устанавливает ваши ставки таким образом, чтобы получить как можно больше кликов в рамках вашего бюджета.

JSON representation 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Поля
targetSpendMicros
(deprecated)

string ( int64 format)

Целевой показатель расходов, при котором планируется максимизировать количество кликов. Участник, устанавливающий целевую ставку TargetSpend, будет пытаться потратить меньшее из этого значения или естественной суммы ограничения расходов. Если не указано иное, в качестве целевого показателя расходов используется бюджет. Это поле устарело и больше не должно использоваться. Подробнее см. https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html .

cpcBidCeilingMicros

string ( int64 format)

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

ManagerLinkStatus

Possible statuses of a link.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE Indicates current in-effect relationship
INACTIVE Indicates terminated relationship
PENDING Indicates relationship has been requested by manager, but the client hasn't accepted yet.
REFUSED Relationship was requested by the manager, but the client has refused.
CANCELED Indicates relationship has been requested by manager, but manager canceled it.

CustomerClient

A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.

JSON representation 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Поля
resourceName

string

The resource name of the customer client. CustomerClient resource names have the form: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form:

customers/{customerId}/labels/{label_id}

status

enum ( CustomerStatus )

The status of the client customer. Read only.

clientCustomer

string

The resource name of the client-customer which is linked to the given customer. Read only.

hidden

boolean

Specifies whether this is a hidden account.

Read only.

level

string ( int64 format)

Distance between given customer and client. For self link, the level value will be 0. Read only.

timeZone

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

testAccount

boolean

Identifies if the client is a test account. Read only.

manager

boolean

Identifies if the client is a manager. Read only.

descriptiveName

string

Descriptive name for the client. Read only.

currencyCode

string

Currency code (for example, 'USD', 'EUR') for the client. Read only.

id

string ( int64 format)

The ID of the client customer. Read only.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

JSON representation 
{
  "resourceName": string,
  "landingPage": string
}
Поля
resourceName

string

The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{adGroupId}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

The dynamically selected landing page URL of the impression.

Это поле доступно только для чтения.

GenderView

A gender view resource. Represents the view of a customer's performance metrics aggregated by gender. All statistics are aggregated at the ad group level.

Note: While you can segment metrics by age range using ageRangeView or by gender using genderView , the Search Ads 360 API does not support segmenting metrics by both age range and gender simultaneously in a single query. Analyzing performance across both dimensions combined is not supported in the Search Ads 360 API.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the gender view. Gender view resource names have the form:

customers/{customerId}/genderViews/{adGroupId}~{criterionId}

GeoTargetConstant

A geo target constant.

JSON representation 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Поля
resourceName

string

The resource name of the geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{geo_target_constant_id}

status

enum ( GeoTargetConstantStatus )

Geo target constant status.

id

string ( int64 format)

The ID of the geo target constant.

name

string

Geo target constant English name.

countryCode

string

The ISO-3166-1 alpha-2 country code that is associated with the target.

targetType

string

Geo target constant target type.

canonicalName

string

The fully qualified English name, consisting of the target's name and that of its parent and country.

parentGeoTarget

string

The resource name of the parent geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

The possible statuses of a geo target constant.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The geo target constant is valid.
REMOVAL_PLANNED The geo target constant is obsolete and will be removed.

KeywordView

A keyword view.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the keyword view. Keyword view resource names have the form:

customers/{customerId}/keywordViews/{adGroupId}~{criterionId}

Этикетка

A label.

JSON representation 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Поля
resourceName

string

Name of the resource. Label resource names have the form: customers/{ownerCustomerId}/labels/{label_id}

status

enum ( LabelStatus )

Status of the label. Read only.

textLabel

object ( TextLabel )

A type of label displaying text on a colored background.

id

string ( int64 format)

ID of the label. Read only.

name

string

The name of the label.

This field is required and should not be empty when creating a new label.

The length of this string should be between 1 and 80, inclusive.

LabelStatus

Possible statuses of a label.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED Label is enabled.
REMOVED Label is removed.

TextLabel

A type of label displaying text on a colored background.

JSON representation 
{
  "backgroundColor": string,
  "description": string
}
Поля
backgroundColor

string

Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.

description

string

A short description of the label. The length must be no more than 200 characters.

LanguageConstant

A language.

JSON representation 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Поля
resourceName

string

The resource name of the language constant. Language constant resource names have the form:

languageConstants/{criterionId}

id

string ( int64 format)

The ID of the language constant.

code

string

The language code, for example, "en_US", "en_AU", "es", "fr", etc.

name

string

The full name of the language in English, for example, "English (US)", "Spanish", etc.

targetable

boolean

Whether the language is targetable.

LocationView

A location view summarizes the performance of campaigns by a Location criterion.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the location view. Location view resource names have the form:

customers/{customerId}/locationViews/{campaignId}~{criterionId}

ProductBiddingCategoryConstant

A Product Bidding Category.

JSON representation 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Поля
resourceName

string

The resource name of the product bidding category. Product bidding category resource names have the form:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum ( ProductBiddingCategoryLevel )

Level of the product bidding category.

status

enum ( ProductBiddingCategoryStatus )

Status of the product bidding category.

id

string ( int64 format)

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

countryCode

string

Two-letter upper-case country code of the product bidding category.

productBiddingCategoryConstantParent

string

Resource name of the parent product bidding category.

languageCode

string

Language code of the product bidding category.

localizedName

string

Display value of the product bidding category localized according to languageCode.

ProductBiddingCategoryLevel

Enum describing the level of the product bidding category.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
LEVEL1 Уровень 1.
LEVEL2 Level 2.
LEVEL3 Уровень 3.
LEVEL4 Уровень 4.
LEVEL5 Уровень 5.

ProductBiddingCategoryStatus

Enum describing the status of the product bidding category.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ACTIVE The category is active and can be used for bidding.
OBSOLETE The category is obsolete. Used only for reporting purposes.

ProductGroupView

A product group view.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the product group view. Product group view resource names have the form:

customers/{customerId}/productGroupViews/{adGroupId}~{criterionId}

ShoppingPerformanceView

Shopping performance view.

Provides Shopping campaign and Performance Max campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition, and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.

The number of impressions and clicks that shoppingPerformanceView returns stats for may be different from campaign reports. shoppingPerformanceView shows impressions and clicks on products appearing in ads, while campaign reports show impressions and clicks on the ads themselves. Depending on the format, an ad can show from zero to several products, so the numbers may not match.

In Search Ads 360 UI, you can query impressions and clicks of products appearing in ads by selecting a column from "Product attributes" in the report editor. For example, selecting the "Brand" column is equivalent to selecting segments.product_brand .

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customerId}/shoppingPerformanceView

UserList

A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: id . Note that the name must also be unique for user lists owned by a given customer, except in some cases where accessReason is set to SHARED . Violating the unique name constraint produces error: UserListError.INVALID_NAME .

JSON representation 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Поля
resourceName

string

The resource name of the user list. User list resource names have the form:

customers/{customerId}/userLists/{userListId}

type

enum ( UserListType )

Type of this list.

Это поле доступно только для чтения.

id

string ( int64 format)

Id of the user list.

name

string

Name of this user list. Unique per user list, except in some cases where a user list of the same name has accessReason set to SHARED .

UserListType

Enum containing possible user list types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
REMARKETING UserList represented as a collection of conversion types.
LOGICAL UserList represented as a combination of other user lists/interests.
EXTERNAL_REMARKETING UserList created in the Google Ad Manager platform.
RULE_BASED UserList associated with a rule.
SIMILAR UserList with users similar to users of another UserList.
CRM_BASED UserList of first-party CRM data provided by advertiser in the form of emails or other formats.

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

JSON representation 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Поля
resourceName

string

The resource name of the user location view. UserLocation view resource names have the form:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string ( int64 format)

Criterion Id for the country.

targetingLocation

boolean

Indicates whether location was targeted or not.

WebpageView

A webpage view.

JSON representation 
{
  "resourceName": string
}
Поля
resourceName

string

The resource name of the webpage view. Webpage view resource names have the form:

customers/{customerId}/webpageViews/{adGroupId}~{criterionId}

Посещать

A visit.

JSON representation 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Поля
resourceName

string

The resource name of the visit. Visit resource names have the form:

customers/{customerId}/visits/{adGroupId}~{criterionId}~{ds_visit_id}

id

string ( int64 format)

The ID of the visit.

criterionId

string ( int64 format)

Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.

merchantId

string ( int64 format)

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

adId

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

clickId

string

A unique string for each visit that is passed to the landing page as the click id URL parameter.

visitDateTime

string

The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

productId

string

The ID of the product clicked on.

productChannel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

productLanguageCode

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

productStoreId

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

productCountryCode

string

The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.

assetId

string ( int64 format)

ID of the asset which was interacted with during the visit event.

assetFieldType

enum ( AssetFieldType )

Asset field type of the visit event.

ProductChannel

Enum describing the locality of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ONLINE The item is sold online.
LOCAL The item is sold in local stores.

Конвертация

A conversion.

JSON representation 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Поля
resourceName

string

The resource name of the conversion. Conversion resource names have the form:

customers/{customerId}/conversions/{adGroupId}~{criterionId}~{ds_conversion_id}

id

string ( int64 format)

The ID of the conversion

criterionId

string ( int64 format)

Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.

merchantId

string ( int64 format)

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

adId

string ( int64 format)

Ad ID. A value of 0 indicates that the ad is unattributed.

clickId

string

A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.

visitId

string ( int64 format)

The Search Ads 360 visit ID that the conversion is attributed to.

advertiserConversionId

string

For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlightOrderId column depending on the advertiser's Floodlight instructions.

productId

string

The ID of the product clicked on.

productChannel

enum ( ProductChannel )

The sales channel of the product that was clicked on: Online or Local.

productLanguageCode

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

productStoreId

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

productCountryCode

string

The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.

attributionType

enum ( AttributionType )

What the conversion is attributed to: Visit or Keyword+Ad.

conversionDateTime

string

The timestamp of the conversion event.

conversionLastModifiedDateTime

string

The timestamp of the last time the conversion was modified.

conversionVisitDateTime

string

The timestamp of the visit that the conversion is attributed to.

conversionQuantity

string ( int64 format)

The quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.

conversionRevenueMicros

string ( int64 format)

The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.

floodlightOriginalRevenue

string ( int64 format)

The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.

floodlightOrderId

string

The Floodlight order ID provided by the advertiser for the conversion.

status

enum ( ConversionStatus )

The status of the conversion, either ENABLED or REMOVED..

assetId

string ( int64 format)

ID of the asset which was interacted with during the conversion event.

assetFieldType

enum ( AssetFieldType )

Asset field type of the conversion event.

AttributionType

Conversion attribution type in SearchAds360

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
VISIT The conversion is attributed to a visit.
CRITERION_AD The conversion is attributed to a criterion and ad pair.

ConversionStatus

Possible statuses of a conversion.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
ENABLED The conversion is enabled.
REMOVED The conversion has been removed.

Метрики

Метрики данных.

JSON representation 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "orders": number,
  "averageOrderValueMicros": string,
  "averageCartSize": number,
  "costOfGoodsSoldMicros": string,
  "grossProfitMicros": string,
  "grossProfitMargin": number,
  "revenueMicros": string,
  "unitsSold": number,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Поля
allConversionsValueByConversionDate

number

Значение всех конверсий. Если для этого столбца выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах by_conversion_date доступна в разделе «О столбце «Все конверсии»» .

allConversionsByConversionDate

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at About the "All conversions" column .

conversionCustomMetrics[]

object ( Value )

Пользовательские метрики конверсии.

conversionsValueByConversionDate

number

Сумма значений конверсий, доступных для участия в торгах, по дате конверсии. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии.

conversionsByConversionDate

number

Сумма конверсий по дате конверсии для типов конверсий, доступных для размещения ставок. Может быть дробной из-за особенностей модели атрибуции. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии.

historicalCreativeQualityScore

enum ( QualityScoreBucket )

Оценка качества творческого исторического контекста.

historicalLandingPageQualityScore

enum ( QualityScoreBucket )

Качество восприятия исторической целевой страницы.

historicalSearchPredictedCtr

enum ( QualityScoreBucket )

Прогнозируемый показатель кликабельности (CTR) на основе исторических данных поисковых запросов.

interactionEventTypes[]

enum ( InteractionEventType )

Типы платных и бесплатных взаимодействий.

rawEventConversionMetrics[]

object ( Value )

Исходные показатели конверсии событий.

absoluteTopImpressionPercentage

number

Абсолютная доля показов в поисковой выдаче — это процент показов вашей рекламы в поиске, которые отображаются на наиболее заметной позиции в результатах поиска.

allConversionsFromInteractionsRate

number

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

allConversionsValue

number

Значение всех конверсий.

allConversions

number

The total number of conversions. This includes all conversions regardless of the value of includeInConversionsMetric.

allConversionsValuePerCost

number

Значение всех конверсий, деленное на общую стоимость взаимодействия с рекламой (например, клики для текстовых объявлений или просмотры для видеообъявлений).

allConversionsFromClickToCall

number

Количество нажатий кнопки «Позвонить» для связи с компанией во время или после просмотра рекламы. Это число не включает информацию о том, были ли звонки соединены, а также продолжительность звонков.

Этот показатель применяется только к элементам корма.

allConversionsFromDirections

number

Количество нажатий кнопки «Проложить маршрут» для перехода к нужному заведению после просмотра рекламного объявления.

Этот показатель применяется только к элементам корма.

allConversionsFromInteractionsValuePerInteraction

number

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

allConversionsFromMenu

number

Количество раз, когда люди переходили по ссылке для просмотра меню компании после клика по рекламному объявлению.

Этот показатель применяется только к элементам корма.

allConversionsFromOrder

number

Количество раз, когда люди разместили заказ в компании после клика по рекламному объявлению.

Этот показатель применяется только к элементам корма.

allConversionsFromOtherEngagement

number

Количество других конверсий (например, оставление отзыва или сохранение местоположения для компании), произошедших после того, как люди кликнули на объявление.

Этот показатель применяется только к элементам корма.

allConversionsFromStoreVisit

number

Примерное количество посещений сайта компанией после клика по рекламному объявлению.

Этот показатель применяется только к элементам корма.

visits

number

Клики, которые Search Ads 360 успешно зафиксировал и перенаправил на целевую страницу рекламодателя.

allConversionsFromStoreWebsite

number

Количество раз, когда пользователи переходили на URL-адрес компании после клика по рекламному объявлению.

Этот показатель применяется только к элементам корма.

averageCost

number

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

averageCpc

number

Общая стоимость всех кликов, деленная на общее количество полученных кликов. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

averageCpm

number

Средняя стоимость за тысячу показов (CPM). Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clicks

string ( int64 format)

Количество кликов.

contentBudgetLostImpressionShare

number

Примерный процент случаев, когда ваша реклама могла быть показана в контекстно-медийной сети, но не была показана из-за слишком низкого бюджета. Примечание: Показатель «потерянная доля показов из-за бюджета на контент» отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

contentImpressionShare

number

Количество показов, полученных вами в контекстно-медийной сети, деленное на предполагаемое количество показов, на которые вы имели право.

Примечание: Доля показов контента указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999.

contentRankLostImpressionShare

number

Примерный процент показов в контекстно-медийной сети, которые ваши объявления не получили из-за низкого рейтинга объявления.

Примечание: Показатель потери доли показов из-за низкого рейтинга контента отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

conversionsFromInteractionsRate

number

Среднее количество конверсий, соответствующих условиям размещения ставки (на основе взаимодействия), на одно взаимодействие, дающее право на конверсию. Показывает, как часто в среднем взаимодействие с объявлением приводит к конверсии, соответствующей условиям размещения ставки.

clientAccountConversionsValue

number

The value of client account conversions. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true . If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversionsValuePerCost

number

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

conversionsFromInteractionsValuePerInteraction

number

The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which includeInConversionsMetric attribute is set to true . If you use conversion-based bidding, your bid strategies will optimize for these conversions.

clientAccountConversions

number

The number of client account conversions. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true . If you use conversion-based bidding, your bid strategies will optimize for these conversions.

costMicros

string ( int64 format)

Сумма ваших затрат на клик (CPC) и стоимость за тысячу показов (CPM) за этот период. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. Дополнительные сведения см. в параметре metrics_currency в разделе PARAMETERS .

costPerAllConversions

number

Стоимость взаимодействия с рекламой, деленная на общее количество конверсий.

costPerConversion

number

Средняя допустимая стоимость конверсии на одну конверсию, при которой можно сделать ставку.

costPerCurrentModelAttributedConversion

number

The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true . If you use conversion-based bidding, your bid strategies will optimize for these conversions.

crossDeviceConversions

number

Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in allConversions .

crossDeviceConversionsByConversionDate

number

Количество конверсий между устройствами по дате конверсии. Подробная информация о столбце by_conversion_date доступна в разделе «О столбце "Все конверсии"».

crossDeviceConversionsValue

number

Сумма значений преобразований между устройствами.

crossDeviceConversionsValueByConversionDate

number

Сумма значений конверсий между устройствами по дате by_conversion_date . Подробная информация о столбце "Все конверсии" доступна в разделе "О столбце"".

ctr

number

Количество кликов по вашему объявлению (Клики), деленное на количество показов вашего объявления (Показы).

conversions

number

The number of conversions. This only includes conversion actions which includeInConversionsMetric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.

conversionsValue

number

Сумма значений конверсий для конверсий, включенных в поле «Конверсии». Этот показатель полезен только в том случае, если вы ввели значение для ваших действий по конверсии.

averageQualityScore

number

Средний балл качества.

historicalQualityScore

string ( int64 format)

Исторический показатель качества.

impressions

string ( int64 format)

Подсчет количества появлений вашего объявления на странице результатов поиска или на веб-сайте в сети Google.

interactionRate

number

Частота взаимодействия пользователей с вашей рекламой после её показа. Это количество взаимодействий, делённое на количество показов вашей рекламы.

interactions

string ( int64 format)

Количество взаимодействий. Взаимодействие — это основное действие пользователя, связанное с форматом объявления: клики для текстовых и товарных объявлений, просмотры для видеообъявлений и так далее.

invalidClickRate

number

Процент отфильтрованных кликов от общего числа кликов (отфильтрованные + неотфильтрованные) за отчетный период.

invalidClicks

string ( int64 format)

Количество кликов, которые Google считает незаконными и за которые не взимает плату.

generalInvalidClickRate

number

Процент кликов, отфильтрованных из общего числа кликов (отфильтрованные + неотфильтрованные) как недействительные. Это клики, которые Google считает нелегитимными и которые обнаруживаются с помощью стандартных методов фильтрации (то есть, известный недействительный трафик из дата-центров, боты и пауки или другие краулеры, нерегулярные шаблоны и т. д.). С них не взимается плата, и они не влияют на статистику вашего аккаунта. См. Фильтрация недействительного трафика для обеспечения качества .

generalInvalidClicks

string ( int64 format)

Количество общих недействительных кликов. Это подмножество ваших недействительных кликов, которые обнаруживаются с помощью стандартных методов фильтрации (например, известный недействительный трафик из дата-центра, боты и поисковые роботы, нестандартные шаблоны и т. д.). С вас за них не взимается плата, и они не влияют на статистику вашей учетной записи. См. Фильтрация недействительного трафика для обеспечения качества .

mobileFriendlyClicksPercentage

number

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

searchAbsoluteTopImpressionShare

number

Процент показов товарных или поисковых объявлений клиента, отображаемых на наиболее заметной позиции в товарной выдаче. Подробнее см. раздел «О показателях верхней и абсолютной верхней позиции» . Любое значение ниже 0,1 отображается как 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Показатель, отражающий, как часто ваше объявление не занимало первое место в результатах поиска из-за недостаточного бюджета.

Примечание: Потерянная доля показов в абсолютном выражении в верхнем диапазоне поискового бюджета отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchBudgetLostImpressionShare

number

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

Примечание: Показатель «потерянные показы» в рамках поискового бюджета отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchBudgetLostTopImpressionShare

number

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

Примечание: Потерянная доля показов в поисковой выдаче отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchClickShare

number

Количество кликов, полученных вами в поисковой сети, деленное на предполагаемое количество кликов, которые вы могли бы получить.

Примечание: Доля кликов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999.

searchExactMatchImpressionShare

number

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

Примечание: Доля показов при точном совпадении в результатах поиска отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999.

searchImpressionShare

number

Количество показов, полученных вами в поисковой сети, деленное на предполагаемое количество показов, на получение которых вы имели право.

Примечание: Доля показов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Показатель, отражающий, как часто ваше объявление не занимало первое место в результатах поиска из-за низкого рейтинга объявления.

Примечание: Потеря абсолютной доли показов в поисковой выдаче указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchRankLostImpressionShare

number

Примерный процент показов в поисковой сети, которые ваши объявления не получили из-за низкого рейтинга объявления. Примечание: доля потерянных показов в поисковой выдаче отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchRankLostTopImpressionShare

number

Показатель, отражающий, как часто ваше объявление не отображалось рядом с верхними органическими результатами поиска из-за низкого рейтинга объявления.

Примечание: Потеря доли показов в поисковой выдаче указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

searchTopImpressionShare

number

Количество показов, полученных вами среди лучших объявлений, по сравнению с предполагаемым количеством показов, которые вы могли бы получить среди лучших объявлений. Примечание: Доля показов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999.

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

topImpressionPercentage

number

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

valuePerAllConversions

number

Значение всех конверсий, деленное на общее количество конверсий.

valuePerAllConversionsByConversionDate

number

Значение всех конверсий, деленное на общее количество конверсий. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах by_conversion_date доступна в разделе «О столбце «Все конверсии»» .

valuePerConversion

number

Значение конверсии, доступной для размещения ставки, деленное на количество таких конверсий. Показывает, сколько в среднем стоит каждая из таких конверсий.

valuePerConversionsByConversionDate

number

Значение конверсий, доступных для размещения ставок, в зависимости от даты конверсии, деленное на количество конверсий, доступных для размещения ставок, в зависимости от даты конверсии. Показывает, сколько в среднем стоит каждая из конверсий, доступных для размещения ставок (в зависимости от даты конверсии). Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии.

clientAccountViewThroughConversions

string ( int64 format)

Общее количество конверсий, совершенных после просмотра. Это происходит, когда клиент видит изображение или мультимедийную рекламу, а затем совершает конверсию на вашем сайте, не взаимодействуя (например, не кликая) на другую рекламу.

orders

number

«Заказы» — это общее количество конверсий покупок, полученных благодаря вашей рекламе.

Как это работает: Вы отслеживаете конверсии с помощью данных корзины для завершенных покупок на вашем сайте. Если конверсия связана с предыдущими взаимодействиями с вашими объявлениями (клики для текстовых или товарных объявлений, просмотры для видеообъявлений и т. д.), она засчитывается как заказ.

Пример: Кто-то кликнул на рекламное объявление в разделе «Товары для дома» и купил ту же шляпу и рубашку в одном заказе на вашем сайте. Даже если он купил два товара, это будет считаться одним заказом.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

averageOrderValueMicros

string ( int64 format)

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

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

Пример: Вы получили 3 заказа, которые принесли доход в размере 10, 15 и 20 долларов. Средняя стоимость заказа составляет 15 долларов = (10 + 15 + 20)/3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

averageCartSize

number

Средний размер корзины — это среднее количество товаров в каждом заказе, оформленном с использованием вашей рекламы.

Как это работает: Вы отчитываетесь о конверсиях, используя данные о корзине покупок, совершенных на вашем сайте. Средний размер корзины — это общее количество проданных товаров, деленное на общее количество полученных заказов.

Пример: Вы получили 2 заказа, первый содержал 3 товара, а второй — 2. Средний размер корзины составляет 2,5 товара = (3+2)/2.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

costOfGoodsSoldMicros

string ( int64 format)

Себестоимость проданных товаров (COGS) — это общая стоимость товаров, проданных вами по заказам, оформленным благодаря вашей рекламе.

Как это работает: Вы можете добавить стоимость проданных товаров к каждому товару в Merchant Center. Если вы формируете отчеты о конверсиях с использованием данных корзины, проданные вами товары сопоставляются с их себестоимостью, и это можно использовать для расчета валовой прибыли, полученной с каждого заказа.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 8 долларов = 3 + 5 долларов.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

grossProfitMicros

string ( int64 format)

Валовая прибыль — это прибыль, полученная вами от заказов, связанных с вашей рекламой, за вычетом себестоимости проданных товаров (COGS).

Как это работает: Валовая прибыль — это выручка от продаж, совершенных благодаря вашей рекламе, за вычетом себестоимости реализованной продукции. Расчеты валовой прибыли включают только те товары, себестоимость реализованной продукции которых указана в Merchant Center.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Себестоимость проданных товаров для шляпы составляет 3 доллара, а для рубашки — нет. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поэтому она составит 7 долларов = 10 долларов - 3 доллара.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

grossProfitMargin

number

Валовая прибыль — это процент валовой прибыли, полученной вами от заказов, совершенных благодаря вашей рекламе, после вычета себестоимости проданных товаров (COGS).

Как это работает: Вы формируете отчеты о конверсиях с данными о корзине покупок на вашем сайте. Валовая прибыль рассчитывается как валовая прибыль, разделенная на общую выручку и умноженная на 100%. Расчеты валовой прибыли включают только товары, для которых в Merchant Center указана себестоимость реализованной продукции.

Пример: Кто-то купил шляпу и рубашку на вашем сайте. Шляпа стоит 10 долларов, а ее себестоимость проданных товаров составляет 3 доллара. Рубашка стоит 20 долларов, но ее себестоимость проданных товаров отсутствует. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поскольку она имеет себестоимость проданных товаров, поэтому она составляет 70% = (10 долларов - 3 доллара) / 10 долларов x 100%.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

revenueMicros

string ( int64 format)

Выручка — это общая сумма, которую вы получили от заказов, связанных с вашей рекламой.

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. На весь заказ действует скидка в 5 долларов. Доход от этого заказа составляет 25 долларов = (10 + 20) - 5.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

unitsSold

number

Количество проданных единиц — это общее число товаров, проданных по заказам, оформленным на основе вашей рекламы.

Как это работает: Вы отчитываетесь о конверсиях с данными о корзине покупок на вашем сайте. Количество проданных единиц — это общее число товаров, проданных по всем заказам, связанным с вашей рекламой.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, а затем купил ту же шляпу, рубашку и куртку. Количество проданных единиц в этом заказе — 3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

clientAccountCrossSellCostOfGoodsSoldMicros

string ( int64 format)

Себестоимость проданных товаров (COGS) при перекрестных продажах по клиентскому счету — это общая стоимость товаров, проданных в результате рекламы другого продукта.

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если рекламное объявление, с которым взаимодействовал покупатель перед покупкой, имеет связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, размещенный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Стоимость проданных товаров в рамках перекрестной продажи — это общая стоимость проданных товаров, которые не были рекламируемыми.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

crossSellCostOfGoodsSoldMicros

string ( int64 format)

Перекрестные продажи (стоимость проданных товаров) — это общая стоимость товаров, проданных в результате рекламы другого продукта.

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если рекламное объявление, с которым взаимодействовал покупатель перед покупкой, имеет связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, размещенный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Стоимость проданных товаров в рамках перекрестной продажи — это общая стоимость проданных товаров, которые не были рекламируемыми.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountCrossSellGrossProfitMicros

string ( int64 format)

Валовая прибыль от перекрестных продаж по клиентскому счету — это прибыль, полученная вами от продажи товаров в результате рекламы другого продукта, за вычетом себестоимости реализованной продукции (COGS).

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым вы взаимодействовали перед покупкой, есть связанный товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в покупку, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж — это доход, полученный вами от перекрестных продаж, отнесенный к вашим объявлениям, за вычетом стоимости проданных товаров.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

crossSellGrossProfitMicros

string ( int64 format)

Валовая прибыль от перекрестных продаж — это прибыль, полученная от продажи товаров в результате рекламы другого продукта, за вычетом себестоимости реализованной продукции (COGS).

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым вы взаимодействовали перед покупкой, есть связанный товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в покупку, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж — это доход, полученный вами от перекрестных продаж, отнесенный к вашим объявлениям, за вычетом стоимости проданных товаров.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountCrossSellRevenueMicros

string ( int64 format)

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

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым взаимодействовал покупатель перед покупкой, есть связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, оформленный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж — это общая сумма, полученная вами от перекрестных продаж, связанных с вашими объявлениями.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

crossSellRevenueMicros

string ( int64 format)

Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product.

Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым взаимодействовал покупатель перед покупкой, есть связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, оформленный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж — это общая сумма, полученная вами от перекрестных продаж, связанных с вашими объявлениями.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountCrossSellUnitsSold

number

Client account cross-sell units sold is the total number of products sold as a result of advertising a different product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

crossSellUnitsSold

number

Cross-sell units sold is the total number of products sold as a result of advertising a different product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

clientAccountLeadCostOfGoodsSoldMicros

string ( int64 format)

Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

leadCostOfGoodsSoldMicros

string ( int64 format)

Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountLeadGrossProfitMicros

string ( int64 format)

Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS).

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

leadGrossProfitMicros

string ( int64 format)

Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS).

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountLeadRevenueMicros

string ( int64 format)

Client account lead revenue is the total amount you made from products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

leadRevenueMicros

string ( int64 format)

Lead revenue is the total amount you made from products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clientAccountLeadUnitsSold

number

Client account lead units sold is the total number of products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

leadUnitsSold

number

Lead units sold is the total number of products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1.

Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины.

uniqueUsers

string ( int64 format)

The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

averageImpressionFrequencyPerUser

number

The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

Ценить

A generic data container.

JSON representation 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Поля
Union field value . A value. value can be only one of the following:
booleanValue

boolean

A boolean.

int64Value

string ( int64 format)

An int64.

floatValue

number

A float.

doubleValue

number

Двойной.

stringValue

string

Строка.

QualityScoreBucket

Enum listing the possible quality score buckets.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
BELOW_AVERAGE Quality of the creative is below average.
AVERAGE Quality of the creative is average.
ABOVE_AVERAGE Quality of the creative is above average.

InteractionEventType

Enum describing possible types of payable and free interactions.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
CLICK Click to site. In most cases, this interaction navigates to an external location, usually the advertiser's landing page. This is also the default InteractionEventType for click events.
ENGAGEMENT The user's expressed intent to engage with the ad in-place.
VIDEO_VIEW User viewed a video ad.
NONE The default InteractionEventType for ad conversion events. This is used when an ad conversion row does NOT indicate that the free interactions (for example, the ad conversions) should be 'promoted' and reported as part of the core metrics. These are simply other (ad) conversions.

Сегменты

Segment only fields.

JSON representation 
{
  "adFormatType": enum (AdFormatType),
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetPostalCode": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "verticalAdsEventParticipantDisplayNames": string,
  "verticalAdsHotelClass": string,
  "verticalAdsListing": string,
  "verticalAdsListingBrand": string,
  "verticalAdsListingCity": string,
  "verticalAdsListingCountry": string,
  "verticalAdsListingRegion": string,
  "verticalAdsPartnerAccount": string,
  "verticalAdsVertical": enum (VerticalAdsItemVerticalType),
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Поля
adFormatType

enum ( AdFormatType )

Ad Format type.

adNetworkType

enum ( AdNetworkType )

Ad network type.

conversionActionCategory

enum ( ConversionActionCategory )

Conversion action category.

conversionCustomDimensions[]

object ( Value )

The conversion custom dimensions.

dayOfWeek

enum ( DayOfWeek )

Day of the week, for example, MONDAY.

device

enum ( Device )

Device to which metrics apply.

keyword

object ( Keyword )

Keyword criterion.

productChannel

enum ( ProductChannel )

Channel of the product.

productChannelExclusivity

enum ( ProductChannelExclusivity )

Channel exclusivity of the product.

productCondition

enum ( ProductCondition )

Condition of the product.

productSoldCondition

enum ( ProductCondition )

Condition of the product sold.

rawEventConversionDimensions[]

object ( Value )

The raw event conversion dimensions.

conversionAction

string

Resource name of the conversion action.

conversionActionName

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geoTargetCity

string

Resource name of the geo target constant that represents a city.

geoTargetCountry

string

Resource name of the geo target constant that represents a country.

geoTargetMetro

string

Resource name of the geo target constant that represents a metro.

geoTargetPostalCode

string

Resource name of the geo target constant that represents a postal code.

geoTargetRegion

string

Resource name of the geo target constant that represents a region.

hour

integer

Hour of day as a number between 0 and 23, inclusive.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

productBiddingCategoryLevel1

string

Bidding category (level 1) of the product.

productBiddingCategoryLevel2

string

Bidding category (level 2) of the product.

productBiddingCategoryLevel3

string

Bidding category (level 3) of the product.

productBiddingCategoryLevel4

string

Bidding category (level 4) of the product.

productBiddingCategoryLevel5

string

Bidding category (level 5) of the product.

productBrand

string

Brand of the product.

productCountry

string

Resource name of the geo target constant for the country of sale of the product.

productCustomAttribute0

string

Custom attribute 0 of the product.

productCustomAttribute1

string

Custom attribute 1 of the product.

productCustomAttribute2

string

Custom attribute 2 of the product.

productCustomAttribute3

string

Custom attribute 3 of the product.

productCustomAttribute4

string

Custom attribute 4 of the product.

productItemId

string

Item ID of the product.

productLanguage

string

Resource name of the language constant for the language of the product.

productSoldBiddingCategoryLevel1

string

Bidding category (level 1) of the product sold.

productSoldBiddingCategoryLevel2

string

Bidding category (level 2) of the product sold.

productSoldBiddingCategoryLevel3

string

Bidding category (level 3) of the product sold.

productSoldBiddingCategoryLevel4

string

Bidding category (level 4) of the product sold.

productSoldBiddingCategoryLevel5

string

Bidding category (level 5) of the product sold.

productSoldBrand

string

Brand of the product sold.

productSoldCustomAttribute0

string

Custom attribute 0 of the product sold.

productSoldCustomAttribute1

string

Custom attribute 1 of the product sold.

productSoldCustomAttribute2

string

Custom attribute 2 of the product sold.

productSoldCustomAttribute3

string

Custom attribute 3 of the product sold.

productSoldCustomAttribute4

string

Custom attribute 4 of the product sold.

productSoldItemId

string

Item ID of the product sold.

productSoldTitle

string

Title of the product sold.

productSoldTypeL1

string

Type (level 1) of the product sold.

productSoldTypeL2

string

Type (level 2) of the product sold.

productSoldTypeL3

string

Type (level 3) of the product sold.

productSoldTypeL4

string

Type (level 4) of the product sold.

productSoldTypeL5

string

Type (level 5) of the product sold.

productStoreId

string

Store ID of the product.

productTitle

string

Title of the product.

productTypeL1

string

Type (level 1) of the product.

productTypeL2

string

Type (level 2) of the product.

productTypeL3

string

Type (level 3) of the product.

productTypeL4

string

Type (level 4) of the product.

productTypeL5

string

Type (level 5) of the product.

quarter

string

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

verticalAdsEventParticipantDisplayNames

string

The display names of participants in an event listing, like performers, speakers, or teams.

verticalAdsHotelClass

string ( int64 format)

The class of the hotel. Generally in the range of 1 to 5 stars, but fully customizable in the hotel feed.

verticalAdsListing

string

The listing associated with a listing impression, click or conversion.

verticalAdsListingBrand

string

The brand associated with a specific listing within a Vertical Ads context, for example, the brand of a car rental, a vacation home, or an event.

verticalAdsListingCity

string

The city where the vertical ads listing is located.

verticalAdsListingCountry

string

The country where the vertical ads listing is located.

verticalAdsListingRegion

string

The region where the vertical ads listing is located.

verticalAdsPartnerAccount

string ( int64 format)

A specific partner account within a Partner Center (for example, Hotel Center) that supplies inventory feed data for Vertical Ads.

verticalAdsVertical

enum ( VerticalAdsItemVerticalType )

Type of vertical ad, such as Vacation Rentals, Car Rentals, or Events, used to categorize and segment data in the context of Vertical Ads.

week

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

integer

Year, formatted as yyyy.

assetInteractionTarget

object ( AssetInteractionTarget )

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interactionOnThisAsset is true, it means the interactions are on this specific asset and when interactionOnThisAsset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with.

AdFormatType

Enumerates Google Ads format types.

Note that this segmentation is available only for Video and Demand Gen campaigns. For assets, only video assets are supported.

Перечисления
UNSPECIFIED No value has been specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
VERTICAL_ADS_PROMOTION An ad format that promotes a specific entity within a vertical, for example, a hotel ad in the Travel vertical on Search.
TEXT A standard text ad format. This is currently only used for ads on the Search network.

AdNetworkType

Enumerates Google Ads network types.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN The value is unknown in this version.
SEARCH Поиск в Google.
SEARCH_PARTNERS Search partners.
CONTENT Display Network.
YOUTUBE_WATCH YouTube Videos
MIXED Cross-network.

Ключевое слово

Сегмент критериев ключевых слов.

JSON representation 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Поля
info

object ( KeywordInfo )

Информация по ключевым словам.

adGroupCriterion

string

Имя ресурса AdGroupCriterion.

ProductChannelExclusivity

Enum describing the availability of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
SINGLE_CHANNEL The item is sold through one channel only, either local stores or online as indicated by its ProductChannel.
MULTI_CHANNEL The item is matched to its online or local stores counterpart, indicating it is available for purchase in both ShoppingProductChannels.

Состояние продукта

Enum describing the condition of a product offer.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
OLD The product condition is old.
NEW The product condition is new.
REFURBISHED The product condition is refurbished.
USED The product condition is used.

VerticalAdsItemVerticalType

Enum describing Vertical Ads Item Vertical Type for SharedSet of type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Used for return value only. Represents value unknown in this version.
HOTELS Hotels travel vertical.
VACATION_RENTALS Vacation rentals travel vertical.
RENTAL_CARS Rental cars travel vertical.
EVENTS Events travel vertical.
THINGS_TO_DO Things to do travel vertical.
FLIGHTS Flights travel vertical.

AssetInteractionTarget

Сегмент AssetInteractionTarget.

JSON representation 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Поля
asset

string

Название ресурса актива.

interactionOnThisAsset

boolean

Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, произошло ли взаимодействие с самим ресурсом или с другим ресурсом или рекламным блоком.