Индекс
-
AdScheduleInfo
(сообщение) -
AdTextAsset
(сообщение) -
AgeRangeInfo
(сообщение) -
AssetInteractionTarget
(сообщение) -
AssetUsage
(сообщение) -
AudienceInfo
(сообщение) -
BusinessProfileLocation
(сообщение) -
CallToActionAsset
(сообщение) -
CustomParameter
(сообщение) -
DeviceInfo
(сообщение) -
EnhancedCpc
(сообщение) -
FrequencyCapEntry
(сообщение) -
GenderInfo
(сообщение) -
ImageAsset
(сообщение) -
ImageDimension
(сообщение) -
Keyword
(сообщение) -
KeywordInfo
(сообщение) -
LanguageInfo
(сообщение) -
ListingGroupInfo
(сообщение) -
LocationGroupInfo
(сообщение) -
LocationInfo
(сообщение) -
ManualCpa
(сообщение) -
ManualCpc
(сообщение) -
ManualCpm
(сообщение) -
MaximizeConversionValue
(сообщение) -
MaximizeConversions
(сообщение) -
Metrics
(сообщение) -
MobileAppAsset
(сообщение) -
PercentCpc
(сообщение) -
RealTimeBiddingSetting
(сообщение) -
SearchAds360ExpandedDynamicSearchAdInfo
(сообщение) -
SearchAds360ExpandedTextAdInfo
(сообщение) -
SearchAds360ProductAdInfo
(сообщение) -
SearchAds360ResponsiveSearchAdInfo
(сообщение) -
SearchAds360TextAdInfo
(сообщение) -
Segments
(сообщение) -
TargetCpa
(сообщение) -
TargetCpm
(сообщение) -
TargetImpressionShare
(сообщение) -
TargetOutrankShare
(сообщение) -
TargetRestriction
(сообщение) -
TargetRoas
(сообщение) -
TargetSpend
(сообщение) -
TargetingSetting
(сообщение) -
TextAsset
(сообщение) -
TextLabel
(сообщение) -
UnifiedCallAsset
(сообщение) -
UnifiedCalloutAsset
(сообщение) -
UnifiedLocationAsset
(сообщение) -
UnifiedPageFeedAsset
(сообщение) -
UnifiedSitelinkAsset
(сообщение) -
UserListInfo
(сообщение) -
Value
(сообщение) -
WebpageConditionInfo
(сообщение) -
WebpageInfo
(сообщение) -
YoutubeVideoAsset
(сообщение)
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 | Текст актива. |
Возрастной диапазонИнформация
Критерий возрастного диапазона.
Поля | |
---|---|
type | Тип возрастного диапазона. |
Цель взаимодействия активов
Сегмент AssetInteractionTarget.
Поля | |
---|---|
asset | Имя ресурса актива. |
interaction_on_this_asset | Используется только с метриками CustomerAsset, CampaignAsset и AdGroupAsset. Указывает, произошли ли метрики взаимодействия с самим объектом или с другим объектом или рекламным блоком. |
Использование активов
Содержит информацию об использовании актива.
Поля | |
---|---|
asset | Имя ресурса актива. |
served_asset_field_type | Тип обслуживаемого поля актива. |
Информация об аудитории
Критерий аудитории.
Поля | |
---|---|
audience | Имя ресурса аудитории. |
БизнесПрофильМестоположение
Данные о местоположении бизнес-профиля синхронизируются из связанной учетной записи бизнес-профиля.
Поля | |
---|---|
labels[] | Метка местоположения, указанная рекламодателем в аккаунте профиля компании. Это синхронизируется с учетной записью бизнес-профиля. |
store_code | Код магазина этого местоположения в профиле компании. Это синхронизируется с учетной записью бизнес-профиля. |
listing_id | Идентификатор листинга этого местоположения в профиле компании. Они синхронизируются со связанной учетной записью бизнес-профиля. |
Каллтоактионассет
Призыв к действию.
Поля | |
---|---|
call_to_action | Призыв к действию. |
Пользовательский параметр
Сопоставление, которое может использоваться тегами специальных параметров в tracking_url_template
, final_urls
или mobile_final_urls
.
Поля | |
---|---|
key | Ключ, соответствующий имени тега параметра. |
value | Значение, подлежащее замене. |
Информация об устройстве
Критерий устройства.
Поля | |
---|---|
type | Тип устройства. |
Улучшенная цена за клик
Этот тип не имеет полей.
Стратегия автоматического назначения ставок, которая повышает ставки для кликов, которые с большей вероятностью приведут к конверсии, и снижает их для кликов, которые кажутся менее вероятными.
Эта стратегия назначения ставок устарела и больше не может быть создана. Используйте ManualCpc с параметром Enhanced_cpc_enabled, установленным в значение true для эквивалентной функциональности.
Частота ограничения ввода
Этот тип не имеет полей.
Правило, определяющее максимальное количество раз, которое объявление (или некоторый набор объявлений) может быть показано пользователю в течение определенного периода времени.
Гендерная информация
Половой критерий.
Поля | |
---|---|
type | Тип пола. |
ImageAsset
Ресурс изображения.
Поля | |
---|---|
mime_type | MIME-тип изображения. |
full_size | Метаданные для этого изображения в исходном размере. |
file_size | Размер файла изображения в байтах. |
Размер изображения
Метаданные для изображения определенного размера, исходного или измененного.
Поля | |
---|---|
height_pixels | Высота изображения. |
width_pixels | Ширина изображения. |
url | URL-адрес, который возвращает изображение с этой высотой и шириной. |
Ключевое слово
Сегмент критерия ключевого слова.
Поля | |
---|---|
info | Информация о ключевом слове. |
ad_group_criterion | Имя ресурса AdGroupCriterion. |
Информация о ключевом слове
Критерий ключевого слова.
Поля | |
---|---|
match_type | Тип соответствия ключевого слова. |
text | Текст ключевого слова (максимум 80 символов и 10 слов). |
Информация о языке
Языковой критерий.
Поля | |
---|---|
language_constant | Имя ресурса языковой константы. |
Информация о группе
Критерий группы листинга.
Поля | |
---|---|
type | Тип группы объявлений. |
МестоположениеГруппаИнформация
Радиус вокруг списка местоположений, указанного в фиде.
Поля | |
---|---|
geo_target_constants[] | Целевые географические константы, ограничивающие объем географической области в фиде. В настоящее время разрешена только одна константа географической цели. |
radius_units | Единица радиуса. Для постоянных географических целей поддерживаются мили и метры. Для наборов элементов фида поддерживаются миллимили и метры. Это является обязательным и должно быть установлено в операциях CREATE. |
feed_item_sets[] | FeedItemSets, FeedItems которых являются целевыми. Если указано несколько идентификаторов, то целевыми будут все элементы, которые встречаются хотя бы в одном наборе. Это поле нельзя использовать с geo_target_constants. Это необязательно и может быть установлено только в операциях CREATE. |
radius | Расстояние в единицах, определяющее радиус вокруг целевых местоположений. Это является обязательным и должно быть установлено в операциях CREATE. |
Информация о местоположении
Критерий местоположения.
Поля | |
---|---|
geo_target_constant | Имя постоянного ресурса географической цели. |
Ручная цена за конверсию
Этот тип не имеет полей.
Стратегия назначения ставок вручную, которая позволяет рекламодателю устанавливать ставку за каждое действие, указанное рекламодателем.
Ручная цена за клик
Назначение ставок вручную на основе кликов, при котором пользователь платит за клик.
Поля | |
---|---|
enhanced_cpc_enabled | Следует ли повышать ставки на основе данных оптимизатора конверсий. |
Ручная цена за тысячу показов
Этот тип не имеет полей.
Назначение ставок вручную на основе показов, при котором пользователь платит за тысячу показов.
Максимизироватьконверсионвалуе
Стратегия автоматического назначения ставок, которая поможет получить максимальную ценность конверсий для ваших кампаний, расходуя при этом бюджет.
Поля | |
---|---|
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменяемо только для пакетных стратегий назначения ставок. |
cpc_bid_floor_micros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменяемо только для пакетных стратегий назначения ставок. |
target_roas | Опция целевой рентабельности инвестиций в рекламу (ROAS). Если этот параметр установлен, стратегия назначения ставок будет максимизировать доход при усреднении целевой рентабельности инвестиций в рекламу. Если целевая рентабельность инвестиций в рекламу высока, стратегия назначения ставок может оказаться не в состоянии израсходовать весь бюджет. Если целевая рентабельность инвестиций в рекламу не задана, стратегия назначения ставок будет направлена на достижение максимально возможной рентабельности инвестиций в рекламу в рамках бюджета. |
Максимизация конверсий
Стратегия автоматического назначения ставок, которая поможет получить максимальное количество конверсий в ваших кампаниях, расходуя при этом бюджет.
Поля | |
---|---|
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменяемо только для пакетных стратегий назначения ставок. |
cpc_bid_floor_micros | Минимальный предел ставки, который может быть установлен стратегией назначения ставок. Ограничение распространяется на все ключевые слова, управляемые стратегией. Изменяемо только для пакетных стратегий назначения ставок. |
target_cpa_micros | Вариант целевой цены за действие (CPA). Это средняя сумма, которую вы готовы потратить за действие-конверсию, указанная в микроединицах валюты стратегии назначения ставок. Если этот параметр установлен, стратегия назначения ставок обеспечит как можно больше конверсий по целевой цене за действие или ниже. Если целевая цена за конверсию не установлена, стратегия назначения ставок будет направлена на достижение минимально возможной цены за конверсию с учетом бюджета. |
Метрики
Данные метрик.
Поля | |
---|---|
all_conversions_value_by_conversion_date | Ценность всех конверсий. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти на странице https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | Общее количество конверсий. Сюда входят все конверсии независимо от значения include_in_conversions_metric. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти на странице https://support.google.com/sa360/answer/9250611 . |
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 | Общая стоимость всех кликов, разделенная на общее количество полученных кликов. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
average_cpm | Средняя цена за тысячу показов (CPM). Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
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 | Ценность конверсий клиентского аккаунта. Сюда входят только те действия-конверсии, для которых атрибуту include_in_client_account_conversions_metric присвоено значение true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
conversions_value_per_cost | Ценность конверсии, подлежащей назначению ставки, разделенная на общую стоимость взаимодействий, отвечающих критериям конверсии. |
conversions_from_interactions_value_per_interaction | Ценность конверсий от взаимодействий, разделенная на количество взаимодействий с рекламой. Сюда входят только те действия-конверсии, для которых атрибуту include_in_conversions_metric присвоено значение true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
client_account_conversions | Количество конверсий клиентского аккаунта. Сюда входят только те действия-конверсии, для которых атрибуту include_in_client_account_conversions_metric присвоено значение true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
cost_micros | Сумма затрат на цену за клик (CPC) и цену за тысячу показов (CPM) за этот период. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cost_per_all_conversions | Стоимость взаимодействий с рекламой, разделенная на все конверсии. |
cost_per_conversion | Средняя допущенная цена за конверсию, подлежащую назначению ставок. |
cost_per_current_model_attributed_conversion | Стоимость взаимодействий с рекламой, разделенная на количество конверсий, связанных с текущей моделью. Сюда входят только те действия-конверсии, для которых атрибуту include_in_conversions_metric присвоено значение true. Если вы используете назначение ставок на основе конверсий, ваши стратегии назначения ставок будут оптимизированы для этих конверсий. |
cross_device_conversions | Конверсии, когда клиент нажимает на рекламу на одном устройстве, а затем совершает конверсию на другом устройстве или в браузере. Конверсии в результате взаимодействий на нескольких устройствах уже включены в all_conversions. |
cross_device_conversions_by_conversion_date | Количество конверсий на нескольких устройствах по дате конверсии. Подробную информацию о столбцах by_conversion_date можно найти на странице https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | Сумма ценности конверсий в результате взаимодействий на нескольких устройствах. |
cross_device_conversions_value_by_conversion_date | Сумма ценности конверсий в результате взаимодействий на нескольких устройствах по дате конверсии. Подробную информацию о столбцах by_conversion_date можно найти на странице https://support.google.com/sa360/answer/9250611 . |
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 считает незаконными и которые обнаруживаются с помощью обычных средств фильтрации (т. е. известного недействительного трафика центра обработки данных, ботов и пауков или других сканеров, нестандартных шаблонов и т. д.). За них не взимается плата, и они не влияют на статистику вашего аккаунта. Подробную информацию можно найти на странице справки по адресу https://support.google.com/campaignmanager/answer/6076504 . |
general_invalid_clicks | Количество общих недействительных кликов. Это подмножество недействительных кликов, которые обнаруживаются с помощью обычных средств фильтрации (таких как известный недействительный трафик центров обработки данных, боты и пауки или другие сканеры, нерегулярные шаблоны и т. д.). За них не взимается плата, и они не влияют на статистику вашего аккаунта. Подробную информацию можно найти на странице справки по адресу https://support.google.com/campaignmanager/answer/6076504 . |
mobile_friendly_clicks_percentage | Процент мобильных кликов, которые переходят на страницу, оптимизированную для мобильных устройств. |
search_absolute_top_impression_share | Процент показов товарных или поисковых объявлений клиента, которые показываются на наиболее заметной позиции в покупках. Подробности см. на странице https://support.google.com/sa360/answer/9566729 . Любое значение ниже 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 | Ценность всех конверсий, разделенная на количество всех конверсий. Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. Подробную информацию о столбцах by_conversion_date можно найти на странице https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | Ценность конверсий с возможностью назначения ставок, разделенная на количество конверсий с возможностью назначения ставок. Показывает, сколько в среднем стоит каждая конверсия, подлежащая назначению ставок. |
value_per_conversions_by_conversion_date | Ценность конверсий с возможностью назначения ставок по дате конверсии, разделенная на число конверсий с возможностью назначения ставок по дате конверсии. Показывает среднюю ценность каждой из конверсий, подлежащих назначению ставок (по дате конверсии). Если этот столбец выбран с датой, значения в столбце даты означают дату конверсии. |
client_account_view_through_conversions | Общее количество конверсий по показам. Это происходит, когда клиент видит графическое или мультимедийное объявление, а затем совершает конверсию на вашем сайте, не взаимодействуя с другим объявлением (например, не нажимая на него). |
client_account_cross_sell_cost_of_goods_sold_micros | Себестоимость проданных товаров при перекрестных продажах на клиентском счете (COGS) — это общая стоимость продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Себестоимость проданных товаров при перекрестных продажах — это общая стоимость проданных товаров, которые не рекламировались. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость перекрестной продажи товаров, проданных по этому заказу, составляет 5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cross_sell_cost_of_goods_sold_micros | Себестоимость проданных товаров при перекрестных продажах (COGS) — это общая стоимость продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Себестоимость проданных товаров при перекрестных продажах — это общая стоимость проданных товаров, которые не рекламировались. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость перекрестной продажи товаров, проданных по этому заказу, составляет 5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
client_account_cross_sell_gross_profit_micros | Валовая прибыль от перекрестных продаж на клиентском счете – это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в покупку, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж – это доход, полученный вами от перекрестных продаж, связанных с вашей рекламой, за вычетом стоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена рубашки составляет 20 долларов США, а себестоимость реализованной продукции составляет 5 долларов США. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов США = 20–5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cross_sell_gross_profit_micros | Валовая прибыль от перекрестных продаж — это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (COGS). Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в покупку, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Валовая прибыль от перекрестных продаж – это доход, полученный вами от перекрестных продаж, связанных с вашей рекламой, за вычетом стоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Цена рубашки составляет 20 долларов США, а себестоимость реализованной продукции составляет 5 долларов США. Валовая прибыль от перекрестных продаж по этому заказу составляет 15 долларов США = 20–5 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
client_account_cross_sell_revenue_micros | Доход от перекрестных продаж клиентского аккаунта – это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж – это общая прибыль, которую вы получили от перекрестных продаж, связанных с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от перекрестных продаж этого заказа составляет 20 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
cross_sell_revenue_micros | Доход от перекрестных продаж — это общая сумма, которую вы заработали на продуктах, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Доход от перекрестных продаж – это общая прибыль, которую вы получили от перекрестных продаж, связанных с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Шляпа стоит 10 долларов, а рубашка — 20 долларов. Доход от перекрестных продаж этого заказа составляет 20 долларов США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
client_account_cross_sell_units_sold | Проданные единицы перекрестных продаж на клиентском счете – это общее количество продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Проданные единицы перекрестных продаж – это общее количество продуктов перекрестной продажи по всем заказам, связанным с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество перекрестных продаж, проданных в этом заказе, равно 2. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
cross_sell_units_sold | Проданные единицы перекрестных продаж — это общее количество продуктов, проданных в результате рекламы другого продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым взаимодействовали перед покупкой, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если эти продукты не совпадают, это считается перекрестной продажей. Проданные единицы перекрестных продаж – это общее количество продуктов перекрестной продажи по всем заказам, связанным с вашей рекламой. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу, рубашку и куртку. Количество перекрестных продаж, проданных в этом заказе, равно 2. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. |
client_account_lead_cost_of_goods_sold_micros | Себестоимость проданных товаров по счету клиента (COGS) — это общая стоимость продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым осуществлялось взаимодействие, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемая и продаваемая продукция совпадают, то стоимость этих товаров учитывается в составе себестоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость лида товаров, проданных по этому заказу, составляет 3 доллара США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
lead_cost_of_goods_sold_micros | Стоимость проданных товаров (COGS) — это общая стоимость продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсиях с данными корзины для совершенных покупок на своем веб-сайте. Если с объявлением, с которым осуществлялось взаимодействие, связан продукт (см. «Товарные объявления»), то этот продукт считается рекламируемым. Любой продукт, включенный в заказ клиента, является проданным продуктом. Если рекламируемая и продаваемая продукция совпадают, то стоимость этих товаров учитывается в составе себестоимости проданных товаров. Пример. Кто-то нажал на товарное объявление о шляпе, а затем купил такую же шляпу и рубашку. Себестоимость проданного товара для шляпы составляет 3 доллара, себестоимость проданного товара для рубашки — 5 долларов. Стоимость лида товаров, проданных по этому заказу, составляет 3 доллара США. Этот показатель доступен только в том случае, если вы сообщаете о конверсиях с данными корзины. Эта метрика имеет денежную величину и по умолчанию возвращается в валюте клиента. См. Параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_gross_profit_micros | Клиентская учетная запись Ведущая валовая прибыль - это прибыль, которую вы получили из продуктов, проданных в результате рекламы того же продукта, минус стоимость проданных товаров (Cogs). Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то доход, который вы принесли из этих продаж за вычетом стоимости проданных товаров, является вашей ведущей валовой прибылью. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу и рубашку. Шляпа по цене 10 долларов и имеет стоимость проданной товаров в размере 3 долл. США. Ведущая валовая прибыль этого заказа составляет $ 7 = 10 - 3 долл. США. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. Этот показатель является денежной стоимостью и возвращается в валюту клиента по умолчанию. См. Параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_gross_profit_micros | Ведущая валовая прибыль - это прибыль, которую вы получили из продуктов, проданных в результате рекламы того же продукта, минус стоимость проданных товаров (Cogs). Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то доход, который вы принесли из этих продаж за вычетом стоимости проданных товаров, является вашей ведущей валовой прибылью. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу и рубашку. Шляпа по цене 10 долларов и имеет стоимость проданной товаров в размере 3 долл. США. Ведущая валовая прибыль этого заказа составляет $ 7 = 10 - 3 долл. США. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. Этот показатель является денежной стоимостью и возвращается в валюту клиента по умолчанию. См. Параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_revenue_micros | Выручка в качестве клиентской учетной записи - это общая сумма, которую вы изготовили из продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то общая стоимость, которую вы сделали из продаж этих продуктов, отображается в результате выручки. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу и рубашку. Шляпа по цене 10 долларов, а рубашка - 20 долларов. Ведущий доход этого заказа составляет 10 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. Этот показатель является денежной стоимостью и возвращается в валюту клиента по умолчанию. См. Параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_revenue_micros | Ведущий доход - это общая сумма, которую вы сделали из продуктов, проданных в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то общая стоимость, которую вы сделали из продаж этих продуктов, отображается в результате выручки. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу и рубашку. Шляпа по цене 10 долларов, а рубашка - 20 долларов. Ведущий доход этого заказа составляет 10 долларов. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. Этот показатель является денежной стоимостью и возвращается в валюту клиента по умолчанию. См. Параметр metrics_currency по адресу https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_units_sold | Проданные ведущие единицы учетной записи - это общее количество продуктов, продаваемых в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то общее количество проданных продуктов показано под проданными единицами. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу, рубашку и куртку. Ведущие единицы, продаваемые в этом порядке, составляет 1. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. |
lead_units_sold | Проданные ведущие единицы - это общее количество продуктов, продаваемых в результате рекламы того же продукта. Как это работает: вы сообщаете о конверсии с данными CART для завершенных покупок на вашем сайте. Если реклама, с которой было взаимодействовано до покупки, есть связанный продукт (см. Объявления для покупок), то этот продукт считается рекламируемым продуктом. Любой продукт, включенный в заказ, где клиентские места, является проданным продуктом. Если рекламируемые и проданные продукты совпадают, то общее количество проданных продуктов показано под проданными единицами. Пример: кто -то нажал на рекламу для покупок для шляпы, а затем купил ту же шляпу, рубашку и куртку. Ведущие единицы, продаваемые в этом порядке, составляет 1. Этот показатель доступен только в том случае, если вы сообщаете о конверсии с данными CART. |
MobileAppasset
Актив, представляющий мобильное приложение.
Поля | |
---|---|
app_id | Необходимый. Строка, которая уникально идентифицирует мобильное приложение. Он должен содержать только нативный идентификатор платформы, такой как «com.android.ebay» для Android или «12345689» для iOS. |
app_store | Необходимый. Хранилище приложения, которое распределяет это конкретное приложение. |
Процент CPC
Стратегия торгов, где ставки - это часть рекламируемой цены на что -то хорошее или услуги.
Поля | |
---|---|
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Это необязательное поле, введенное рекламодателем и указанное в локальных Micros. Примечание. Нулевое значение интерпретируется так же, как и BID_CEILINE не определен. |
enhanced_cpc_enabled | Регулирует ставку для каждого аукциона вверх или вниз, в зависимости от вероятности конверсии. Отдельные предложения могут превышать CPC_BID_CEILING_MICROS, но средняя сумма предложения для кампании не должна. |
RealtimeBiddingsetting
Настройки для торгов в реальном времени, функция, доступная только для кампаний, предназначенных для сети AD Exchange.
Поля | |
---|---|
opt_in | Будет ли кампания выбрана в торговые центры в реальном времени. |
SearchAds360ExpededDynamicsearchAdinfo
Расширенная динамическая поисковая объявление.
Поля | |
---|---|
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
ad_tracking_id | Идентификатор отслеживания объявления. |
SEARKADS360EXPANEDTEXTADINFO
Поисковая реклама 360 Расширенная текстовая объявление.
Поля | |
---|---|
headline | Заголовок объявления. |
headline2 | Второй заголовок объявления. |
headline3 | Третий заголовок объявления. |
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
path1 | Текст добавил к автоматически генерируемому видимому URL с разделителем. |
path2 | Текст добавлен в Path1 с разделителем. |
ad_tracking_id | Идентификатор отслеживания объявления. |
SearchAds360ProductAdinfo
Этот тип не имеет полей.
Поисковая реклама 360 AD.
SearchAds360RessionsiveSearchAdinfo
Поисковое объявление 360 Акцентивное поисковое объявление.
Поля | |
---|---|
headlines[] | Список текстовых активов для заголовков. Когда объявление обслуживает заголовки, будет выбран из этого списка. |
descriptions[] | Список текстовых активов для описаний. Когда объявление служит описаниям из этого списка. |
path1 | Текст добавил к автоматически генерируемому видимому URL с разделителем. |
path2 | Текст добавлен в Path1 с разделителем. |
ad_tracking_id | Идентификатор отслеживания объявления. |
SearchAds360TextAdinfo
Поисковая реклама 360 Текстовое объявление.
Поля | |
---|---|
headline | Заголовок объявления. |
description1 | Первая строка описания объявления. |
description2 | Вторая строка описания объявления. |
display_url | Отображаемый URL объявления. |
display_mobile_url | Отображаемый мобильный URL объявления. |
ad_tracking_id | Идентификатор отслеживания объявления. |
Сегменты
Сегмент только поля.
Поля | |
---|---|
ad_network_type | Тип сети рекламы. |
conversion_action_category | Категория действий конверсии. |
conversion_custom_dimensions[] | Измерения обычаи преобразования. |
day_of_week | День недели, например, в понедельник. |
device | Устройство, к которому применяются метрики. |
keyword | Ключевой критерий. |
product_channel | Канал продукта. |
product_channel_exclusivity | Эксклюзивность канала продукта. |
product_condition | Состояние продукта. |
product_sold_condition | Состояние проданного продукта. |
raw_event_conversion_dimensions[] | Размеры преобразования необработанных событий. |
conversion_action | Название ресурса действия преобразования. |
conversion_action_name | Имя действия преобразования. |
date | Дата, на которую применяются метрики. Формат yyyy-mm-dd, например, 2018-04-17. |
geo_target_city | Название ресурса константы Geo Target, которая представляет город. |
geo_target_country | Название ресурса константы Geo Target, которая представляет страну. |
geo_target_metro | Название ресурса константы Geo Target, которая представляет метро. |
geo_target_region | Название ресурса целевой константы GEO, которая представляет регион. |
hour | Час дня как число от 0 до 23, включительно. |
month | Месяц, как представлен датой первого дня месяца. Отформатируется как yyyy-mm-dd. |
product_bidding_category_level1 | Категория торгов (уровень 1) продукта. |
product_bidding_category_level2 | Категория торгов (уровень 2) продукта. |
product_bidding_category_level3 | Категория торгов (уровень 3) продукта. |
product_bidding_category_level4 | Категория торгов (уровень 4) продукта. |
product_bidding_category_level5 | Категория торгов (уровень 5) продукта. |
product_brand | Бренд продукта. |
product_country | Название ресурса константы Geo Target для страны продажи продукта. |
product_custom_attribute0 | Пользовательский атрибут 0 продукта. |
product_custom_attribute1 | Пользовательский атрибут 1 продукта. |
product_custom_attribute2 | Пользовательский атрибут 2 продукта. |
product_custom_attribute3 | Пользовательский атрибут 3 продукта. |
product_custom_attribute4 | Пользовательский атрибут 4 продукта. |
product_item_id | Идентификатор продукта продукта. |
product_language | Название ресурса постоянной языка для языка продукта. |
product_sold_bidding_category_level1 | Категория торгов (уровень 1) проданного продукта. |
product_sold_bidding_category_level2 | Категория торгов (уровень 2) проданного продукта. |
product_sold_bidding_category_level3 | Категория торгов (уровень 3) проданного продукта. |
product_sold_bidding_category_level4 | Категория торгов (уровень 4) проданного продукта. |
product_sold_bidding_category_level5 | Категория торгов (уровень 5) проданного продукта. |
product_sold_brand | Бренд продукта продан. |
product_sold_custom_attribute0 | Пользовательский атрибут 0 проданного продукта. |
product_sold_custom_attribute1 | Пользовательский атрибут 1 проданного продукта. |
product_sold_custom_attribute2 | Пользовательский атрибут 2 проданного продукта. |
product_sold_custom_attribute3 | Пользовательский атрибут 3 проданного продукта. |
product_sold_custom_attribute4 | Пользовательский атрибут 4 проданного продукта. |
product_sold_item_id | Идентификатор товара проданного продукта. |
product_sold_title | Название проданного продукта. |
product_sold_type_l1 | Тип (уровень 1) проданного продукта. |
product_sold_type_l2 | Тип (уровень 2) проданного продукта. |
product_sold_type_l3 | Тип (уровень 3) проданного продукта. |
product_sold_type_l4 | Тип (уровень 4) проданного продукта. |
product_sold_type_l5 | Тип (уровень 5) проданного продукта. |
product_store_id | Идентификатор магазина продукта. |
product_title | Название продукта. |
product_type_l1 | Тип (уровень 1) продукта. |
product_type_l2 | Тип (уровень 2) продукта. |
product_type_l3 | Тип (уровень 3) продукта. |
product_type_l4 | Тип (уровень 4) продукта. |
product_type_l5 | Тип (уровень 5) продукта. |
quarter | Квартал, как представлен датой первого дня четверти. Например, использует календарный год для кварталов, второй квартал 2018 года начинается с 2018-04-01. Отформатируется как yyyy-mm-dd. |
week | Неделя, определенная как с понедельника по воскресенье, и представлена датой понедельника. Отформатируется как yyyy-mm-dd. |
year | Год, отформатированный как yyyy. |
asset_interaction_target | Используется только с показателями CultipsAsset, CamomeAsset и Adgroupasset. Указывает, произошли ли показатели взаимодействия на самом активе или в другом активе или блоке AD. Взаимодействия (например, клики) подсчитываются во всех частях обслуживаемого объявления (например, сама AD и другие компоненты, такие как SiteLinks), когда они обслуживаются вместе. Когда interaction_on_this_asset является истинной, это означает, что взаимодействия находятся на этом конкретном активе, и когда Interaction_on_this_asset является ложным, это означает, что взаимодействия не на этом конкретном активе, а в других частях обслуживаемого AD. Этот актив обслуживается. |
TargetCpa
Автоматизированная стратегия ставки, которая устанавливает ставки, чтобы помочь получить как можно больше конверсий в целевой стоимости за затраты на получение (CPA), которую вы устанавливаете.
Поля | |
---|---|
target_cpa_micros | Средняя цель CPA. Эта цель должна быть больше или равна минимально оплачиваемой единице на основе валюты для учетной записи. |
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Это должно быть установлено только для стратегий портфеля. |
cpc_bid_floor_micros | Минимальный лимит ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Это должно быть установлено только для стратегий портфеля. |
TargetCpm
Этот тип не имеет полей.
Целевой CPM (стоимость за тысячу показов) - это автоматическая стратегия ставок, которая устанавливает ставки для оптимизации производительности, учитывая целевую CPM, которую вы устанавливаете.
TargetRestriction
Список настройки таргетинга из-за цели.
Поля | |
---|---|
targeting_dimension | Измерение таргетинга, к которому применяются эти настройки. |
bid_only | Указывает, ограничить ли ваши объявления показать только для критериев, которые вы выбрали для этого Targeting_dimension, или нацеливаться на все значения для этого Targeting_dimension и показывать объявления на основе вашего таргетирования в других целевых показателях. Значение |
TargetRoas
Автоматизированная стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS).
Поля | |
---|---|
target_roas | Необходимый. Выбранный доход (на основе данных конверсии) на единицу расходов. Значение должно быть от 0,01 до 1000,0, включительно. |
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Это должно быть установлено только для стратегий портфеля. |
cpc_bid_floor_micros | Минимальный лимит ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Это должно быть установлено только для стратегий портфеля. |
TargetSpend
Автоматизированная стратегия ставки, которая устанавливает ваши заявки, чтобы помочь получить как можно больше кликов в рамках вашего бюджета.
Поля | |
---|---|
target_spend_micros | Установилось: цель траттов, по которой можно максимизировать щелчки. Участник TargetSpend попытается потратить меньшую часть этой стоимости или на естественную сумму затрат на дросселирование. Если не указано, бюджет используется в качестве цели расходов. Это поле устарело и больше не должно использоваться. См . |
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. |
Нацеливание
Настройки для функций, связанных с таргетингом, на уровнях кампании и групп рекламы. Для получения более подробной информации о настройке таргетинга, посетите https://support.google.com/google-ads/answer/7365594
Поля | |
---|---|
target_restrictions[] | Настройка измерения в течение целей для ограничения охвата вашей кампании или рекламной группы. |
Текстовый
Текстовый актив.
Поля | |
---|---|
text | Текстовое содержание текстового актива. |
Textlabel
Тип метки, отображающего текст на цветном фоне.
Поля | |
---|---|
background_color | Фоновый цвет ярлыка в шестнадцатеричном формате. Эта строка должна соответствовать регулярному выражению '^#([A-FA-F0-9] {6} | [A-FA-F0-9] {3}) $'. Примечание. Цвет фона не может быть виден для учетных записей менеджера. |
description | Краткое описание этикетки. Длина должна быть не более 200 символов. |
UnifiedCallasset
Объединенное вызов.
Поля | |
---|---|
country_code | Двухбуктный код страны номера телефона. Примеры: «США», «США». |
phone_number | Номер телефона рекламодателя. Примеры: '1234567890', '(123) 456-7890' |
call_conversion_reporting_state | Указывает, должен ли этот Callasset использовать свой собственный настройка преобразования вызовов, следить за настройкой уровня учетной записи или отключить преобразование вызовов. |
call_conversion_action | Действие преобразования, чтобы приписать конверсию вызова. Если не установлено, используется действие преобразования по умолчанию. Это поле имеет эффект, только если call_conversion_reporting_state установлен на use_resource_level_call_conversion_action. |
ad_schedule_targets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
call_only | Показывает ли звонок только номер телефона без ссылки на веб -сайт. Применяется к рекламе Microsoft. |
call_tracking_enabled | Должен ли вызов быть включен при отслеживании вызовов. Применяется к рекламе Microsoft. |
use_searcher_time_zone | Показать расширение вызова в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
start_date | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
end_date | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
UnifiedCalloutasset
Объединенное вынововое актив.
Поля | |
---|---|
callout_text | Текст вызовов. Длина этой строки должна быть от 1 до 25, включительно. |
start_date | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
end_date | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
ad_schedule_targets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
use_searcher_time_zone | Показать активу в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
UnifiedLocationAsset
Объединенное местоположение актива.
Поля | |
---|---|
place_id | Поместите идентификаторы уникально идентифицировать место в базе данных Google Place и на картах Google. Это поле уникально для данного идентификатора клиента и типа активов. См . |
business_profile_locations[] | Список бизнес -локаций для клиента. Это будет возвращено только в случае синхронизации местоположения с учетной записью профиля бизнеса. Можно иметь несколько списков бизнес -профилей в одной и той же учетной записи, которая указывает на один идентификатор места. |
location_ownership_type | Тип владения местоположением. Если тип Business_owner, он будет обслуживаться расширением местоположения. Если тип является партнером, он будет обслуживаться в качестве партнерского места. |
UnifiedPageFeedAsset
Объединенная страница.
Поля | |
---|---|
page_url | Веб -страница, на которую хотят нацелены рекламодатели. |
labels[] | Метки, используемые для группировки URL -адресов страницы. |
UnifiedSitelinkasset
Объединенный актив SiteLink.
Поля | |
---|---|
link_text | URL -отображение текст для SiteLink. Длина этой строки должна быть от 1 до 25, включительно. |
description1 | Первая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, инклюзивных, а также должно быть установлено описание2. |
description2 | Вторая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, включительно, а также должно быть установлено описание1. |
start_date | Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD. |
end_date | Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD. |
ad_schedule_targets[] | Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42. |
tracking_id | Идентификатор используется для отслеживания кликов для актива SiteLink. Это Yahoo! Япония только поле. |
use_searcher_time_zone | Показать активы SiteLink в часовом поясе пользователя поиска. Применяется к рекламе Microsoft. |
mobile_preferred | Является ли предпочтение для отображения актива SiteLink на мобильных устройствах. Применяется к рекламе Microsoft. |
UserListInfo
Критерий списка пользователей. Представляет список пользователей, который определяется рекламодателем для целевого.
Поля | |
---|---|
user_list | Имя ресурса в списке пользователей. |
Ценить
Общий контейнер данных.
Поля | |
---|---|
value поля профсоюза. Значение. value может быть только одним из следующих: | |
boolean_value | Логический. |
int64_value | Int64. |
float_value | Поплавок. |
double_value | Двойной. |
string_value | Строка. |
WebPageConditionInfo
Логическое выражение для нацеливания веб -страниц веб -сайта рекламодателя.
Поля | |
---|---|
operand | Операнд условия таргетинга веб -страницы. |
operator | Оператор условия таргетинга веб -страницы. |
argument | Аргумент условия таргетирования веб -страницы. |
Webpageinfo
Представляет собой критерий для нацеливания на веб -страницы веб -сайта рекламодателя.
Поля | |
---|---|
conditions[] | Условия или логические выражения, для таргетинга веб -страницы. Список условий таргетинга веб-страницы и объединен при оценке для таргетинга. Пустой список условий указывает на все страницы веб -сайта кампании. Это поле требуется для создания операций и запрещено в операциях обновления. |
coverage_percentage | Процент покрытия критериев веб -сайта. Это вычислимый процент освещения веб -сайтов, основанный на целевом целевом веб -сайте, отрицательной целевой и негативной ключевых словах в группе рекламы и кампании. Например, когда покрытие возвращается как 1, оно указывает, что оно имеет 100% покрытие. Это поле только для чтения. |
criterion_name | Имя критерия, который определяется этим параметром. Значение имени будет использоваться для идентификации, сортировки и фильтрации критериев с этим типом параметров. Это поле требуется для создания операций и запрещено в операциях обновления. |
Youtubevideoasset
Активы на YouTube.
Поля | |
---|---|
youtube_video_title | Название видео на YouTube. |
youtube_video_id | YouTube Video Id. Это 11 строкового значения символов, используемое в URL -адресе видео на YouTube. |
Индекс
-
AdScheduleInfo
(сообщение) -
AdTextAsset
(сообщение) -
AgeRangeInfo
(сообщение) -
AssetInteractionTarget
(сообщение) -
AssetUsage
(сообщение) -
AudienceInfo
(сообщение) -
BusinessProfileLocation
(сообщение) -
CallToActionAsset
(сообщение) -
CustomParameter
(сообщение) -
DeviceInfo
(сообщение) -
EnhancedCpc
(сообщение) -
FrequencyCapEntry
(сообщение) -
GenderInfo
(сообщение) -
ImageAsset
(сообщение) -
ImageDimension
(сообщение) -
Keyword
(сообщение) -
KeywordInfo
(сообщение) -
LanguageInfo
(сообщение) -
ListingGroupInfo
(сообщение) -
LocationGroupInfo
(сообщение) -
LocationInfo
(сообщение) -
ManualCpa
(сообщение) -
ManualCpc
(сообщение) -
ManualCpm
(сообщение) -
MaximizeConversionValue
(сообщение) -
MaximizeConversions
(сообщение) -
Metrics
(сообщение) -
MobileAppAsset
(сообщение) -
PercentCpc
(сообщение) -
RealTimeBiddingSetting
(сообщение) -
SearchAds360ExpandedDynamicSearchAdInfo
(сообщение) -
SearchAds360ExpandedTextAdInfo
(сообщение) -
SearchAds360ProductAdInfo
(сообщение) -
SearchAds360ResponsiveSearchAdInfo
(сообщение) -
SearchAds360TextAdInfo
(сообщение) -
Segments
(сообщение) -
TargetCpa
(сообщение) -
TargetCpm
(сообщение) -
TargetImpressionShare
(сообщение) -
TargetOutrankShare
(сообщение) -
TargetRestriction
(сообщение) -
TargetRoas
(сообщение) -
TargetSpend
(сообщение) -
TargetingSetting
(сообщение) -
TextAsset
(сообщение) -
TextLabel
(сообщение) -
UnifiedCallAsset
(сообщение) -
UnifiedCalloutAsset
(сообщение) -
UnifiedLocationAsset
(сообщение) -
UnifiedPageFeedAsset
(сообщение) -
UnifiedSitelinkAsset
(сообщение) -
UserListInfo
(сообщение) -
Value
(сообщение) -
WebpageConditionInfo
(сообщение) -
WebpageInfo
(сообщение) -
YoutubeVideoAsset
(сообщение)
Adscheduleinfo
Представляет собой критерий adschedule.
Adschedule указывается как день недели и интервал времени, в течение которого будут показаны реклама.
Не более шести Adschedules можно добавить в тот же день.
Поля | |
---|---|
start_minute | Через несколько минут после начала, в котором начинается это расписание. Это поле требуется для создания операций и запрещено в операциях обновления. |
end_minute | Через несколько минут после окончания, в котором это расписание заканчивается. График исключает конечную минуту. Это поле требуется для создания операций и запрещено в операциях обновления. |
day_of_week | День недели, к которому применяется расписание. Это поле требуется для создания операций и запрещено в операциях обновления. |
start_hour | Начальный час в 24 часа. Это поле должно быть от 0 до 23, включительно. Это поле требуется для создания операций и запрещено в операциях обновления. |
end_hour | Конец часа за 24 часа; 24 означает конец дня. Это поле должно быть от 0 до 24, включительно. Это поле требуется для создания операций и запрещено в операциях обновления. |
Adtextasset
Текстовый актив используется внутри рекламы.
Поля | |
---|---|
text | Текст актива. |
Agerangeinfo
Критерий возрастного диапазона.
Поля | |
---|---|
type | Тип возрастного диапазона. |
AssetInteractionTarget
Сегмент AssetInteractionTarget.
Поля | |
---|---|
asset | Имя ресурса активов. |
interaction_on_this_asset | Используется только с показателями CultipsAsset, CamomeAsset и Adgroupasset. Указывает, произошли ли показатели взаимодействия на самом активе или в другом активе или блоке AD. |
Активиз
Содержит информацию об использовании актива.
Поля | |
---|---|
asset | Название ресурса актива. |
served_asset_field_type | Поличный тип актива. |
Аудитория
Критерий аудитории.
Поля | |
---|---|
audience | Название ресурса аудитории. |
BusinessProfileLocation
Данные местоположения бизнес -профиля, синхронизированные с учетной записи связанного бизнес -профиля.
Поля | |
---|---|
labels[] | Рекламодатель указал этикетку для местоположения в учетной записи бизнес -профиля. Это синхронизируется с учетной записи бизнес -профиля. |
store_code | Код магазина бизнеса в этом месте. Это синхронизируется с учетной записи бизнес -профиля. |
listing_id | Листинг идентификатор этого местоположения бизнес -профиля. Это синхронизируется из связанной учетной записи бизнес -профиля. |
CalltoActionAsset
Призыв к активу действия.
Поля | |
---|---|
call_to_action | Призыв к действию. |
CustomParameter
Картирование, которое можно использовать с помощью пользовательских тегов параметров в tracking_url_template
, final_urls
или mobile_final_urls
.
Поля | |
---|---|
key | Ключ, соответствующий имени тега параметра. |
value | Значение, которое нужно заменить. |
DeviceInfo
Критерий устройства.
Поля | |
---|---|
type | Тип устройства. |
EnhancedCpc
Этот тип не имеет полей.
Автоматизированная стратегия торгов, которая поднимает предложения для кликов, которые, похоже, с большей вероятностью приведут к преобразованию и снижает их для кликов, где они кажутся менее вероятными.
Эта стратегия торгов устарела и больше не может быть создана. Используйте ManualCPC с установленным набором ensanced_cpc_enabled для эквивалентной функциональности.
Частота
Этот тип не имеет полей.
Правило, указывающее максимальное количество раз, когда объявление (или некоторый набор объявлений) может быть показано пользователю в течение определенного периода времени.
Genderinfo
Гендерный критерий.
Поля | |
---|---|
type | Тип пола. |
ImageAsset
Актив изображения.
Поля | |
---|---|
mime_type | Тип мима изображного актива. |
full_size | Метаданные для этого изображения при его исходном размере. |
file_size | Размер файла актива изображения в байтах. |
ИМЕНАРИНГИИНГ
Метаданные для изображения при определенном размере, либо оригинал, либо изменение размера.
Поля | |
---|---|
height_pixels | Высота изображения. |
width_pixels | Ширина изображения. |
url | URL, который возвращает изображение с этой высотой и шириной. |
Ключевое слово
Сегмент критерия ключевых слов.
Поля | |
---|---|
info | Информация о ключевом слова. |
ad_group_criterion | Имя ресурса Adgroupcriterion. |
Ключевое слово
Критерий ключевого слова.
Поля | |
---|---|
match_type | Тип совпадения ключевого слова. |
text | Текст ключевого слова (не более 80 символов и 10 слов). |
Язык Info
Языковой критерий.
Поля | |
---|---|
language_constant | Языковая постоянная название ресурса. |
ListingGroupInfo
Критерий группы листинга.
Поля | |
---|---|
type | Тип группы листинга. |
LocationGroupInfo
Радиус вокруг списка мест, указанных через подачу.
Поля | |
---|---|
geo_target_constants[] | Гео -целевая константа (ы), ограничивающая область охвата географической области внутри корма. В настоящее время разрешена только одна целевая константа GEO. |
radius_units | Единица радиуса. Мили и счетчики поддерживаются для констант Geo Target. Милли мили и счетчики поддерживаются для наборов корма. Это требуется и должно быть установлено в создании операций. |
feed_item_sets[] | FeedItemsets, чьи кормовые элементы целенаправленны. Если указано несколько идентификаторов, то целевые элементы, которые появляются по крайней мере в одном наборе. Это поле не может быть использовано с GEO_TARGET_CONSTANTS. Это необязательно и может быть установлено только в операциях создания. |
radius | Расстояние в подразделениях, указывающих радиус вокруг целевых мест. Это требуется и должно быть установлено в создании операций. |
LocationInfo
Критерий местоположения.
Поля | |
---|---|
geo_target_constant | Георальное постоянное имя ресурса. |
Manualcpa
Этот тип не имеет полей.
Стратегия ручной торговли, которая позволяет рекламодателю установить предложение на предложение по рекламодателю.
Manualcpc
Руководство на основе кликов, где пользователь оплачивает за клик.
Поля | |
---|---|
enhanced_cpc_enabled | Должны ли предложения быть улучшенными на основе данных оптимизатора конверсии. |
Manualcpm
Этот тип не имеет полей.
Ручные впечатления, основанные на торгах, где пользователь платит за тысячу впечатлений.
MaximizeConversionValue
Автоматизированная стратегия торгов, чтобы помочь получить наибольшую ценность конверсии для ваших кампаний при проведении вашего бюджета.
Поля | |
---|---|
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменен только для стратегий ставок на портфель. |
cpc_bid_floor_micros | Минимальный лимит ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменен только для стратегий ставок на портфель. |
target_roas | Опция «Возврат» на рекламу (ROAS). В случае установки стратегия ставки будет максимизировать доход, усредняя доход от целевого роста по расходам на рекламу. Если цель ROAS высока, стратегия ставки может не может потратить полный бюджет. Если Target ROAS не установлен, стратегия предложения будет направлена на достижение максимально возможных ROA для бюджета. |
Максимальные реверсии
Автоматизированная стратегия торгов, чтобы помочь получить наибольшее количество конверсий для ваших кампаний при проведении вашего бюджета.
Поля | |
---|---|
cpc_bid_ceiling_micros | Максимальный предел ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменен только для стратегий ставок на портфель. |
cpc_bid_floor_micros | Минимальный лимит ставки, который может быть установлен стратегией ставки. Лимит применяется ко всем ключевым словам, управляемым стратегией. Изменен только для стратегий ставок на портфель. |
target_cpa_micros | Опция целевой стоимости за действие (CPA). Это средняя сумма, которую вы хотели бы потратить на действие конверсии, указанное в микро -единицах валюты стратегии торгов. В случае установки стратегия ставки получит как можно больше конверсий при или ниже целевой стоимости за действие. Если целевой CPA не установлен, стратегия ставки будет направлена на достижение максимально возможного CPA, учитывая бюджет. |
Метрики
Данные метрик.
Поля | |
---|---|
all_conversions_value_by_conversion_date | Ценность всех конверсий. Когда этот столбец выбран с датой, столбец значений в дате означает дату преобразования. Подробная информация о столбцах by_conversion_date доступна по адресу https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | Общее количество конверсий. Это включает в себя все преобразования независимо от значения include_in_conversions_metric. Когда этот столбец выбран с датой, столбец значений в дате означает дату преобразования. Подробная информация о столбцах by_conversion_date доступна по адресу https://support.google.com/sa360/answer/9250611 . |
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 | Все конверсии от взаимодействий (как противодействие просмотру через конверсии), разделенные на количество взаимодействий AD. |
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 | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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. |
MobileAppAsset
An asset representing a mobile app.
Поля | |
---|---|
app_id | Необходимый. 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 | Необходимый. 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.
Поля | |
---|---|
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. |
Segments
Segment only fields.
Поля | |
---|---|
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_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. |
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. |
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 | Необходимый. 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 | A double. |
string_value | A string. |
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. |
Индекс
-
AdScheduleInfo
(message) -
AdTextAsset
(message) -
AgeRangeInfo
(message) -
AssetInteractionTarget
(message) -
AssetUsage
(message) -
AudienceInfo
(message) -
BusinessProfileLocation
(message) -
CallToActionAsset
(message) -
CustomParameter
(message) -
DeviceInfo
(message) -
EnhancedCpc
(message) -
FrequencyCapEntry
(message) -
GenderInfo
(message) -
ImageAsset
(message) -
ImageDimension
(message) -
Keyword
(message) -
KeywordInfo
(message) -
LanguageInfo
(message) -
ListingGroupInfo
(message) -
LocationGroupInfo
(message) -
LocationInfo
(message) -
ManualCpa
(message) -
ManualCpc
(message) -
ManualCpm
(message) -
MaximizeConversionValue
(message) -
MaximizeConversions
(message) -
Metrics
(message) -
MobileAppAsset
(message) -
PercentCpc
(message) -
RealTimeBiddingSetting
(message) -
SearchAds360ExpandedDynamicSearchAdInfo
(message) -
SearchAds360ExpandedTextAdInfo
(message) -
SearchAds360ProductAdInfo
(message) -
SearchAds360ResponsiveSearchAdInfo
(message) -
SearchAds360TextAdInfo
(message) -
Segments
(message) -
TargetCpa
(message) -
TargetCpm
(message) -
TargetImpressionShare
(message) -
TargetOutrankShare
(message) -
TargetRestriction
(message) -
TargetRoas
(message) -
TargetSpend
(message) -
TargetingSetting
(message) -
TextAsset
(message) -
TextLabel
(message) -
UnifiedCallAsset
(message) -
UnifiedCalloutAsset
(message) -
UnifiedLocationAsset
(message) -
UnifiedPageFeedAsset
(message) -
UnifiedSitelinkAsset
(message) -
UserListInfo
(message) -
Value
(message) -
WebpageConditionInfo
(message) -
WebpageInfo
(message) -
YoutubeVideoAsset
(message)
AdScheduleInfo
Represents an AdSchedule criterion.
AdSchedule is specified as the day of the week and a time interval within which ads will be shown.
No more than six AdSchedules can be added for the same day.
Поля | |
---|---|
start_minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
day_of_week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
start_hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
AdTextAsset
A text asset used inside an ad.
Поля | |
---|---|
text | Asset text. |
AgeRangeInfo
An age range criterion.
Поля | |
---|---|
type | Type of the age range. |
AssetInteractionTarget
An AssetInteractionTarget segment.
Поля | |
---|---|
asset | The asset resource name. |
interaction_on_this_asset | 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. |
AssetUsage
Contains the usage information of the asset.
Поля | |
---|---|
asset | Resource name of the asset. |
served_asset_field_type | The served field type of the asset. |
AudienceInfo
An audience criterion.
Поля | |
---|---|
audience | The Audience resource name. |
BusinessProfileLocation
Business Profile location data synced from the linked Business Profile account.
Поля | |
---|---|
labels[] | Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account. |
store_code | Business Profile store code of this location. This is synced from the Business Profile account. |
listing_id | Listing ID of this Business Profile location. This is synced from the linked Business Profile account. |
CallToActionAsset
A call to action asset.
Поля | |
---|---|
call_to_action | Call to action. |
CustomParameter
A mapping that can be used by custom parameter tags in a tracking_url_template
, final_urls
, or mobile_final_urls
.
Поля | |
---|---|
key | The key matching the parameter tag name. |
value | The value to be substituted. |
DeviceInfo
A device criterion.
Поля | |
---|---|
type | Type of the device. |
EnhancedCpc
Этот тип не имеет полей.
An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality.
FrequencyCapEntry
Этот тип не имеет полей.
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
GenderInfo
A gender criterion.
Поля | |
---|---|
type | Type of the gender. |
ImageAsset
An Image asset.
Поля | |
---|---|
mime_type | MIME type of the image asset. |
full_size | Metadata for this image at its original size. |
file_size | File size of the image asset in bytes. |
ImageDimension
Metadata for an image at a certain size, either original or resized.
Поля | |
---|---|
height_pixels | Height of the image. |
width_pixels | Width of the image. |
url | A URL that returns the image with this height and width. |
Ключевое слово
A Keyword criterion segment.
Поля | |
---|---|
info | Keyword info. |
ad_group_criterion | The AdGroupCriterion resource name. |
KeywordInfo
A keyword criterion.
Поля | |
---|---|
match_type | The match type of the keyword. |
text | The text of the keyword (at most 80 characters and 10 words). |
LanguageInfo
A language criterion.
Поля | |
---|---|
language_constant | The language constant resource name. |
ListingGroupInfo
A listing group criterion.
Поля | |
---|---|
type | Type of the listing group. |
LocationGroupInfo
A radius around a list of locations specified through a feed.
Поля | |
---|---|
geo_target_constants[] | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
radius_units | Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations. |
feed_item_sets[] | FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations. |
radius | Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations. |
LocationInfo
A location criterion.
Поля | |
---|---|
geo_target_constant | The geo target constant resource name. |
ManualCpa
Этот тип не имеет полей.
Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
ManualCpc
Manual click-based bidding where user pays per click.
Поля | |
---|---|
enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
ManualCpm
Этот тип не имеет полей.
Manual impression-based bidding where user pays per thousand impressions.
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
Поля | |
---|---|
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. Mutable for portfolio bidding strategies only. |
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. Mutable for portfolio bidding strategies only. |
target_roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
Поля | |
---|---|
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. Mutable for portfolio bidding strategies only. |
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. Mutable for portfolio bidding strategies only. |
target_cpa_micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Metrics
Metrics data.
Поля | |
---|---|
all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
conversion_custom_metrics[] | The conversion custom metrics. |
conversions_value_by_conversion_date | The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date. |
conversions_by_conversion_date | The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date. |
historical_creative_quality_score | The creative historical quality score. |
historical_landing_page_quality_score | The quality of historical landing page experience. |
historical_search_predicted_ctr | The historical search predicted click through rate (CTR). |
interaction_event_types[] | The types of payable and free interactions. |
raw_event_conversion_metrics[] | The raw event conversion metrics. |
absolute_top_impression_percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
all_conversions_value | The value of all conversions. |
all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
all_conversions_from_click_to_call | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
all_conversions_from_directions | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
all_conversions_from_menu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
all_conversions_from_order | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_other_engagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
all_conversions_from_store_visit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
visits | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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. |
MobileAppAsset
An asset representing a mobile app.
Поля | |
---|---|
app_id | Необходимый. 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 | Необходимый. 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.
Поля | |
---|---|
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. |
Segments
Segment only fields.
Поля | |
---|---|
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_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. |
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. |
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 | Необходимый. 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 | A double. |
string_value | A string. |
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. |
Индекс
-
AdScheduleInfo
(message) -
AdTextAsset
(message) -
AgeRangeInfo
(message) -
AssetInteractionTarget
(message) -
AssetUsage
(message) -
AudienceInfo
(message) -
BusinessProfileLocation
(message) -
CallToActionAsset
(message) -
CustomParameter
(message) -
DeviceInfo
(message) -
EnhancedCpc
(message) -
FrequencyCapEntry
(message) -
GenderInfo
(message) -
ImageAsset
(message) -
ImageDimension
(message) -
Keyword
(message) -
KeywordInfo
(message) -
LanguageInfo
(message) -
ListingGroupInfo
(message) -
LocationGroupInfo
(message) -
LocationInfo
(message) -
ManualCpa
(message) -
ManualCpc
(message) -
ManualCpm
(message) -
MaximizeConversionValue
(message) -
MaximizeConversions
(message) -
Metrics
(message) -
MobileAppAsset
(message) -
PercentCpc
(message) -
RealTimeBiddingSetting
(message) -
SearchAds360ExpandedDynamicSearchAdInfo
(message) -
SearchAds360ExpandedTextAdInfo
(message) -
SearchAds360ProductAdInfo
(message) -
SearchAds360ResponsiveSearchAdInfo
(message) -
SearchAds360TextAdInfo
(message) -
Segments
(message) -
TargetCpa
(message) -
TargetCpm
(message) -
TargetImpressionShare
(message) -
TargetOutrankShare
(message) -
TargetRestriction
(message) -
TargetRoas
(message) -
TargetSpend
(message) -
TargetingSetting
(message) -
TextAsset
(message) -
TextLabel
(message) -
UnifiedCallAsset
(message) -
UnifiedCalloutAsset
(message) -
UnifiedLocationAsset
(message) -
UnifiedPageFeedAsset
(message) -
UnifiedSitelinkAsset
(message) -
UserListInfo
(message) -
Value
(message) -
WebpageConditionInfo
(message) -
WebpageInfo
(message) -
YoutubeVideoAsset
(message)
AdScheduleInfo
Represents an AdSchedule criterion.
AdSchedule is specified as the day of the week and a time interval within which ads will be shown.
No more than six AdSchedules can be added for the same day.
Поля | |
---|---|
start_minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
day_of_week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
start_hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
AdTextAsset
A text asset used inside an ad.
Поля | |
---|---|
text | Asset text. |
AgeRangeInfo
An age range criterion.
Поля | |
---|---|
type | Type of the age range. |
AssetInteractionTarget
An AssetInteractionTarget segment.
Поля | |
---|---|
asset | The asset resource name. |
interaction_on_this_asset | 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. |
AssetUsage
Contains the usage information of the asset.
Поля | |
---|---|
asset | Resource name of the asset. |
served_asset_field_type | The served field type of the asset. |
AudienceInfo
An audience criterion.
Поля | |
---|---|
audience | The Audience resource name. |
BusinessProfileLocation
Business Profile location data synced from the linked Business Profile account.
Поля | |
---|---|
labels[] | Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account. |
store_code | Business Profile store code of this location. This is synced from the Business Profile account. |
listing_id | Listing ID of this Business Profile location. This is synced from the linked Business Profile account. |
CallToActionAsset
A call to action asset.
Поля | |
---|---|
call_to_action | Call to action. |
CustomParameter
A mapping that can be used by custom parameter tags in a tracking_url_template
, final_urls
, or mobile_final_urls
.
Поля | |
---|---|
key | The key matching the parameter tag name. |
value | The value to be substituted. |
DeviceInfo
A device criterion.
Поля | |
---|---|
type | Type of the device. |
EnhancedCpc
Этот тип не имеет полей.
An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality.
FrequencyCapEntry
Этот тип не имеет полей.
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
GenderInfo
A gender criterion.
Поля | |
---|---|
type | Type of the gender. |
ImageAsset
An Image asset.
Поля | |
---|---|
mime_type | MIME type of the image asset. |
full_size | Metadata for this image at its original size. |
file_size | File size of the image asset in bytes. |
ImageDimension
Metadata for an image at a certain size, either original or resized.
Поля | |
---|---|
height_pixels | Height of the image. |
width_pixels | Width of the image. |
url | A URL that returns the image with this height and width. |
Ключевое слово
A Keyword criterion segment.
Поля | |
---|---|
info | Keyword info. |
ad_group_criterion | The AdGroupCriterion resource name. |
KeywordInfo
A keyword criterion.
Поля | |
---|---|
match_type | The match type of the keyword. |
text | The text of the keyword (at most 80 characters and 10 words). |
LanguageInfo
A language criterion.
Поля | |
---|---|
language_constant | The language constant resource name. |
ListingGroupInfo
A listing group criterion.
Поля | |
---|---|
type | Type of the listing group. |
LocationGroupInfo
A radius around a list of locations specified through a feed.
Поля | |
---|---|
geo_target_constants[] | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
radius_units | Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations. |
feed_item_sets[] | FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations. |
radius | Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations. |
LocationInfo
A location criterion.
Поля | |
---|---|
geo_target_constant | The geo target constant resource name. |
ManualCpa
Этот тип не имеет полей.
Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
ManualCpc
Manual click-based bidding where user pays per click.
Поля | |
---|---|
enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
ManualCpm
Этот тип не имеет полей.
Manual impression-based bidding where user pays per thousand impressions.
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
Поля | |
---|---|
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. Mutable for portfolio bidding strategies only. |
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. Mutable for portfolio bidding strategies only. |
target_roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
Поля | |
---|---|
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. Mutable for portfolio bidding strategies only. |
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. Mutable for portfolio bidding strategies only. |
target_cpa_micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Metrics
Metrics data.
Поля | |
---|---|
all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
conversion_custom_metrics[] | The conversion custom metrics. |
conversions_value_by_conversion_date | The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date. |
conversions_by_conversion_date | The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date. |
historical_creative_quality_score | The creative historical quality score. |
historical_landing_page_quality_score | The quality of historical landing page experience. |
historical_search_predicted_ctr | The historical search predicted click through rate (CTR). |
interaction_event_types[] | The types of payable and free interactions. |
raw_event_conversion_metrics[] | The raw event conversion metrics. |
absolute_top_impression_percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
all_conversions_value | The value of all conversions. |
all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
all_conversions_from_click_to_call | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
all_conversions_from_directions | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
all_conversions_from_menu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
all_conversions_from_order | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_other_engagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
all_conversions_from_store_visit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
visits | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost 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 cost of goods sold is the total cost of the products sold that weren't advertised. 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 cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different 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 purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account 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 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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 metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
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. |
MobileAppAsset
An asset representing a mobile app.
Поля | |
---|---|
app_id | Необходимый. 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 | Необходимый. 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.
Поля | |
---|---|
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. |
Segments
Segment only fields.
Поля | |
---|---|
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_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. |
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. |
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 | Необходимый. 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 | A double. |
string_value | A string. |
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. |