- JSON-представление
- Группа объявлений
- Статус группы объявлений
- Тип группы объявлений
- Группа объявленийРежим ротации объявлений
- Статус AdGroupEngineStatus
- Настройка таргетинга
- Целевое ограничение
- Измерение таргетинга
- Группа объявленийОбъявление
- Группа объявленийСтатус объявления
- Объявление
- Тип объявления
- Поисковая реклама360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360АдаптивныйSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- Статус AdGroupAdEngine
- Группа объявленийAdLabel
- Актив группы объявлений
- Ассетлинкстатус
- AdGroupAssetSet
- Ассетсетлинкстатус
- Группа объявленийАудиторияView
- Модификатор ставки группы объявлений
- Информация об устройстве
- Устройство
- Критерий группы объявлений
- Статус критерия группы объявлений
- Информация о качестве
- Тип Критерия
- ПозицияОценки
- AdGroupCriterionEngineStatus
- Информация о ключевом слове
- Тип соответствия ключевого слова
- Информация о группе
- Тип группы листинга
- Возрастной диапазонИнформация
- Возрастной диапазонТип
- Гендерная информация
- ПолТип
- ПользовательСписокИнфо
- Информация о веб-странице
- Информация о состоянии веб-страницы
- Веб-страницаУсловиеОперанд
- Веб-страницаУсловиеОператор
- Информация о местоположении
- AdGroupCriterionLabel
- Ярлык группы объявлений
- Возрастной диапазонПросмотр
- Объект
- тип актива
- Статус актива
- АссетИнжинеСтатус
- YoutubeВидеоАктив
- ImageAsset
- Миметип
- Размер изображения
- ТекстАссет
- УнифицированныйCalloutAsset
- AdScheduleInfo
- МинутаЧаса
- ДеньНедели
- UnifiedSitelinkAsset
- Унифидпажефидассет
- Мобильное приложениеАссет
- Поставщик мобильных приложений
- Унифицированныйколлассет
- Коллконверсиярепортингстате
- Каллтоактионассет
- Каллтоэкшнтипе
- УнифицированныйLocationAsset
- БизнесПрофильМестоположение
- МестоположениеВладениеТип
- Группа АктивовАктив
- Ассетфилдтипе
- Группа АктивовСигнал
- Информация об аудитории
- AssetGroupListingGroupFilter
- Тип фильтра группы листинга
- ЛистингГруппаФильтрВертикальный
- ListingGroupFilterDimension
- ПродуктКатегория ставок
- ЛистингГруппаФильтрБиддингКатегорияУровень
- ПродуктБренд
- ПродуктКанал
- ЛистингГруппаФильтрПродуктКанал
- Состояние продукта
- ЛистингГруппаФильтрПродуктУсловие
- ПродуктПользовательскийАтрибут
- ListingGroupFilterCustomAttributeIndex
- Продуктителемид
- Тип продукта
- ЛистингГруппаФильтрПродуктТипУровень
- ListingGroupFilterDimensionPath
- Ассетгрупптопкомбинатионвиев
- AssetGroupAssetCombinationData
- Использование активов
- Обслуживаемыйассетфилдтипе
- Группа активов
- Статус группы активов
- Сила объявления
- АктивСетАссет
- Ассетсетассетстатус
- Набор активов
- Стратегия торгов
- Статус стратегии назначения ставок
- Тип стратегии назначения ставок
- Улучшенная цена за клик
- Максимизироватьконверсионвалуе
- Максимизация конверсий
- Целевая цена за конверсию
- Целевая доля показов
- TargetImpressionShareLocation
- TargetOutrankShare
- Целевая рентабельность инвестиций в рекламу
- Целевые расходы
- Бюджет кампании
- Метод доставки бюджета
- Бюджетный период
- Кампания
- Статус кампании
- Статус обслуживания кампании
- Стратегия ставок, статус системы
- Статус оптимизации показа рекламы
- Тип рекламного канала
- Рекламный каналПодтип
- Пользовательский параметр
- Настройка ставок в реальном времени
- Настройки сети
- Настройка динамической поисковой рекламы
- ПокупкиНастройки
- Настройка геотаржеттипесеттинг
- ПозитивГеоТаржетТип
- Негативеотаржеттипе
- Частота ограничения ввода
- ВыборочнаяОптимизация
- ОптимизацияНастройка целей
- Тип цели оптимизации
- Настройка отслеживания
- Ручная цена за конверсию
- Ручная цена за клик
- Ручная цена за тысячу показов
- Процент цены за клик
- Целевая цена за тысячу показов
- КампанияАктив
- Набор активов кампании
- КампанияАудиторияПросмотр
- Критерий кампании
- Статус критерия кампании
- Информация о языке
- МестоположениеГруппаИнформация
- МестоположениеГруппаРадиусЕдиницы измерения
- Ярлык кампании
- КорзинаДанныхПродажиПросмотр
- Аудитория
- Конверсионное действие
- Статус конверсионного действия
- Тип действия конверсии
- Категория действия конверсии
- Настройки значений
- Настройки модели атрибуции
- Модель атрибуции
- Статус DataDrivenModelStatus
- Настройки прожектора
- КонверсияПользовательскаяПеременная
- Статус конверсииCustomVariableStatus
- ConversionCustomVariableFamily
- КонверсияПользовательскаяПеременнаяКардинальность
- FloodlightConversionCustomVariableInfo
- ПрожекторVariableType
- ПрожекторVariableDataType
- Клиент
- Настройка отслеживания конверсий
- Статус отслеживания конверсий
- Тип аккаунта
- Настройка DoubleClickCampaignManagerSetting
- Статус учетной записи
- Статус клиента
- КлиентАссет
- CustomerAssetSet
- Доступная стратегия ставок
- Максимизироватьконверсионвалуе
- Максимизация конверсий
- Целевая цена за конверсию
- Целевая доля показов
- Целевая рентабельность инвестиций в рекламу
- Целевые расходы
- Менеджер по работе с клиентамиСсылка
- Статус менеджера ссылки
- КлиентКлиент
- ДинамическийSearchAdsSearchTermView
- ПолПросмотр
- GeoTargetConstant
- Геотаржетконстантстатус
- Просмотр ключевых слов
- Этикетка
- Меткастатус
- Текстовая метка
- ЯзыкКонстанта
- МестоположениеПросмотр
- ПродуктБиддингКатегорияКонстанта
- ПродуктБиддингКатегорияУровень
- ПродуктБиддингКатегорияСтатус
- Просмотр группы продуктов
- ПокупкиПроизводительностьПросмотр
- Список пользователей
- Усерлисттипе
- Просмотр веб-страницы
- Посещать
- ПродуктКанал
- Конверсия
- Тип атрибуции
- Статус конверсии
- Метрики
- Ценить
- КачествоОценкаВедро
- Тип события взаимодействия
- Сегменты
- тип рекламной сети
- Ключевое слово
- ПродуктКаналЭксклюзивность
- Состояние продукта
- Цель взаимодействия активов
Возвращенная строка из запроса.
JSON-представление |
---|
{ "adGroup": { object ( |
Поля | |
---|---|
adGroup | Группа объявлений, указанная в запросе. |
adGroupAd | Объявление, указанное в запросе. |
adGroupAdLabel | Ярлык объявления группы объявлений, указанный в запросе. |
adGroupAsset | Объект группы объявлений, указанный в запросе. |
adGroupAssetSet | Набор объектов группы объявлений, указанный в запросе. |
adGroupAudienceView | Представление аудитории группы объявлений, указанное в запросе. |
adGroupBidModifier | Модификатор ставки, указанный в запросе. |
adGroupCriterion | Критерий, указанный в запросе. |
adGroupCriterionLabel | Метка критерия группы объявлений, указанная в запросе. |
adGroupLabel | Ярлык группы объявлений, указанный в запросе. |
ageRangeView | Представление возрастного диапазона, указанное в запросе. |
asset | Актив, указанный в запросе. |
assetGroupAsset | Актив группы активов, указанный в запросе. |
assetGroupSignal | Сигнал группы активов, указанный в запросе. |
assetGroupListingGroupFilter | Фильтр группы списков групп активов, на который ссылается запрос. |
assetGroupTopCombinationView | Представление верхней комбинации группы активов, указанное в запросе. |
assetGroup | Группа активов, указанная в запросе. |
assetSetAsset | Актив набора активов, на который ссылается запрос. |
assetSet | Набор активов, на который ссылается запрос. |
biddingStrategy | Стратегия назначения ставок, указанная в запросе. |
campaignBudget | Бюджет кампании, указанный в запросе. |
campaign | Кампания, указанная в запросе. |
campaignAsset | Актив кампании, указанный в запросе. |
campaignAssetSet | Набор объектов кампании, указанный в запросе. |
campaignAudienceView | Представление аудитории кампании, указанное в запросе. |
campaignCriterion | Критерий кампании, указанный в запросе. |
campaignLabel | Ярлык кампании, указанный в запросе. |
cartDataSalesView | Представление продаж данных корзины, указанное в запросе. |
audience | Аудитория, указанная в запросе. |
conversionAction | Действие-конверсия, указанное в запросе. |
conversionCustomVariable | Пользовательская переменная преобразования, указанная в запросе. |
customer | Клиент, указанный в запросе. |
customerAsset | Актив клиента, указанный в запросе. |
customerAssetSet | Набор активов клиента, указанный в запросе. |
accessibleBiddingStrategy | Доступная стратегия назначения ставок, указанная в запросе. |
customerManagerLink | CustomerManagerLink, указанный в запросе. |
customerClient | CustomerClient, указанный в запросе. |
dynamicSearchAdsSearchTermView | Представление поискового запроса в динамических поисковых объявлениях, указанное в запросе. |
genderView | Половое представление, указанное в запросе. |
geoTargetConstant | Константа географической цели, указанная в запросе. |
keywordView | Представление ключевого слова, указанное в запросе. |
label | Метка, указанная в запросе. |
languageConstant | Языковая константа, указанная в запросе. |
locationView | Представление местоположения, указанное в запросе. |
productBiddingCategoryConstant | Категория назначения ставок по продукту, указанная в запросе. |
productGroupView | Представление группы продуктов, указанное в запросе. |
shoppingPerformanceView | Представление эффективности покупок, указанное в запросе. |
userList | Список пользователей, на который ссылается запрос. |
webpageView | Представление веб-страницы, указанное в запросе. |
visit | Посещение на уровне события, указанное в запросе. |
conversion | Преобразование уровня события, указанное в запросе. |
metrics | Метрики. |
segments | Сегменты. |
customColumns[] | Пользовательские столбцы. |
Группа объявлений
Группа объявлений.
JSON-представление |
---|
{ "resourceName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса группы объявлений. Названия ресурсов группы объявлений имеют вид: |
status | Статус группы объявлений. |
type | Тип группы объявлений. |
adRotationMode | Режим ротации объявлений в группе объявлений. |
creationTime | Временная метка создания этой группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
targetingSetting | Настройка таргетинга на связанные функции. |
labels[] | Имена ресурсов ярлыков, прикрепленных к этой группе объявлений. |
engineId | Идентификатор группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «adGroup.id». |
startDate | Дата, когда в этой группе объявлений начнется показ объявлений. По умолчанию группа объявлений начинается сейчас или в дату начала группы объявлений, в зависимости от того, что наступит позже. Если это поле задано, то группа объявлений начинается в начале указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook. Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019. |
endDate | Дата прекращения показа объявлений в группе объявлений. По умолчанию группа объявлений заканчивается в дату окончания группы объявлений. Если это поле задано, группа объявлений заканчивается в конце указанной даты в часовом поясе клиента. Это поле доступно только для учетных записей Microsoft Advertising и шлюза Facebook. Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019. |
languageCode | Язык объявлений и ключевых слов в группе объявлений. Это поле доступно только для учетных записей Microsoft Advertising. Более подробная информация: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage . |
lastModifiedTime | Дата и время последнего изменения этой группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор группы объявлений. |
name | Название группы объявлений. Это поле является обязательным и не должно быть пустым при создании новых групп объявлений. Он должен содержать менее 255 символов полной ширины UTF-8. Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD). |
cpcBidMicros | Максимальная ставка CPC (цена за клик). |
engineStatus | Статус системы для группы объявлений. |
Статус группы объявлений
Возможные статусы группы объявлений.
Перечисления | |
---|---|
UNSPECIFIED | Статус не указан. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Группа объявлений включена. |
PAUSED | Группа объявлений приостановлена. |
REMOVED | Группа объявлений удалена. |
Тип группы объявлений
Перечисление со списком возможных типов группы объявлений.
Перечисления | |
---|---|
UNSPECIFIED | Тип не указан. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
SEARCH_STANDARD | Тип группы объявлений по умолчанию для кампаний в поисковой сети. |
DISPLAY_STANDARD | Тип группы объявлений по умолчанию для кампаний в контекстно-медийной сети. |
SHOPPING_PRODUCT_ADS | Тип группы объявлений для торговых кампаний со стандартной рекламой товаров. |
SHOPPING_SHOWCASE_ADS | Тип групп объявлений, которые ограничиваются показом объявлений-витрин или торговых объявлений в результатах покупок. |
HOTEL_ADS | Тип группы объявлений по умолчанию для кампаний для гостиниц. |
SHOPPING_SMART_ADS | Тип групп объявлений в умных торговых кампаниях. |
VIDEO_BUMPER | Короткие видеообъявления In-Stream, которые нельзя пропустить. |
VIDEO_TRUE_VIEW_IN_STREAM | Видеореклама In-Stream TrueView (с возможностью пропуска). |
VIDEO_TRUE_VIEW_IN_DISPLAY | Видеореклама TrueView In-Display. |
VIDEO_NON_SKIPPABLE_IN_STREAM | Видеообъявления In-Stream, которые нельзя пропустить. |
VIDEO_OUTSTREAM | Аутстрим видеореклама. |
SEARCH_DYNAMIC_ADS | Тип группы объявлений для групп объявлений динамических поисковых объявлений. |
SHOPPING_COMPARISON_LISTING_ADS | Тип групп объявлений в кампаниях со сравнительными торговыми листами. |
PROMOTED_HOTEL_ADS | Тип группы объявлений для групп объявлений продвигаемых отелей. |
VIDEO_RESPONSIVE | Группы адаптивных видеообъявлений. |
VIDEO_EFFICIENT_REACH | Группы видеообъявлений с эффективным охватом. |
SMART_CAMPAIGN_ADS | Тип группы объявлений для умных кампаний. |
TRAVEL_ADS | Тип группы объявлений для туристических кампаний. |
Группа объявленийРежим ротации объявлений
Возможные режимы ротации объявлений в группе объявлений.
Перечисления | |
---|---|
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 ( |
Поля | |
---|---|
targetRestrictions[] | Настройка каждого параметра таргетинга, позволяющая ограничить охват вашей кампании или группы объявлений. |
Целевое ограничение
Список настроек таргетинга по каждому параметру таргетинга.
JSON-представление |
---|
{
"targetingDimension": enum ( |
Поля | |
---|---|
targetingDimension | Параметр таргетинга, к которому применяются эти настройки. |
bidOnly | Указывает, следует ли ограничить показ ваших объявлений только по критериям, которые вы выбрали для этого параметра таргетинга, или настроить таргетинг на все значения для этого параметра таргетинга и показывать объявления на основе вашего таргетинга в других измерениях таргетинга. Значение |
Измерение таргетинга
Перечисление, описывающее возможные параметры таргетинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
KEYWORD | Критерии ключевых слов, например, «круиз по Марсу». KEYWORD можно использовать в качестве параметра специальной ставки. Ключевые слова всегда являются параметром таргетинга, поэтому их нельзя установить в качестве целевого параметра «ВСЕ» с помощью TargetRestriction. |
AUDIENCE | Критерии аудитории, которые включают список пользователей, интересы пользователей, особую близость и индивидуальное присутствие на рынке. |
TOPIC | Критерии темы для таргетинга на категории контента, например «категория::Животные>Домашние животные». Используется для таргетинга на медийную и видеорекламу. |
GENDER | Критерии гендерного таргетинга. |
AGE_RANGE | Критерии таргетинга на возрастные диапазоны. |
PLACEMENT | Критерии размещения включают такие веб-сайты, как www.flowers4sale.com, а также мобильные приложения, категории мобильных приложений, видеоролики YouTube и каналы YouTube. |
PARENTAL_STATUS | Критерии таргетинга по родительскому статусу. |
INCOME_RANGE | Критерии таргетирования диапазона доходов. |
Группа объявленийОбъявление
Объявление группы объявлений.
JSON-представление |
---|
{ "resourceName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса объявления. Названия рекламных ресурсов группы объявлений имеют следующий вид: |
status | Статус объявления. |
ad | Реклама. |
creationTime | Временная метка создания этого объявления adGroupAd. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
labels[] | Названия ресурсов ярлыков, прикрепленных к этому объявлению группы объявлений. |
engineId | Идентификатор объявления во внешнем аккаунте системы. Это поле предназначено только для учетной записи Search Ads 360, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта, не относящегося к Search Ads 360, вместо этого используйте «adGroupAd.ad.id». |
engineStatus | Дополнительный статус объявления во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи) включают активный, соответствующий требованиям, ожидающий проверки и т. д. |
lastModifiedTime | Дата и время последнего изменения этого объявления группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
Группа объявленийСтатус объявления
Возможные статусы AdGroupAd.
Перечисления | |
---|---|
UNSPECIFIED | Значение не указано. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Объявление группы объявлений включено. |
PAUSED | Объявление группы объявлений приостановлено. |
REMOVED | Объявление группы объявлений удалено. |
Объявление
Реклама.
JSON-представление |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса объявления. Имена рекламных ресурсов имеют вид: |
finalUrls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления. |
type | Тип объявления. |
id | Идентификатор объявления. |
displayUrl | URL-адрес, который отображается в описании объявления для некоторых форматов объявлений. |
name | Название объявления. Это используется только для идентификации объявления. Он не обязательно должен быть уникальным и не влияет на отображаемое объявление. Поле имени в настоящее время поддерживается только для DisplayUploadAd, ImageAd, ShoppingComparisonListingAd и VideoAd. |
Поле объединения ad_data . Подробности, относящиеся к типу объявления. Должно быть установлено ровно одно значение. ad_data может быть только одним из следующих: | |
textAd | Подробности, относящиеся к текстовому объявлению. |
expandedTextAd | Подробная информация о развернутом текстовом объявлении. |
responsiveSearchAd | Подробная информация об адаптивном поисковом объявлении. |
productAd | Подробности, относящиеся к рекламе продукта. |
expandedDynamicSearchAd | Подробная информация о расширенном динамическом поисковом объявлении. |
Тип объявления
Возможные типы объявления.
Перечисления | |
---|---|
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 | Видеореклама In-Stream без возможности пропуска. |
VIDEO_OUTSTREAM_AD | Видеообъявление Out-Stream. |
VIDEO_TRUEVIEW_DISCOVERY_AD | Видеореклама TrueView In-Display. |
VIDEO_TRUEVIEW_IN_STREAM_AD | Видеореклама TrueView In-Stream. |
VIDEO_RESPONSIVE_AD | Адаптивная видеореклама. |
SMART_CAMPAIGN_AD | Умная рекламная кампания. |
APP_PRE_REGISTRATION_AD | Универсальное объявление о предварительной регистрации приложения. |
DISCOVERY_MULTI_ASSET_AD | Объявление Discovery с несколькими объектами. |
DISCOVERY_CAROUSEL_AD | Рекламная карусель Discovery. |
TRAVEL_AD | Реклама путешествия. |
DISCOVERY_VIDEO_RESPONSIVE_AD | Адаптивное видеообъявление Discovery. |
MULTIMEDIA_AD | Мультимедийная реклама. |
Поисковая реклама360TextAdInfo
Текстовое объявление Поисковой рекламы 360.
JSON-представление |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
Поля | |
---|---|
headline | Заголовок объявления. |
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
displayUrl | Отображаемый URL объявления. |
displayMobileUrl | Отображаемый мобильный URL объявления. |
adTrackingId | Идентификатор отслеживания объявления. |
SearchAds360ExpandedTextAdInfo
Расширенное текстовое объявление Search Ads 360.
JSON-представление |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
Поля | |
---|---|
headline | Заголовок объявления. |
headline2 | Второй заголовок объявления. |
headline3 | Третий заголовок объявления. |
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
path1 | Текст, добавленный к автоматически созданному видимому URL-адресу с разделителем. |
path2 | Текст, добавленный к пути 1 с разделителем. |
adTrackingId | Идентификатор отслеживания объявления. |
SearchAds360АдаптивныйSearchAdInfo
Адаптивное поисковое объявление Search Ads 360.
JSON-представление |
---|
{ "headlines": [ { object ( |
Поля | |
---|---|
headlines[] | Список текстовых ресурсов для заголовков. При показе объявления заголовки будут выбраны из этого списка. |
descriptions[] | Список текстовых ресурсов для описаний. При показе объявления описания будут выбраны из этого списка. |
path1 | Текст, добавленный к автоматически созданному видимому URL-адресу с разделителем. |
path2 | Текст, добавленный к пути 1 с разделителем. |
adTrackingId | Идентификатор отслеживания объявления. |
AdTextAsset
Текстовый ресурс, используемый внутри объявления.
JSON-представление |
---|
{ "text": string } |
Поля | |
---|---|
text | Текст актива. |
SearchAds360ProductAdInfo
Этот тип не имеет полей.
Товарное объявление Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
Расширенное динамическое поисковое объявление.
JSON-представление |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Поля | |
---|---|
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
adTrackingId | Идентификатор отслеживания объявления. |
Статус AdGroupAdEngine
Перечисляет статусы системы 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 | Устарело. Не используйте. Ранее использовался Близнецами |
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 | Креатив приостановлен, поскольку группа объявлений приостановлена. |
Группа объявленийAdLabel
Связь между объявлением группы объявлений и ярлыком.
JSON-представление |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
Поля | |
---|---|
resourceName | Имя ресурса ярлыка объявления группы объявлений. Имена ресурсов меток объявлений группы объявлений имеют форму: |
adGroupAd | Объявление группы объявлений, к которому прикреплен ярлык. |
label | Ярлык, присвоенный объявлению группы объявлений. |
ownerCustomerId | Идентификатор клиента, которому принадлежит этикетка. |
Актив группы объявлений
Связь между группой объявлений и объектом.
JSON-представление |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса объекта группы объявлений. Имена ресурсов AdGroupAsset имеют вид: |
adGroup | Необходимый. Группа объявлений, с которой связан объект. |
asset | Необходимый. Объект, связанный с группой объявлений. |
status | Статус объекта группы объявлений. |
Ассетлинкстатус
Перечисление, описывающее статусы ссылки на актив.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ENABLED | Ссылка на актив включена. |
REMOVED | Ссылка на ресурс удалена. |
PAUSED | Связь с объектом приостановлена. |
AdGroupAssetSet
AdGroupAssetSet – это связь между группой объявлений и набором объектов. Создание AdGroupAssetSet связывает набор объектов с группой объявлений.
JSON-представление |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса набора объектов группы объявлений. Названия ресурсов набора объектов группы объявлений имеют следующий вид: |
adGroup | Группа объявлений, с которой связан этот набор объектов. |
assetSet | Набор объектов, связанный с группой объявлений. |
status | Статус набора объектов группы объявлений. Только для чтения. |
Ассетсетлинкстатус
Возможные статусы связи между набором активов и его контейнером.
Перечисления | |
---|---|
UNSPECIFIED | Статус не указан. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Связь между набором ресурсов и его контейнером включена. |
REMOVED | Связь между набором ресурсов и его контейнером удалена. |
Группа объявленийАудиторияView
Просмотр аудитории группы объявлений. Включает данные об эффективности по интересам и спискам ремаркетинга для рекламы в контекстно-медийной сети и сети YouTube, а также списки ремаркетинга для поисковых объявлений (RLSA), агрегированные на уровне аудитории.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Имя ресурса представления аудитории группы объявлений. Названия ресурсов просмотра аудитории группы объявлений имеют следующий вид: |
Модификатор ставки группы объявлений
Представляет модификатор ставки на уровне группы объявлений.
JSON-представление |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Поля | |
---|---|
resourceName | Имя ресурса модификатора ставок на уровне группы объявлений. Названия ресурсов модификаторов ставок группы объявлений имеют следующий вид: |
bidModifier | Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Диапазон составляет 1,0–6,0 для PreferredContent. Используйте 0, чтобы отказаться от типа устройства. |
Требуется при операциях создания, начиная с V5. | |
device | Критерий устройства. |
Информация об устройстве
Критерий устройства.
JSON-представление |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип устройства. |
Устройство
Перечисляет устройства Google Рекламы, доступные для таргетинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | В этой версии значение неизвестно. |
MOBILE | Мобильные устройства с полнофункциональными браузерами. |
TABLET | Планшеты с полнофункциональными браузерами. |
DESKTOP | Компьютеры. |
CONNECTED_TV | Смарт-телевизоры и игровые приставки. |
OTHER | Другие типы устройств. |
Критерий группы объявлений
Критерий группы объявлений. Отчет adGroupCriterion возвращает только те критерии, которые были явно добавлены в группу объявлений.
JSON-представление |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса критерия группы объявлений. Названия ресурсов критерия группы объявлений имеют следующий вид: |
creationTime | Временная метка создания критерия группы объявлений. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
status | Статус критерия. Это статус объекта критерия группы объявлений, установленный клиентом. Примечание. Отчеты пользовательского интерфейса могут включать дополнительную информацию, влияющую на возможность применения критерия. В некоторых случаях критерий, УДАЛЕННЫЙ в API, все равно может отображаться в пользовательском интерфейсе как включенный. Например, кампании по умолчанию показываются пользователям всех возрастных диапазонов, если они не исключены. В пользовательском интерфейсе каждая возрастная группа будет отображаться как «включенная», поскольку они имеют право видеть рекламу; но в AdGroupCriterion.status будет указано «удалено», поскольку положительный критерий не был добавлен. |
qualityInfo | Информация о качестве критерия. |
type | Тип критерия. |
labels[] | Имена ресурсов ярлыков, прикрепленных к этому критерию группы объявлений. |
positionEstimates | Оценки критериальных ставок на различных позициях. |
finalUrls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений объявления. |
engineId | Идентификатор критерия группы объявлений во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «adGroupCriterion.criterion_id». |
lastModifiedTime | Дата и время последнего изменения этого критерия группы объявлений. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
criterionId | Идентификатор критерия. |
adGroup | Группа объявлений, к которой относится критерий. |
negative | Нацеливать ( Это поле неизменяемо. Чтобы переключить критерий с положительного на отрицательный, удалите его, а затем добавьте заново. |
bidModifier | Модификатор ставки при совпадении критерия. Модификатор должен находиться в диапазоне: 0,1 – 10,0. Большинство типов таргетируемых критериев поддерживают модификаторы. |
cpcBidMicros | Ставка CPC (цена за клик). |
effectiveCpcBidMicros | Эффективная ставка CPC (цена за клик). |
engineStatus | Статус системы для критерия группы объявлений. |
finalUrlSuffix | Шаблон URL-адреса для добавления параметров к конечному URL-адресу. |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
Должен быть установлен именно один. | |
keyword | Ключевое слово. |
listingGroup | Группа листингов. |
ageRange | Возрастной диапазон. |
gender | Пол. |
userList | Список пользователей. |
webpage | Веб-страница |
location | Расположение. |
Статус критерия группы объявлений
Возможные статусы AdGroupCriterion.
Перечисления | |
---|---|
UNSPECIFIED | Значение не указано. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Критерий группы объявлений включен. |
PAUSED | Критерий группы объявлений приостановлен. |
REMOVED | Критерий группы объявлений удален. |
Информация о качестве
Контейнер для информации о качестве критериев группы объявлений.
JSON-представление |
---|
{ "qualityScore": integer } |
Поля | |
---|---|
qualityScore | Показатель качества. Это поле может быть не заполнено, если у 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 | IPБлок. |
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 | Расчетная ставка CPC, необходимая для показа объявления вверху первой страницы результатов поиска. |
AdGroupCriterionEngineStatus
Перечисляет статусы системы AdGroupCriterion.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
AD_GROUP_CRITERION_ELIGIBLE | Устарело. Не используйте. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN | Baidu: ставка или качество слишком низкие для отображения. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH | Baidu: ставка или качество слишком низкие для мобильных устройств, но могут отображаться на настольных компьютерах. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH | Baidu: ставка или качество слишком низкие для настольных компьютеров, но могут отображаться на мобильных устройствах. |
AD_GROUP_CRITERION_INVALID_SEARCH | 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. Близнецы: Критерий на рассмотрении. |
AD_GROUP_CRITERION_NOT_REVIEWED | Baidu: Критерий подлежит пересмотру. |
AD_GROUP_CRITERION_ON_HOLD | Устарело. Не используйте. Ранее использовался Близнецами |
AD_GROUP_CRITERION_PENDING_REVIEW | Y!J : Критерий ожидает рассмотрения. |
AD_GROUP_CRITERION_PAUSED | Критерий приостановлен. |
AD_GROUP_CRITERION_REMOVED | Критерий удален. |
AD_GROUP_CRITERION_APPROVED | Критерий утвержден. |
AD_GROUP_CRITERION_DISAPPROVED | Критерий отклонен. |
AD_GROUP_CRITERION_SERVING | Критерий активен и обслуживает. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED | Критерий приостановлен, поскольку аккаунт приостановлен. |
Информация о ключевом слове
Критерий ключевого слова.
JSON-представление |
---|
{
"matchType": enum ( |
Поля | |
---|---|
matchType | Тип соответствия ключевого слова. |
text | Текст ключевого слова (максимум 80 символов и 10 слов). |
Тип соответствия ключевого слова
Возможные типы соответствия ключевых слов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EXACT | Точное совпадение. |
PHRASE | Фразовое соответствие. |
BROAD | Широкое соответствие. |
Информация о группе
Критерий группы листинга.
JSON-представление |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип группы объявлений. |
Тип группы листинга
Тип группы объявлений.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
SUBDIVISION | Подразделение продуктов по некоторым параметрам листинга. Эти узлы не используются для целевых записей списка, а предназначены исключительно для определения структуры дерева. |
UNIT | Единица группы листинга, определяющая ставку. |
Возрастной диапазонИнформация
Критерий возрастного диапазона.
JSON-представление |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Тип возрастного диапазона. |
Возрастной диапазонТип
Тип демографического возраста варьируется (например, от 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 ( |
Поля | |
---|---|
type | Тип пола. |
ПолТип
Тип демографического пола (например, женский).
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
MALE | Мужской. |
FEMALE | Женский. |
UNDETERMINED | Неопределенный пол. |
ПользовательСписокИнфо
Критерий списка пользователей. Представляет список пользователей, определенный рекламодателем для таргетинга.
JSON-представление |
---|
{ "userList": string } |
Поля | |
---|---|
userList | Имя ресурса списка пользователей. |
Информация о веб-странице
Представляет критерий таргетинга на веб-страницы веб-сайта рекламодателя.
JSON-представление |
---|
{
"conditions": [
{
object ( |
Поля | |
---|---|
conditions[] | Условия или логические выражения для таргетинга на веб-страницы. Список условий таргетинга веб-страницы объединяется при оценке таргетинга. Пустой список условий означает, что таргетингом являются все страницы веб-сайта кампании. Это поле является обязательным для операций CREATE и запрещено для операций UPDATE. |
coveragePercentage | Процент охвата критериев сайта. Это вычисляемый процент охвата веб-сайта на основе целевого веб-сайта, минус-целевого веб-сайта и минус-слов в группе объявлений и кампании. Например, когда покрытие возвращается как 1, это означает, что оно имеет 100% покрытие. Это поле доступно только для чтения. |
criterionName | Имя критерия, определяемого этим параметром. Значение имени будет использоваться для идентификации, сортировки и фильтрации критериев с параметрами этого типа. Это поле является обязательным для операций CREATE и запрещено для операций UPDATE. |
Информация о состоянии веб-страницы
Логическое выражение для таргетинга на веб-страницы сайта рекламодателя.
JSON-представление |
---|
{ "operand": enum ( |
Поля | |
---|---|
operand | Операнд условия таргетинга веб-страницы. |
operator | Оператор условия таргетинга веб-страницы. |
argument | Аргумент условия таргетинга веб-страницы. |
Веб-страницаУсловиеОперанд
Операнд условия веб-страницы в критерии веб-страницы.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
URL | Операнд, обозначающий условие таргетинга URL-адреса веб-страницы. |
CATEGORY | Операнд, обозначающий условие таргетинга на категорию веб-страницы. |
PAGE_TITLE | Операнд, обозначающий условие таргетинга на заголовок веб-страницы. |
PAGE_CONTENT | Операнд, обозначающий условие таргетинга контента веб-страницы. |
CUSTOM_LABEL | Операнд, обозначающий условие таргетинга настраиваемого ярлыка веб-страницы. |
Веб-страницаУсловиеОператор
Оператор условия веб-страницы в критерии веб-страницы.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
EQUALS | Веб-условие аргумента равно сравниваемому веб-условию. |
CONTAINS | Веб-условие аргумента является частью сравниваемого веб-условия. |
Информация о местоположении
Критерий местоположения.
JSON-представление |
---|
{ "geoTargetConstant": string } |
Поля | |
---|---|
geoTargetConstant | Имя постоянного ресурса географической цели. |
AdGroupCriterionLabel
Связь между критерием группы объявлений и ярлыком.
JSON-представление |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
Поля | |
---|---|
resourceName | Имя ресурса метки критерия группы объявлений. Названия ресурсов меток критерия группы объявлений имеют следующий вид: |
adGroupCriterion | Критерий группы объявлений, к которому прикреплен ярлык. |
label | Ярлык, присвоенный критерию группы объявлений. |
ownerCustomerId | Идентификатор клиента, которому принадлежит этикетка. |
Ярлык группы объявлений
Связь между группой объявлений и ярлыком.
JSON-представление |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
Поля | |
---|---|
resourceName | Имя ресурса ярлыка группы объявлений. Названия ресурсов ярлыков групп объявлений имеют форму: |
adGroup | Группа объявлений, к которой прикреплен ярлык. |
label | Ярлык, присвоенный группе объявлений. |
ownerCustomerId | Идентификатор клиента, которому принадлежит этикетка. |
Возрастной диапазонПросмотр
Представление о возрастном диапазоне.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Имя ресурса представления возрастного диапазона. Имена ресурсов представления возрастного диапазона имеют вид: |
Объект
Актив – это часть объявления, которую можно использовать в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Ресурсы неизменяемы и не могут быть удалены. Чтобы остановить показ объекта, удалите его из организации, которая его использует.
JSON-представление |
---|
{ "resourceName": string, "type": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса актива. Имена ресурсов активов имеют форму: |
type | Тип актива. |
finalUrls[] | Список возможных конечных URL-адресов после всех междоменных перенаправлений. |
status | Статус актива. |
creationTime | Временная метка создания этого актива. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
lastModifiedTime | Дата и время последнего изменения этого актива. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор актива. |
name | Необязательное имя актива. |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
engineStatus | Статус механизма для актива. |
Поле объединения asset_data . Конкретный тип актива. asset_data может быть только одним из следующих: | |
youtubeVideoAsset | Видеоресурс YouTube. |
imageAsset | Имиджевый актив. |
textAsset | Текстовый ресурс. |
calloutAsset | Единый объект выноски. |
sitelinkAsset | Единый ресурс дополнительной ссылки. |
pageFeedAsset | Единый ресурс фида страниц. |
mobileAppAsset | Актив мобильного приложения. |
callAsset | Единый актив вызова. |
callToActionAsset | Призыв к действию. |
locationAsset | Единый объект местоположения. |
тип актива
Перечисление, описывающее возможные типы активов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
YOUTUBE_VIDEO | Видеоресурс YouTube. |
MEDIA_BUNDLE | Ресурс медиагруппы. |
IMAGE | Имиджевый актив. |
TEXT | Текстовый актив. |
LEAD_FORM | Актив формы для потенциальных клиентов. |
BOOK_ON_GOOGLE | Забронируйте в активе Google. |
PROMOTION | Актив продвижения. |
CALLOUT | Выноска. |
STRUCTURED_SNIPPET | Актив структурированного фрагмента. |
SITELINK | Дополнительная ссылка. |
PAGE_FEED | Ресурс фида страниц. |
DYNAMIC_EDUCATION | Актив динамического образования. |
MOBILE_APP | Актив мобильного приложения. |
HOTEL_CALLOUT | Объект уточнения отеля. |
CALL | Вызов актива. |
PRICE | Ценовой актив. |
CALL_TO_ACTION | Призыв к действию. |
DYNAMIC_REAL_ESTATE | Динамический объект недвижимости. |
DYNAMIC_CUSTOM | Динамический пользовательский актив. |
DYNAMIC_HOTELS_AND_RENTALS | Динамичный актив в сфере отелей и аренды. |
DYNAMIC_FLIGHTS | Актив динамических полетов. |
DISCOVERY_CAROUSEL_CARD | Актив карты Discovery Carousel. |
DYNAMIC_TRAVEL | Динамичный туристический актив. |
DYNAMIC_LOCAL | Динамический локальный актив. |
DYNAMIC_JOBS | Актив динамичных рабочих мест. |
LOCATION | Объект местоположения. |
HOTEL_PROPERTY | Актив гостиничной недвижимости. |
Статус актива
Возможные статусы актива.
Перечисления | |
---|---|
UNSPECIFIED | Статус не указан. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
ENABLED | Актив включен. |
REMOVED | Актив удален. |
ARCHIVED | Актив заархивирован. |
PENDING_SYSTEM_GENERATED | Ресурс создается системой и ожидает рассмотрения пользователем. |
АссетИнжинеСтатус
Следующий идентификатор = 11
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
SERVING | Актив активен. |
SERVING_LIMITED | Актив ограничен. |
DISAPPROVED | Объект отклонен (не соответствует критериям). |
DISABLED | Актив неактивен (ожидает рассмотрения). |
REMOVED | Актив удален. |
YoutubeВидеоАктив
Ресурс YouTube.
JSON-представление |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Поля | |
---|---|
youtubeVideoTitle | Название видео на YouTube. |
youtubeVideoId | Идентификатор видео YouTube. Это строковое значение из 11 символов, используемое в URL-адресе видео YouTube. |
ImageAsset
Ресурс изображения.
JSON-представление |
---|
{ "mimeType": enum ( |
Поля | |
---|---|
mimeType | MIME-тип изображения. |
fullSize | Метаданные для этого изображения в исходном размере. |
fileSize | Размер файла изображения в байтах. |
Миметип
Тип мима
Перечисления | |
---|---|
UNSPECIFIED | Тип mime не указан. |
UNKNOWN | Полученное значение в этой версии неизвестно. Это значение только для ответа. |
IMAGE_JPEG | Тип изображения MIME/JPEG. |
IMAGE_GIF | Тип изображения MIME/GIF. |
IMAGE_PNG | Тип изображения MIME/PNG. |
FLASH | Тип приложения MIME/X-Shockwave-Flash. |
TEXT_HTML | Тип Text/HTML. |
PDF | Тип приложения MIME/PDF. |
MSWORD | Тип приложения MIME/MSWORD. |
MSEXCEL | Тип приложения MIME/VND.MS-EXCEL. |
RTF | Тип приложения MIME/RTF. |
AUDIO_WAV | Тип звука MIME/WAV. |
AUDIO_MP3 | Тип звука Mime/mp3. |
HTML5_AD_ZIP | Тип приложения MIME/X-HTML5-AD-Zip. |
ИМЕНАРИНГИИНГ
Метаданные для изображения при определенном размере, либо оригинал, либо изменение размера.
Представление JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Поля | |
---|---|
heightPixels | Высота изображения. |
widthPixels | Ширина изображения. |
url | URL, который возвращает изображение с этой высотой и шириной. |
ТекстАссет
Текстовый актив.
Представление JSON |
---|
{ "text": string } |
Поля | |
---|---|
text | Текстовое содержание текстового актива. |
UnifiedCalloutasset
Объединенное вынововое актив.
Представление JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Поля | |
---|---|
calloutText | Текст вызовов. Длина этой строки должна быть от 1 до 25, включительно. |
startDate | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
endDate | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
adScheduleTargets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
useSearcherTimeZone | Показать активу в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
Adscheduleinfo
Представляет собой критерий adschedule.
Adschedule указывается как день недели и интервал времени, в течение которого будут показаны реклама.
Не более шести Adschedules можно добавить в тот же день.
Представление JSON |
---|
{ "startMinute": enum ( |
Поля | |
---|---|
startMinute | Через несколько минут после начала, в котором начинается это расписание. Это поле требуется для создания операций и запрещено в операциях обновления. |
endMinute | Через несколько минут после окончания, в котором это расписание заканчивается. График исключает конечную минуту. Это поле требуется для создания операций и запрещено в операциях обновления. |
dayOfWeek | День недели, к которому применяется расписание. Это поле требуется для создания операций и запрещено в операциях обновления. |
startHour | Начальный час в 24 часа. Это поле должно быть от 0 до 23, включительно. Это поле требуется для создания операций и запрещено в операциях обновления. |
endHour | Конец часа за 24 часа; 24 означает конец дня. Это поле должно быть от 0 до 24, включительно. Это поле требуется для создания операций и запрещено в операциях обновления. |
Минута
Перечисления четверть часа. Например, "Пятнадцать"
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Значение неизвестно в этой версии. |
ZERO | Ноль минут после часа. |
FIFTEEN | Пятнадцать минут после часа. |
THIRTY | Тридцать минут после часа. |
FORTY_FIVE | Сорок пять минут после часа. |
Dayofweek
Перечисляет дни недели, например, «понедельник».
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Значение неизвестно в этой версии. |
MONDAY | Понедельник. |
TUESDAY | Вторник. |
WEDNESDAY | Среда. |
THURSDAY | Четверг. |
FRIDAY | Пятница. |
SATURDAY | Суббота. |
SUNDAY | Воскресенье. |
UnifiedSitelinkasset
Объединенный актив SiteLink.
Представление JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Поля | |
---|---|
linkText | URL -отображение текст для SiteLink. Длина этой строки должна быть от 1 до 25, включительно. |
description1 | Первая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, инклюзивных, а также должно быть установлено описание2. |
description2 | Вторая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, включительно, а также должно быть установлено описание1. |
startDate | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
endDate | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
adScheduleTargets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
trackingId | Идентификатор используется для отслеживания кликов для актива SiteLink. Это Yahoo! Япония только поле. |
useSearcherTimeZone | Показать активы SiteLink в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
mobilePreferred | Является ли предпочтение для отображения актива SiteLink на мобильных устройствах. Применяется к рекламе Microsoft. |
UnifiedPageFeedAsset
Объединенная страница.
Представление JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Поля | |
---|---|
pageUrl | Веб -страница, на которую хотят нацелены рекламодатели. |
labels[] | Метки, используемые для группировки URL -адресов страницы. |
MobileAppasset
Актив, представляющий мобильное приложение.
Представление JSON |
---|
{
"appId": string,
"appStore": enum ( |
Поля | |
---|---|
appId | Необходимый. Строка, которая уникально идентифицирует мобильное приложение. Он должен содержать только нативный идентификатор платформы, такой как «com.android.ebay» для Android или «12345689» для iOS. |
appStore | Необходимый. Хранилище приложения, которое распределяет это конкретное приложение. |
MobileAppvendor
Тип поставщика мобильных приложений
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
APPLE_APP_STORE | Поставщик мобильных приложений для Apple App Store. |
GOOGLE_APP_STORE | Поставщик мобильных приложений для Google App Store. |
UnifiedCallasset
Объединенное вызов.
JSON-представление |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Поля | |
---|---|
countryCode | Двухбуктный код страны номера телефона. Примеры: «США», «США». |
phoneNumber | Номер телефона рекламодателя. Примеры: '1234567890', '(123) 456-7890' |
callConversionReportingState | Указывает, должен ли этот Callasset использовать свой собственный настройка преобразования вызовов, следить за настройкой уровня учетной записи или отключить преобразование вызовов. |
callConversionAction | Действие преобразования, чтобы приписать конверсию вызова. Если не установлено, используется действие преобразования по умолчанию. Это поле имеет эффект только в том случае, если CallConversionReportingState установлен на use_resource_level_call_conversion_action. |
adScheduleTargets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
callOnly | Показывает ли звонок только номер телефона без ссылки на веб -сайт. Применяется к рекламе Microsoft. |
callTrackingEnabled | Должен ли вызов быть включен при отслеживании вызовов. Применяется к рекламе Microsoft. |
useSearcherTimeZone | Показать расширение вызова в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
startDate | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
endDate | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
CallConversionReportingState
Возможные типы данных для состояния действия преобразования вызовов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
DISABLED | Действие по преобразованию вызова отключено. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION | Действие по преобразованию вызова будет использовать тип преобразования вызовов, установленный на уровне учетной записи. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION | Действие по преобразованию вызова будет использовать тип преобразования вызовов, установленный на уровне ресурса (только вызов объявлений/расширения вызовов). |
CalltoActionAsset
Призыв к активу действия.
Представление JSON |
---|
{
"callToAction": enum ( |
Поля | |
---|---|
callToAction | Призыв к действию. |
CalltoActionType
Enum описывает возможные типы призыв к действию.
Перечисления | |
---|---|
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 ( |
Поля | |
---|---|
placeId | Поместите идентификаторы уникально идентифицировать место в базе данных Google Place и на картах Google. Это поле уникально для данного идентификатора клиента и типа активов. См . |
businessProfileLocations[] | Список бизнес -локаций для клиента. Это будет возвращено только в случае синхронизации местоположения с учетной записью профиля бизнеса. Можно иметь несколько списков бизнес -профилей в одной и той же учетной записи, которая указывает на один идентификатор места. |
locationOwnershipType | Тип владения местоположением. Если тип Business_owner, он будет обслуживаться расширением местоположения. Если тип является партнером, он будет обслуживаться в качестве партнерского места. |
BusinessProfileLocation
Данные местоположения бизнес -профиля, синхронизированные с учетной записи связанного бизнес -профиля.
Представление JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Поля | |
---|---|
labels[] | Рекламодатель указал этикетку для местоположения в учетной записи бизнес -профиля. Это синхронизируется с учетной записи бизнес -профиля. |
storeCode | Код магазина бизнеса в этом месте. Это синхронизируется с учетной записи бизнес -профиля. |
listingId | Листинг идентификатор этого местоположения бизнес -профиля. Это синхронизируется из связанной учетной записи бизнес -профиля. |
LocationOWNERSPHETYPE
Возможные виды владения местоположением.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
BUSINESS_OWNER | Владелец бизнеса Location (Legacy Location расширение - LE). |
AFFILIATE | Партнерское местоположение (расширение местоположения сторонних сторон - эль). |
AssetGroupasset
AssetGroupAsset - это связь между активом и группой активов. Добавление AssetGroupasset ссылается на актив с группой активов.
Представление JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Поля | |
---|---|
resourceName | Название ресурса актива Asset Group. Название ресурса активов Asset Group имеет форму: |
assetGroup | Группа активов, которую связывает этот активы группы активов. |
asset | Актив, который связывает этот активы группы активов. |
fieldType | Описание размещения актива в группе активов. Например: заголовок, youtube_video и т. Д. |
status | Статус связи между активом и группой активов. |
AssetFieldType
Enum описывает возможные размещения актива.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
HEADLINE | Актив связан для использования в качестве заголовка. |
DESCRIPTION | Актив связан для использования в качестве описания. |
MANDATORY_AD_TEXT | Актив связан для использования в качестве обязательного текста AD. |
MARKETING_IMAGE | Актив связан для использования в качестве маркетингового изображения. |
MEDIA_BUNDLE | Актив связан для использования в качестве мультимедийного пакета. |
YOUTUBE_VIDEO | Актив связан для использования в качестве видео на YouTube. |
BOOK_ON_GOOGLE | Актив связан с тем, чтобы указать, что кампания отелей включена «Book on Google». |
LEAD_FORM | Актив связан для использования в качестве расширения ведущей формы. |
PROMOTION | Актив связан для использования в качестве расширения продвижения. |
CALLOUT | Актив связан для использования в качестве расширения выноски. |
STRUCTURED_SNIPPET | Актив связан для использования в качестве структурированного расширения фрагмента. |
SITELINK | Актив связан для использования в качестве SiteLink. |
MOBILE_APP | Актив связан для использования в качестве расширения мобильного приложения. |
HOTEL_CALLOUT | Актив связан для использования в качестве расширения выноски отеля. |
CALL | Актив связан для использования в качестве расширения вызова. |
PRICE | Актив связан для использования в качестве расширения цены. |
LONG_HEADLINE | Актив связан для использования в качестве длинного заголовка. |
BUSINESS_NAME | Актив связан для использования в качестве названия бизнеса. |
SQUARE_MARKETING_IMAGE | Актив связан для использования в качестве квадратного маркетингового изображения. |
PORTRAIT_MARKETING_IMAGE | Актив связан для использования в качестве портретного маркетингового изображения. |
LOGO | Актив связан для использования в качестве логотипа. |
LANDSCAPE_LOGO | Актив связан для использования в качестве логотипа ландшафта. |
VIDEO | Актив связан для использования в качестве логотипа Non YouTube. |
CALL_TO_ACTION_SELECTION | Актив связан для использования для выбора вызового действия. |
AD_IMAGE | Актив связан для использования для выбора изображения рекламы. |
BUSINESS_LOGO | Актив связан для использования в качестве бизнес -логотипа. |
HOTEL_PROPERTY | Актив связан для использования в качестве отеля в кампании Max Max для Travel The Goals. |
DISCOVERY_CAROUSEL_CARD | Актив связан для использования в качестве карты Carousel Discovery. |
AssetGroupSignal
AssetGroupSignal представляет сигнал в группе активов. Существование сигнала сообщает кампании Max Max, которая, скорее всего, конвертирует. Performance Max использует сигнал, чтобы найти новых людей с аналогичным или более сильным намерением найти конверсии через поиск, отображение, видео и многое другое.
Представление JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Поля | |
---|---|
resourceName | Название ресурса сигнала группы активов. Имя ресурса сигнала Asset Group имеет форму: |
assetGroup | Группа активов, к которой принадлежит этот сигнал группы активов. |
signal поля Союза. Сигнал группы активов. signal может быть только одним из следующих: | |
audience | Аудитория сигнализирует, чтобы использовать кампанию Max Performance. |
Аудитория
Критерий аудитории.
Представление JSON |
---|
{ "audience": string } |
Поля | |
---|---|
audience | Название ресурса аудитории. |
AssetGrouplistingGroupFilter
AssetGrouplistingGroupFilter представляет собой узел дерева фильтров группы в листинге в группе активов.
JSON-представление |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Поля | |
---|---|
resourceName | Название ресурса группы листинга групп активов. Имя ресурса группы групп групп |
assetGroup | Группа активов, частью которой является эта группа по группу активов. |
id | Идентификатор ListingGroupFilter. |
type | Тип узла фильтра группы листинга. |
vertical | Вертикаль представляет собой текущее дерево узла. Все узлы в одном и том же дереве должны принадлежать к одной и той же вертикальной. |
caseValue | Значение измерения, с помощью которого эта группа листинга уточняет своего родителя. Неопределен для корневой группы. |
parentListingGroupFilter | Название ресурса подразделения группы родительской группы. NULL для корневого листинга Группового фильтра Узел. |
path | Путь измерений, определяющих этот фильтр группы листинга. |
ListingGroupFilterType
Тип фильтра группы листинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
SUBDIVISION | Подразделение продуктов по некоторым размерам листинга. |
UNIT_INCLUDED | Включенный листовый листовой узел группы группы. |
UNIT_EXCLUDED | Исключенный листовый листовой узел группы листинга. |
ListingGroupFilterVertical
Тип вертикального фильтра листинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
SHOPPING | Представляет вертикаль покупок. Вертикаль разрешена только в производительности Max для розничных кампаний. |
ListingGroupFilterDimension
Листинг измерений для группового фильтра группы Acset Group.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
Объединенное dimension . Размер одного из приведенных ниже типов всегда присутствует. dimension может быть только одним из следующих: | |
productBiddingCategory | Категория ставок предложения о продукте. |
productBrand | Бренд предложения продукта. |
productChannel | Местность предложения продукта. |
productCondition | Состояние предложения продукта. |
productCustomAttribute | Пользовательский атрибут предложения продукта. |
productItemId | Идентификатор предложения предложения продукта. |
productType | Тип предложения продукта. |
ProductBiddingCategory
Один элемент категории торгов на определенном уровне. Категории высшего уровня находятся на уровне 1, их дети на уровне 2 и так далее. В настоящее время мы поддерживаем до 5 уровней. Пользователь должен указать тип измерения, который указывает уровень категории. Все случаи одного и того же подразделения должны иметь одинаковый тип измерения (уровень категории).
Представление JSON |
---|
{
"level": enum ( |
Поля | |
---|---|
level | Указывает уровень категории в таксономии. |
id | Удостоверение личности категории ставок продукта. Этот идентификатор эквивалентен идентификатору Google_product_category, как описано в этой статье: https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
Уровень категории ставок групп листинга.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
LEVEL1 | Уровень 1. |
LEVEL2 | Уровень 2. |
LEVEL3 | Уровень 3. |
LEVEL4 | Уровень 4. |
LEVEL5 | Уровень 5. |
Продукт
Бренд продукта.
Представление JSON |
---|
{ "value": string } |
Поля | |
---|---|
value | Строковое значение бренда продукта. |
ProductChannel
Местность предложения продукта.
Представление JSON |
---|
{
"channel": enum ( |
Поля | |
---|---|
channel | Ценность местности. |
ListingGroupFilterProductChannel
Enum описывает местонахождение предложения продукта.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
ONLINE | Товар продается онлайн. |
LOCAL | Товар продается в местных магазинах. |
ProductCondition
Состояние предложения продукта.
Представление JSON |
---|
{
"condition": enum ( |
Поля | |
---|---|
condition | Значение условия. |
ListingGroupFilterProductCondition
Enum описывает состояние предложения продукта.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
NEW | Состояние продукта новое. |
REFURBISHED | Состояние продукта отремонтировано. |
USED | Состояние продукта используется. |
ProductCustomattribute
Пользовательский атрибут предложения продукта.
Представление JSON |
---|
{
"index": enum ( |
Поля | |
---|---|
index | Указывает индекс пользовательского атрибута. |
value | Строковое значение продукта пользовательское атрибут. |
LiledingGroupFilterCustomattributeIndex
Индекс атрибутов клиента.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
INDEX0 | Первый листинг группы фильтра пользовательский атрибут. |
INDEX1 | Второй листинг группы фильтра пользовательский атрибут. |
INDEX2 | Третий листинг группы фильтра пользовательский атрибут. |
INDEX3 | Четвертый листинг группы фильтра пользовательский атрибут. |
INDEX4 | Пятый листинг группы фильтра «Пользовательский атрибут». |
ProductiTemid
Идентификатор предложения предложения продукта.
Представление JSON |
---|
{ "value": string } |
Поля | |
---|---|
value | Значение идентификатора. |
Тип продукта
Тип предложения продукта.
Представление JSON |
---|
{
"level": enum ( |
Поля | |
---|---|
level | Уровень типа. |
value | Значение типа. |
ListingGroupFilterProductTypelevel
Enum описывает уровень типа предложения продукта.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
LEVEL1 | Уровень 1. |
LEVEL2 | Уровень 2. |
LEVEL3 | Уровень 3. |
LEVEL4 | Уровень 4. |
LEVEL5 | Уровень 5. |
ListingGroupFilterDimensionPath
Путь, определяющий измерения, определяющие фильтр группы листинга.
JSON-представление |
---|
{
"dimensions": [
{
object ( |
Поля | |
---|---|
dimensions[] | Полный путь измерений через иерархию фильтра группы листинга (исключая корневой узел) к этому фильтру группы листинга. |
AssetGrouptOpCombinationView
Взгляд на использование комбинации активов AD Group AD.
Представление JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Поля | |
---|---|
resourceName | Название ресурса в высшей комбинации группы активов. AssetGroup Top Comminate View Имена ресурсов имеют форму: `" Customs/{customer}/assetgrouptopcombinationviews/{asset_group_id} ~ {asset_combination_category} " |
assetGroupTopCombinations[] | Лучшие комбинации активов, которые служили вместе. |
AssetGroupasSetCombinationData
Данные комбинации активов группы активов
Представление JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Поля | |
---|---|
assetCombinationServedAssets[] | Обслуживали активы. |
Активиз
Содержит информацию об использовании актива.
Представление JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Поля | |
---|---|
asset | Название ресурса актива. |
servedAssetFieldType | Поличный тип актива. |
Sedassetfieldtype
Возможные типы поля активов.
Перечисления | |
---|---|
UNSPECIFIED | Значения не указано. |
UNKNOWN | Полученная стоимость не известна в этой версии. Это значение только для ответа. |
HEADLINE_1 | Актив используется в заголовке 1. |
HEADLINE_2 | Актив используется в заголовке 2. |
HEADLINE_3 | Актив используется в заголовке 3. |
DESCRIPTION_1 | Актив используется в описании 1. |
DESCRIPTION_2 | Актив используется в описании 2. |
HEADLINE | Актив использовался в заголовке. Используйте это только в том случае, если в объявлении есть только один заголовок. В противном случае используйте Headline_1, Headline_2 или Headline_3 Enumss |
HEADLINE_IN_PORTRAIT | Актив использовался в качестве заголовка в портретном изображении. |
LONG_HEADLINE | Активы использовали в длинном заголовке (используется в многосентрическом отношении). |
DESCRIPTION | Активы использовались в описании. Используйте это, только если в объявлении есть только одно описание. В противном случае используйте description_1 или description_@ enums |
DESCRIPTION_IN_PORTRAIT | Актив использовался как описание на портретном изображении. |
BUSINESS_NAME_IN_PORTRAIT | Актив использовался в качестве названия бизнеса на изображении портрета. |
BUSINESS_NAME | Актив использовался в качестве названия бизнеса. |
MARKETING_IMAGE | Актив использовался в качестве маркетингового имиджа. |
MARKETING_IMAGE_IN_PORTRAIT | Актив использовался в качестве маркетингового изображения на портретном изображении. |
SQUARE_MARKETING_IMAGE | Актив использовался в качестве квадратного маркетингового имиджа. |
PORTRAIT_MARKETING_IMAGE | Актив использовался в качестве портретного маркетингового имиджа. |
LOGO | Актив использовался в качестве логотипа. |
LANDSCAPE_LOGO | Актив использовался в качестве логотипа ландшафта. |
CALL_TO_ACTION | Актив использовался в качестве призывного к действию. |
YOU_TUBE_VIDEO | Актив использовался в качестве видео на YouTube. |
SITELINK | Этот актив используется в качестве SiteLink. |
CALL | Этот актив используется в качестве вызова. |
MOBILE_APP | Этот актив используется в качестве мобильного приложения. |
CALLOUT | Этот актив используется в качестве выносливости. |
STRUCTURED_SNIPPET | Этот актив используется в качестве структурированного фрагмента. |
PRICE | Этот актив используется в качестве цены. |
PROMOTION | Этот актив используется как продвижение. |
AD_IMAGE | Этот актив используется в качестве изображения. |
LEAD_FORM | Актив используется в качестве свинцовой формы. |
BUSINESS_LOGO | Актив используется в качестве бизнес -логотипа. |
AssetGroup
Группа активов. AssetGroupAsset используется для связи актива с группой активов. AssetGroupSignal используется для связи сигнала для группы активов.
Представление JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Поля | |
---|---|
resourceName | Название ресурса группы активов. Имена ресурсов группы Asset Group имеют форму: |
id | Идентификатор группы активов. |
campaign | Кампания, с которой ассоциируется эта группа активов. Актив, который связан с группой активов. |
name | Необходимый. Название группы активов. Необходимый. Он должен иметь минимальную длину 1 и максимальную длину 128. Он должен быть уникальным в рамках кампании. |
finalUrls[] | Список окончательных URL -адресов после всех перекрестных доменов перенаправления. В Max Max, по умолчанию, URL -адреса имеют право на расширение, если не отказано. |
finalMobileUrls[] | Список окончательных мобильных URL -адресов после всех перекрестных доменов перенаправления. В Max Max, по умолчанию, URL -адреса имеют право на расширение, если не отказано. |
status | Статус группы активов. |
path1 | Первая часть текста, которая может появиться, добавленная к URL -адресу, отображаемому в объявлении. |
path2 | Вторая часть текста, которая может появиться, добавленная к URL -адресу, отображаемому в объявлении. Это поле может быть установлено только при установке PATH1. |
adStrength | Общая сила рекламы этой группы активов. |
AssetGroupStatus
Возможные статусы группы активов.
Перечисления | |
---|---|
UNSPECIFIED | Статус не был указан. |
UNKNOWN | Полученная стоимость не известна в этой версии. |
ENABLED | Группа активов включена. |
PAUSED | Группа активов приостановлен. |
REMOVED | Группа активов удалена. |
Adstrength
Enum перечисляет возможные сильные стороны рекламы.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
PENDING | Сила рекламы в настоящее время находится на рассмотрении. |
NO_ADS | Объявления не могут быть сгенерированы. |
POOR | Плохая сила. |
AVERAGE | Средняя сила. |
GOOD | Хорошая сила. |
EXCELLENT | Отличная сила. |
Assetsetasset
AssetSetasset - это связь между активом и набором активов. Добавление AssetSetasset ссылается на активу с набором активов.
Представление JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса актива набора активов. Набор активов имена ресурсов активов есть форма: |
assetSet | Набор активов, на который ссылается этот актива, на который ссылается актива. |
asset | Активы, на который ссылается этот актив. |
status | Статус актива набора активов. Только для чтения. |
AssetSetassetStatus
Возможные статусы актива набора активов.
Перечисления | |
---|---|
UNSPECIFIED | Статус не был указан. |
UNKNOWN | Полученная стоимость не известна в этой версии. Это значение только для ответа. |
ENABLED | Активист для набора активов включен. |
REMOVED | Актив набора активов удален. |
Активист
Набор активов, представляющий набор активов. Используйте AssetSetasset, чтобы связать активу с набором активов.
Представление JSON |
---|
{ "id": string, "resourceName": string } |
Поля | |
---|---|
id | Идентификатор набора активов. |
resourceName | Имя ресурса набора активов. Имена ресурсов для набора активов есть форма: |
Биддингстратеги
Стратегия торгов.
Представление JSON |
---|
{ "resourceName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Название ресурса стратегии торгов. Названия ресурсов стратегии предложения имеют форму: |
status | Статус стратегии торгов. Это поле доступно только для чтения. |
type | Тип стратегии торгов. Создайте стратегию торга, установив схему ставок. Это поле доступно только для чтения. |
currencyCode | Валюта, используемая стратегией торгов (ISO 4217 Трехбуктный код). Для стратегий торгов в клиентах менеджера эта валюта может быть установлена на создание и по умолчанию валюту клиента менеджера. Для обслуживания клиентов это поле не может быть установлено; Все стратегии в обслуживающем клиенте неявно используют валюту обслуживающего клиента. Во всех случаях поле EffectiveCurrencyCode возвращает валюту, используемую стратегией. |
id | Идентификатор стратегии торгов. |
name | Название стратегии торгов. Все стратегии торгов в рамках учетной записи должны быть названы отчетливо. Длина этой строки должна составлять от 1 до 255, включительно, в байтах UTF-8 (обрезается). |
effectiveCurrencyCode | Валюта, используемая стратегией торгов (ISO 4217 Трехбуктный код). Для стратегий ставок в клиентах менеджера это валюта, установленная рекламодателем при создании стратегии. Для обслуживания клиентов это валютный код клиента. Метрики стратегии торгов представлены в этой валюте. Это поле доступно только для чтения. |
campaignCount | Количество кампаний, связанных с этой стратегией торгов. Это поле доступно только для чтения. |
nonRemovedCampaignCount | Количество не удаленных кампаний, прикрепленных к этой стратегии торгов. Это поле доступно только для чтения. |
Полевая Только один может быть установлен. | |
enhancedCpc | Стратегия торгов, которая поднимает ставки на клики, которые, кажется, с большей вероятностью приведут к преобразованию и снижает их для кликов, где они кажутся менее вероятными. |
maximizeConversionValue | Автоматизированная стратегия торгов, чтобы помочь получить наибольшую ценность конверсии для ваших кампаний при проведении вашего бюджета. |
maximizeConversions | Автоматизированная стратегия торгов, чтобы помочь получить наибольшее количество конверсий для ваших кампаний при проведении вашего бюджета. |
targetCpa | Стратегия торгов, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий в целевой стоимости за затрат на получение (CPA), которую вы устанавливаете. |
targetImpressionShare | Стратегия торга, которая автоматически оптимизирует в направлении выбранного процента впечатлений. |
targetOutrankShare | Стратегия торгов, которая устанавливает ставки на основе целевой доли аукционов, где рекламодатель должен опередить конкретного конкурента. Это поле устарело. Создание новой стратегии торгов с этой областью или прикрепление стратегий торгов с этой областью к кампании потерпит неудачу. Мутаты к стратегиям, которые уже заселиваются этой схемой. |
targetRoas | Стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS). |
targetSpend | Стратегия ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета. |
Биддингстратегистатус
Возможные статусы Биддингстратегии.
Перечисления | |
---|---|
UNSPECIFIED | Значения не указано. |
UNKNOWN | Полученная стоимость не известна в этой версии. Это значение только для ответа. |
ENABLED | Стратегия ставок включена. |
REMOVED | Стратегия торгов удалена. |
Биддингстратеигит
Enum описывает возможные типы стратегии торгов.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
COMMISSION | Комиссия - это автоматическая стратегия торгов, в которой рекламодатель платит определенную часть конверсионной стоимости. |
ENHANCED_CPC | Enhanced CPC - это стратегия торгов, которая поднимает заявки на клики, которые, кажется, с большей вероятностью приведут к конверсии и снижают их для кликов, где они кажутся менее вероятными. |
INVALID | Используется только для возвращаемого значения. Указывает, что кампания не имеет стратегии торгов. Это предотвращает подачу кампании. Например, кампания может быть прикреплена к стратегии ставок менеджера, а впоследствии с учетная запись с учетной записью менеджера не связана с учетной записью. В этом случае кампания будет автоматически отделена от ныне недоступной стратегии ставок менеджера и перехода к неверному типу стратегии торгов. |
MANUAL_CPA | Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем. |
MANUAL_CPC | Руководство на основе кликов, где пользователь платит за клик. |
MANUAL_CPM | Ручные торговцы на основе впечатлений, где пользователь платит за тысячу впечатлений. |
MANUAL_CPV | Стратегия торга, которая платит настраиваемую сумму за видео. |
MAXIMIZE_CONVERSIONS | Стратегия ставок, которая автоматически максимизирует количество конверсий с учетом ежедневного бюджета. |
MAXIMIZE_CONVERSION_VALUE | Автоматизированная стратегия торгов, которая автоматически устанавливает ставки для максимизации дохода при трати на ваш бюджет. |
PAGE_ONE_PROMOTED | Page-One Promed Scheamding, которая устанавливает Max CPC-ставки на целевые впечатления на первой странице или на странице. Это значение перечисления устарело. |
PERCENT_CPC | Процент CPC - это стратегия ставок, в которой предложения являются частью рекламной цены на что -то хорошее или услуги. |
TARGET_CPA | Target CPA-это стратегия автоматизированной ставки, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий на целевой стоимости за затраты на получение (CPA), которую вы устанавливаете. |
TARGET_CPM | Target CPM - это стратегия автоматизированной ставки, которая устанавливает ставки, чтобы помочь получить как можно больше впечатлений по целевой стоимости за одну тысячу показов (CPM), которые вы устанавливаете. |
TARGET_IMPRESSION_SHARE | Автоматизированная стратегия торгов, которая устанавливает ставки так, чтобы определенный процент поисковой рекламы показан в верхней части первой страницы (или другого целевого местоположения). |
TARGET_OUTRANK_SHARE | Target Outrank Share - это автоматизированная стратегия торгов, которая устанавливает ставки на основе целевой доли аукционов, где рекламодатель должен опередить конкретного конкурента. Это значение перечисления устарело. |
TARGET_ROAS | Target Roas - это автоматическая стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной доходности цели в среднем (ROAS). |
TARGET_SPEND | Целевые расходы - это стратегия автоматической ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета. |
EnhancedCpc
Этот тип не имеет полей.
Автоматизированная стратегия торгов, которая поднимает предложения для кликов, которые, похоже, с большей вероятностью приведут к преобразованию и снижает их для кликов, где они кажутся менее вероятными.
Эта стратегия торгов устарела и больше не может быть создана. Используйте ManualCPC с EnhancedCpcenabled SET для True для эквивалентной функциональности.
MaximizeConversionValue
Автоматизированная стратегия торгов, чтобы помочь получить наибольшую ценность конверсии для ваших кампаний при проведении вашего бюджета.
Представление JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Поля | |
---|---|
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменен только для стратегий ставок на портфель. |
cpcBidFloorMicros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменен только для стратегий ставок на портфель. |
targetRoas | Опция целевой рентабельности инвестиций в рекламу (ROAS). Если этот параметр установлен, стратегия назначения ставок будет максимизировать доход при усреднении целевой рентабельности инвестиций в рекламу. Если целевая рентабельность инвестиций в рекламу высока, стратегия назначения ставок может оказаться не в состоянии израсходовать весь бюджет. Если целевая рентабельность инвестиций в рекламу не задана, стратегия назначения ставок будет направлена на достижение максимально возможной рентабельности инвестиций в рекламу в рамках бюджета. |
Максимальные реверсии
Автоматизированная стратегия торгов, чтобы помочь получить наибольшее количество конверсий для ваших кампаний при проведении вашего бюджета.
JSON-представление |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Поля | |
---|---|
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменен только для стратегий ставок на портфель. |
cpcBidFloorMicros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменен только для стратегий ставок на портфель. |
targetCpaMicros | Опция целевой стоимости за действие (CPA). Это средняя сумма, которую вы хотели бы потратить на действие конверсии, указанное в микро -единицах валюты стратегии торгов. В случае установки стратегия ставки получит как можно больше конверсий при или ниже целевой стоимости за действие. Если целевой CPA не установлен, стратегия ставки будет направлена на достижение максимально возможного CPA, учитывая бюджет. |
TargetCpa
Автоматизированная стратегия ставки, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий в целевой стоимости за затраты на получение (CPA), которую вы устанавливаете.
Представление JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Поля | |
---|---|
targetCpaMicros | Целевая средняя цена за конверсию. Эта цель должна быть больше или равна минимальной единице оплаты в зависимости от валюты аккаунта. |
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Этот параметр следует устанавливать только для портфельных стратегий назначения ставок. |
cpcBidFloorMicros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Этот параметр следует устанавливать только для портфельных стратегий назначения ставок. |
TargetRoas
Автоматизированная стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS).
Представление JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Поля | |
---|---|
targetRoas | Необходимый. Выбранный доход (на основе данных о конверсиях) на единицу расходов. Значение должно быть от 0,01 до 1000,0, включительно. |
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Этот параметр следует устанавливать только для портфельных стратегий назначения ставок. |
cpcBidFloorMicros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Этот параметр следует устанавливать только для портфельных стратегий назначения ставок. |
TargetSpend
Автоматизированная стратегия ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета.
Представление JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Поля | |
---|---|
targetSpendMicros | Установилось: цель траттов, по которой можно максимизировать щелчки. Участник торгов TargetSpend попытается потратить меньшую из этих величин или суммы расходов при естественном регулировании. Если не указано, бюджет используется в качестве целевого показателя расходов. Это поле устарело и больше не должно использоваться. Подробности см. на странице https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html . |
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. |
Кампания Budget
Бюджет кампании.
Представление JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Поля | |
---|---|
resourceName | Название ресурса бюджета кампании. Имена ресурсов бюджета кампании имеют форму: |
deliveryMethod | Метод доставки, который определяет ставку, на которую тратится бюджет кампании. По умолчанию стандартные, если не указано в операции создания. |
period | Период, на который можно тратить бюджет. По умолчанию ежедневно, если не указано. |
amountMicros | Сумма бюджета в местной валюте для счета. Сумма указана в микросхеме, где один миллион эквивалентен одной валютной единице. Ежемесячные расходы ограничены в 30,4 раза больше этой суммы. |
Бюджетный
Возможные методы доставки бюджета.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
STANDARD | Бюджетный сервер будет равномерно, служащий равномерно в течение всего периода времени. |
ACCELERATED | Бюджетный сервер не будет затопленной податкой, и реклама будет служить как можно быстрее. |
Бюджетный
Возможный период бюджета.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение неизвестно в этой версии. |
DAILY | Ежедневный бюджет. |
FIXED_DAILY | Фиксированный ежедневный бюджет. |
CUSTOM_PERIOD | Пользовательский бюджет может использоваться с Total_Amount, чтобы указать лимит бюджета в течение жизни. |
Кампания
Кампания.
JSON-представление |
---|
{ "resourceName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Имя ресурса кампании. Имена ресурсов кампании имеют форму: |
status | Статус кампании. При добавлении новой кампании статус по умолчанию становится ВКЛЮЧЕНО. |
servingStatus | Статус показа объявлений в кампании. |
biddingStrategySystemStatus | Системный статус стратегии назначения ставок кампании. |
adServingOptimizationStatus | Статус оптимизации показа объявлений в кампании. |
advertisingChannelType | Основная цель показа объявлений в рамках кампании. Параметры таргетинга могут быть уточнены в Это поле является обязательным и не должно быть пустым при создании новых кампаний. Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
advertisingChannelSubType | Необязательное уточнение для Можно задать только при создании кампаний. После создания кампании поле нельзя изменить. |
urlCustomParameters[] | Список сопоставлений, используемых для замены пользовательских тегов параметров в |
realTimeBiddingSetting | Настройки для торгов в реальном времени, функция, доступная только для кампаний, предназначенных для сети AD Exchange. |
networkSettings | Настройки сети для кампании. |
dynamicSearchAdsSetting | Настройка для управления динамическим поисковым объявлением (DSA). |
shoppingSetting | Настройка контроля за покупками. |
geoTargetTypeSetting | Настройка для геотаргетирования рекламы. |
labels[] | Названия ресурсов ярлыков, прикрепленных к этой кампании. |
biddingStrategyType | Тип стратегии назначения ставок. Стратегия ставок может быть создана путем установки либо схемы ставок для создания стандартной стратегии ставков торгов, либо в поле Это поле доступно только для чтения. |
accessibleBiddingStrategy | Название ресурса доступного доступного обращения, только для чтения представление о неограниченных атрибутах прикрепленной стратегии ставок на портфель, определенной «Биддингстратеги». Пусто, если в кампании не используется портфельная стратегия. Неограниченные атрибуты стратегии доступны всем клиентам, которым предоставлен общий доступ к стратегии, и считываются из ресурса AccessibleBiddingStrategy. Напротив, ограниченные атрибуты доступны только владельцу стратегии и его менеджерам. Атрибуты с ограниченным доступом можно прочитать только из ресурса BiddingStrategy. |
frequencyCaps[] | Список, ограничивающий частоту просмотра рекламы этой кампании каждым пользователем. |
selectiveOptimization | Селективная настройка оптимизации для этой кампании, которая включает в себя набор действий по конверсии для оптимизации этой кампании. Эта функция применяется только к кампаниям приложений, которые используют multi_channel в качестве рекламы changanneltype и app_campaign или app_campaign_for_engagement в качестве рекламы. |
optimizationGoalSetting | Установка целей оптимизации для этой кампании, которая включает в себя набор типов целей оптимизации. |
trackingSetting | Настройки на уровне кампании для отслеживания информации. |
engineId | Идентификатор кампании во внешнем аккаунте системы. Это поле предназначено только для аккаунтов, не принадлежащих Google Реклама, например Yahoo Japan, Microsoft, Baidu и т. д. Для объекта Google Реклама вместо этого используйте «campaign.id». |
excludedParentAssetFieldTypes[] | Типы полей активов, которые следует исключить из этой кампании. Ссылки на активы с этими типами полей не будут унаследованы этой кампанией с верхнего уровня. |
createTime | Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». CreateTime будет устарел в V1. Вместо этого используйте время создания. |
creationTime | Временная метка создания этой кампании. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
lastModifiedTime | Дата и время последнего изменения этой кампании. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
id | Идентификатор кампании. |
name | Название кампании. Это поле является обязательным и не должно быть пустым при создании новых кампаний. Он не должен содержать нулевых символов (кодовая точка 0x0), перевода строки NL (кодовая точка 0xA) или возврата каретки (кодовая точка 0xD). |
trackingUrlTemplate | Шаблон URL-адреса для создания URL-адреса отслеживания. |
campaignBudget | Имя ресурса бюджета кампании. |
startDate | Дата начала кампании в часовом поясе обслуживающего клиента в формате ГГГГ-ММ-ДД. |
endDate | Последний день кампании по обслуживанию часового пояса клиента в формате ГГГГ-ММ-ДД. При создании по умолчанию используется 30 декабря 2037 г., что означает, что кампания будет длиться неопределенное время. Чтобы настроить существующую кампанию на неопределенный срок, установите в этом поле значение 30 декабря 2037 г. |
finalUrlSuffix | Суффикс, используемый для добавления параметров запроса к целевым страницам, которые обслуживаются с помощью параллельного отслеживания. |
urlExpansionOptOut | Представляет собой отказ от расширения URL-адресов до более целевых URL-адресов. Если этот параметр отключен (true), таргетингом будут выбраны только конечные URL-адреса в группе объектов или URL-адреса, указанные в Google Merchant Center или фидах бизнес-данных рекламодателя. Если выбрано значение (false), целью будет весь домен. Это поле можно задать только для кампаний с максимальной эффективностью, где значение по умолчанию — false. |
Союз полевой Должен быть либо портфель (созданный через сервис Biddingstrategy), либо стандарт, который встроен в кампанию. | |
biddingStrategy | Название ресурса пакетной стратегии назначения ставок, используемой в кампании. |
manualCpa | Стандартная стратегия назначения ставок CPA вручную. Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем. Поддерживается только для кампаний "Местные услуги". |
manualCpc | Стандартная стратегия ставок на CPC. Руководство на основе кликов, где пользователь оплачивает за клик. |
manualCpm | Стандартная стратегия назначения ставок вручную с ценой за тысячу показов. Назначение ставок вручную на основе показов, при котором пользователь платит за тысячу показов. |
maximizeConversions | Стандарт максимизирует стратегию преобразований, которые автоматически максимизируют количество конверсий, тратя ваш бюджет. |
maximizeConversionValue | Стандартная стратегия преобразования преобразования, которая автоматически устанавливает предложения для максимизации дохода при трати в свой бюджет. |
targetCpa | Стандартная целевая стратегия ставок CPA, которая автоматически устанавливает ставки, чтобы помочь получить как можно больше конверсий на целевой стоимости за затраты на получение (CPA), которую вы устанавливаете. |
targetImpressionShare | Целевое впечатление от стратегии торгов. Автоматизированная стратегия торгов, которая устанавливает ставки для достижения выбранного процента впечатлений. |
targetRoas | Стандартная целевая стратегия ставок ROAS, которая автоматически максимизирует доход, в среднем определенную целевую доходность по расходам на рекламу (ROAS). |
targetSpend | Стандартная стратегия потрат на целевые расходы, которая автоматически устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета. |
percentCpc | Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service. |
targetCpm | Стратегия назначения ставок, которая автоматически оптимизирует цену за тысячу показов. |
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 | Поисковая сеть. 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. |
CustomParameter
A mapping that can be used by custom parameter tags in a trackingUrlTemplate
, finalUrls
, or mobile_final_urls
.
JSON-представление |
---|
{ "key": string, "value": string } |
Поля | |
---|---|
key | The key matching the parameter tag name. |
value | The value to be substituted. |
RealTimeBiddingSetting
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
JSON representation |
---|
{ "optIn": boolean } |
Поля | |
---|---|
optIn | Включено ли в кампании назначение ставок в реальном времени. |
Настройки сети
The network settings for the campaign.
JSON representation |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Поля | |
---|---|
targetGoogleSearch | Будет ли реклама показываться в результатах поиска google.com. |
targetSearchNetwork | Whether ads will be served on partner sites in the Google Search Network (requires |
targetContentNetwork | Будет ли реклама показываться на определенных местах размещения в контекстно-медийной сети Google. Места размещения определяются с использованием критерия Placement. |
targetPartnerSearchNetwork | Будут ли показываться объявления в партнерской сети Google. Это доступно только для некоторых учетных записей партнеров Google. |
DynamicSearchAdsSetting
The setting for controlling Dynamic Search Ads (DSA).
JSON representation |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Поля | |
---|---|
domainName | Необходимый. Имя интернет-домена, которое представляет этот параметр, например «google.com» или «www.google.com». |
languageCode | Необходимый. Код языка, определяющий язык домена, например «en». |
useSuppliedUrlsOnly | Используются ли в кампании исключительно URL-адреса, предоставленные рекламодателем. |
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 | Ярлыки фида продуктов, которые нужно включить в кампанию. Only one of feedLabel or salesCountry can be set. If used instead of salesCountry, the feedLabel field accepts country codes in the same format for example: 'XX'. В противном случае это может быть любая строка, используемая для метки фида в Google Merchant Center. |
useVehicleInventory | Следует ли использовать таргетинг на инвентарь в списке транспортных средств. |
merchantId | Идентификатор аккаунта Merchant Center. Это поле является обязательным для операций создания. Это поле является неизменным для торговых кампаний. |
salesCountry | Страна продаж продуктов, которые будут включены в кампанию. |
campaignPriority | Приоритет кампании. Кампании с более высоким приоритетом имеют приоритет над кампаниями с более низким приоритетом. Это поле обязательно для торговых кампаний со значениями от 0 до 2 включительно. Это поле является необязательным для умных торговых кампаний, но если оно установлено, оно должно быть равно 3. |
enableLocal | Включать ли местные продукты. |
GeoTargetTypeSetting
Represents a collection of settings related to ads geotargeting.
JSON-представление |
---|
{ "positiveGeoTargetType": enum ( |
Поля | |
---|---|
positiveGeoTargetType | Настройка, используемая для позитивного геотаргетинга в этой конкретной кампании. |
negativeGeoTargetType | Настройка, используемая для негативного геотаргетинга в этой конкретной кампании. |
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
This type has no fields.
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
SelectiveOptimization
Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.
JSON representation |
---|
{ "conversionActions": [ string ] } |
Поля | |
---|---|
conversionActions[] | Выбранный набор названий ресурсов для действий-конверсий для оптимизации данной кампании. |
OptimizationGoalSetting
Optimization goal setting for this campaign, which includes a set of optimization goal types.
JSON representation |
---|
{
"optimizationGoalTypes": [
enum ( |
Поля | |
---|---|
optimizationGoalTypes[] | Список типов целей оптимизации. |
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
Campaign-level settings for tracking information.
JSON representation |
---|
{ "trackingUrl": string } |
Поля | |
---|---|
trackingUrl | URL-адрес, используемый для динамического отслеживания. |
ManualCpa
This type has no fields.
Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем.
ManualCpc
Manual click-based bidding where user pays per click.
JSON representation |
---|
{ "enhancedCpcEnabled": boolean } |
Поля | |
---|---|
enhancedCpcEnabled | Следует ли повышать ставки на основе данных оптимизатора конверсий. |
ManualCpm
This type has no fields.
Назначение ставок вручную на основе показов, при котором пользователь платит за тысячу показов.
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 | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Это необязательное поле, введенное рекламодателем и указанное в локальных микропрограммах. Примечание. Нулевое значение интерпретируется так же, как если значение bid_ceiling не определено. |
enhancedCpcEnabled | Корректирует ставку для каждого аукциона в сторону увеличения или уменьшения в зависимости от вероятности конверсии. Individual bids may exceed cpcBidCeilingMicros, but the average bid amount for a campaign should not. |
TargetCpm
This type has no fields.
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 ( |
Поля | |
---|---|
resourceName | The resource name of the campaign asset. CampaignAsset resource names have the form: |
status | Status of the campaign asset. |
campaign | The campaign to which the asset is linked. |
asset | 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 ( |
Поля | |
---|---|
resourceName | The resource name of the campaign asset set. Asset set asset resource names have the form: |
campaign | The campaign to which this asset set is linked. |
assetSet | The asset set which is linked to the campaign. |
status | The status of the campaign asset set asset. Только для чтения. |
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 | The resource name of the campaign audience view. Campaign audience view resource names have the form: |
CampaignCriterion
A campaign criterion.
JSON representation |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Поля | |
---|---|
resourceName | The resource name of the campaign criterion. Campaign criterion resource names have the form: |
displayName | The display name of the criterion. This field is ignored for mutates. |
type | The type of the criterion. |
status | The status of the criterion. |
lastModifiedTime | The datetime when this campaign criterion was last modified. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
criterionId | The ID of the criterion. This field is ignored during mutate. |
bidModifier | 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 | Whether to target ( |
Union field Exactly one must be set. | |
keyword | Ключевое слово. |
location | Расположение. |
device | Устройство. |
ageRange | Age range. |
gender | Пол. |
userList | User List. |
language | Язык. |
webpage | Веб-страница. |
locationGroup | 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
A language criterion.
JSON representation |
---|
{ "languageConstant": string } |
Поля | |
---|---|
languageConstant | The language constant resource name. |
LocationGroupInfo
A radius around a list of locations specified through a feed.
JSON representation |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Поля | |
---|---|
geoTargetConstants[] | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
radiusUnits | Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations. |
feedItemSets[] | 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 | Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations. |
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 | Майлз |
MILLI_MILES | Milli Miles |
CampaignLabel
Represents a relationship between a campaign and a label.
JSON representation |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
Поля | |
---|---|
resourceName | Name of the resource. Campaign label resource names have the form: |
campaign | The campaign to which the label is attached. |
label | The label assigned to the campaign. |
ownerCustomerId | The ID of the Customer which owns the label. |
CartDataSalesView
Cart data sales view.
JSON representation |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the Cart data sales view. Cart data sales view resource names have the form: |
Аудитория
Audience is an effective targeting option that lets you intersect different segment attributes, such as detailed demographics and affinities, to create audiences that represent sections of your target segments.
JSON representation |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Поля | |
---|---|
resourceName | The resource name of the audience. Audience names have the form: |
id | ID of the audience. |
name | Необходимый. Name of the audience. It should be unique across all audiences. It must have a minimum length of 1 and maximum length of 255. |
description | Description of this audience. |
ConversionAction
A conversion action.
JSON representation |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Поля | |
---|---|
resourceName | The resource name of the conversion action. Conversion action resource names have the form: |
creationTime | Timestamp of the Floodlight activity's creation, formatted in ISO 8601. |
status | The status of this conversion action for conversion event accrual. |
type | The type of this conversion action. |
category | The category of conversions reported for this conversion action. |
valueSettings | Settings related to the value for conversion events associated with this conversion action. |
attributionModelSettings | Settings related to this conversion action's attribution model. |
floodlightSettings | Floodlight settings for Floodlight conversion types. |
id | The ID of the conversion action. |
name | The name of the conversion action. This field is required and should not be empty when creating new conversion actions. |
primaryForGoal | 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 | The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. |
includeInClientAccountConversionsMetric | Whether this conversion action should be included in the "clientAccountConversions" metric. |
includeInConversionsMetric | Whether this conversion action should be included in the "conversions" metric. |
clickThroughLookbackWindowDays | The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event. |
appId | 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 | Conversions that come from Salesforce. Read only. |
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-представление |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Поля | |
---|---|
defaultValue | 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 | 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 | 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 | The attribution model type of this conversion action. |
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 used to identify a Floodlight activity group when reporting conversions. |
activityTag | String used to identify a Floodlight activity when reporting conversions. |
activityId | 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 ( |
Поля | |
---|---|
resourceName | The resource name of the conversion custom variable. Conversion custom variable resource names have the form: |
id | The ID of the conversion custom variable. |
name | Необходимый. 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 | Необходимый. 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 | The status of the conversion custom variable for conversion event accrual. |
ownerCustomer | The resource name of the customer that owns the conversion custom variable. |
family | Family of the conversion custom variable. |
cardinality | Cardinality of the conversion custom variable. |
floodlightConversionCustomVariableInfo | Fields for Search Ads 360 floodlight conversion custom variables. |
customColumnIds[] | 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 | Floodlight variable type defined in Search Ads 360. |
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. |
Клиент
Клиент.
JSON representation |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Поля | |
---|---|
resourceName | The resource name of the customer. Customer resource names have the form: |
conversionTrackingSetting | Conversion tracking setting for a customer. |
accountType | Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc. |
doubleClickCampaignManagerSetting | DoubleClick Campaign Manager (DCM) setting for a manager customer. |
accountStatus | Account status, for example, Enabled, Paused, Removed, etc. |
lastModifiedTime | The datetime when this customer was last modified. Дата и время указываются в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ: мм: сс.сссссс». |
engineId | ID of the account in the external engine account. |
status | The status of the customer. |
creationTime | The timestamp when this customer was created. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
id | The ID of the customer. |
descriptiveName | Optional, non-unique descriptive name of the customer. |
currencyCode | The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
timeZone | The local timezone ID of the customer. |
trackingUrlTemplate | The URL template for constructing a tracking URL out of parameters. |
finalUrlSuffix | The URL template for appending params to the final URL. |
autoTaggingEnabled | Whether auto-tagging is enabled for the customer. |
manager | 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 ( |
Поля | |
---|---|
acceptedCustomerDataTerms | Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. Это поле доступно только для чтения. For more information, see https://support.google.com/adspolicy/answer/7475709 . |
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 |
enhancedConversionsForLeadsEnabled | Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. Это поле доступно только для чтения. |
googleAdsConversionCustomer | The resource name of the customer where conversions are created and managed. Это поле доступно только для чтения. |
conversionTrackingId | The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversionTrackingStatus does). Это поле доступно только для чтения. |
googleAdsCrossAccountConversionTrackingId | 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. Это поле доступно только для чтения. |
crossAccountConversionTrackingId | 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 | ID of the Campaign Manager advertiser associated with this customer. |
networkId | ID of the Campaign Manager network associated with this customer. |
timeZone | 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. |
CustomerAsset
A link between a customer and an asset.
JSON-представление |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Поля | |
---|---|
resourceName | The resource name of the customer asset. CustomerAsset resource names have the form: |
asset | Необходимый. The asset which is linked to the customer. |
status | 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 ( |
Поля | |
---|---|
resourceName | The resource name of the customer asset set. Asset set asset resource names have the form: |
assetSet | The asset set which is linked to the customer. |
customer | The customer to which this asset set is linked. |
status | The status of the customer asset set asset. Только для чтения. |
AccessibleBiddingStrategy
Represents a view of BiddingStrategies owned by and shared with the customer.
In contrast to BiddingStrategy, this resource includes strategies owned by managers of the customer and shared with this customer - in addition to strategies owned by this customer. This resource does not provide metrics and only exposes a limited subset of the BiddingStrategy attributes.
JSON representation |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Поля | |
---|---|
resourceName | The resource name of the accessible bidding strategy. AccessibleBiddingStrategy resource names have the form: |
id | The ID of the bidding strategy. |
name | The name of the bidding strategy. |
type | The type of the bidding strategy. |
ownerCustomerId | The ID of the Customer which owns the bidding strategy. |
ownerDescriptiveName | descriptiveName of the Customer which owns the bidding strategy. |
Union field Only one can be set. | |
maximizeConversionValue | An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget. |
maximizeConversions | An automated bidding strategy to help get the most conversions for your campaigns while spending your budget. |
targetCpa | A bidding strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set. |
targetImpressionShare | A bidding strategy that automatically optimizes towards a chosen percentage of impressions. |
targetRoas | A bidding strategy that helps you maximize revenue while averaging a specific target Return On Ad Spend (ROAS). |
targetSpend | A bid strategy that sets your bids to help get as many clicks as possible within your budget. |
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
JSON representation |
---|
{ "targetRoas": number } |
Поля | |
---|---|
targetRoas | Опция целевой рентабельности инвестиций в рекламу (ROAS). Если этот параметр установлен, стратегия назначения ставок будет максимизировать доход при усреднении целевой рентабельности инвестиций в рекламу. Если целевая рентабельность инвестиций в рекламу высока, стратегия назначения ставок может оказаться не в состоянии израсходовать весь бюджет. Если целевая рентабельность инвестиций в рекламу не задана, стратегия назначения ставок будет направлена на достижение максимально возможной рентабельности инвестиций в рекламу в рамках бюджета. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
JSON representation |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Поля | |
---|---|
targetCpa | Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение. |
targetCpaMicros | Опция целевой цены за приобретение (CPA). Это средняя сумма, которую вы готовы потратить на одно приобретение. |
TargetCpa
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
JSON representation |
---|
{ "targetCpaMicros": string } |
Поля | |
---|---|
targetCpaMicros | Целевая средняя цена за конверсию. Эта цель должна быть больше или равна минимальной единице оплаты в зависимости от валюты аккаунта. |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
JSON representation |
---|
{ "targetRoas": number } |
Поля | |
---|---|
targetRoas | Выбранный доход (на основе данных о конверсиях) на единицу расходов. |
TargetSpend
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
JSON representation |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Поля | |
---|---|
targetSpendMicros | Целевой показатель расходов, при достижении которого можно получить максимальное количество кликов. Участник торгов TargetSpend попытается потратить меньшую из этих величин или суммы расходов при естественном регулировании. Если не указано, бюджет используется в качестве целевого показателя расходов. Это поле устарело и больше не должно использоваться. Подробности см. на странице https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html . |
cpcBidCeilingMicros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. |
CustomerManagerLink
Represents customer-manager link relationship.
JSON representation |
---|
{
"resourceName": string,
"status": enum ( |
Поля | |
---|---|
resourceName | Name of the resource. CustomerManagerLink resource names have the form: |
status | Status of the link between the customer and the manager. |
managerCustomer | The manager customer linked to the customer. |
managerLinkId | ID of the customer-manager link. This field is read only. |
startTime | The timestamp when the CustomerManagerLink was created. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
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 ( |
Поля | |
---|---|
resourceName | The resource name of the customer client. CustomerClient resource names have the form: |
appliedLabels[] | The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form: |
status | The status of the client customer. Read only. |
clientCustomer | The resource name of the client-customer which is linked to the given customer. Read only. |
level | Distance between given customer and client. For self link, the level value will be 0. Read only. |
timeZone | Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only. |
testAccount | Identifies if the client is a test account. Read only. |
manager | Identifies if the client is a manager. Read only. |
descriptiveName | Descriptive name for the client. Read only. |
currencyCode | Currency code (for example, 'USD', 'EUR') for the client. Read only. |
id | The ID of the client customer. Read only. |
DynamicSearchAdsSearchTermView
A dynamic search ads search term view.
JSON representation |
---|
{ "resourceName": string, "landingPage": string } |
Поля | |
---|---|
resourceName | The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form: |
landingPage | The dynamically selected landing page URL of the impression. Это поле доступно только для чтения. |
GenderView
A gender view. The genderView resource reflects the effective serving state, rather than what criteria were added. An ad group without gender criteria by default shows to all genders, so all genders appear in genderView with stats.
JSON representation |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the gender view. Gender view resource names have the form: |
GeoTargetConstant
A geo target constant.
JSON representation |
---|
{
"resourceName": string,
"status": enum ( |
Поля | |
---|---|
resourceName | The resource name of the geo target constant. Geo target constant resource names have the form: |
status | Geo target constant status. |
id | The ID of the geo target constant. |
name | Geo target constant English name. |
countryCode | The ISO-3166-1 alpha-2 country code that is associated with the target. |
targetType | Geo target constant target type. |
canonicalName | The fully qualified English name, consisting of the target's name and that of its parent and country. |
parentGeoTarget | The resource name of the parent geo target constant. Geo target constant resource names have the form: |
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-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the keyword view. Keyword view resource names have the form: |
Этикетка
Этикетка.
JSON-представление |
---|
{ "resourceName": string, "status": enum ( |
Поля | |
---|---|
resourceName | Name of the resource. Label resource names have the form: |
status | Status of the label. Read only. |
textLabel | A type of label displaying text on a colored background. |
id | ID of the label. Read only. |
name | 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. |
Текстовая метка
A type of label displaying text on a colored background.
JSON representation |
---|
{ "backgroundColor": string, "description": string } |
Поля | |
---|---|
backgroundColor | 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 | A short description of the label. The length must be no more than 200 characters. |
LanguageConstant
Язык.
JSON representation |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Поля | |
---|---|
resourceName | The resource name of the language constant. Language constant resource names have the form: |
id | The ID of the language constant. |
code | The language code, for example, "en_US", "en_AU", "es", "fr", etc. |
name | The full name of the language in English, for example, "English (US)", "Spanish", etc. |
targetable | Whether the language is targetable. |
LocationView
A location view summarizes the performance of campaigns by a Location criterion.
JSON representation |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the location view. Location view resource names have the form: |
ProductBiddingCategoryConstant
A Product Bidding Category.
JSON-представление |
---|
{ "resourceName": string, "level": enum ( |
Поля | |
---|---|
resourceName | The resource name of the product bidding category. Product bidding category resource names have the form: |
level | Level of the product bidding category. |
status | Status of the product bidding category. |
id | 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 | Two-letter upper-case country code of the product bidding category. |
productBiddingCategoryConstantParent | Resource name of the parent product bidding category. |
languageCode | Language code of the product bidding category. |
localizedName | 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 | Уровень 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 | The resource name of the product group view. Product group view resource names have the form: |
ShoppingPerformanceView
Shopping performance view. Provides Shopping 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.
JSON representation |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the Shopping performance view. Shopping performance view resource names have the form: |
UserList
A user list. This is a list of users a customer may target.
JSON representation |
---|
{
"resourceName": string,
"type": enum ( |
Поля | |
---|---|
resourceName | The resource name of the user list. User list resource names have the form: |
type | Type of this list. Это поле доступно только для чтения. |
id | Id of the user list. |
name | Name of this user list. Depending on its access_reason, the user list name may not be unique (for example, if access_reason=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. |
WebpageView
A webpage view.
JSON representation |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | The resource name of the webpage view. Webpage view resource names have the form: |
Посещать
Визит.
JSON representation |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Поля | |
---|---|
resourceName | The resource name of the visit. Visit resource names have the form: |
id | The ID of the visit. |
criterionId | Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed. |
merchantId | 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 | Ad ID. A value of 0 indicates that the ad is unattributed. |
clickId | A unique string for each visit that is passed to the landing page as the click id URL parameter. |
visitDateTime | The timestamp of the visit event. Временная метка указывается в часовом поясе клиента и в формате «гггг-ММ-дд ЧЧ:мм:сс». |
productId | The ID of the product clicked on. |
productChannel | The sales channel of the product that was clicked on: Online or Local. |
productLanguageCode | The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product. |
productStoreId | The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed. |
productCountryCode | The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on. |
assetId | ID of the asset which was interacted with during the visit event. |
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 ( |
Поля | |
---|---|
resourceName | The resource name of the conversion. Conversion resource names have the form: |
id | The ID of the conversion |
criterionId | Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed. |
merchantId | 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 | Ad ID. A value of 0 indicates that the ad is unattributed. |
clickId | 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 | The Search Ads 360 visit ID that the conversion is attributed to. |
advertiserConversionId | 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 | The ID of the product clicked on. |
productChannel | The sales channel of the product that was clicked on: Online or Local. |
productLanguageCode | The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product. |
productStoreId | The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed. |
productCountryCode | The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on. |
attributionType | What the conversion is attributed to: Visit or Keyword+Ad. |
conversionDateTime | The timestamp of the conversion event. |
conversionLastModifiedDateTime | The timestamp of the last time the conversion was modified. |
conversionVisitDateTime | The timestamp of the visit that the conversion is attributed to. |
conversionQuantity | 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 | The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account. |
floodlightOriginalRevenue | The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications. |
floodlightOrderId | The Floodlight order ID provided by the advertiser for the conversion. |
status | The status of the conversion, either ENABLED or REMOVED.. |
assetId | ID of the asset which was interacted with during the conversion event. |
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. |
Метрики
Metrics data.
JSON-представление |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Поля | |
---|---|
allConversionsValueByConversionDate | Ценность всех конверсий. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти по адресу https://support.google.com/sa360/answer/9250611 . |
allConversionsByConversionDate | Общее количество конверсий. This includes all conversions regardless of the value of includeInConversionsMetric. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти по адресу https://support.google.com/sa360/answer/9250611 . |
conversionCustomMetrics[] | The conversion custom metrics. |
conversionsValueByConversionDate | Сумма ценности конверсий, доступных для назначения ставок, по дате конверсии. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. |
conversionsByConversionDate | Сумма конверсий по дате конверсии для типов конверсий с возможностью назначения ставок. Может быть дробным из-за моделирования атрибуции. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. |
historicalCreativeQualityScore | The creative historical quality score. |
historicalLandingPageQualityScore | Качество исторического опыта целевой страницы. |
historicalSearchPredictedCtr | Исторический поиск предсказывал рейтинг кликов (CTR). |
interactionEventTypes[] | The types of payable and free interactions. |
rawEventConversionMetrics[] | The raw event conversion metrics. |
absoluteTopImpressionPercentage | Процент показов на самых высоких позициях в поиске – это процент показов ваших объявлений в поисковой сети, которые показываются на наиболее заметных позициях в поиске. |
allConversionsFromInteractionsRate | Все конверсии по взаимодействиям (в отличие от конверсий по просмотрам), разделенные на количество взаимодействий с рекламой. |
allConversionsValue | Ценность всех конверсий. |
allConversions | Общее количество конверсий. This includes all conversions regardless of the value of includeInConversionsMetric. |
allConversionsValuePerCost | Ценность всех конверсий, разделенная на общую стоимость взаимодействий с рекламой (например, кликов по текстовым объявлениям или просмотров видеообъявлений). |
allConversionsFromClickToCall | Сколько раз люди нажимали кнопку «Позвонить», чтобы позвонить в магазин во время или после нажатия на рекламу. В это число не входит, были ли соединены вызовы или нет, а также продолжительность каких-либо вызовов. Этот показатель применяется только к элементам фида. |
allConversionsFromDirections | Сколько раз люди нажимали кнопку «Проложить маршрут», чтобы добраться до магазина после нажатия на рекламу. Этот показатель применяется только к элементам фида. |
allConversionsFromInteractionsValuePerInteraction | Ценность всех конверсий от взаимодействий, деленная на общее количество взаимодействий. |
allConversionsFromMenu | Сколько раз люди нажимали на ссылку, чтобы просмотреть меню магазина после нажатия на рекламу. Этот показатель применяется только к элементам фида. |
allConversionsFromOrder | Сколько раз люди размещали заказ в магазине после нажатия на рекламу. Этот показатель применяется только к элементам фида. |
allConversionsFromOtherEngagement | Количество других конверсий (например, публикация отзыва или сохранение местоположения магазина), произошедших после того, как люди нажали на объявление. Этот показатель применяется только к элементам фида. |
allConversionsFromStoreVisit | Примерное количество раз, когда люди посетили магазин после нажатия на рекламу. Этот показатель применяется только к элементам фида. |
visits | Клики, которые Search Ads 360 успешно зафиксировал и перенаправил на целевую страницу рекламодателя. |
allConversionsFromStoreWebsite | Сколько раз люди переходили на URL-адрес магазина после нажатия на рекламу. Этот показатель применяется только к элементам фида. |
averageCost | Средняя сумма, которую вы платите за взаимодействие. Эта сумма представляет собой общую стоимость вашей рекламы, разделенную на общее количество взаимодействий. |
averageCpc | Общая стоимость всех кликов, разделенная на общее количество полученных кликов. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
averageCpm | Средняя цена за тысячу показов (CPM). Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clicks | Количество кликов. |
contentBudgetLostImpressionShare | Приблизительный процент случаев, когда ваше объявление могло быть показано в контекстно-медийной сети, но не было показано из-за слишком низкого бюджета. Примечание. Процент потерянных показов бюджета контента указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
contentImpressionShare | Количество показов, полученных вами в контекстно-медийной сети, разделенное на расчетное количество показов, которые вы имели право получить. Примечание. Процент полученных показов контента указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
contentRankLostImpressionShare | Предполагаемый процент показов в контекстно-медийной сети, которые ваши объявления не получили из-за низкого рейтинга объявления. Примечание. Процент потерянных показов в рейтинге контента указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
conversionsFromInteractionsRate | Среднее число конверсий, подлежащих назначению ставки (от взаимодействия) на каждое взаимодействие, отвечающее критериям конверсии. Показывает, как часто в среднем взаимодействие с рекламой приводит к конверсии, подлежащей назначению ставки. |
clientAccountConversionsValue | Ценность конверсий клиентского аккаунта. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
conversionsValuePerCost | Ценность конверсии, подлежащей назначению ставки, разделенная на общую стоимость взаимодействий, отвечающих критериям конверсии. |
conversionsFromInteractionsValuePerInteraction | Ценность конверсий от взаимодействий, разделенная на количество взаимодействий с рекламой. This only includes conversion actions which includeInConversionsMetric attribute is set to true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
clientAccountConversions | Количество конверсий клиентского аккаунта. This only includes conversion actions which includeInClientAccountConversionsMetric attribute is set to true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
costMicros | Сумма затрат на цену за клик (CPC) и цену за тысячу показов (CPM) за этот период. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
costPerAllConversions | Стоимость взаимодействий с рекламой, разделенная на все конверсии. |
costPerConversion | Средняя допущенная цена за конверсию, подлежащую назначению ставок. |
costPerCurrentModelAttributedConversion | Стоимость взаимодействий с рекламой, разделенная на количество конверсий, связанных с текущей моделью. This only includes conversion actions which includeInConversionsMetric attribute is set to true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
crossDeviceConversions | Конверсии, когда клиент нажимает на рекламу на одном устройстве, а затем совершает конверсию на другом устройстве или в браузере. Cross-device conversions are already included in allConversions. |
crossDeviceConversionsValue | Сумма ценности конверсий в результате взаимодействий на нескольких устройствах. |
ctr | Количество кликов, полученных вашим объявлением (Клики), разделенное на количество показов вашего объявления (Показы). |
conversions | Количество конверсий. This only includes conversion actions which includeInConversionsMetric attribute is set to true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
conversionsValue | Сумма ценностей конверсий, включенных в поле «Конверсии». Этот показатель полезен только в том случае, если вы указали ценность действий-конверсий. |
averageQualityScore | Средний показатель качества. |
historicalQualityScore | Исторический показатель качества. |
impressions | Подсчет того, как часто ваше объявление появлялось на странице результатов поиска или на веб-сайте сети Google. |
interactionRate | Как часто люди взаимодействуют с вашим объявлением после того, как оно им было показано. Это количество взаимодействий, разделенное на количество показов вашего объявления. |
interactions | Количество взаимодействий. Взаимодействие – это основное действие пользователя, связанное с форматом объявления: клики по текстовым и товарным объявлениям, просмотры видеообъявлений и т. д. |
invalidClickRate | Процент отфильтрованных кликов от общего количества кликов (отфильтрованных и неотфильтрованных кликов) за отчетный период. |
invalidClicks | Количество кликов, которые Google считает незаконными и за которые не взимается плата. |
mobileFriendlyClicksPercentage | Процент мобильных кликов, которые переходят на страницу, оптимизированную для мобильных устройств. |
searchAbsoluteTopImpressionShare | Процент показов товарных или поисковых объявлений клиента, которые показываются на наиболее заметной позиции в магазине. Подробную информацию см. на странице https://support.google.com/sa360/answer/9566729 . Любое значение ниже 0,1 отображается как 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare | Число, оценивающее, насколько часто ваше объявление не занимало первое место среди лучших объявлений в результатах поиска из-за низкого бюджета. Примечание. Процент показов, потерянных в абсолютном топе поискового бюджета, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchBudgetLostImpressionShare | Приблизительный процент случаев, когда ваше объявление могло быть показано в поисковой сети, но не было показано из-за слишком низкого бюджета. Примечание. Процент потерянных показов поискового бюджета указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchBudgetLostTopImpressionShare | Показатель, показывающий, как часто ваше объявление не показывалось рядом с верхними результатами обычного поиска из-за недостаточного бюджета. Примечание. Процент потерянных верхних показов поискового бюджета указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchClickShare | Количество кликов, полученных вами в поисковой сети, разделенное на расчетное количество кликов, которые вы имели право получить. Примечание. Доля кликов при поиске указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
searchExactMatchImpressionShare | Количество полученных вами показов, разделенное на расчетное количество показов, которые вы имели право получить в поисковой сети для поисковых запросов, которые точно соответствовали вашим ключевым словам (или были близкими вариантами вашего ключевого слова), независимо от типов соответствия ваших ключевых слов. Примечание. Процент показов с точным соответствием при поиске указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
searchImpressionShare | Количество показов, полученных вами в поисковой сети, разделенное на расчетное количество показов, которые вы имели право получить. Примечание. Процент полученных показов при поиске указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 считается 0,0999. |
searchRankLostAbsoluteTopImpressionShare | Число, оценивающее, как часто ваше объявление не занимало первое место среди лучших объявлений в результатах поиска из-за низкого рейтинга объявления. Примечание. Процент потерянных абсолютных верхних показов в поисковом рейтинге указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchRankLostImpressionShare | Предполагаемый процент показов в поисковой сети, которые ваши объявления не получили из-за низкого рейтинга объявления. ПРИМЕЧАНИЕ. Поисковое ранг Потерянный впечатление сообщается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchRankLostTopImpressionShare | Число, оценивающее, как часто ваше объявление не показывалось рядом с верхними результатами обычного поиска из-за низкого рейтинга объявления. Примечание. Процент потерянных верхних показов поискового рейтинга указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
searchTopImpressionShare | Количество показов, которые вы получили среди самых популярных объявлений, по сравнению с расчетным количеством показов, которые вы имели право получить среди самых популярных объявлений. Примечание. Процент полученных показов в верхней части поиска указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 считается 0,0999. Лучшие объявления обычно располагаются над верхними органическими результатами, хотя по определенным запросам они могут показываться и ниже верхних органических результатов. |
topImpressionPercentage | Процент показов вашей рекламы, которые отображаются рядом с верхними результатами обычного поиска. |
valuePerAllConversions | Ценность всех конверсий, разделенная на количество всех конверсий. |
valuePerAllConversionsByConversionDate | Ценность всех конверсий, разделенная на количество всех конверсий. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти по адресу https://support.google.com/sa360/answer/9250611 . |
valuePerConversion | Ценность конверсий с возможностью назначения ставок, разделенная на количество конверсий с возможностью назначения ставок. Показывает, сколько в среднем стоит каждая конверсия, подлежащая назначению ставок. |
valuePerConversionsByConversionDate | Ценность конверсий с возможностью назначения ставок по дате конверсии, разделенная на число конверсий с возможностью назначения ставок по дате конверсии. Показывает, сколько в среднем стоит каждая из конверсий, подлежащих назначению ставок (по дате конверсии). Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. |
clientAccountViewThroughConversions | Общее количество конверсий по показам. Это происходит, когда клиент видит графическое или мультимедийное объявление, а затем совершает конверсию на вашем сайте, не взаимодействуя с другим объявлением (например, не нажимая на него). |
clientAccountCrossSellCostOfGoodsSoldMicros | Себестоимость проданных товаров при перекрестных продажах на клиентском счете (COGS) — это общая стоимость продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Себестоимость проданных товаров при перекрестных продажах — это общая стоимость проданных товаров, которые не рекламировались. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость перекрестной продажи товаров, проданных по этому заказу, составляет 5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellCostOfGoodsSoldMicros | Себестоимость проданных товаров при перекрестных продажах (COGS) — это общая стоимость продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Себестоимость проданных товаров при перекрестных продажах — это общая стоимость проданных товаров, которые не рекламировались. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость перекрестной продажи товаров, проданных по этому заказу, составляет 5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountCrossSellGrossProfitMicros | Валовая прибыль от перекрестных продаж на клиентском счете – это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в покупку, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж – это доход, полученный вами от перекрестных продаж, связанных с вашей рекламой, за вычетом стоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена рубашки составляет 20 долларов США, а себестоимость реализованной продукции составляет 5 долларов США. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов США = 20–5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellGrossProfitMicros | Валовая прибыль от перекрестных продаж — это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в покупку, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж – это доход, полученный вами от перекрестных продаж, связанных с вашей рекламой, за вычетом стоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена рубашки составляет 20 долларов США, а себестоимость реализованной продукции составляет 5 долларов США. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов США = 20–5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountCrossSellRevenueMicros | Доход от перекрестных продаж клиентского аккаунта – это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж – это общая прибыль, которую вы получили от перекрестных продаж, связанных с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от перекрестных продаж этого заказа составляет 20 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellRevenueMicros | Доход от перекрестных продаж — это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж – это общая прибыль, которую вы получили от перекрестных продаж, связанных с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от перекрестных продаж этого заказа составляет 20 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountCrossSellUnitsSold | Проданные единицы перекрестных продаж на клиентском счете – это общее количество продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Проданные единицы перекрестных продаж – это общее количество продуктов перекрестной продажи по всем заказам, связанным с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество единиц перекрестных продаж, проданных в этом заказе, равно 2. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
crossSellUnitsSold | Проданные единицы перекрестных продаж — это общее количество продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Проданные единицы перекрестных продаж – это общее количество продуктов перекрестной продажи по всем заказам, связанным с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество единиц перекрестных продаж, проданных в этом заказе, равно 2. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
clientAccountLeadCostOfGoodsSoldMicros | Себестоимость проданных товаров по счету клиента (COGS) — это общая стоимость продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым осуществлялось взаимодействие, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемая и продаваемая продукция совпадают, то стоимость этих товаров учитывается в составе себестоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость лида товаров, проданных по этому заказу, составляет 3 доллара США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadCostOfGoodsSoldMicros | Себестоимость проданных товаров (COGS) — это общая стоимость продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым осуществлялось взаимодействие, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемая и продаваемая продукция совпадают, то стоимость этих товаров учитывается в составе себестоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость лида товаров, проданных по этому заказу, составляет 3 доллара США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadGrossProfitMicros | Валовая прибыль от потенциальных клиентов — это прибыль, которую вы получили от продуктов, проданных в результате рекламы того же продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые товары совпадают, то доход, полученный вами от этих продаж за вычетом себестоимости проданных товаров, и будет вашей валовой прибылью от потенциальных клиентов. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена шляпы составляет 10 долларов, а себестоимость реализованной продукции составляет 3 доллара. Валовая прибыль лида по этому заказу составляет $7 = $10 – $3. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadGrossProfitMicros | Валовая прибыль от потенциальных клиентов — это прибыль, которую вы получили от продуктов, проданных в результате рекламы того же продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые товары совпадают, то доход, полученный вами от этих продаж за вычетом себестоимости проданных товаров, и будет вашей валовой прибылью от потенциальных клиентов. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена шляпы составляет 10 долларов, а себестоимость реализованной продукции составляет 3 доллара. Валовая прибыль лида по этому заказу составляет $7 = $10 – $3. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadRevenueMicros | Доход от потенциальных клиентов – это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые продукты совпадают, то общая стоимость, полученная вами от продаж этих продуктов, отображается в разделе «Доход от потенциальных клиентов». Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от лидов по этому заказу составляет 10 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadRevenueMicros | Доход от потенциальных клиентов — это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые продукты совпадают, то общая стоимость, полученная вами от продаж этих продуктов, отображается в разделе «Доход от потенциальных клиентов». Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от лидов по этому заказу составляет 10 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadUnitsSold | Продано единиц клиентского аккаунта — это общее количество продуктов, проданных в результате рекламы одного и того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые продукты совпадают, то общее количество проданных этих продуктов отображается в разделе «Продано единиц лида». Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество потенциальных единиц, проданных в этом заказе, равно 1. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
leadUnitsSold | Проданные лид-единицы — это общее количество продуктов, проданных в результате рекламы одного и того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемые и продаваемые продукты совпадают, то общее количество проданных этих продуктов отображается в разделе «Продано единиц лида». Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество потенциальных единиц, проданных в этом заказе, равно 1. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
Ценить
A generic data container.
JSON representation |
---|
{ // Union field |
Поля | |
---|---|
Union field value . Ценность. value can be only one of the following: | |
booleanValue | A boolean. |
int64Value | An int64. |
floatValue | A float. |
doubleValue | Двойник. |
stringValue | Строка. |
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 |
---|
{ "adNetworkType": enum ( |
Поля | |
---|---|
adNetworkType | Тип рекламной сети. |
conversionActionCategory | Категория действия-конверсии. |
conversionCustomDimensions[] | The conversion custom dimensions. |
dayOfWeek | День недели, например, ПОНЕДЕЛЬНИК. |
device | Device to which metrics apply. |
keyword | Keyword criterion. |
productChannel | Канал продукта. |
productChannelExclusivity | Эксклюзивность продукта на канале. |
productCondition | Состояние товара. |
productSoldCondition | Состояние продаваемого товара. |
rawEventConversionDimensions[] | The raw event conversion dimensions. |
conversionAction | Название ресурса действия-конверсии. |
conversionActionName | Название действия-конверсии. |
date | Дата, к которой применяются показатели. формат гггг-ММ-дд, например, 17.04.2018. |
geoTargetCity | Имя ресурса целевой географической константы, представляющей город. |
geoTargetCountry | Имя ресурса целевой географической константы, представляющей страну. |
geoTargetMetro | Имя ресурса целевой географической константы, представляющей метро. |
geoTargetRegion | Имя ресурса целевой географической константы, представляющей регион. |
hour | Час дня в виде числа от 0 до 23 включительно. |
month | Месяц, представленный датой первого дня месяца. В формате гггг-ММ-дд. |
productBiddingCategoryLevel1 | Категория торгов (уровень 1) товара. |
productBiddingCategoryLevel2 | Категория торгов (уровень 2) товара. |
productBiddingCategoryLevel3 | Категория торгов (уровень 3) товара. |
productBiddingCategoryLevel4 | Категория торгов (уровень 4) товара. |
productBiddingCategoryLevel5 | Категория торгов (уровень 5) товара. |
productBrand | Бренд продукта. |
productCountry | Имя ресурса целевой геоконстанты для страны сбыта продукта. |
productCustomAttribute0 | Пользовательский атрибут 0 продукта. |
productCustomAttribute1 | Пользовательский атрибут 1 товара. |
productCustomAttribute2 | Пользовательский атрибут 2 товара. |
productCustomAttribute3 | Пользовательский атрибут 3 товара. |
productCustomAttribute4 | Пользовательский атрибут 4 товара. |
productItemId | Идентификатор товара. |
productLanguage | Имя ресурса языковой константы для языка продукта. |
productSoldBiddingCategoryLevel1 | Категория торгов (уровень 1) продаваемого товара. |
productSoldBiddingCategoryLevel2 | Категория торгов (уровень 2) продаваемого товара. |
productSoldBiddingCategoryLevel3 | Категория торгов (уровень 3) продаваемого товара. |
productSoldBiddingCategoryLevel4 | Категория торгов (уровень 4) продаваемого товара. |
productSoldBiddingCategoryLevel5 | Категория торгов (уровень 5) продаваемого товара. |
productSoldBrand | Марка продаваемого товара. |
productSoldCustomAttribute0 | Пользовательский атрибут 0 проданного товара. |
productSoldCustomAttribute1 | Пользовательский атрибут 1 проданного товара. |
productSoldCustomAttribute2 | Пользовательский атрибут 2 проданного товара. |
productSoldCustomAttribute3 | Пользовательский атрибут 3 проданного товара. |
productSoldCustomAttribute4 | Пользовательский атрибут 4 продаваемого продукта. |
productSoldItemId | Идентификатор проданного товара. |
productSoldTitle | Название продаваемого продукта. |
productSoldTypeL1 | Тип (уровень 1) продаваемого товара. |
productSoldTypeL2 | Тип (уровень 2) продаваемого товара. |
productSoldTypeL3 | Тип (уровень 3) продаваемого товара. |
productSoldTypeL4 | Тип (уровень 4) продаваемого товара. |
productSoldTypeL5 | Тип (уровень 5) продаваемого товара. |
productStoreId | Идентификатор магазина продукта. |
productTitle | Название продукта. |
productTypeL1 | Тип (уровень 1) продукта. |
productTypeL2 | Type (level 2) of the product. |
productTypeL3 | Тип (уровень 3) продукта. |
productTypeL4 | Тип (уровень 4) продукта. |
productTypeL5 | Тип (уровень 5) продукта. |
quarter | Квартал, представленный датой первого дня квартала. Для кварталов используется календарный год, например, второй квартал 2018 года начинается 1 апреля 2018 года. В формате гггг-ММ-дд. |
week | Неделя определяется как с понедельника по воскресенье и обозначается датой понедельника. В формате гггг-ММ-дд. |
year | Год в формате гггг. |
assetInteractionTarget | Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, произошли ли метрики взаимодействия с самим объектом или с другим объектом или рекламным блоком. 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. |
AdNetworkType
Enumerates Google Ads network types.
Перечисления | |
---|---|
UNSPECIFIED | Не указан. |
UNKNOWN | The value is unknown in this version. |
SEARCH | Google search. |
SEARCH_PARTNERS | Search partners. |
CONTENT | Display Network. |
YOUTUBE_SEARCH | Поиск на YouTube. |
YOUTUBE_WATCH | Видео на YouTube |
MIXED | Cross-network. |
Ключевое слово
A Keyword criterion segment.
JSON representation |
---|
{
"info": {
object ( |
Поля | |
---|---|
info | Keyword info. |
adGroupCriterion | The AdGroupCriterion resource name. |
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. |
ProductCondition
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. |
AssetInteractionTarget
An AssetInteractionTarget segment.
JSON representation |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Поля | |
---|---|
asset | Имя ресурса актива. |
interactionOnThisAsset | Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, произошли ли метрики взаимодействия с самим объектом или с другим объектом или рекламным блоком. |