Package google.ads.searchads360.v0.common

MinuteOfHour

Минуты после часа начала действия этого расписания.

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

MinuteOfHour

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

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

DayOfWeek

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

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

int32

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

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

int32

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

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

string

Текст актива.

AgeRangeType

Тип возрастного диапазона.

string

Имя ресурса актива.

bool

Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, относится ли метрика взаимодействия к самому активу или к другому активу или рекламному блоку.

string

Имя ресурса актива.

ServedAssetFieldType

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

string

Имя ресурса аудитории.

string

Метка местоположения, указанная рекламодателем в профиле компании. Синхронизируется с профилем компании.

string

Код магазина в профиле компании для этого местоположения. Синхронизируется с учётной записью профиля компании.

int64

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

CallToActionType

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

string

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

string

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

Device

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

AppUrlOperatingSystemType

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

string

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

GenderType

Тип пола.

MimeType

Тип MIME ресурса изображения.

ImageDimension

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

int64

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

int64

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

int64

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

string

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

KeywordInfo

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

string

Имя ресурса AdGroupCriterion.

KeywordMatchType

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

string

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

string

Имя константного ресурса языка.

ListingGroupType

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

string

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

LocationGroupRadiusUnits

Единица измерения радиуса. Для констант геоцелей поддерживаются мили и метры. Для наборов элементов фида поддерживаются милли-мили и метры. Это обязательное условие, которое должно быть задано в операциях CREATE.

string

Наборы FeedItemSets, для которых выбраны FeedItems. Если указано несколько идентификаторов, то выбраны все элементы, присутствующие хотя бы в одном наборе. Это поле нельзя использовать с geo_target_constants. Это необязательное поле, которое можно задать только в операциях CREATE.

int64

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

string

Имя постоянного ресурса геоцелевого объекта.

bool

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

int64

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

int64

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

double

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

int64

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

int64

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

int64

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

double

Ценность всех конверсий. Если этот столбец выбран с датой, значения в столбце «Дата» соответствуют дате конверсии. Подробная информация о столбцах «by_conversion_date» доступна по адресу https://support.google.com/sa360/answer/9250611 .

double

Общее количество конверсий. Включает все конверсии независимо от значения include_in_conversions_metric. Если этот столбец выбран с датой, значения в столбце date соответствуют дате конверсии. Подробная информация о столбцах by_conversion_date доступна по адресу https://support.google.com/sa360/answer/9250611 .

Value

Пользовательские метрики конверсии.

double

Суммарная стоимость конверсий, доступных для ставок, по дате конверсии. Если этот столбец выбран с датой, значения в столбце «Дата» соответствуют дате конверсии.

double

Сумма конверсий по дате конверсии для типов конверсий, доступных для назначения ставок. Может быть дробной из-за особенностей моделирования атрибуции. Если этот столбец выбран с датой, значения в столбце «Дата» соответствуют дате конверсии.

QualityScoreBucket

Творческий исторический показатель качества.

QualityScoreBucket

Качество исторического опыта использования целевой страницы.

QualityScoreBucket

Прогнозируемый показатель кликабельности (CTR) на основе исторического поиска.

InteractionEventType

Типы платных и бесплатных взаимодействий.

Value

Необработанные метрики конверсии событий.

double

Доля показов на самой верхней позиции в результатах поиска — это процент показов ваших поисковых объявлений, которые отображаются на самой заметной позиции в результатах поиска.

double

Все конверсии от взаимодействий (в отличие от конверсий от просмотров), деленные на количество взаимодействий с рекламой.

double

Ценность всех конверсий.

double

Общее количество конверсий. Включает все конверсии независимо от значения include_in_conversions_metric.

double

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

double

Количество раз, когда пользователи нажимали кнопку «Позвонить», чтобы позвонить в магазин во время или после просмотра рекламы. Это число не учитывает, были ли звонки соединены или нет, а также их продолжительность.

Эта метрика применима только к элементам фида.

double

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

Эта метрика применима только к элементам фида.

double

Значение всех конверсий от взаимодействий, деленное на общее количество взаимодействий.

double

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

Эта метрика применима только к элементам фида.

double

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

Эта метрика применима только к элементам фида.

double

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

Эта метрика применима только к элементам фида.

double

Расчетное количество посещений магазина после нажатия на рекламу.

Эта метрика применима только к элементам фида.

double

Клики, которые Search Ads 360 успешно зарегистрировал и перенаправил на целевую страницу рекламодателя.

double

Количество раз, когда люди переходили по URL-адресу магазина после нажатия на рекламу.

Эта метрика применима только к элементам фида.

double

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

double

Общая стоимость всех кликов, деленная на общее количество полученных кликов. Эта метрика имеет денежное значение и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency на странице https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

double

Средняя цена за тысячу показов (CPM). Эта метрика имеет денежное значение и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency на странице https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Количество кликов.

double

Расчетный процент показов вашего объявления в контекстно-медийной сети, которые не были показаны из-за слишком низкого бюджета. Примечание: доля показов, потерянных из-за бюджета контента, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 указывается как 0,9001.

double

Количество показов, полученных вами в контекстно-медийной сети, деленное на предполагаемое количество показов, которые вы могли получить. Примечание: доля показов контента указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 указывается как 0,0999.

double

Расчетный процент показов в контекстно-медийной сети, которые ваши объявления не получили из-за низкого рейтинга объявления. Примечание: доля потерянных показов из-за низкого рейтинга контента указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 указывается как 0,9001.

double

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

double

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

double

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

double

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

double

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

int64

Сумма затрат на клик (CPC) и тысячу показов (CPM) за этот период. Эта метрика имеет денежное значение и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency на странице https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause .

double

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

double

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

double

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

double

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

double

Количество конверсий на нескольких устройствах по дате конверсии. Подробная информация о столбцах «by_conversion_date» доступна по адресу https://support.google.com/sa360/answer/9250611 .

double

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

double

Суммарная ценность конверсий на нескольких устройствах по дате конверсии. Подробная информация о столбцах «by_conversion_date» доступна по адресу https://support.google.com/sa360/answer/9250611 .

double

Количество кликов по вашему объявлению (клики), деленное на количество показов вашего объявления (показы).

double

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

double

Сумма значений конверсий, включённых в поле «Конверсии». Эта метрика полезна только в том случае, если вы указали значение для своих действий-конверсий.

double

Средний показатель качества.

int64

Исторический показатель качества.

int64

Подсчет того, как часто ваше объявление появлялось на странице результатов поиска или на веб-сайте в сети Google.

double

Как часто пользователи взаимодействуют с вашей рекламой после её показа. Это количество взаимодействий, делённое на количество показов вашей рекламы.

int64

Количество взаимодействий. Взаимодействие — это основное действие пользователя, связанное с рекламным форматом: клики по текстовым и товарным объявлениям, просмотры видеорекламы и т. д.

double

Процент отфильтрованных кликов от общего числа кликов (отфильтрованные + неотфильтрованные клики) за отчетный период.

int64

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

double

Процент кликов, отфильтрованных от общего числа ваших кликов (отфильтрованные + неотфильтрованные) по причине недействительных кликов. Это клики, которые Google считает недействительными и которые обнаруживаются стандартными средствами фильтрации (например, заведомо недействительный трафик центров обработки данных, боты, поисковые роботы или другие поисковые роботы, нестандартные алгоритмы и т. д.). Плата за них не взимается, и они не влияют на статистику вашего аккаунта. Подробнее см. на странице справки по адресу https://support.google.com/campaignmanager/answer/6076504 .

int64

Количество недействительных кликов общего характера. Это подмножество недействительных кликов, которые обнаруживаются стандартными средствами фильтрации (такими как известный недействительный трафик центров обработки данных, боты, поисковые роботы или другие поисковые роботы, нестандартные алгоритмы и т. д.). Плата за них не взимается, и они не влияют на статистику вашего аккаунта. Подробнее см. на странице справки по адресу https://support.google.com/campaignmanager/answer/6076504 .

double

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

double

Процент показов рекламы покупателя в поисковой или торговой сети, которые отображаются на самой заметной позиции в поисковой сети. Подробнее см. https://support.google.com/sa360/answer/9566729 . Любое значение ниже 0,1 учитывается как 0,0999.

double

Число, показывающее, как часто ваше объявление не оказывалось на самом первом месте среди верхних объявлений в результатах поиска из-за низкого бюджета. Примечание: Абсолютная доля показов, потерянных из-за бюджета поиска, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

double

Расчетный процент показов вашего объявления в поисковой сети, которые не были показаны из-за слишком низкого бюджета. Примечание: доля потерянных показов в поисковой сети определяется в диапазоне от 0 до 0,9. Любое значение выше 0,9 определяется как 0,9001.

double

Число, показывающее, как часто ваше объявление не показывалось рядом с верхними результатами органического поиска из-за низкого бюджета. Примечание: процент показов в верхних результатах поиска, потерянных из-за низкого бюджета, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 указывается как 0,9001.

double

Количество кликов, полученных вами в поисковой сети, делённое на предполагаемое количество кликов, которые вы могли получить. Примечание: доля кликов в поисковой сети указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 указывается как 0,0999.

double

Количество полученных показов, делённое на предполагаемое количество показов, которые вы могли получить в поисковой сети по поисковым запросам, которые полностью соответствуют вашим ключевым словам (или являются близкими вариантами), независимо от типов соответствия ключевых слов. Примечание: доля показов с точным соответствием поисковой выдачи рассчитывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 рассчитывается как 0,0999.

double

Количество показов, полученных вами в поисковой сети, делённое на предполагаемое количество показов, которые вы могли получить. Примечание: доля показов в поисковой сети указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 указывается как 0,0999.

double

Число, показывающее, как часто ваше объявление не оказывалось на самом первом месте среди верхних объявлений в результатах поиска из-за низкого рейтинга. Примечание: процент показов, потерянных в абсолютном верхнем рейтинге, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

double

Расчетный процент показов в поисковой сети, которые ваши объявления не получили из-за низкого рейтинга. Примечание: процент потерянных показов в поисковой сети указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 указывается как 0,9001.

double

Число, показывающее, как часто ваше объявление не показывалось рядом с верхними результатами органического поиска из-за низкого рейтинга объявления. Примечание: процент показов, потерянных в поисковой выдаче, указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001.

double

Количество показов, полученных вами среди самых популярных объявлений, по сравнению с предполагаемым количеством показов, которые вы могли получить среди самых популярных объявлений. Примечание: доля показов в верхней части поисковой выдачи определяется в диапазоне от 0,1 до 1. Любое значение ниже 0,1 определяется как 0,0999.

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

double

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

double

Стоимость всех конверсий, деленная на количество всех конверсий.

double

Значение всех конверсий, делённое на количество всех конверсий. Если этот столбец выбран с датой, значения в столбце «Дата» соответствуют дате конверсии. Подробная информация о столбцах «by_conversion_date» доступна по адресу https://support.google.com/sa360/answer/9250611 .

double

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

double

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

int64

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

int64

Себестоимость проданных товаров (COGS) по кросс-продажам на клиентском аккаунте — это общая стоимость товаров, проданных в результате рекламы другого товара. Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали до покупки, имело связанный товар (см. Товарные объявления), то этот товар считается рекламируемым товаром. Любой товар, включенный в заказ, который размещает клиент, является проданным товаром. Если эти товары не совпадают, то это считается кросс-продажей. Себестоимость проданных товаров по кросс-продажам — это общая стоимость проданных товаров, которые не рекламировались. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил ту же шляпу и рубашку. Себестоимость проданных товаров для шляпы составляет 3 доллара, а для рубашки — 5 долларов. Себестоимость проданных товаров по этому заказу составляет 5 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Себестоимость проданных товаров при перекрестных продажах (COGS) — это общая стоимость продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали до покупки, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, который размещает клиент, является проданным продуктом. Если эти продукты не совпадают, то это считается перекрестными продажами. Себестоимость проданных товаров при перекрестных продажах — это общая стоимость проданных товаров, которые не были рекламированы. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил ту же шляпу и рубашку. Себестоимость проданных товаров для шляпы составляет 3 доллара, а для рубашки — 5 долларов. Себестоимость проданных товаров при перекрестных продажах для этого заказа составляет 5 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Валовая прибыль от перекрестных продаж на клиентском аккаунте — это прибыль, полученная вами от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными о корзине для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали перед покупкой, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в покупку, считается проданным продуктом. Если эти продукты не совпадают, то это считается перекрестными продажами. Валовая прибыль от перекрестных продаж — это доход, полученный вами от перекрестных продаж, отнесенный к вашим рекламным объявлениям, за вычетом себестоимости проданных товаров. Пример: кто-то нажал на товарное объявление, чтобы купить шляпу, а затем купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными о корзине. Эта метрика является денежной величиной и по умолчанию возвращается в валюте покупателя. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Валовая прибыль от кросс-продаж — это прибыль, полученная от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали перед покупкой, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в покупку, является проданным продуктом. Если эти продукты не совпадают, то это считается кросс-продажей. Валовая прибыль от кросс-продаж — это доход, полученный вами от кросс-продаж, отнесенный к вашим рекламным объявлениям, за вычетом себестоимости проданных товаров. Пример: кто-то нажал на товарное объявление, чтобы купить шляпу, а затем купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от кросс-продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте покупателя. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Доход от перекрестных продаж на клиентском аккаунте — это общая сумма, которую вы получили от продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали до покупки, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, размещаемый клиентом, является проданным продуктом. Если эти продукты не совпадают, то это считается перекрестными продажами. Доход от перекрестных продаж — это общая стоимость, которую вы получили от перекрестных продаж, приписанных вашим объявлениям. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил ту же шляпу и рубашку. Цена шляпы составляет 10 долларов, а рубашка — 20 долларов. Доход от перекрестных продаж по этому заказу составляет 20 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Cross-sell income - это общая сумма, которую вы получили от продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали до покупки, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, размещаемый клиентом, является проданным продуктом. Если эти продукты не совпадают, то это считается перекрестными продажами. Cross-sell income - это общая стоимость, которую вы получили от перекрестных продаж, приписанных вашим объявлениям. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил ту же шляпу и рубашку. Цена шляпы составляет 10 долларов, а рубашка - 20 долларов. Доход от перекрестных продаж этого заказа составляет 20 долларов. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

double

Продано единиц кросс-продаж по клиентскому аккаунту — это общее количество товаров, проданных в результате рекламы другого товара. Как это работает: вы сообщаете о конверсиях с данными о корзине для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали перед покупкой, имеет связанный товар (см. Товарные объявления), то этот товар считается рекламируемым товаром. Любой товар, включенный в заказ, размещаемый клиентом, является проданным товаром. Если эти товары не совпадают, то это считается кросс-продажей. Продано единиц кросс-продаж — это общее количество товаров кросс-продаж из всех заказов, отнесенных к вашим объявлениям. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил ту же шляпу, рубашку и куртку. Продано единиц кросс-продаж в этом заказе — 2. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными о корзине.

double

Cross-sell units sold — это общее количество товаров, проданных в результате рекламы другого товара. Как это работает: вы сообщаете о конверсиях с данными о корзине для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовали перед покупкой, имеет связанный товар (см. Товарные объявления), то этот товар считается рекламируемым товаром. Любой товар, включенный в заказ, размещаемый клиентом, считается проданным товаром. Если эти товары не совпадают, то это считается кросс-продажей. Cross-sell units sold — это общее количество товаров, проданных по кросс-продажам, из всех заказов, отнесенных к вашим рекламным объявлениям. Пример: кто-то нажал на товарное объявление, чтобы купить шляпу, а затем купил ту же шляпу, рубашку и куртку. Количество проданных единиц кросс-продаж в этом заказе равно 2. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными о корзине.

int64

Стоимость проданных товаров (COGS) для клиентского аккаунта — это общая стоимость продуктов, проданных в результате рекламы одного и того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для завершенных покупок на своем веб-сайте. Если объявление, с которым взаимодействовал пользователь, имеет связанный продукт (см. Товарные объявления), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, который размещает клиент, является проданным продуктом. Если рекламируемый и проданный продукты совпадают, то стоимость этих товаров учитывается в стоимости проданных товаров для лида. Пример: кто-то нажал на товарное объявление для шляпы, а затем купил такую ​​же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, стоимость проданных товаров для рубашки — 5 долларов. Стоимость проданных товаров для лида для этого заказа составляет 3 доллара. Эта метрика доступна только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика является денежной величиной и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

int64

Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

int64

Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

int64

Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

int64

Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

int64

Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

double

Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.

double

Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.

int64

The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

double

The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App.

string

Required. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.

MobileAppVendor

Required. The application store that distributes this specific app.

int64

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

bool

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

bool

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

string

The first line of the ad's description.

string

The second line of the ad's description.

int64

The tracking id of the ad.

string

The headline of the ad.

string

The second headline of the ad.

string

The third headline of the ad.

string

The first line of the ad's description.

string

The second line of the ad's description.

string

Text appended to the auto-generated visible URL with a delimiter.

string

Text appended to path1 with a delimiter.

int64

The tracking id of the ad.

AdTextAsset

List of text assets for headlines. When the ad serves the headlines will be selected from this list.

AdTextAsset

List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.

string

Text appended to the auto-generated visible URL with a delimiter.

string

Text appended to path1 with a delimiter.

int64

The tracking id of the ad.

string

The headline of the ad.

string

The first line of the ad's description.

string

The second line of the ad's description.

string

The displayed URL of the ad.

string

The displayed mobile URL of the ad.

int64

The tracking id of the ad.

AdNetworkType

Ad network type.

ConversionActionCategory

Conversion action category.

Value

The conversion custom dimensions.

DayOfWeek

Day of the week, for example, MONDAY.

Device

Device to which metrics apply.

Keyword

Keyword criterion.

ProductChannel

Channel of the product.

ProductChannelExclusivity

Channel exclusivity of the product.

ProductCondition

Condition of the product.

ProductCondition

Condition of the product sold.

Value

The raw event conversion dimensions.

string

Resource name of the conversion action.

string

Conversion action name.

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

string

Resource name of the geo target constant that represents a city.

string

Resource name of the geo target constant that represents a country.

string

Resource name of the geo target constant that represents a metro.

string

Resource name of the geo target constant that represents a region.

int32

Hour of day as a number between 0 and 23, inclusive.

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

string

Bidding category (level 1) of the product.

string

Bidding category (level 2) of the product.

string

Bidding category (level 3) of the product.

string

Bidding category (level 4) of the product.

string

Bidding category (level 5) of the product.

string

Brand of the product.

string

Resource name of the geo target constant for the country of sale of the product.

string

Custom attribute 0 of the product.

string

Custom attribute 1 of the product.

string

Custom attribute 2 of the product.

string

Custom attribute 3 of the product.

string

Custom attribute 4 of the product.

string

Item ID of the product.

string

Resource name of the language constant for the language of the product.

string

Bidding category (level 1) of the product sold.

string

Bidding category (level 2) of the product sold.

string

Bidding category (level 3) of the product sold.

string

Bidding category (level 4) of the product sold.

string

Bidding category (level 5) of the product sold.

string

Brand of the product sold.

string

Custom attribute 0 of the product sold.

string

Custom attribute 1 of the product sold.

string

Custom attribute 2 of the product sold.

string

Custom attribute 3 of the product sold.

string

Custom attribute 4 of the product sold.

string

Item ID of the product sold.

string

Title of the product sold.

string

Type (level 1) of the product sold.

string

Type (level 2) of the product sold.

string

Type (level 3) of the product sold.

string

Type (level 4) of the product sold.

string

Type (level 5) of the product sold.

string

Store ID of the product.

string

Title of the product.

string

Type (level 1) of the product.

string

Type (level 2) of the product.

string

Type (level 3) of the product.

string

Type (level 4) of the product.

string

Type (level 5) of the product.

string

Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

int32

Year, formatted as yyyy.

AssetInteractionTarget

Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interaction_on_this_asset is true, it means the interactions are on this specific asset and when interaction_on_this_asset 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.

int64

Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.

int64

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

int64

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

TargetImpressionShareLocation

The targeted location on the search results page.

int64

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

int64

The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

Int64Value

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetingDimension

The targeting dimension that these settings apply to.

bool

Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of true means that these criteria will only apply bid modifiers, and not affect targeting. A value of false means that these criteria will restrict targeting as well as applying bid modifiers.

double

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

int64

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

int64

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

int64

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

int64

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetRestriction

The per-targeting-dimension setting to restrict the reach of your campaign or ad group.

string

Text content of the text asset.

string

Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.

string

A short description of the label. The length must be no more than 200 characters.

string

Two-letter country code of the phone number. Examples: 'US', 'us'.

string

The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'

CallConversionReportingState

Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.

string

The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

AdScheduleInfo

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

bool

Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.

bool

Whether the call should be enabled on call tracking. Applies to Microsoft Ads.

bool

Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

string

The callout text. The length of this string should be between 1 and 25, inclusive.

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

AdScheduleInfo

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

bool

Whether to show the asset in search user's time zone. Applies to Microsoft Ads.

string

Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID.

BusinessProfileLocation

The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID.

LocationOwnershipType

The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location.

string

The webpage that advertisers want to target.

string

Labels used to group the page urls.

string

URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive.

string

First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set.

string

Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set.

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

AdScheduleInfo

List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total.

int64

ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.

bool

Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.

bool

Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads.

string

The User List resource name.

bool

A boolean.

int64

An int64.

float

Поплавок.

double

A double.

string

A string.

WebpageConditionOperand

Operand of webpage targeting condition.

WebpageConditionOperator

Operator of webpage targeting condition.

string

Argument of webpage targeting condition.

WebpageConditionInfo

Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted.

This field is required for CREATE operations and is prohibited on UPDATE operations.

double

Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.

string

The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters.

This field is required for CREATE operations and is prohibited on UPDATE operations.

string

YouTube video title.

string

YouTube video id. This is the 11 character string value used in the YouTube video URL.