Индекс
-
AdScheduleInfo(message) -
AdTextAsset(message) -
AgeRangeInfo(message) -
AssetInteractionTarget(сообщение) -
AssetUsage(сообщение) -
AudienceInfo(сообщение) -
BusinessProfileLocation(message) -
CallToActionAsset(message) -
CustomParameter(message) -
DeviceInfo(сообщение) -
EnhancedCpc(сообщение) -
FinalAppUrl(message) -
FrequencyCapEntry(message) -
GenderInfo(сообщение) -
ImageAsset(message) -
ImageDimension(message) -
Keyword(сообщение) -
KeywordInfo(message) -
LanguageInfo(message) -
ListingGroupInfo(message) -
LocationGroupInfo(message) -
LocationInfo(сообщение) -
ManualCpa(сообщение) -
ManualCpc(сообщение) -
ManualCpm(сообщение) -
MaximizeConversionValue(message) -
MaximizeConversions(сообщение) -
Metrics(сообщение) -
MobileAppAsset(message) -
PercentCpc(сообщение) -
RealTimeBiddingSetting(message) -
SearchAds360ExpandedDynamicSearchAdInfo(message) -
SearchAds360ExpandedTextAdInfo(message) -
SearchAds360ProductAdInfo(message) -
SearchAds360ResponsiveSearchAdInfo(message) -
SearchAds360TextAdInfo(message) -
Segments(сообщения) -
SyntheticContentAttestation(message) -
SyntheticContentInfo(message) -
TargetCpa(сообщение) -
TargetCpm(сообщение) -
TargetImpressionShare(message) -
TargetOutrankShare(сообщение) -
TargetRestriction(message) -
TargetRoas(сообщение) -
TargetSpend(сообщение) -
TargetingSetting(message) -
TextAsset(message) -
TextLabel(message) -
UnifiedCallAsset(message) -
UnifiedCalloutAsset(message) -
UnifiedLocationAsset(message) -
UnifiedPageFeedAsset(message) -
UnifiedSitelinkAsset(message) -
UserListInfo(message) -
Value(сообщение) -
WebpageConditionInfo(message) -
WebpageInfo(message) -
YoutubeVideoAsset(message)
AdScheduleInfo
Представляет собой критерий AdSchedule.
В параметре AdSchedule указывается день недели и временной интервал, в течение которого будут показываться объявления.
На один день можно добавить не более шести рекламных расписаний.
| Поля | |
|---|---|
start_minute | Через несколько минут после начала часа, в который начинается действие данного расписания. Это поле обязательно для операций CREATE и запрещено для операций UPDATE. |
end_minute | Минуты после окончания часа, в который заканчивается данное расписание. Расписание не включает последнюю минуту. Это поле обязательно для операций CREATE и запрещено для операций UPDATE. |
day_of_week | День недели, к которому относится расписание. Это поле обязательно для операций CREATE и запрещено для операций UPDATE. |
start_hour | Начальное время в 24-часовом формате. Значение в этом поле должно быть от 0 до 23 включительно. Это поле обязательно для операций CREATE и запрещено для операций UPDATE. |
end_hour | Час окончания дня в 24-часовом формате; 24 означает конец дня. Это поле должно принимать значения от 0 до 24 включительно. Это поле обязательно для операций CREATE и запрещено для операций UPDATE. |
AdTextAsset
Текстовый элемент, используемый в рекламе.
| Поля | |
|---|---|
text | Текст ресурса. |
AgeRangeInfo
Критерий возрастного диапазона.
| Поля | |
|---|---|
type | Тип возрастной группы. |
AssetInteractionTarget
Сегмент AssetInteractionTarget.
| Поля | |
|---|---|
asset | Название ресурса актива. |
interaction_on_this_asset | Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, произошло ли взаимодействие с самим ресурсом или с другим ресурсом или рекламным блоком. |
Использование активов
Содержит информацию об использовании актива.
| Поля | |
|---|---|
asset | Название ресурса актива. |
served_asset_field_type | Тип обслуживаемого поля актива. |
AudienceInfo
Критерий оценки целевой аудитории.
| Поля | |
|---|---|
audience | Название ресурса "Аудитория". |
БизнесПрофильМестоположение
Данные о местоположении бизнес-профиля синхронизируются из связанной учетной записи бизнес-профиля.
| Поля | |
|---|---|
labels[] | Рекламодатель указывает метку для местоположения в учетной записи бизнес-профиля. Эта информация синхронизируется с учетной записью бизнес-профиля. |
store_code | Код хранилища для данного местоположения в рамках бизнес-профиля. Он синхронизируется из учетной записи бизнес-профиля. |
listing_id | Идентификатор объявления для данного местоположения бизнес-профиля. Он синхронизируется из связанной учетной записи бизнес-профиля. |
CallToActionAsset
Призыв к действию.
| Поля | |
|---|---|
call_to_action | Призыв к действию. |
Пользовательский параметр
Сопоставление, которое может использоваться пользовательскими тегами параметров в tracking_url_template , final_urls или mobile_final_urls .
| Поля | |
|---|---|
key | Ключ, соответствующий имени тега параметра. |
value | Значение, которое необходимо подставить. |
Информация об устройстве
Критерий устройства.
| Поля | |
|---|---|
type | Тип устройства. |
EnhancedCpc
Этот тип не содержит полей.
Автоматизированная стратегия назначения ставок, которая повышает ставки для кликов, которые, по всей видимости, с большей вероятностью приведут к конверсии, и понижает их для кликов, которые, по всей видимости, с меньшей вероятностью приведут к конверсии.
Данная стратегия назначения ставок устарела и больше не может быть создана. Для получения аналогичной функциональности используйте ManualCpc с параметром enhanced_cpc_enabled, установленным в значение true.
FinalAppUrl
URL-адрес для прямой ссылки на приложение для данной операционной системы.
| Поля | |
|---|---|
os_type | Операционная система, на которую указывает данный URL. Обязательно. |
url | URL-адрес прямой ссылки приложения. Глубокие ссылки указывают местоположение в приложении, соответствующее контенту, который вы хотите отобразить, и должны иметь вид {схема}://{путь_хоста}. Схема определяет, какое приложение следует открыть. Для вашего приложения вы можете использовать пользовательскую схему, начинающуюся с имени приложения. Хост и путь указывают уникальное местоположение в приложении, где находится ваш контент. Пример: "exampleapp://productid_1234". Обязательно. |
FrequencyCapEntry
Этот тип не содержит полей.
Правило, определяющее максимальное количество показов объявления (или набора объявлений) пользователю за определенный период времени.
Гендерная информация
Гендерный критерий.
| Поля | |
|---|---|
type | Тип пола. |
ImageAsset
Изображение.
| Поля | |
|---|---|
mime_type | MIME-тип графического ресурса. |
full_size | Метаданные для этого изображения в исходном размере. |
file_size | Размер файла изображения в байтах. |
Размерность изображения
Метаданные для изображения определенного размера, как исходного, так и измененного.
| Поля | |
|---|---|
height_pixels | Высота изображения. |
width_pixels | Ширина изображения. |
url | URL-адрес, возвращающий изображение с указанными высотой и шириной. |
Ключевое слово
Сегмент критериев ключевых слов.
| Поля | |
|---|---|
info | Информация по ключевым словам. |
ad_group_criterion | Имя ресурса AdGroupCriterion. |
KeywordInfo
Критерий ключевого слова.
| Поля | |
|---|---|
match_type | Тип соответствия ключевого слова. |
text | Текст ключевого слова (не более 80 символов и 10 слов). |
LanguageInfo
Критерий владения языком.
| Поля | |
|---|---|
language_constant | Имя ресурса языковой константы. |
ListingGroupInfo
Критерий для включения в список.
| Поля | |
|---|---|
type | Тип группы объявлений. |
LocationGroupInfo
Радиус вокруг списка местоположений, указанных в потоке данных.
| Поля | |
|---|---|
geo_target_constants[] | Константы географической цели ограничивают область охвата в ленте. В настоящее время допускается только одна константа географической цели. |
radius_units | Единица измерения радиуса. Для констант географических целей поддерживаются мили и метры. Для наборов элементов ленты поддерживаются миллимили и метры. Это обязательное значение, которое необходимо задать в операциях CREATE. |
feed_item_sets[] | FeedItemSets, элементы FeedItems которых являются целевыми. Если указано несколько идентификаторов, то целевыми становятся все элементы, которые присутствуют хотя бы в одном наборе. Это поле нельзя использовать с geo_target_constants. Оно является необязательным и может быть установлено только в операциях CREATE. |
radius | Расстояние в единицах, указывающее радиус вокруг целевых местоположений. Это обязательный параметр, который необходимо задать в операции CREATE. |
Информация о местоположении
Критерий местоположения.
| Поля | |
|---|---|
geo_target_constant | Название ресурса константы географической цели. |
ManualCpa
Этот тип не содержит полей.
Стратегия ручного назначения ставок, позволяющая рекламодателю устанавливать ставку для каждого действия, указанного рекламодателем.
ManualCpc
Ручное назначение ставок по кликам, при котором пользователь платит за каждый клик.
| Поля | |
|---|---|
enhanced_cpc_enabled | Следует ли повышать ставки на основе данных оптимизатора конверсии? |
Ручной Cpm
Этот тип не содержит полей.
Ручное назначение ставок на основе показов, при котором пользователь платит за тысячу показов.
Максимизировать значение конверсии
Автоматизированная стратегия назначения ставок, которая поможет получить максимальную конверсию от ваших кампаний при оптимальном расходовании бюджета.
| Поля | |
|---|---|
cpc_bid_ceiling_micros | Максимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле. |
cpc_bid_floor_micros | Минимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле. |
target_roas | Параметр «Целевая рентабельность рекламных расходов» (ROAS). Если он установлен, стратегия назначения ставок будет максимизировать доход, усредняя при этом целевую рентабельность рекламных расходов. Если целевой показатель ROAS высок, стратегия назначения ставок может не позволить потратить весь бюджет. Если целевой показатель ROAS не установлен, стратегия назначения ставок будет стремиться достичь максимально возможного показателя ROAS для бюджета. |
Максимизировать конверсии
Автоматизированная стратегия назначения ставок, которая поможет добиться максимальной конверсии в ваших кампаниях при оптимальном расходовании бюджета.
| Поля | |
|---|---|
cpc_bid_ceiling_micros | Максимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле. |
cpc_bid_floor_micros | Минимальный лимит ставки, устанавливаемый стратегией назначения ставок. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменяемый только для стратегий назначения ставок в портфеле. |
target_cpa_micros | Параметр целевой стоимости за действие (CPA). Это средняя сумма, которую вы хотели бы потратить на одно действие по конверсии, указанная в микроединицах валюты стратегии назначения ставок. Если этот параметр установлен, стратегия назначения ставок обеспечит максимально возможное количество конверсий по цене, равной или ниже целевой стоимости за действие. Если целевая стоимость за действие не установлена, стратегия назначения ставок будет стремиться достичь минимально возможной стоимости за действие с учетом бюджета. |
Метрики
Метрики данных.
| Поля | |
|---|---|
all_conversions_value_by_conversion_date | Значение всех конверсий. Если для этого столбца выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах |
all_conversions_by_conversion_date | Общее количество конверсий. Сюда входят все конверсии независимо от значения параметра include_in_conversions_metric. Если для этого столбца выбран параметр date, значения в столбце date означают дату конверсии. Подробная информация о столбцах |
conversion_custom_metrics[] | Пользовательские метрики конверсии. |
conversions_value_by_conversion_date | Сумма значений конверсий, доступных для участия в торгах, по дате конверсии. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. |
conversions_by_conversion_date | Сумма конверсий по дате конверсии для типов конверсий, доступных для размещения ставок. Может быть дробной из-за особенностей модели атрибуции. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. |
historical_creative_quality_score | Оценка качества творческого исторического контекста. |
historical_landing_page_quality_score | Качество восприятия исторической целевой страницы. |
historical_search_predicted_ctr | Прогнозируемый показатель кликабельности (CTR) на основе исторических данных поисковых запросов. |
interaction_event_types[] | Типы платных и бесплатных взаимодействий. |
raw_event_conversion_metrics[] | Исходные показатели конверсии событий. |
absolute_top_impression_percentage | Абсолютная доля показов в поисковой выдаче — это процент показов вашей рекламы в поиске, которые отображаются на наиболее заметной позиции в результатах поиска. |
all_conversions_from_interactions_rate | Количество конверсий, полученных в результате взаимодействия с сайтом (в отличие от конверсий, связанных с просмотром), деленное на количество взаимодействий с рекламой. |
all_conversions_value | Значение всех конверсий. |
all_conversions | Общее количество конверсий. Сюда входят все конверсии независимо от значения параметра include_in_conversions_metric. |
all_conversions_value_per_cost | Значение всех конверсий, деленное на общую стоимость взаимодействия с рекламой (например, клики для текстовых объявлений или просмотры для видеообъявлений). |
all_conversions_from_click_to_call | Количество нажатий кнопки «Позвонить» для связи с компанией во время или после просмотра рекламы. Это число не включает информацию о том, были ли звонки соединены, а также продолжительность звонков. Этот показатель применяется только к элементам корма. |
all_conversions_from_directions | Количество нажатий кнопки «Проложить маршрут» для перехода к нужному заведению после просмотра рекламного объявления. Этот показатель применяется только к элементам корма. |
all_conversions_from_interactions_value_per_interaction | Значение всех конверсий, полученных в результате взаимодействий, деленное на общее количество взаимодействий. |
all_conversions_from_menu | Количество раз, когда люди переходили по ссылке для просмотра меню компании после клика по рекламному объявлению. Этот показатель применяется только к элементам корма. |
all_conversions_from_order | Количество раз, когда люди разместили заказ в компании после клика по рекламному объявлению. Этот показатель применяется только к элементам корма. |
all_conversions_from_other_engagement | Количество других конверсий (например, оставление отзыва или сохранение местоположения для компании), произошедших после того, как люди кликнули на объявление. Этот показатель применяется только к элементам корма. |
all_conversions_from_store_visit | Примерное количество посещений сайта компанией после клика по рекламному объявлению. Этот показатель применяется только к элементам корма. |
visits | Клики, которые Search Ads 360 успешно зафиксировал и перенаправил на целевую страницу рекламодателя. |
all_conversions_from_store_website | Количество раз, когда пользователи переходили на URL-адрес компании после клика по рекламному объявлению. Этот показатель применяется только к элементам корма. |
average_cost | Средняя сумма, которую вы платите за одно взаимодействие. Эта сумма рассчитывается как общая стоимость ваших объявлений, деленная на общее количество взаимодействий. |
average_cpc | Общая стоимость всех кликов, деленная на общее количество полученных кликов. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
average_cpm | Средняя стоимость за тысячу показов (CPM). Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
clicks | Количество кликов. |
content_budget_lost_impression_share | Примерный процент случаев, когда ваша реклама могла быть показана в контекстно-медийной сети, но не была показана из-за слишком низкого бюджета. Примечание: Показатель «потерянная доля показов из-за бюджета на контент» отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
content_impression_share | Количество показов, полученных вами в контекстно-медийной сети, деленное на предполагаемое количество показов, на которые вы имели право. Примечание: Доля показов контента указывается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
content_rank_lost_impression_share | Примерный процент показов в контекстно-медийной сети, которые ваши объявления не получили из-за низкого рейтинга объявления. Примечание: Показатель потери доли показов из-за низкого рейтинга контента отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
conversions_from_interactions_rate | Среднее количество конверсий, соответствующих условиям размещения ставки (на основе взаимодействия), на одно взаимодействие, дающее право на конверсию. Показывает, как часто в среднем взаимодействие с объявлением приводит к конверсии, соответствующей условиям размещения ставки. |
client_account_conversions_value | Значение конверсий клиентских аккаунтов. Сюда входят только те действия конверсии, для которых атрибут |
conversions_value_per_cost | Значение конверсии, позволяющей сделать ставку, деленное на общую стоимость конверсии соответствующих взаимодействий. |
conversions_from_interactions_value_per_interaction | Значение конверсий от взаимодействий, деленное на количество взаимодействий с объявлением. Сюда входят только действия конверсии, для которых атрибут |
client_account_conversions | Количество конверсий клиентских аккаунтов. Сюда входят только те действия конверсии, для которых атрибут |
cost_micros | Сумма ваших затрат на клик (CPC) и стоимость за тысячу показов (CPM) за этот период. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. Дополнительные сведения см. в параметре |
cost_per_all_conversions | Стоимость взаимодействия с рекламой, деленная на общее количество конверсий. |
cost_per_conversion | Средняя допустимая стоимость конверсии на одну конверсию, при которой можно сделать ставку. |
cost_per_current_model_attributed_conversion | Стоимость взаимодействия с рекламой, деленная на количество конверсий, учитываемых текущей моделью. Это включает только те действия конверсии, для которых атрибут |
cross_device_conversions | Конверсии, возникающие, когда клиент кликает на объявление на одном устройстве, а затем совершает конверсию на другом устройстве или в другом браузере. Конверсии между устройствами уже включены в |
cross_device_conversions_by_conversion_date | Количество конверсий между устройствами по дате конверсии. Подробная информация о столбце |
cross_device_conversions_value | Сумма значений преобразований между устройствами. |
cross_device_conversions_value_by_conversion_date | Сумма значений конверсий между устройствами по дате |
ctr | Количество кликов по вашему объявлению (Клики), деленное на количество показов вашего объявления (Показы). |
conversions | Количество конверсий. Сюда входят только те действия конверсии, для которых атрибут include_in_conversions_metric установлен в значение true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
conversions_value | Сумма значений конверсий для конверсий, включенных в поле «Конверсии». Этот показатель полезен только в том случае, если вы ввели значение для ваших действий по конверсии. |
average_quality_score | Средний балл качества. |
historical_quality_score | Исторический показатель качества. |
impressions | Подсчет количества появлений вашего объявления на странице результатов поиска или на веб-сайте в сети Google. |
interaction_rate | Частота взаимодействия пользователей с вашей рекламой после её показа. Это количество взаимодействий, делённое на количество показов вашей рекламы. |
interactions | Количество взаимодействий. Взаимодействие — это основное действие пользователя, связанное с форматом объявления: клики для текстовых и товарных объявлений, просмотры для видеообъявлений и так далее. |
invalid_click_rate | Процент отфильтрованных кликов от общего числа кликов (отфильтрованные + неотфильтрованные) за отчетный период. |
invalid_clicks | Количество кликов, которые Google считает незаконными и за которые не взимает плату. |
general_invalid_click_rate | Процент кликов, отфильтрованных из общего числа кликов (отфильтрованные + неотфильтрованные) как недействительные. Это клики, которые Google считает нелегитимными и которые обнаруживаются с помощью стандартных методов фильтрации (то есть, известный недействительный трафик из дата-центров, боты и пауки или другие краулеры, нерегулярные шаблоны и т. д.). С них не взимается плата, и они не влияют на статистику вашего аккаунта. См. Фильтрация недействительного трафика для обеспечения качества . |
general_invalid_clicks | Количество общих недействительных кликов. Это подмножество ваших недействительных кликов, которые обнаруживаются с помощью стандартных методов фильтрации (например, известный недействительный трафик из дата-центра, боты и поисковые роботы, нестандартные шаблоны и т. д.). С вас за них не взимается плата, и они не влияют на статистику вашей учетной записи. См. Фильтрация недействительного трафика для обеспечения качества . |
mobile_friendly_clicks_percentage | Процент кликов с мобильных устройств, ведущих на страницу, оптимизированную для мобильных устройств. |
search_absolute_top_impression_share | Процент показов товарных или поисковых объявлений клиента, отображаемых на наиболее заметной позиции в товарной выдаче. Подробнее см. раздел «О показателях верхней и абсолютной верхней позиции» . Любое значение ниже 0,1 отображается как 0,0999. |
search_budget_lost_absolute_top_impression_share | Показатель, отражающий, как часто ваше объявление не занимало первое место в результатах поиска из-за недостаточного бюджета. Примечание: Потерянная доля показов в абсолютном выражении в верхнем диапазоне поискового бюджета отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_budget_lost_impression_share | Примерный процент случаев, когда ваше объявление могло быть показано в поисковой сети, но не было показано из-за слишком низкого бюджета. Примечание: Показатель «потерянные показы» в рамках поискового бюджета отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_budget_lost_top_impression_share | Примерный процент случаев, когда ваше объявление не отображалось рядом с верхними органическими результатами поиска из-за низкого бюджета. Примечание: Потерянная доля показов в поисковой выдаче отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_click_share | Количество кликов, полученных вами в поисковой сети, деленное на предполагаемое количество кликов, которые вы могли бы получить. Примечание: Доля кликов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
search_exact_match_impression_share | Количество полученных вами показов, разделенное на предполагаемое количество показов, которые вы могли получить в поисковой сети по поисковым запросам, точно соответствующим вашим ключевым словам (или являющимся близкими вариантами ваших ключевых слов), независимо от типов соответствия ключевых слов. Примечание: Доля показов при точном совпадении в результатах поиска отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
search_impression_share | Количество показов, полученных вами в поисковой сети, деленное на предполагаемое количество показов, на получение которых вы имели право. Примечание: Доля показов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. |
search_rank_lost_absolute_top_impression_share | Показатель, отражающий, как часто ваше объявление не занимало первое место в результатах поиска из-за низкого рейтинга объявления. Примечание: Потеря абсолютной доли показов в поисковой выдаче указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_rank_lost_impression_share | Примерный процент показов в поисковой сети, которые ваши объявления не получили из-за низкого рейтинга объявления. Примечание: доля потерянных показов в поисковой выдаче отображается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_rank_lost_top_impression_share | Показатель, отражающий, как часто ваше объявление не отображалось рядом с верхними органическими результатами поиска из-за низкого рейтинга объявления. Примечание: Потеря доли показов в поисковой выдаче указывается в диапазоне от 0 до 0,9. Любое значение выше 0,9 отображается как 0,9001. |
search_top_impression_share | Количество показов, полученных вами среди лучших объявлений, по сравнению с предполагаемым количеством показов, которые вы могли бы получить среди лучших объявлений. Примечание: Доля показов в поисковой выдаче отображается в диапазоне от 0,1 до 1. Любое значение ниже 0,1 отображается как 0,0999. Как правило, верхние рекламные объявления располагаются выше верхних органических результатов поиска, хотя по некоторым запросам они могут отображаться ниже верхних органических результатов. |
top_impression_percentage | Процент показов вашей рекламы, отображаемых рядом с верхними органическими результатами поиска. |
value_per_all_conversions | Значение всех конверсий, деленное на общее количество конверсий. |
value_per_all_conversions_by_conversion_date | Значение всех конверсий, деленное на общее количество конверсий. Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. Подробная информация о столбцах |
value_per_conversion | Значение конверсии, доступной для размещения ставки, деленное на количество таких конверсий. Показывает, сколько в среднем стоит каждая из таких конверсий. |
value_per_conversions_by_conversion_date | Значение конверсий, доступных для размещения ставок, в зависимости от даты конверсии, деленное на количество конверсий, доступных для размещения ставок, в зависимости от даты конверсии. Показывает, сколько в среднем стоит каждая из конверсий, доступных для размещения ставок (в зависимости от даты конверсии). Если в этом столбце выбрана дата, значения в столбце «Дата» означают дату конверсии. |
client_account_view_through_conversions | Общее количество конверсий, совершенных после просмотра. Это происходит, когда клиент видит изображение или мультимедийную рекламу, а затем совершает конверсию на вашем сайте, не взаимодействуя (например, не кликая) на другую рекламу. |
orders | «Заказы» — это общее количество конверсий покупок, полученных благодаря вашей рекламе. Как это работает: Вы отслеживаете конверсии с помощью данных корзины для завершенных покупок на вашем сайте. Если конверсия связана с предыдущими взаимодействиями с вашими объявлениями (клики для текстовых или товарных объявлений, просмотры для видеообъявлений и т. д.), она засчитывается как заказ. Пример: Кто-то кликнул на рекламное объявление в разделе «Товары для дома» и купил ту же шляпу и рубашку в одном заказе на вашем сайте. Даже если он купил два товара, это будет считаться одним заказом. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
average_order_value_micros | Средняя стоимость заказа — это средний доход, который вы получили с каждого заказа благодаря вашей рекламе. Как это работает: Вы отчитываетесь о конверсиях с помощью данных корзины для завершенных покупок на вашем веб-сайте. Средняя стоимость заказа — это общая выручка от ваших заказов, разделенная на общее количество заказов. Пример: Вы получили 3 заказа, которые принесли доход в размере 10, 15 и 20 долларов. Средняя стоимость заказа составляет 15 долларов = (10 + 15 + 20)/3. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
average_cart_size | Средний размер корзины — это среднее количество товаров в каждом заказе, оформленном с использованием вашей рекламы. Как это работает: Вы отчитываетесь о конверсиях, используя данные о корзине покупок, совершенных на вашем сайте. Средний размер корзины — это общее количество проданных товаров, деленное на общее количество полученных заказов. Пример: Вы получили 2 заказа, первый содержал 3 товара, а второй — 2. Средний размер корзины составляет 2,5 товара = (3+2)/2. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
cost_of_goods_sold_micros | Себестоимость проданных товаров (COGS) — это общая стоимость товаров, проданных вами по заказам, оформленным благодаря вашей рекламе. Как это работает: Вы можете добавить стоимость проданных товаров к каждому товару в Merchant Center. Если вы формируете отчеты о конверсиях с использованием данных корзины, проданные вами товары сопоставляются с их себестоимостью, и это можно использовать для расчета валовой прибыли, полученной с каждого заказа. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 8 долларов = 3 + 5 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
gross_profit_micros | Валовая прибыль — это прибыль, полученная вами от заказов, связанных с вашей рекламой, за вычетом себестоимости проданных товаров (COGS). Как это работает: Валовая прибыль — это выручка от продаж, совершенных благодаря вашей рекламе, за вычетом себестоимости реализованной продукции. Расчеты валовой прибыли включают только те товары, себестоимость реализованной продукции которых указана в Merchant Center. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Себестоимость проданных товаров для шляпы составляет 3 доллара, а для рубашки — нет. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поэтому она составит 7 долларов = 10 долларов - 3 доллара. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
gross_profit_margin | Валовая прибыль — это процент валовой прибыли, полученной вами от заказов, совершенных благодаря вашей рекламе, после вычета себестоимости проданных товаров (COGS). Как это работает: Вы формируете отчеты о конверсиях с данными о корзине покупок на вашем сайте. Валовая прибыль рассчитывается как валовая прибыль, разделенная на общую выручку и умноженная на 100%. Расчеты валовой прибыли включают только товары, для которых в Merchant Center указана себестоимость реализованной продукции. Пример: Кто-то купил шляпу и рубашку на вашем сайте. Шляпа стоит 10 долларов, а ее себестоимость проданных товаров составляет 3 доллара. Рубашка стоит 20 долларов, но ее себестоимость проданных товаров отсутствует. Валовая прибыль по этому заказу будет учитывать только стоимость шляпы, поскольку она имеет себестоимость проданных товаров, поэтому она составляет 70% = (10 долларов - 3 доллара) / 10 долларов x 100%. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
revenue_micros | Выручка — это общая сумма, которую вы получили от заказов, связанных с вашей рекламой. Как это работает: Вы отчитываетесь о конверсиях с данными о корзине покупок на вашем сайте. Доход — это общая стоимость всех заказов, полученных благодаря вашей рекламе, за вычетом любых скидок. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и затем купил ту же шляпу и рубашку в одном заказе на вашем сайте. Шляпа стоит 10 долларов, а рубашка — 20 долларов. На весь заказ действует скидка в 5 долларов. Доход от этого заказа составляет 25 долларов = (10 + 20) - 5. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
units_sold | Количество проданных единиц — это общее число товаров, проданных по заказам, оформленным на основе вашей рекламы. Как это работает: Вы отчитываетесь о конверсиях с данными о корзине покупок на вашем сайте. Количество проданных единиц — это общее число товаров, проданных по всем заказам, связанным с вашей рекламой. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, а затем купил ту же шляпу, рубашку и куртку. Количество проданных единиц в этом заказе — 3. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. |
client_account_cross_sell_cost_of_goods_sold_micros | Себестоимость проданных товаров (COGS) при перекрестных продажах по клиентскому счету — это общая стоимость товаров, проданных в результате рекламы другого продукта. Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если рекламное объявление, с которым взаимодействовал покупатель перед покупкой, имеет связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, размещенный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Стоимость проданных товаров в рамках перекрестной продажи — это общая стоимость проданных товаров, которые не были рекламируемыми. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
cross_sell_cost_of_goods_sold_micros | Перекрестные продажи (стоимость проданных товаров) — это общая стоимость товаров, проданных в результате рекламы другого продукта. Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если рекламное объявление, с которым взаимодействовал покупатель перед покупкой, имеет связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, размещенный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Стоимость проданных товаров в рамках перекрестной продажи — это общая стоимость проданных товаров, которые не были рекламируемыми. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Стоимость проданных товаров для шляпы составляет 3 доллара, для рубашки — 5 долларов. Стоимость проданных товаров для этого заказа составляет 5 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
client_account_cross_sell_gross_profit_micros | Валовая прибыль от перекрестных продаж по клиентскому счету — это прибыль, полученная вами от продажи товаров в результате рекламы другого продукта, за вычетом себестоимости реализованной продукции (COGS). Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым вы взаимодействовали перед покупкой, есть связанный товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в покупку, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж — это доход, полученный вами от перекрестных продаж, отнесенный к вашим объявлениям, за вычетом стоимости проданных товаров. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
cross_sell_gross_profit_micros | Валовая прибыль от перекрестных продаж — это прибыль, полученная от продажи товаров в результате рекламы другого продукта, за вычетом себестоимости реализованной продукции (COGS). Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым вы взаимодействовали перед покупкой, есть связанный товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в покупку, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж — это доход, полученный вами от перекрестных продаж, отнесенный к вашим объявлениям, за вычетом стоимости проданных товаров. Пример: Кто-то кликнул на рекламное объявление в интернет-магазине, где продавалась шляпа, и купил ту же шляпу и рубашку. Рубашка стоит 20 долларов, а себестоимость проданных товаров составляет 5 долларов. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов = 20 долларов - 5 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с использованием данных корзины. Этот показатель представляет собой денежную величину и по умолчанию возвращается в валюте клиента. См. параметр |
client_account_cross_sell_revenue_micros | Доход от перекрестных продаж через клиентские аккаунты — это общая сумма, которую вы получили от продажи товаров, ставшей результатом рекламы другого товара. Как это работает: Вы отчитываетесь о конверсиях с данными корзины для завершенных покупок на вашем веб-сайте. Если у объявления, с которым взаимодействовал покупатель перед покупкой, есть связанный с ним товар (см. Товарные объявления), то этот товар считается рекламируемым. Любой товар, включенный в заказ, оформленный покупателем, считается проданным товаром. Если эти товары не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж — это общая сумма, полученная вами от перекрестных продаж, связанных с вашими объявлениями. 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 |
cross_sell_revenue_micros | 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 |
client_account_cross_sell_units_sold | 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 | 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 | 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 |
lead_cost_of_goods_sold_micros | 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 |
client_account_lead_gross_profit_micros | 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 |
lead_gross_profit_micros | 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 |
client_account_lead_revenue_micros | 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 |
lead_revenue_micros | 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 |
client_account_lead_units_sold | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | Whether the campaign is opted in to real-time bidding. |
SearchAds360ExpandedDynamicSearchAdInfo
An expanded dynamic search ad.
| Поля | |
|---|---|
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ExpandedTextAdInfo
A Search Ads 360 expanded text ad. Expanded text ads are deprecated. Use SearchAds360ResponsiveSearchAd instead.
| Поля | |
|---|---|
headline | The headline of the ad. |
headline2 | The second headline of the ad. |
headline3 | The third headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ProductAdInfo
Этот тип не содержит полей.
A Search Ads 360 product ad.
SearchAds360ResponsiveSearchAdInfo
A Search Ads 360 responsive search ad.
| Поля | |
|---|---|
headlines[] | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
descriptions[] | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360TextAdInfo
A Search Ads 360 text ad.
| Поля | |
|---|---|
headline | The headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
display_url | The displayed URL of the ad. |
display_mobile_url | The displayed mobile URL of the ad. |
ad_tracking_id | The tracking id of the ad. |
Сегменты
Segment only fields.
| Поля | |
|---|---|
ad_format_type | Ad Format type. |
ad_network_type | Ad network type. |
conversion_action_category | Conversion action category. |
conversion_custom_dimensions[] | The conversion custom dimensions. |
day_of_week | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
keyword | Keyword criterion. |
product_channel | Channel of the product. |
product_channel_exclusivity | Channel exclusivity of the product. |
product_condition | Condition of the product. |
product_sold_condition | Condition of the product sold. |
raw_event_conversion_dimensions[] | The raw event conversion dimensions. |
conversion_action | Resource name of the conversion action. |
conversion_action_name | Conversion action name. |
date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
geo_target_city | Resource name of the geo target constant that represents a city. |
geo_target_country | Resource name of the geo target constant that represents a country. |
geo_target_metro | Resource name of the geo target constant that represents a metro. |
geo_target_postal_code | Resource name of the geo target constant that represents a postal code. |
geo_target_region | Resource name of the geo target constant that represents a region. |
hour | Hour of day as a number between 0 and 23, inclusive. |
month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
product_bidding_category_level1 | Bidding category (level 1) of the product. |
product_bidding_category_level2 | Bidding category (level 2) of the product. |
product_bidding_category_level3 | Bidding category (level 3) of the product. |
product_bidding_category_level4 | Bidding category (level 4) of the product. |
product_bidding_category_level5 | Bidding category (level 5) of the product. |
product_brand | Brand of the product. |
product_country | Resource name of the geo target constant for the country of sale of the product. |
product_custom_attribute0 | Custom attribute 0 of the product. |
product_custom_attribute1 | Custom attribute 1 of the product. |
product_custom_attribute2 | Custom attribute 2 of the product. |
product_custom_attribute3 | Custom attribute 3 of the product. |
product_custom_attribute4 | Custom attribute 4 of the product. |
product_item_id | Item ID of the product. |
product_language | Resource name of the language constant for the language of the product. |
product_sold_bidding_category_level1 | Bidding category (level 1) of the product sold. |
product_sold_bidding_category_level2 | Bidding category (level 2) of the product sold. |
product_sold_bidding_category_level3 | Bidding category (level 3) of the product sold. |
product_sold_bidding_category_level4 | Bidding category (level 4) of the product sold. |
product_sold_bidding_category_level5 | Bidding category (level 5) of the product sold. |
product_sold_brand | Brand of the product sold. |
product_sold_custom_attribute0 | Custom attribute 0 of the product sold. |
product_sold_custom_attribute1 | Custom attribute 1 of the product sold. |
product_sold_custom_attribute2 | Custom attribute 2 of the product sold. |
product_sold_custom_attribute3 | Custom attribute 3 of the product sold. |
product_sold_custom_attribute4 | Custom attribute 4 of the product sold. |
product_sold_item_id | Item ID of the product sold. |
product_sold_title | Title of the product sold. |
product_sold_type_l1 | Type (level 1) of the product sold. |
product_sold_type_l2 | Type (level 2) of the product sold. |
product_sold_type_l3 | Type (level 3) of the product sold. |
product_sold_type_l4 | Type (level 4) of the product sold. |
product_sold_type_l5 | Type (level 5) of the product sold. |
product_store_id | Store ID of the product. |
product_title | Title of the product. |
product_type_l1 | Type (level 1) of the product. |
product_type_l2 | Type (level 2) of the product. |
product_type_l3 | Type (level 3) of the product. |
product_type_l4 | Type (level 4) of the product. |
product_type_l5 | Type (level 5) of the product. |
quarter | 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 | The display names of participants in an event listing, like performers, speakers, or teams. |
vertical_ads_hotel_class | The class of the hotel. Generally in the range of 1 to 5 stars, but fully customizable in the hotel feed. |
vertical_ads_listing | The listing associated with a listing impression, click or conversion. |
vertical_ads_listing_brand | 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 | The city where the vertical ads listing is located. |
vertical_ads_listing_country | The country where the vertical ads listing is located. |
vertical_ads_listing_region | The region where the vertical ads listing is located. |
vertical_ads_partner_account | A specific partner account within a Partner Center (for example, Hotel Center) that supplies inventory feed data for Vertical Ads. |
vertical_ads_vertical | 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 | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year | Year, formatted as yyyy. |
asset_interaction_target | 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 | Indicates whether the content is considered synthetic by this source. |
source | 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 | Input provided by the advertiser. |
system_attestation | 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 | 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 | 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 | 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.
TargetRestriction
The list of per-targeting-dimension targeting settings.
| Поля | |
|---|---|
targeting_dimension | The targeting dimension that these settings apply to. |
bid_only | 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 |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
| Поля | |
|---|---|
target_roas | 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 | 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 | 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: 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 | 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[] | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
TextAsset
A Text asset.
| Поля | |
|---|---|
text | Text content of the text asset. |
TextLabel
A type of label displaying text on a colored background.
| Поля | |
|---|---|
background_color | Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
description | A short description of the label. The length must be no more than 200 characters. |
UnifiedCallAsset
A unified call asset.
| Поля | |
|---|---|
country_code | Two-letter country code of the phone number. Examples: 'US', 'us'. |
phone_number | The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
call_conversion_reporting_state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
call_conversion_action | 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[] | 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 | Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads. |
call_tracking_enabled | Whether the call should be enabled on call tracking. Applies to Microsoft Ads. |
use_searcher_time_zone | Whether to show the call extension in search user's time zone. Applies to Microsoft Ads. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
UnifiedCalloutAsset
A unified callout asset.
| Поля | |
|---|---|
callout_text | The callout text. The length of this string should be between 1 and 25, inclusive. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | 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 | Whether to show the asset in search user's time zone. Applies to Microsoft Ads. |
UnifiedLocationAsset
A unified location asset.
| Поля | |
|---|---|
place_id | 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[] | 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 | 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 | The webpage that advertisers want to target. |
labels[] | Labels used to group the page urls. |
UnifiedSitelinkAsset
A unified sitelink asset.
| Поля | |
|---|---|
link_text | URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
description1 | 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 | 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 | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | 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 | ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field. |
use_searcher_time_zone | Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads. |
mobile_preferred | 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 | The User List resource name. |
Ценить
A generic data container.
| Поля | |
|---|---|
Union field value . A value. value can be only one of the following: | |
boolean_value | A boolean. |
int64_value | An int64. |
float_value | A float. |
double_value | Двойной. |
string_value | Строка. |
WebpageConditionInfo
Logical expression for targeting webpages of an advertiser's website.
| Поля | |
|---|---|
operand | Operand of webpage targeting condition. |
operator | Operator of webpage targeting condition. |
argument | Argument of webpage targeting condition. |
WebpageInfo
Represents a criterion for targeting webpages of an advertiser's website.
| Поля | |
|---|---|
conditions[] | 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 | 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 | 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 | YouTube video title. |
youtube_video_id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |