Package google.ads.searchads360.v0.common

Индекс

AdScheduleInfo

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

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

В один и тот же день можно добавить не более шести расписаний показа объявлений.

Поля
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

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

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

day_of_week

DayOfWeek

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

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

start_hour

int32

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

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

end_hour

int32

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

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

AdTextAsset

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

Поля
text

string

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

Возрастной диапазонИнформация

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

Поля
type

AgeRangeType

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

Цель взаимодействия активов

Сегмент AssetInteractionTarget.

Поля
asset

string

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

interaction_on_this_asset

bool

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

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

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

Поля
asset

string

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

served_asset_field_type

ServedAssetFieldType

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

Информация об аудитории

Критерий аудитории.

Поля
audience

string

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

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

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

Поля
labels[]

string

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

store_code

string

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

listing_id

int64

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

Каллтоактионассет

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

Поля
call_to_action

CallToActionType

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

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

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

Поля
key

string

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

value

string

Значение, подлежащее замене.

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

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

Поля
type

Device

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

Улучшенная цена за клик

Этот тип не имеет полей.

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

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

Частота ограничения входа

Этот тип не имеет полей.

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

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

Половой критерий.

Поля
type

GenderType

Тип пола.

ImageAsset

Ресурс изображения.

Поля
mime_type

MimeType

MIME-тип изображения.

full_size

ImageDimension

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

file_size

int64

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

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

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

Поля
height_pixels

int64

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

width_pixels

int64

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

url

string

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

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

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

Поля
info

KeywordInfo

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

ad_group_criterion

string

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

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

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

Поля
match_type

KeywordMatchType

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

text

string

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

Информация о языке

Языковой критерий.

Поля
language_constant

string

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

ЛистингГруппаИнформация

Критерий группы листинга.

Поля
type

ListingGroupType

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

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

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

Поля
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

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

radius

int64

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

Информация о местонахождении

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

Поля
geo_target_constant

string

Имя постоянного ресурса географической цели.

Ручная цена за конверсию

Этот тип не имеет полей.

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

Ручная цена за клик

Назначение ставок вручную на основе кликов, при котором пользователь платит за клик.

Поля
enhanced_cpc_enabled

bool

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

Ручная цена за тысячу показов

Этот тип не имеет полей.

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

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

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

Максимизация конверсий

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

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

Метрики

Данные метрик.

Поля
all_conversions_value_by_conversion_date

double

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

all_conversions_by_conversion_date

double

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

conversion_custom_metrics[]

Value

Специальные показатели конверсии.

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

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

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

Исторический поиск предсказывал рейтинг кликов (CTR).

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

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

absolute_top_impression_percentage

double

Процент показов на самых высоких позициях в поиске – это процент показов ваших объявлений в поисковой сети, которые показываются на наиболее заметных позициях в поиске.

all_conversions_from_interactions_rate

double

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

all_conversions_value

double

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

all_conversions

double

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

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

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

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

all_conversions_from_directions

double

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

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

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

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

all_conversions_from_order

double

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

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

all_conversions_from_other_engagement

double

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

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

all_conversions_from_store_visit

double

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

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

visits

double

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

all_conversions_from_store_website

double

Сколько раз люди переходили на URL-адрес магазина после нажатия на рекламу.

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

average_cost

double

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

average_cpc

double

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

average_cpm

double

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

clicks

int64

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

content_budget_lost_impression_share

double

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

content_impression_share

double

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

content_rank_lost_impression_share

double

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

conversions_from_interactions_rate

double

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

client_account_conversions_value

double

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

conversions_value_per_cost

double

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

conversions_from_interactions_value_per_interaction

double

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

client_account_conversions

double

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

cost_micros

int64

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

cost_per_all_conversions

double

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

cost_per_conversion

double

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

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

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

cross_device_conversions_value

double

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

ctr

double

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

conversions

double

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

conversions_value

double

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

average_quality_score

double

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

historical_quality_score

int64

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

impressions

int64

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

interaction_rate

double

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

interactions

int64

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

invalid_click_rate

double

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

invalid_clicks

int64

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

mobile_friendly_clicks_percentage

double

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

search_absolute_top_impression_share

double

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

search_budget_lost_absolute_top_impression_share

double

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

search_budget_lost_impression_share

double

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

search_budget_lost_top_impression_share

double

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

search_click_share

double

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

search_exact_match_impression_share

double

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

search_impression_share

double

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

search_rank_lost_absolute_top_impression_share

double

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

search_rank_lost_impression_share

double

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

search_rank_lost_top_impression_share

double

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

search_top_impression_share

double

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

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

top_impression_percentage

double

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

value_per_all_conversions

double

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

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

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

client_account_view_through_conversions

int64

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

client_account_cross_sell_cost_of_goods_sold_micros

int64

Себестоимость проданных товаров при перекрестных продажах на клиентском счете (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

int64

Себестоимость проданных товаров при перекрестных продажах (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

int64

Валовая прибыль от перекрестных продаж на клиентском счете – это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (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

int64

Валовая прибыль от перекрестных продаж — это прибыль, которую вы получили от продуктов, проданных в результате рекламы другого продукта, за вычетом себестоимости проданных товаров (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

int64

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

cross_sell_revenue_micros

int64

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

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

double

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

client_account_lead_cost_of_goods_sold_micros

int64

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

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

int64

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

lead_gross_profit_micros

int64

Ведущая валовая прибыль - это прибыль, которую вы получили из продуктов, проданных в результате рекламы того же продукта, минус стоимость проданных товаров (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

int64

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

lead_revenue_micros

int64

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

client_account_lead_units_sold

double

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

lead_units_sold

double

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

MobileAppasset

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

Поля
app_id

string

Необходимый. Строка, которая уникально идентифицирует мобильное приложение. Он должен содержать только нативный идентификатор платформы, такой как «com.android.ebay» для Android или «12345689» для iOS.

app_store

MobileAppVendor

Необходимый. Хранилище приложения, которое распределяет это конкретное приложение.

Процент CPC

Стратегия торгов, где ставки - это часть рекламируемой цены на что -то хорошее или услуги.

Поля
cpc_bid_ceiling_micros

int64

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

enhanced_cpc_enabled

bool

Регулирует ставку для каждого аукциона вверх или вниз, в зависимости от вероятности конверсии. Отдельные предложения могут превышать CPC_BID_CEILING_MICROS, но средняя сумма предложения для кампании не должна.

RealtimeBiddingsetting

Настройки для торгов в реальном времени, функция, доступная только для кампаний, предназначенных для сети AD Exchange.

Поля
opt_in

bool

Будет ли кампания выбрана в торговые центры в реальном времени.

SearchAds360ExpededDynamicsearchAdinfo

Расширенная динамическая поисковая объявление.

Поля
description1

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

ad_tracking_id

int64

Идентификатор отслеживания объявления.

SEARKADS360EXPANEDTEXTADINFO

Поисковая реклама 360 Расширенная текстовая объявление.

Поля
headline

string

Заголовок объявления.

headline2

string

Второй заголовок объявления.

headline3

string

Третий заголовок объявления.

description1

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

path1

string

Текст добавил к автоматически генерируемому видимому URL с разделителем.

path2

string

Текст добавлен в Path1 с разделителем.

ad_tracking_id

int64

Идентификатор отслеживания объявления.

SearchAds360ProductAdinfo

Этот тип не имеет полей.

Поисковая реклама 360 AD.

SearchAds360RessionsiveSearchAdinfo

Поисковое объявление 360 Акцентивное поисковое объявление.

Поля
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

Список текстовых активов для описаний. Когда объявление служит описаниям из этого списка.

path1

string

Текст добавил к автоматически генерируемому видимому URL с разделителем.

path2

string

Текст добавлен в Path1 с разделителем.

ad_tracking_id

int64

Идентификатор отслеживания объявления.

SearchAds360TextAdinfo

Поисковая реклама 360 Текстовое объявление.

Поля
headline

string

Заголовок объявления.

description1

string

Первая строка описания объявления.

description2

string

Вторая строка описания объявления.

display_url

string

Отображаемый URL объявления.

display_mobile_url

string

Отображаемый мобильный URL объявления.

ad_tracking_id

int64

Идентификатор отслеживания объявления.

Сегменты

Сегмент только поля.

Поля
ad_network_type

AdNetworkType

Тип сети рекламы.

conversion_action_category

ConversionActionCategory

Категория действий конверсии.

conversion_custom_dimensions[]

Value

Измерения обычаи преобразования.

day_of_week

DayOfWeek

День недели, например, в понедельник.

device

Device

Устройство, к которому применяются метрики.

keyword

Keyword

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

product_channel

ProductChannel

Канал продукта.

product_channel_exclusivity

ProductChannelExclusivity

Эксклюзивность канала продукта.

product_condition

ProductCondition

Состояние продукта.

product_sold_condition

ProductCondition

Состояние проданного продукта.

raw_event_conversion_dimensions[]

Value

Размеры преобразования необработанных событий.

conversion_action

string

Название ресурса действия преобразования.

conversion_action_name

string

Имя действия преобразования.

date

string

Дата, на которую применяются метрики. Формат yyyy-mm-dd, например, 2018-04-17.

geo_target_city

string

Название ресурса константы Geo Target, которая представляет город.

geo_target_country

string

Название ресурса константы Geo Target, которая представляет страну.

geo_target_metro

string

Название ресурса константы Geo Target, которая представляет метро.

geo_target_region

string

Название ресурса целевой константы GEO, которая представляет регион.

hour

int32

Час дня как число от 0 до 23, включительно.

month

string

Месяц, как представлен датой первого дня месяца. Отформатируется как yyyy-mm-dd.

product_bidding_category_level1

string

Категория торгов (уровень 1) продукта.

product_bidding_category_level2

string

Категория торгов (уровень 2) продукта.

product_bidding_category_level3

string

Категория торгов (уровень 3) продукта.

product_bidding_category_level4

string

Категория торгов (уровень 4) продукта.

product_bidding_category_level5

string

Категория торгов (уровень 5) продукта.

product_brand

string

Бренд продукта.

product_country

string

Название ресурса константы Geo Target для страны продажи продукта.

product_custom_attribute0

string

Пользовательский атрибут 0 продукта.

product_custom_attribute1

string

Пользовательский атрибут 1 продукта.

product_custom_attribute2

string

Пользовательский атрибут 2 продукта.

product_custom_attribute3

string

Пользовательский атрибут 3 продукта.

product_custom_attribute4

string

Пользовательский атрибут 4 продукта.

product_item_id

string

Идентификатор продукта продукта.

product_language

string

Название ресурса постоянной языка для языка продукта.

product_sold_bidding_category_level1

string

Категория торгов (уровень 1) проданного продукта.

product_sold_bidding_category_level2

string

Категория торгов (уровень 2) проданного продукта.

product_sold_bidding_category_level3

string

Категория торгов (уровень 3) проданного продукта.

product_sold_bidding_category_level4

string

Категория торгов (уровень 4) проданного продукта.

product_sold_bidding_category_level5

string

Категория торгов (уровень 5) проданного продукта.

product_sold_brand

string

Бренд продукта продан.

product_sold_custom_attribute0

string

Пользовательский атрибут 0 проданного продукта.

product_sold_custom_attribute1

string

Пользовательский атрибут 1 проданного продукта.

product_sold_custom_attribute2

string

Пользовательский атрибут 2 проданного продукта.

product_sold_custom_attribute3

string

Пользовательский атрибут 3 проданного продукта.

product_sold_custom_attribute4

string

Пользовательский атрибут 4 проданного продукта.

product_sold_item_id

string

Идентификатор товара проданного продукта.

product_sold_title

string

Название проданного продукта.

product_sold_type_l1

string

Тип (уровень 1) проданного продукта.

product_sold_type_l2

string

Тип (уровень 2) проданного продукта.

product_sold_type_l3

string

Тип (уровень 3) проданного продукта.

product_sold_type_l4

string

Тип (уровень 4) проданного продукта.

product_sold_type_l5

string

Тип (уровень 5) проданного продукта.

product_store_id

string

Идентификатор магазина продукта.

product_title

string

Название продукта.

product_type_l1

string

Тип (уровень 1) продукта.

product_type_l2

string

Тип (уровень 2) продукта.

product_type_l3

string

Тип (уровень 3) продукта.

product_type_l4

string

Тип (уровень 4) продукта.

product_type_l5

string

Тип (уровень 5) продукта.

quarter

string

Квартал, как представлен датой первого дня четверти. Например, использует календарный год для кварталов, второй квартал 2018 года начинается с 2018-04-01. Отформатируется как yyyy-mm-dd.

week

string

Неделя, определенная как с понедельника по воскресенье, и представлена ​​датой понедельника. Отформатируется как yyyy-mm-dd.

year

int32

Год, отформатированный как yyyy.

asset_interaction_target

AssetInteractionTarget

Используется только с показателями CultipsAsset, CamomeAsset и Adgroupasset. Указывает, произошли ли показатели взаимодействия на самом активе или в другом активе или блоке AD. Взаимодействия (например, клики) подсчитываются во всех частях обслуживаемого объявления (например, сама AD и другие компоненты, такие как SiteLinks), когда они обслуживаются вместе. Когда interaction_on_this_asset является истинной, это означает, что взаимодействия находятся на этом конкретном активе, и когда Interaction_on_this_asset является ложным, это означает, что взаимодействия не на этом конкретном активе, а в других частях обслуживаемого AD. Этот актив обслуживается.

TargetCpa

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

Поля
target_cpa_micros

int64

Средняя цель CPA. Эта цель должна быть больше или равна минимально оплачиваемой единице на основе валюты для учетной записи.

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

Этот тип не имеет полей.

Целевой CPM (стоимость за тысячу показов) - это автоматическая стратегия ставок, которая устанавливает ставки для оптимизации производительности, учитывая целевую CPM, которую вы устанавливаете.

TargetImpressionShare

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

Поля
location

TargetImpressionShareLocation

Целевое местоположение на странице результатов поиска.

location_fraction_micros

int64

Выбранная доля объявлений, которая будет показана в целевом месте в микрос. Например, 1% равняется 10000.

cpc_bid_ceiling_micros

int64

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

Targetoutrankshare

Автоматизированная стратегия торгов, которая устанавливает ставки на основе целевой доли аукционов, где рекламодатель должен опередить конкретного конкурента. Эта стратегия устарела.

Поля
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

Список настройки таргетинга из-за цели.

Поля
targeting_dimension

TargetingDimension

Измерение таргетинга, к которому применяются эти настройки.

bid_only

bool

Указывает, ограничить ли ваши объявления показать только для критериев, которые вы выбрали для этого Targeting_dimension, или нацеливаться на все значения для этого Targeting_dimension и показывать объявления на основе вашего таргетирования в других целевых показателях. Значение true означает, что эти критерии будут применять только модификаторы ставки и не влиять на таргетинг. Значение false означает, что эти критерии будут ограничивать таргетинг, а также применение модификаторов ставки.

TargetRoas

Автоматизированная стратегия торгов, которая помогает вам максимизировать доход при усреднении определенной целевой доходности по расходам на рекламу (ROAS).

Поля
target_roas

double

Необходимый. Выбранный доход (на основе данных конверсии) на единицу расходов. Значение должно быть от 0,01 до 1000,0, включительно.

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetSpend

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

Поля
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

Нацеливание

Настройки для функций, связанных с таргетингом, на уровнях кампании и групп рекламы. Для получения более подробной информации о настройке таргетинга, посетите https://support.google.com/google-ads/answer/7365594

Поля
target_restrictions[]

TargetRestriction

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

Текстовый

Текстовый актив.

Поля
text

string

Текстовое содержание текстового актива.

Textlabel

Тип метки, отображающего текст на цветном фоне.

Поля
background_color

string

Фоновый цвет ярлыка в шестнадцатеричном формате. Эта строка должна соответствовать регулярному выражению '^#([A-FA-F0-9] {6} | [A-FA-F0-9] {3}) $'. Примечание. Цвет фона не может быть виден для учетных записей менеджера.

description

string

Краткое описание этикетки. Длина должна быть не более 200 символов.

UnifiedCallasset

Объединенное вызов.

Поля
country_code

string

Двухбуктный код страны номера телефона. Примеры: «США», «США».

phone_number

string

Номер телефона рекламодателя. Примеры: '1234567890', '(123) 456-7890'

call_conversion_reporting_state

CallConversionReportingState

Указывает, должен ли этот Callasset использовать свой собственный настройка преобразования вызовов, следить за настройкой уровня учетной записи или отключить преобразование вызовов.

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42.

call_only

bool

Показывает ли звонок только номер телефона без ссылки на веб -сайт. Применяется к рекламе Microsoft.

call_tracking_enabled

bool

Должен ли вызов быть включен при отслеживании вызовов. Применяется к рекламе Microsoft.

use_searcher_time_zone

bool

Показать расширение вызова в часовом поясе пользователя поиска. Применяется к рекламе Microsoft.

start_date

string

Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD.

end_date

string

Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD.

UnifiedCalloutasset

Объединенное вынововое актив.

Поля
callout_text

string

Текст вызовов. Длина этой строки должна быть от 1 до 25, включительно.

start_date

string

Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD.

end_date

string

Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD.

ad_schedule_targets[]

AdScheduleInfo

Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42.

use_searcher_time_zone

bool

Показать активу в часовом поясе пользователя поиска. Применяется к рекламе Microsoft.

UnifiedLocationAsset

Объединенное местоположение актива.

Поля
place_id

string

Поместите идентификаторы уникально идентифицировать место в базе данных Google Place и на картах Google. Это поле уникально для данного идентификатора клиента и типа активов. См .

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

Тип владения местоположением. Если тип Business_owner, он будет обслуживаться расширением местоположения. Если тип является партнером, он будет обслуживаться в качестве партнерского места.

UnifiedPageFeedAsset

Объединенная страница.

Поля
page_url

string

Веб -страница, на которую хотят нацелены рекламодатели.

labels[]

string

Метки, используемые для группировки URL -адресов страницы.

UnifiedSitelinkasset

Объединенный актив SiteLink.

Поля
description1

string

Первая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, инклюзивных, а также должно быть установлено описание2.

description2

string

Вторая строка описания для SiteLink. Если установлена, длина должна быть от 1 до 35, включительно, а также должно быть установлено описание1.

start_date

string

Дата начала, когда этот актив вступит в силу и может начать служить в формате Yyyy-MM-DD.

end_date

string

Последняя дата, когда этот актив вступает в силу и все еще служит, в формате Yyyy-MM-DD.

ad_schedule_targets[]

AdScheduleInfo

Список непересекающихся графиков, указывающих на все интервалы времени, для которых может служить актив. Там может быть максимум 6 графиков в день, всего 42.

tracking_id

int64

Идентификатор используется для отслеживания кликов для актива SiteLink. Это Yahoo! Япония только поле.

use_searcher_time_zone

bool

Показать активы SiteLink в часовом поясе пользователя поиска. Применяется к рекламе Microsoft.

mobile_preferred

bool

Является ли предпочтение для отображения актива SiteLink на мобильных устройствах. Применяется к рекламе Microsoft.

UserListInfo

Критерий списка пользователей. Представляет список пользователей, который определяется рекламодателем для целевого.

Поля
user_list

string

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

Ценить

Общий контейнер данных.

Поля
value поля профсоюза. Ценность. value может быть только одним из следующих:
boolean_value

bool

Логический.

int64_value

int64

Int64.

float_value

float

Поплавок.

double_value

double

Двойной.

string_value

string

Строка.

WebPageConditionInfo

Логическое выражение для нацеливания веб -страниц веб -сайта рекламодателя.

Поля
operand

WebpageConditionOperand

Операнд условия таргетинга веб -страницы.

operator

WebpageConditionOperator

Оператор условия таргетирования веб -страницы.

argument

string

Аргумент условия таргетирования веб -страницы.

Webpageinfo

Представляет собой критерий для нацеливания на веб -страницы веб -сайта рекламодателя.

Поля
conditions[]

WebpageConditionInfo

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

Это поле требуется для создания операций и запрещено в операциях обновления.

coverage_percentage

double

Процент покрытия критериев веб -сайта. Это вычислимый процент освещения веб -сайтов, основанный на целевом целевом веб -сайте, отрицательной целевой и негативной ключевых словах в группе рекламы и кампании. Например, когда покрытие возвращается как 1, оно указывает, что оно имеет 100% покрытие. Это поле только для чтения.

criterion_name

string

Имя критерия, который определяется этим параметром. Значение имени будет использоваться для идентификации, сортировки и фильтрации критериев с этим типом параметров.

Это поле требуется для создания операций и запрещено в операциях обновления.

Youtubevideoasset

Активы на YouTube.

Поля
youtube_video_title

string

Название видео на YouTube.

youtube_video_id

string

YouTube Video Id. Это 11 строкового значения символов, используемое в URL -адресе видео на YouTube.

,

Индекс

Adscheduleinfo

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

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

Не более шести Adschedules можно добавить в тот же день.

Поля
start_minute

MinuteOfHour

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

Это поле требуется для создания операций и запрещено в операциях обновления.

end_minute

MinuteOfHour

Через несколько минут после окончания, в котором это расписание заканчивается. График исключает конечную минуту.

Это поле требуется для создания операций и запрещено в операциях обновления.

day_of_week

DayOfWeek

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

Это поле требуется для создания операций и запрещено в операциях обновления.

start_hour

int32

Начальный час в 24 часа. Это поле должно быть от 0 до 23, включительно.

Это поле требуется для создания операций и запрещено в операциях обновления.

end_hour

int32

Конец часа за 24 часа; 24 означает конец дня. Это поле должно быть от 0 до 24, включительно.

Это поле требуется для создания операций и запрещено в операциях обновления.

Adtextasset

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

Поля
text

string

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

Agerangeinfo

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

Поля
type

AgeRangeType

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

AssetInteractionTarget

Сегмент AssetInteractionTarget.

Поля
asset

string

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

interaction_on_this_asset

bool

Используется только с показателями CultipsAsset, CamomeAsset и Adgroupasset. Указывает, произошли ли показатели взаимодействия на самом активе или в другом активе или блоке AD.

Активиз

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

Поля
asset

string

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

served_asset_field_type

ServedAssetFieldType

Поличный тип актива.

Аудитория

Критерий аудитории.

Поля
audience

string

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

BusinessProfileLocation

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

Поля
labels[]

string

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

store_code

string

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

listing_id

int64

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

CalltoActionAsset

Призыв к активу действия.

Поля
call_to_action

CallToActionType

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

CustomParameter

Картирование, которое можно использовать с помощью пользовательских тегов параметров в tracking_url_template , final_urls или mobile_final_urls .

Поля
key

string

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

value

string

Значение, которое нужно заменить.

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

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

Поля
type

Device

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

EnhancedCpc

Этот тип не имеет полей.

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

Эта стратегия торгов устарела и больше не может быть создана. Используйте ManualCPC с установленным набором ensanced_cpc_enabled для эквивалентной функциональности.

Частота

Этот тип не имеет полей.

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

Genderinfo

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

Поля
type

GenderType

Тип пола.

ImageAsset

Актив изображения.

Поля
mime_type

MimeType

Тип мима изображного актива.

full_size

ImageDimension

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

file_size

int64

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

ИМЕНАРИНГИИНГ

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

Поля
height_pixels

int64

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

width_pixels

int64

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

url

string

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

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

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

Поля
info

KeywordInfo

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

ad_group_criterion

string

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

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

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

Поля
match_type

KeywordMatchType

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

text

string

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

Язык Info

Языковой критерий.

Поля
language_constant

string

Языковая постоянная название ресурса.

ListingGroupInfo

Критерий группы листинга.

Поля
type

ListingGroupType

Тип группы листинга.

LocationGroupInfo

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

Поля
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

Единица радиуса. Мили и счетчики поддерживаются для констант Geo Target. Милли мили и счетчики поддерживаются для наборов корма. Это требуется и должно быть установлено в создании операций.

feed_item_sets[]

string

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

radius

int64

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

LocationInfo

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

Поля
geo_target_constant

string

Георальное постоянное имя ресурса.

Manualcpa

Этот тип не имеет полей.

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

Manualcpc

Руководство на основе кликов, где пользователь оплачивает за клик.

Поля
enhanced_cpc_enabled

bool

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

Manualcpm

Этот тип не имеет полей.

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

MaximizeConversionValue

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

Максимальные реверсии

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

Поля
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

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

Метрики

Данные метрик.

Поля
all_conversions_value_by_conversion_date

double

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

all_conversions_by_conversion_date

double

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

conversion_custom_metrics[]

Value

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

conversions_value_by_conversion_date

double

Сумма значения преобразования ставок по дате преобразования. Когда этот столбец выбран с датой, столбец значений в дате означает дату преобразования.

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

Творческий исторический счет качества.

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

Исторический поиск прогнозировал скорость клика (CTR).

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

Сырые показатели преобразования событий.

absolute_top_impression_percentage

double

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

all_conversions_from_interactions_rate

double

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

all_conversions_value

double

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

all_conversions

double

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

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

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

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

all_conversions_from_directions

double

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

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

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

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

all_conversions_from_order

double

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

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

all_conversions_from_other_engagement

double

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

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

all_conversions_from_store_visit

double

Ориентировочное количество раз люди посещали магазин после нажатия на объявление.

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

visits

double

Нажмите на то, что поиск объявлений 360 успешно записал и отправил на целевую страницу рекламодателя.

all_conversions_from_store_website

double

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

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

average_cost

double

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

average_cpc

double

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

average_cpm

double

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

clicks

int64

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

content_budget_lost_impression_share

double

Предполагаемый процент, когда ваше объявление имело право показывать в сети дисплея, но не было, потому что ваш бюджет был слишком низким. ПРИМЕЧАНИЕ. Бюджет содержимого. Любое значение выше 0,9 сообщается как 0,9001.

content_impression_share

double

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

double

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

double

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

double

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

double

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversions_from_interactions_value_per_interaction

double

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

double

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

int64

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

double

The cost of ad interactions divided by all conversions.

cost_per_conversion

double

Average conversion eligible cost per biddable conversion.

cost_per_current_model_attributed_conversion

double

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

double

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_value

double

The sum of the value of cross-device conversions.

ctr

double

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

double

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

double

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

double

The average quality score.

historical_quality_score

int64

The historical quality score.

impressions

int64

Count of how often your ad has appeared on a search results page or website on the Google Network.

interaction_rate

double

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

int64

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

double

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalid_clicks

int64

Number of clicks Google considers illegitimate and doesn't charge you for.

mobile_friendly_clicks_percentage

double

The percentage of mobile clicks that go to a mobile-friendly page.

search_absolute_top_impression_share

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

The percent of your ad impressions that are shown adjacent to the top organic search results.

value_per_all_conversions

double

The value of all conversions divided by the number of all conversions.

value_per_all_conversions_by_conversion_date

double

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

double

Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.

client_account_lead_cost_of_goods_sold_micros

int64

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

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

int64

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

lead_gross_profit_micros

int64

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

client_account_lead_revenue_micros

int64

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

lead_revenue_micros

int64

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

client_account_lead_units_sold

double

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

lead_units_sold

double

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

MobileAppAsset

An asset representing a mobile app.

Поля
app_id

string

Необходимый. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS.

app_store

MobileAppVendor

Необходимый. The application store that distributes this specific app.

PercentCpc

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

Поля
cpc_bid_ceiling_micros

int64

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

enhanced_cpc_enabled

bool

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

RealTimeBiddingSetting

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

Поля
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

An expanded dynamic search ad.

Поля
description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ExpandedTextAdInfo

A Search Ads 360 expanded text ad.

Поля
headline

string

The headline of the ad.

headline2

string

The second headline of the ad.

headline3

string

The third headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

path1

string

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

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ProductAdInfo

This type has no fields.

A Search Ads 360 product ad.

SearchAds360ResponsiveSearchAdInfo

A Search Ads 360 responsive search ad.

Поля
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

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

path1

string

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

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360TextAdInfo

A Search Ads 360 text ad.

Поля
headline

string

The headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

display_url

string

The displayed URL of the ad.

display_mobile_url

string

The displayed mobile URL of the ad.

ad_tracking_id

int64

The tracking id of the ad.

Сегменты

Segment only fields.

Поля
ad_network_type

AdNetworkType

Ad network type.

conversion_action_category

ConversionActionCategory

Conversion action category.

conversion_custom_dimensions[]

Value

The conversion custom dimensions.

day_of_week

DayOfWeek

Day of the week, for example, MONDAY.

device

Device

Device to which metrics apply.

keyword

Keyword

Keyword criterion.

product_channel

ProductChannel

Channel of the product.

product_channel_exclusivity

ProductChannelExclusivity

Channel exclusivity of the product.

product_condition

ProductCondition

Condition of the product.

product_sold_condition

ProductCondition

Condition of the product sold.

raw_event_conversion_dimensions[]

Value

The raw event conversion dimensions.

conversion_action

string

Resource name of the conversion action.

conversion_action_name

string

Conversion action name.

date

string

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

geo_target_city

string

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

geo_target_country

string

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

geo_target_metro

string

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

geo_target_region

string

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

hour

int32

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

month

string

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

product_bidding_category_level1

string

Bidding category (level 1) of the product.

product_bidding_category_level2

string

Bidding category (level 2) of the product.

product_bidding_category_level3

string

Bidding category (level 3) of the product.

product_bidding_category_level4

string

Bidding category (level 4) of the product.

product_bidding_category_level5

string

Bidding category (level 5) of the product.

product_brand

string

Brand of the product.

product_country

string

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

product_custom_attribute0

string

Custom attribute 0 of the product.

product_custom_attribute1

string

Custom attribute 1 of the product.

product_custom_attribute2

string

Custom attribute 2 of the product.

product_custom_attribute3

string

Custom attribute 3 of the product.

product_custom_attribute4

string

Custom attribute 4 of the product.

product_item_id

string

Item ID of the product.

product_language

string

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

product_sold_bidding_category_level1

string

Bidding category (level 1) of the product sold.

product_sold_bidding_category_level2

string

Bidding category (level 2) of the product sold.

product_sold_bidding_category_level3

string

Bidding category (level 3) of the product sold.

product_sold_bidding_category_level4

string

Bidding category (level 4) of the product sold.

product_sold_bidding_category_level5

string

Bidding category (level 5) of the product sold.

product_sold_brand

string

Brand of the product sold.

product_sold_custom_attribute0

string

Custom attribute 0 of the product sold.

product_sold_custom_attribute1

string

Custom attribute 1 of the product sold.

product_sold_custom_attribute2

string

Custom attribute 2 of the product sold.

product_sold_custom_attribute3

string

Custom attribute 3 of the product sold.

product_sold_custom_attribute4

string

Custom attribute 4 of the product sold.

product_sold_item_id

string

Item ID of the product sold.

product_sold_title

string

Title of the product sold.

product_sold_type_l1

string

Type (level 1) of the product sold.

product_sold_type_l2

string

Type (level 2) of the product sold.

product_sold_type_l3

string

Type (level 3) of the product sold.

product_sold_type_l4

string

Type (level 4) of the product sold.

product_sold_type_l5

string

Type (level 5) of the product sold.

product_store_id

string

Store ID of the product.

product_title

string

Title of the product.

product_type_l1

string

Type (level 1) of the product.

product_type_l2

string

Type (level 2) of the product.

product_type_l3

string

Type (level 3) of the product.

product_type_l4

string

Type (level 4) of the product.

product_type_l5

string

Type (level 5) of the product.

quarter

string

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

week

string

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

year

int32

Year, formatted as yyyy.

asset_interaction_target

AssetInteractionTarget

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

TargetCpa

An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

Поля
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

This type has no fields.

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

TargetImpressionShare

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

Поля
location

TargetImpressionShareLocation

The targeted location on the search results page.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetOutrankShare

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

Поля
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

The list of per-targeting-dimension targeting settings.

Поля
targeting_dimension

TargetingDimension

The targeting dimension that these settings apply to.

bid_only

bool

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

TargetRoas

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

Поля
target_roas

double

Необходимый. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetSpend

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

Поля
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

TargetingSetting

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

Поля
target_restrictions[]

TargetRestriction

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

TextAsset

A Text asset.

Поля
text

string

Text content of the text asset.

TextLabel

A type of label displaying text on a colored background.

Поля
background_color

string

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

description

string

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

UnifiedCallAsset

A unified call asset.

Поля
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

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

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

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

start_date

string

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

end_date

string

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

UnifiedCalloutAsset

A unified callout asset.

Поля
callout_text

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

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

UnifiedLocationAsset

A unified location asset.

Поля
place_id

string

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

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

A Unified Page Feed asset.

Поля
page_url

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

UnifiedSitelinkAsset

A unified sitelink asset.

Поля
description1

string

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

description2

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

tracking_id

int64

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

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

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

Поля
user_list

string

The User List resource name.

Ценить

A generic data container.

Поля
Union field value . Ценность. value can be only one of the following:
boolean_value

bool

A boolean.

int64_value

int64

An int64.

float_value

float

A float.

double_value

double

Двойной.

string_value

string

Строка.

WebpageConditionInfo

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

Поля
operand

WebpageConditionOperand

Operand of webpage targeting condition.

operator

WebpageConditionOperator

Operator of webpage targeting condition.

argument

string

Argument of webpage targeting condition.

WebpageInfo

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

Поля
conditions[]

WebpageConditionInfo

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

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

coverage_percentage

double

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

criterion_name

string

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

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

YoutubeVideoAsset

A YouTube asset.

Поля
youtube_video_title

string

YouTube video title.

youtube_video_id

string

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