Package google.ads.searchads360.v0.common

Индекс

AdScheduleInfo

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

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

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

Поля
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

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

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

day_of_week

DayOfWeek

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

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

start_hour

int32

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

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

end_hour

int32

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

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

AdTextAsset

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

Поля
text

string

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

AgeRangeInfo

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

Поля
type

AgeRangeType

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

AssetInteractionTarget

Сегмент AssetInteractionTarget.

Поля
asset

string

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

interaction_on_this_asset

bool

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

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

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

Поля
asset

string

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

served_asset_field_type

ServedAssetFieldType

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

AudienceInfo

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

Поля
audience

string

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

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

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

Поля
labels[]

string

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

store_code

string

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

listing_id

int64

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

CallToActionAsset

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

Поля
call_to_action

CallToActionType

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

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

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

Поля
key

string

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

value

string

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

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

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

Поля
type

Device

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

EnhancedCpc

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

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

Данная стратегия назначения ставок устарела и больше не может быть создана. Для получения аналогичной функциональности используйте ManualCpc с параметром enhanced_cpc_enabled, установленным в значение true.

FinalAppUrl

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

Поля
os_type

AppUrlOperatingSystemType

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

url

string

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

FrequencyCapEntry

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

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

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

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

Поля
type

GenderType

Тип пола.

ImageAsset

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

Поля
mime_type

MimeType

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

full_size

ImageDimension

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

file_size

int64

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

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

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

Поля
height_pixels

int64

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

width_pixels

int64

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

url

string

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

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

Сегмент критериев ключевых слов.

Поля
info

KeywordInfo

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

ad_group_criterion

string

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

KeywordInfo

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

Поля
match_type

KeywordMatchType

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

text

string

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

LanguageInfo

Критерий владения языком.

Поля
language_constant

string

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

ListingGroupInfo

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

Поля
type

ListingGroupType

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

LocationGroupInfo

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

Поля
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

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

radius

int64

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

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

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

Поля
geo_target_constant

string

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

ManualCpa

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

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

ManualCpc

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

Поля
enhanced_cpc_enabled

bool

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

Ручной Cpm

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

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

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

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

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

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

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

Метрики

Метрики данных.

Поля
all_conversions_value_by_conversion_date

double

Значение всех конверсий. Если для этого столбца выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах by_conversion_date доступна в разделе «О столбце «Все конверсии»» .

all_conversions_by_conversion_date

double

Общее количество конверсий. Сюда входят все конверсии независимо от значения параметра include_in_conversions_metric. Если для этого столбца выбран параметр date, значения в столбце date означают дату конверсии. Подробная информация о столбцах by_conversion_date доступна в разделе «О столбце "Все конверсии"» .

conversion_custom_metrics[]

Value

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

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

Оценка качества творческого исторического контекста.

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

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

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

Исходные показатели конверсии событий.

absolute_top_impression_percentage

double

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

all_conversions_from_interactions_rate

double

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

all_conversions_value

double

Значение всех конверсий.

all_conversions

double

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

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

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

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

all_conversions_from_directions

double

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

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

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

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

all_conversions_from_order

double

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

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

all_conversions_from_other_engagement

double

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

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

all_conversions_from_store_visit

double

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

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

visits

double

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

all_conversions_from_store_website

double

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

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

average_cost

double

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

average_cpc

double

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

average_cpm

double

Средняя стоимость за тысячу показов (CPM). Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency в разделе PARAMETERS .

clicks

int64

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

content_budget_lost_impression_share

double

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

content_impression_share

double

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

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

content_rank_lost_impression_share

double

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

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

conversions_from_interactions_rate

double

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

client_account_conversions_value

double

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

conversions_value_per_cost

double

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

conversions_from_interactions_value_per_interaction

double

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

client_account_conversions

double

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

cost_micros

int64

Сумма ваших затрат на клик (CPC) и стоимость за тысячу показов (CPM) за этот период. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. Дополнительные сведения см. в параметре metrics_currency в разделе PARAMETERS .

cost_per_all_conversions

double

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

cost_per_conversion

double

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

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

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

cross_device_conversions_by_conversion_date

double

Количество конверсий между устройствами по дате конверсии. Подробная информация о столбце by_conversion_date доступна в разделе «О столбце "Все конверсии"».

cross_device_conversions_value

double

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

cross_device_conversions_value_by_conversion_date

double

Сумма значений конверсий между устройствами по дате by_conversion_date . Подробная информация о столбце "Все конверсии" доступна в разделе "О столбце"".

ctr

double

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

conversions

double

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

conversions_value

double

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

average_quality_score

double

Средний балл качества.

historical_quality_score

int64

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

impressions

int64

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

interaction_rate

double

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

interactions

int64

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

invalid_click_rate

double

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

invalid_clicks

int64

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

general_invalid_click_rate

double

Процент кликов, отфильтрованных из общего числа кликов (отфильтрованные + неотфильтрованные) как недействительные. Это клики, которые Google считает нелегитимными и которые обнаруживаются с помощью стандартных методов фильтрации (то есть, известный недействительный трафик из дата-центров, боты и пауки или другие краулеры, нерегулярные шаблоны и т. д.). С них не взимается плата, и они не влияют на статистику вашего аккаунта. См. Фильтрация недействительного трафика для обеспечения качества .

general_invalid_clicks

int64

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

mobile_friendly_clicks_percentage

double

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

search_absolute_top_impression_share

double

Процент показов товарных или поисковых объявлений клиента, отображаемых на наиболее заметной позиции в товарной выдаче. Подробнее см. раздел «О показателях верхней и абсолютной верхней позиции» . Любое значение ниже 0,1 отображается как 0,0999.

search_budget_lost_absolute_top_impression_share

double

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

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

search_budget_lost_impression_share

double

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

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

search_budget_lost_top_impression_share

double

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

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

search_click_share

double

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

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

search_exact_match_impression_share

double

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

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

search_impression_share

double

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

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

search_rank_lost_absolute_top_impression_share

double

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

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

search_rank_lost_impression_share

double

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

search_rank_lost_top_impression_share

double

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

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

search_top_impression_share

double

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

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

top_impression_percentage

double

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

value_per_all_conversions

double

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

value_per_all_conversions_by_conversion_date

double

Значение всех конверсий, деленное на общее количество конверсий. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах by_conversion_date доступна в разделе «О столбце «Все конверсии»» .

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

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

client_account_view_through_conversions

int64

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

orders

double

«Заказы» — это общее количество конверсий покупок, полученных благодаря вашей рекламе.

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

Пример: Кто-то кликнул на рекламное объявление в разделе «Товары для дома» и купил ту же шляпу и рубашку в одном заказе на вашем сайте. Даже если он купил два товара, это будет считаться одним заказом.

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

average_order_value_micros

int64

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

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

Пример: Вы получили 3 заказа, которые принесли доход в размере 10, 15 и 20 долларов. Средняя стоимость заказа составляет 15 долларов = (10 + 15 + 20)/3.

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

average_cart_size

double

Средний размер корзины — это среднее количество товаров в каждом заказе, оформленном с использованием вашей рекламы.

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

Пример: Вы получили 2 заказа, первый содержал 3 товара, а второй — 2. Средний размер корзины составляет 2,5 товара = (3+2)/2.

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

cost_of_goods_sold_micros

int64

Себестоимость проданных товаров (COGS) — это общая стоимость товаров, проданных вами по заказам, оформленным благодаря вашей рекламе.

Как это работает: Вы можете добавить стоимость проданных товаров к каждому товару в Merchant Center. Если вы формируете отчеты о конверсиях с использованием данных корзины, проданные вами товары сопоставляются с их себестоимостью, и это можно использовать для расчета валовой прибыли, полученной с каждого заказа.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 8 долларов = 3 + 5 долларов.

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

gross_profit_micros

int64

Валовая прибыль — это прибыль, полученная вами от заказов, связанных с вашей рекламой, за вычетом себестоимости проданных товаров (COGS).

Как это работает: Валовая прибыль — это выручка от продаж, совершенных благодаря вашей рекламе, за вычетом себестоимости реализованной продукции. Расчеты валовой прибыли включают только те товары, себестоимость реализованной продукции которых указана в Merchant Center.

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Себестоимость проданных товаров для шляпы составляет 3 доллара, а для рубашки — нет. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поэтому она составит 7 долларов = 10 долларов - 3 доллара.

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

gross_profit_margin

double

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

Как это работает: Вы формируете отчеты о конверсиях с данными о корзине покупок на вашем сайте. Валовая прибыль рассчитывается как валовая прибыль, разделенная на общую выручку и умноженная на 100%. Расчеты валовой прибыли включают только товары, для которых в Merchant Center указана себестоимость реализованной продукции.

Пример: Кто-то купил шляпу и рубашку на вашем сайте. Шляпа стоит 10 долларов, а ее себестоимость проданных товаров составляет 3 доллара. Рубашка стоит 20 долларов, но ее себестоимость проданных товаров отсутствует. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поскольку она имеет себестоимость проданных товаров, поэтому она составляет 70% = (10 долларов - 3 доллара) / 10 долларов x 100%.

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

revenue_micros

int64

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

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. На весь заказ действует скидка в 5 долларов. Доход от этого заказа составляет 25 долларов = (10 + 20) - 5.

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

units_sold

double

Количество проданных единиц — это общее число товаров, проданных по заказам, оформленным на основе вашей рекламы.

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, а затем купил ту же шляпу, рубашку и куртку. Количество проданных единиц в этом заказе — 3.

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

client_account_cross_sell_cost_of_goods_sold_micros

int64

Себестоимость проданных товаров (COGS) при перекрестных продажах по клиентскому счету — это общая стоимость товаров, проданных в результате рекламы другого продукта.

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов.

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

cross_sell_cost_of_goods_sold_micros

int64

Перекрестные продажи (стоимость проданных товаров) — это общая стоимость товаров, проданных в результате рекламы другого продукта.

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов.

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

client_account_cross_sell_gross_profit_micros

int64

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

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов.

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

cross_sell_gross_profit_micros

int64

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

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

Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов.

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

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

client_account_cross_sell_revenue_micros

int64

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

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

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20.

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 PARAMETERS clause .

cross_sell_revenue_micros

int64

Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20.

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 PARAMETERS clause .

client_account_cross_sell_units_sold

double

Client account cross-sell units sold is the total number of products sold as a result of advertising a different product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2.

This metric is only available if you report conversions with cart data.

cross_sell_units_sold

double

Cross-sell units sold is the total number of products sold as a result of advertising a different product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2.

This metric is only available if you report conversions with cart data.

client_account_lead_cost_of_goods_sold_micros

int64

Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product.

How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold.

Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3.

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 PARAMETERS clause .

lead_cost_of_goods_sold_micros

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 PARAMETERS clause .

client_account_lead_gross_profit_micros

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 PARAMETERS clause .

lead_gross_profit_micros

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 PARAMETERS clause .

client_account_lead_revenue_micros

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 PARAMETERS clause .

lead_revenue_micros

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 PARAMETERS clause .

client_account_lead_units_sold

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.

lead_units_sold

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.

unique_users

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.

average_impression_frequency_per_user

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.

MobileAppAsset

An asset representing a mobile app.

Поля
app_id

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.

app_store

MobileAppVendor

Required. The application store that distributes this specific app.

PercentCpc

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

Поля
cpc_bid_ceiling_micros

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.

enhanced_cpc_enabled

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.

RealTimeBiddingSetting

Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.

Поля
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

An expanded dynamic search ad.

Поля
description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ExpandedTextAdInfo

A Search Ads 360 expanded text ad. Expanded text ads are deprecated. Use SearchAds360ResponsiveSearchAd instead.

Поля
headline

string

The headline of the ad.

headline2

string

The second headline of the ad.

headline3

string

The third headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

path1

string

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

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ProductAdInfo

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

A Search Ads 360 product ad.

SearchAds360ResponsiveSearchAdInfo

A Search Ads 360 responsive search ad.

Поля
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

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

path1

string

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

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360TextAdInfo

A Search Ads 360 text ad.

Поля
headline

string

The headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

display_url

string

The displayed URL of the ad.

display_mobile_url

string

The displayed mobile URL of the ad.

ad_tracking_id

int64

The tracking id of the ad.

Сегменты

Segment only fields.

Поля
ad_format_type

AdFormatType

Ad Format type.

ad_network_type

AdNetworkType

Ad network type.

conversion_action_category

ConversionActionCategory

Conversion action category.

conversion_custom_dimensions[]

Value

The conversion custom dimensions.

day_of_week

DayOfWeek

Day of the week, for example, MONDAY.

device

Device

Device to which metrics apply.

keyword

Keyword

Keyword criterion.

product_channel

ProductChannel

Channel of the product.

product_channel_exclusivity

ProductChannelExclusivity

Channel exclusivity of the product.

product_condition

ProductCondition

Condition of the product.

product_sold_condition

ProductCondition

Condition of the product sold.

raw_event_conversion_dimensions[]

Value

The raw event conversion dimensions.

conversion_action

string

Resource name of the conversion action.

conversion_action_name

string

Conversion action name.

date

string

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

geo_target_city

string

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

geo_target_country

string

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

geo_target_metro

string

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

geo_target_postal_code

string

Resource name of the geo target constant that represents a postal code.

geo_target_region

string

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

hour

int32

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

month

string

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

product_bidding_category_level1

string

Bidding category (level 1) of the product.

product_bidding_category_level2

string

Bidding category (level 2) of the product.

product_bidding_category_level3

string

Bidding category (level 3) of the product.

product_bidding_category_level4

string

Bidding category (level 4) of the product.

product_bidding_category_level5

string

Bidding category (level 5) of the product.

product_brand

string

Brand of the product.

product_country

string

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

product_custom_attribute0

string

Custom attribute 0 of the product.

product_custom_attribute1

string

Custom attribute 1 of the product.

product_custom_attribute2

string

Custom attribute 2 of the product.

product_custom_attribute3

string

Custom attribute 3 of the product.

product_custom_attribute4

string

Custom attribute 4 of the product.

product_item_id

string

Item ID of the product.

product_language

string

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

product_sold_bidding_category_level1

string

Bidding category (level 1) of the product sold.

product_sold_bidding_category_level2

string

Bidding category (level 2) of the product sold.

product_sold_bidding_category_level3

string

Bidding category (level 3) of the product sold.

product_sold_bidding_category_level4

string

Bidding category (level 4) of the product sold.

product_sold_bidding_category_level5

string

Bidding category (level 5) of the product sold.

product_sold_brand

string

Brand of the product sold.

product_sold_custom_attribute0

string

Custom attribute 0 of the product sold.

product_sold_custom_attribute1

string

Custom attribute 1 of the product sold.

product_sold_custom_attribute2

string

Custom attribute 2 of the product sold.

product_sold_custom_attribute3

string

Custom attribute 3 of the product sold.

product_sold_custom_attribute4

string

Custom attribute 4 of the product sold.

product_sold_item_id

string

Item ID of the product sold.

product_sold_title

string

Title of the product sold.

product_sold_type_l1

string

Type (level 1) of the product sold.

product_sold_type_l2

string

Type (level 2) of the product sold.

product_sold_type_l3

string

Type (level 3) of the product sold.

product_sold_type_l4

string

Type (level 4) of the product sold.

product_sold_type_l5

string

Type (level 5) of the product sold.

product_store_id

string

Store ID of the product.

product_title

string

Title of the product.

product_type_l1

string

Type (level 1) of the product.

product_type_l2

string

Type (level 2) of the product.

product_type_l3

string

Type (level 3) of the product.

product_type_l4

string

Type (level 4) of the product.

product_type_l5

string

Type (level 5) of the product.

quarter

string

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

vertical_ads_event_participant_display_names

string

The display names of participants in an event listing, like performers, speakers, or teams.

vertical_ads_hotel_class

int64

The class of the hotel. Generally in the range of 1 to 5 stars, but fully customizable in the hotel feed.

vertical_ads_listing

string

The listing associated with a listing impression, click or conversion.

vertical_ads_listing_brand

string

The brand associated with a specific listing within a Vertical Ads context, for example, the brand of a car rental, a vacation home, or an event.

vertical_ads_listing_city

string

The city where the vertical ads listing is located.

vertical_ads_listing_country

string

The country where the vertical ads listing is located.

vertical_ads_listing_region

string

The region where the vertical ads listing is located.

vertical_ads_partner_account

int64

A specific partner account within a Partner Center (for example, Hotel Center) that supplies inventory feed data for Vertical Ads.

vertical_ads_vertical

VerticalAdsItemVerticalType

Type of vertical ad, such as Vacation Rentals, Car Rentals, or Events, used to categorize and segment data in the context of Vertical Ads.

week

string

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

year

int32

Year, formatted as yyyy.

asset_interaction_target

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.

SyntheticContentAttestation

Represents an attestation about synthetic content from a single source.

Поля
status

SyntheticContentAttestationStatus

Indicates whether the content is considered synthetic by this source.

source

SyntheticContentSource

The source of the synthetic content attestation.

SyntheticContentInfo

Container for synthetic content attestations from different sources, such as the advertiser and Google systems.

Поля
advertiser_attestation

SyntheticContentAttestation

Input provided by the advertiser.

system_attestation

SyntheticContentAttestation

Information about synthetic content generated by Google's systems.

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.

Поля
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

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.

cpc_bid_floor_micros

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.

TargetCpm

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

Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

Поля
location

TargetImpressionShareLocation

The targeted location on the search results page.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

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.

TargetOutrankShare

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

Поля
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

The list of per-targeting-dimension targeting settings.

Поля
targeting_dimension

TargetingDimension

The targeting dimension that these settings apply to.

bid_only

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.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

Поля
target_roas

double

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

cpc_bid_ceiling_micros

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.

cpc_bid_floor_micros

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.

TargetSpend

An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.

Поля
target_spend_micros
(deprecated)

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.

cpc_bid_ceiling_micros

int64

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

TargetingSetting

Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594

Поля
target_restrictions[]

TargetRestriction

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

TextAsset

A Text asset.

Поля
text

string

Text content of the text asset.

TextLabel

A type of label displaying text on a colored background.

Поля
background_color

string

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

description

string

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

UnifiedCallAsset

A unified call asset.

Поля
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

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.

ad_schedule_targets[]

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.

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

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

start_date

string

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

end_date

string

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

UnifiedCalloutAsset

A unified callout asset.

Поля
callout_text

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

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.

use_searcher_time_zone

bool

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

UnifiedLocationAsset

A unified location asset.

Поля
place_id

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.

business_profile_locations[]

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.

location_ownership_type

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.

UnifiedPageFeedAsset

A Unified Page Feed asset.

Поля
page_url

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

UnifiedSitelinkAsset

A unified sitelink asset.

Поля
description1

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.

description2

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.

start_date

string

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

end_date

string

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

ad_schedule_targets[]

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.

tracking_id

int64

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

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

A User List criterion. Represents a user list that is defined by the advertiser to be targeted.

Поля
user_list

string

The User List resource name.

Ценить

A generic data container.

Поля
Union field value . A value. value can be only one of the following:
boolean_value

bool

A boolean.

int64_value

int64

An int64.

float_value

float

A float.

double_value

double

Двойной.

string_value

string

Строка.

WebpageConditionInfo

Logical expression for targeting webpages of an advertiser's website.

Поля
operand

WebpageConditionOperand

Operand of webpage targeting condition.

operator

WebpageConditionOperator

Operator of webpage targeting condition.

argument

string

Argument of webpage targeting condition.

WebpageInfo

Represents a criterion for targeting webpages of an advertiser's website.

Поля
conditions[]

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.

coverage_percentage

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.

criterion_name

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.

YoutubeVideoAsset

A YouTube asset.

Поля
youtube_video_title

string

YouTube video title.

youtube_video_id

string

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