Ads Data Hub table schema - Publishers

Аукционы Менеджера рекламы 360

am360_auctions
bid struct
Повторяющееся поле, описывающее каждую ставку на аукционе AdX.
bid.bidder_name string
Имя сети покупателя учетной записи участника торгов или название сторонней биржи, разместившей эту ставку.
bid.buyer_name string
Название сети покупателя или сторонней биржи, разместившей эту ставку.
bid.classified_advertiser_name string
Классифицированное Google имя рекламодателя, чье объявление будет показано в случае выигрыша этой ставки.
bid.cpm double
Цена за тысячу показов этой ставки в валюте сети издателя по умолчанию.
bid.deal_id string
Идентификатор сделки, которая будет применена, если эта ставка выиграет.
bid.deal_type string
Тип сделки, связанной с этой ставкой. Может быть одним из вариантов "Частный аукцион", "Приоритетная сделка" или "Гарантированная алгоритмическая продажа" или нулевым, если сделка не применялась.
bid.outcome string
Результат этой ставки. Может быть одним из следующих вариантов: «Победитель» (выигрышная ставка), «Переигранная ставка» (проигрыш из-за другой ставки или резервирования), «Этаж» (отклонено из-за того, что аукцион находится ниже минимального уровня под контролем издателя), «Нет согласия» (отклонено из-за отсутствие согласия пользователя на поставщика), «Издатель заблокирован» (отклонено из-за настроек издателя, таких как фильтрация категорий продуктов), «Неизвестный поставщик» (отклонено из-за неустановленного поставщика рекламных технологий GDPR), «Оптимизированное ценообразование» (отклонено из-за для резервирования оптимизации цены) или «Другое» (отклонено по какой-либо другой причине).
bid.source string
Источник этой ставки. Может быть либо «Ad Exchange» (предложение от авторизованного покупателя), либо «Open Bidding» (предложение от сторонней биржи).
bid.upr_floor_cpm double
Минимальная цена на основе единого правила ценообразования, которая применялась к этой ставке.
bid.yield_group_ids int
Идентификаторы групп доходности, которые позволили этому источнику спроса разместить эту ставку.
bid.yield_partner_id int
Идентификатор компании, делающей эту ставку. Присоединяется к am360_match_company.company_id.
event_time_usec timestamp
Отметка времени конкретного события.
metadata struct
Группа полей, содержащих метаданные о событии.
metadata.child_network_code string
Идентифицирует дочернюю сеть Multiple Customer Management (MCM), которая управляет ресурсом, запрашивающим рекламу.
metadata.event_id string
Уникальный идентификатор для этого события во всех таблицах.
metadata.network_code string
Идентифицирует сеть издателя, которая контролирует инвентарь, заполняемый рекламным запросом.
metadata.request_id string
Идентификатор, общий для всех событий, связанных с запросом на заполнение одного рекламного блока (рекламного места). Совместно со всеми запросами и более поздними событиями, связанными с архитектурой единого запроса (SRA) или запросом модуля видео.
request_time_usec timestamp
Отметка времени первоначального запроса в Google, который стал запросом объявления.
user_id string
Назначенный Google идентификатор браузера, отправившего рекламное событие. Не может быть извлечен.
user_ppid string
Закодированный идентификатор, предоставленный издателем (PPID) из запроса объявления. Невозможно расшифровать. Не может быть извлечен.

Конверсии Менеджера рекламы 360

am360_conversions
activity_id int
Идентификатор выполненного действия из тега Spotlight.
activity_trigger string
Действие пользователя, которое привело к этому действию. Один из показов или кликов.
click_id string
Идентификатор клика, который привел к этому действию, если он был. Присоединяется к am360_interactions.metadata.event_id.
delivery struct
Группа полей, описывающих рекламу, показанную для заполнения запроса.
delivery.advertiser_company_id int
Идентификатор компании, связанной с этим заказом. Также можно найти через таблицу метаданных заказа. Только бронирование. Присоединяется к am360_match_company.company_id.
delivery.auction_id string
Если аукцион проводился для заполнения показа объявлений, связанного с этим событием, идентификатор записи аукциона. Присоединяется к am360_auctions.metadata.event_id.
delivery.bidder_name string
Название сети покупателя учетной записи участника торгов или название сторонней биржи, наполнившей объявление.
delivery.buyer_name string
Название сети покупателя или сторонней биржи, наполнившей объявление.
delivery.classified_advertiser_name string
Классифицированное Google имя рекламодателя, чье объявление было показано.
delivery.creative_id int
Идентификатор креатива с резервированием издателя, который был показан. Только бронирование
delivery.creative_serve_id string
Идентификатор показанного объявления. Если это событие было подачей креатива, будет равно event_id. Присоединяется к am360_creative_serves.metadata.event_id.
delivery.creative_size_delivered string
Размер показанного креатива.
delivery.deal_id string
Идентификатор прямой сделки, использованный при выборе этого объявления.
delivery.deal_type string
Тип прямой сделки (например, "Гарантированная программа", "Приоритетная сделка", "Частный аукцион" и т. д.).
delivery.demand_channel string
Канал спроса, по которому поступил запрос объявления (например, "Сервер объявлений", "Открытый аукцион" и т. д.)
delivery.estimated_revenue double
Оценка дохода, который издатель получит от этого события, в валюте сети издателя по умолчанию. Это целые денежные единицы, а не цена за тысячу показов.
delivery.line_item_id int
Позиция, в которой разрешен показ этого объявления. Присоединяется к am360_match_line_item.line_item_id.
delivery.optimization_type string
Тип оптимизации, примененный при выборе этого объявления (например, «Оптимизированный конкурс», «Целевая цена за тысячу показов», «Первый выбор»). Может быть нулевым
delivery.order_id int
Заказ (также известный как кампания), который содержит позицию. Присоединяется к am360_match_order.order_id.
delivery.query_id string
Идентификатор исходной записи запроса в таблице запросов. Присоединяется к am360_queries.metadata.event_id.
delivery.targeted_audience_segment_ids int
Идентификаторы сегмента аудитории (он же список пользователей), используемые при таргетинге этого объявления на пользователя, как положительные, так и отрицательные совпадения.
delivery.targeted_custom_criteria struct
Повторяющееся поле, описывающее, как custom_criteria из инвентаря использовались при таргетинге на это объявление.
delivery.targeted_custom_criteria.is_negative_match bool
Было ли отрицательное соответствие этому ключу/значению при таргетинге позиции.
delivery.targeted_custom_criteria.key string
Имя ключа custom_criteria.
delivery.targeted_custom_criteria.match_type string
Тип выполненного соответствия (например, «Общее», «Точное», «Префикс» и т. д.).
delivery.targeted_custom_criteria.pattern string
Шаблон, которому соответствует значение из inventory.custom_criteria.
delivery.video_fallback_index int
Индекс этого резервного видеокреатива или null.
delivery.yield_group_ids int
Идентификаторы групп доходности, которые позволили этому источнику спроса заполнить это объявление.
delivery.yield_partner_id int
Идентификатор компании, заполнявшей это объявление. Присоединяется к am360_match_company.company_id.
event_time_usec timestamp
Отметка времени конкретного события.
inventory struct
Группа полей, описывающих свойства инвентаря из рекламного запроса.
inventory.ad_unit_id int
Идентификатор рекламного блока (также известного как единица инвентаря), в котором будет отображаться реклама. Присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_path int
Путь к рекламному блоку. Рекламные блоки организованы в виде иерархического дерева, например «корневая страница/спорт/главная страница/верхняя часть». Первая запись в этом списке — это идентификатор корневого рекламного блока, уникальный для каждой сети издателя, а последняя запись — это лист. Каждая запись присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_sizes string
Запрошенный(ые) размер(а) объявления для показа в этом рекламном блоке. Может содержать такие значения, как «320 x 250», «Исходный» и «Гибкий».
inventory.custom_criteria struct
Повторяющееся поле, содержащее ключевые значения в произвольной форме, переданные через запрос объявления. Если ключ передается в запросе объявления несколько раз, каждый из них будет отображаться как отдельная запись custom_criteria.
inventory.custom_criteria.key string
Ключ этого специального критерия, передаваемого в запросе объявления.
inventory.custom_criteria.value string
Значение этого пользовательского критерия, переданное в запросе объявления.
inventory.device struct
Группа полей, описывающих устройство, которое сделало рекламный запрос.
inventory.device_category string
Тип устройства, например «Смартфон» или «Настольный компьютер».
inventory.geo struct
Группа полей, описывающих географическое положение, откуда поступил рекламный запрос.
inventory.geo.country string
Название страны, из которой поступил рекламный запрос.
inventory.geo.language string
Язык запроса.
inventory.geo.language_country string
Страна языка запроса. Может отличаться от страны, если, например, кто-то из Севильи посещает США. Часто ноль.
inventory.geo.region string
Название географического региона, из которого поступил рекламный запрос.
inventory.inventory_format bool
Название формата запрашиваемой инвентаризации. Один из вариантов «Нативная пользовательская визуализация», «Видео In-Stream», «Аудио In-Stream», «Межстраничное объявление», «С вознаграждением», «Межстраничное объявление с вознаграждением», «Открытие приложения», «Баннер» или «Якорь». Нуль, если не указано.
inventory.is_companion bool
True, если запрос был связан с другим объявлением на странице. Такие события не учитываются в отчетах Менеджера рекламы.
inventory.matched_audience_segment_ids int
Идентификаторы сегментов аудитории (иначе списки пользователей), видимые в сети издателя, которые содержат идентификатор пользователя, делающего рекламный запрос.
inventory.placement_id int
Идентификатор места размещения (группы рекламных блоков). Присоединяется к am360_match_placement.placement_id.
inventory.referer_url string
Продезинфицированный URL-адрес страницы, выдавшей рекламный запрос; для веб-запросов это примерно URL-адрес страницы, которая запросила рекламу; для запросов мобильных объявлений это произвольная строка, похожая на URL, но идентифицирующая мобильное приложение.
inventory.video_content_id int
Идентификатор видеоконтента, рядом с которым отображается реклама (определяется издателем).
inventory.video_position int
Позиция в видео, где будет воспроизводиться реклама. 1 — преролл, 3 — постролл, 4+ — мидролл в последовательном порядке.
inventory.web_property string
Код веб-ресурса, связанный с запросом объявления.
metadata struct
Группа полей, содержащих метаданные о событии.
metadata.child_network_code string
Идентифицирует дочернюю сеть Multiple Customer Management (MCM), которая управляет ресурсом, запрашивающим рекламу.
metadata.event_id string
Уникальный идентификатор для этого события во всех таблицах.
metadata.network_code string
Идентифицирует сеть издателя, которая контролирует инвентарь, заполняемый рекламным запросом.
metadata.request_id string
Идентификатор, общий для всех событий, связанных с запросом на заполнение одного рекламного блока (рекламного места). Совместно со всеми запросами и более поздними событиями, связанными с архитектурой единого запроса (SRA) или запросом модуля видео.
order_cost int
Сумма, которую пользователь заплатил рекламодателю, указанная в параметре cost= тега Spotlight.
order_number string
Номер заказа пользователя у рекламодателя, указанный в параметре ord= тега Spotlight.
order_quantity int
Количество товаров, приобретенных пользователем у рекламодателя, указанное в параметре qty= тега Spotlight.
request_time_usec timestamp
Отметка времени первоначального запроса в Google, который стал запросом объявления.
trigger_usec timestamp
Отметка времени действия пользователя, которое привело к этому действию.
user_id string
Назначенный Google идентификатор браузера, отправившего рекламное событие. Не может быть извлечен.
user_ppid string
Закодированный идентификатор, предоставленный издателем (PPID) из запроса объявления. Невозможно расшифровать. Не может быть извлечен.

Показ объявлений Менеджера рекламы 360

am360_creative_serves
delivery struct
Группа полей, описывающих рекламу, показанную для заполнения запроса.
delivery.advertiser_company_id int
Идентификатор компании, связанной с этим заказом. Также можно найти через таблицу метаданных заказа. Только бронирование. Присоединяется к am360_match_company.company_id.
delivery.auction_id string
Если аукцион проводился для заполнения показа объявлений, связанного с этим событием, идентификатор записи аукциона. Присоединяется к am360_auctions.metadata.event_id.
delivery.bidder_name string
Название сети покупателя учетной записи участника торгов или название сторонней биржи, наполнившей объявление.
delivery.buyer_name string
Название сети покупателя или сторонней биржи, наполнившей объявление.
delivery.classified_advertiser_name string
Классифицированное Google имя рекламодателя, чье объявление было показано.
delivery.creative_id int
Идентификатор креатива с резервированием издателя, который был показан. Только бронирование
delivery.creative_serve_id string
Идентификатор показанного объявления. Если это событие было подачей креатива, будет равно event_id. Присоединяется к am360_creative_serves.metadata.event_id.
delivery.creative_size_delivered string
Размер показанного креатива.
delivery.deal_id string
Идентификатор прямой сделки, использованный при выборе этого объявления.
delivery.deal_type string
Тип прямой сделки (например, "Гарантированная программа", "Приоритетная сделка", "Частный аукцион" и т. д.).
delivery.demand_channel string
Канал спроса, по которому поступил запрос объявления (например, "Сервер объявлений", "Открытый аукцион" и т. д.)
delivery.estimated_revenue double
Оценка дохода, который издатель получит от этого события, в валюте сети издателя по умолчанию. Это целые денежные единицы, а не цена за тысячу показов.
delivery.line_item_id int
Позиция, в которой разрешен показ этого объявления. Присоединяется к am360_match_line_item.line_item_id.
delivery.optimization_type string
Тип оптимизации, примененный при выборе этого объявления (например, «Оптимизированный конкурс», «Целевая цена за тысячу показов», «Первый выбор»).
delivery.order_id int
Заказ (также известный как кампания), который содержит позицию. Присоединяется к am360_match_order.order_id.
delivery.query_id string
Идентификатор исходной записи запроса в таблице запросов. Присоединяется к am360_queries.metadata.event_id.
delivery.targeted_audience_segment_ids int
Идентификаторы сегмента аудитории (он же список пользователей), используемые при таргетинге этого объявления на пользователя. Включает как положительные, так и отрицательные совпадения.
delivery.targeted_custom_criteria struct
Повторяющееся поле, описывающее, как custom_criteria из инвентаря использовались при таргетинге на это объявление.
delivery.targeted_custom_criteria.is_negative_match bool
Истинно, если на этот ключ/значение был нанесен отрицательный таргетинг.
delivery.targeted_custom_criteria.key string
Имя ключа custom_criteria.
delivery.targeted_custom_criteria.match_type string
Тип выполненного соответствия (например, «Общее», «Точное», «Префикс» и т. д.).
delivery.targeted_custom_criteria.pattern string
Шаблон, которому соответствует значение из inventory.custom_criteria.
delivery.video_fallback_index int
Индекс этого резервного видеокреатива или null.
delivery.yield_group_ids int
Идентификаторы групп доходности, которые позволили этому источнику спроса показывать это объявление.
delivery.yield_partner_id int
Идентификатор компании, заполнявшей это объявление. Присоединяется к am360_match_company.company_id.
event_time_usec timestamp
Отметка времени конкретного события.
inventory struct
Группа полей, описывающих свойства инвентаря из рекламного запроса.
inventory.ad_unit_id int
Идентификатор рекламного блока (также известного как единица инвентаря), в котором будет отображаться реклама. Присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_path int
Путь к рекламному блоку. Рекламные блоки организованы в виде иерархического дерева, например «корневая страница/спорт/главная страница/верхняя часть». Первая запись в этом списке — это идентификатор корневого рекламного блока, уникальный для каждой сети издателя, а последняя запись — это лист. Каждая запись присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_sizes string
Запрошенный(ые) размер(а) объявления для показа в этом рекламном блоке. Может содержать такие значения, как «320 x 250», «Исходный» и «Гибкий».
inventory.custom_criteria struct
Повторяющееся поле, содержащее ключевые значения в произвольной форме, переданные через запрос объявления. Если ключ передается в запросе объявления несколько раз, каждый из них будет отображаться как отдельная запись custom_criteria.
inventory.custom_criteria.key string
Ключ этого специального критерия, передаваемого в запросе объявления.
inventory.custom_criteria.value string
Значение этого пользовательского критерия, переданное в запросе объявления.
inventory.device struct
Группа полей, описывающих устройство, которое сделало рекламный запрос.
inventory.device_category string
Тип устройства, например «Смартфон» или «Настольный компьютер».
inventory.geo struct
Группа полей, описывающих географическое положение, откуда поступил рекламный запрос.
inventory.geo.country string
Название страны, из которой поступил рекламный запрос.
inventory.geo.language string
Язык запроса.
inventory.geo.language_country string
Страна языка запроса. Может отличаться от страны, если, например, кто-то из Севильи посещает США. Часто ноль.
inventory.geo.region string
Название географического региона, из которого поступил рекламный запрос.
inventory.inventory_format bool
Название формата запрашиваемой инвентаризации. Один из вариантов «Нативная пользовательская визуализация», «Видео In-Stream», «Аудио In-Stream», «Межстраничное объявление», «С вознаграждением», «Межстраничное объявление с вознаграждением», «Открытие приложения», «Баннер» или «Якорь». Нуль, если не указано.
inventory.is_companion bool
True, если запрос был связан с другим объявлением на странице. Такие события не учитываются в отчетах Менеджера рекламы.
inventory.matched_audience_segment_ids int
Идентификаторы сегментов аудитории (иначе списки пользователей), видимые в сети издателя, которые содержат идентификатор пользователя, делающего рекламный запрос.
inventory.placement_id int
Идентификатор места размещения (группы рекламных блоков). Присоединяется к am360_match_placement.placement_id.
inventory.referer_url string
Продезинфицированный URL-адрес страницы, выдавшей рекламный запрос; для веб-запросов это примерно URL-адрес страницы, которая запросила рекламу; для запросов мобильных объявлений это произвольная строка, похожая на URL, но идентифицирующая мобильное приложение.
inventory.video_content_id int
Идентификатор видеоконтента, рядом с которым отображается реклама (определяется издателем).
inventory.video_position int
Позиция в видео, где будет воспроизводиться реклама. 1 — преролл, 3 — постролл, 4+ — мидролл в последовательном порядке.
inventory.web_property string
Код веб-ресурса, связанный с запросом объявления.
metadata struct
Группа полей, содержащих метаданные о событии.
metadata.child_network_code string
Идентифицирует дочернюю сеть Multiple Customer Management (MCM), которая управляет ресурсом, запрашивающим рекламу.
metadata.event_id string
Уникальный идентификатор для этого события во всех таблицах.
metadata.network_code string
Идентифицирует сеть издателя, которая контролирует инвентарь, заполняемый рекламным запросом.
metadata.request_id string
Идентификатор, общий для всех событий, связанных с запросом на заполнение одного рекламного блока (рекламного места). Совместно со всеми запросами и более поздними событиями, связанными с архитектурой единого запроса (SRA) или запросом модуля видео.
request_time_usec timestamp
Отметка времени первоначального запроса в Google, который стал запросом объявления.
user_id string
Назначенный Google идентификатор браузера, отправившего рекламное событие. Не может быть извлечен.
user_ppid string
Закодированный идентификатор, предоставленный издателем (PPID) из запроса объявления. Невозможно расшифровать. Не может быть извлечен.

Показы Менеджера рекламы 360

am360_impressions
delivery struct
Группа полей, описывающих рекламу, показанную для заполнения запроса.
delivery.advertiser_company_id int
Идентификатор компании, связанной с этим заказом. Также можно найти через таблицу метаданных заказа. Только бронирование. Присоединяется к am360_match_company.company_id.
delivery.auction_id string
Если аукцион проводился для заполнения показа объявлений, связанного с этим событием, идентификатор записи аукциона. Присоединяется к am360_auctions.metadata.event_id.
delivery.bidder_name string
Название сети покупателя учетной записи участника торгов или название сторонней биржи, наполнившей объявление.
delivery.buyer_name string
Название сети покупателя или сторонней биржи, наполнившей объявление.
delivery.classified_advertiser_name string
Классифицированное Google имя рекламодателя, чье объявление было показано.
delivery.creative_id int
Идентификатор креатива с резервированием издателя, который был показан. Только бронирование
delivery.creative_serve_id string
Идентификатор показанного объявления. Если это событие было подачей креатива, будет равно event_id. Присоединяется к am360_creative_serves.metadata.event_id.
delivery.creative_size_delivered string
Размер показанного креатива.
delivery.deal_id string
Идентификатор прямой сделки, использованный при выборе этого объявления.
delivery.deal_type string
Тип прямой сделки (например, "Гарантированная программа", "Приоритетная сделка", "Частный аукцион" и т. д.).
delivery.demand_channel string
Канал спроса, по которому поступил запрос объявления (например, "Сервер объявлений", "Открытый аукцион" и т. д.)
delivery.estimated_revenue double
Оценка дохода, который издатель получит от этого события, в валюте сети издателя по умолчанию. Это целые денежные единицы, а не цена за тысячу показов.
delivery.line_item_id int
Позиция, в которой разрешен показ этого объявления. Присоединяется к am360_match_line_item.line_item_id.
delivery.optimization_type string
Тип оптимизации, примененный при выборе этого объявления (например, «Оптимизированный конкурс», «Целевая цена за тысячу показов», «Первый выбор»). Может быть нулевым
delivery.order_id int
Заказ (также известный как кампания), который содержит позицию. Присоединяется к am360_match_order.order_id.
delivery.query_id string
Идентификатор исходной записи запроса в таблице запросов. Присоединяется к am360_queries.metadata.event_id.
delivery.targeted_audience_segment_ids int
Идентификаторы сегмента аудитории (он же список пользователей), используемые при таргетинге этого объявления на пользователя, как положительные, так и отрицательные совпадения.
delivery.targeted_custom_criteria struct
Повторяющееся поле, описывающее, как custom_criteria из инвентаря использовались при таргетинге на это объявление.
delivery.targeted_custom_criteria.is_negative_match bool
Было ли отрицательное соответствие этому ключу/значению при таргетинге позиции.
delivery.targeted_custom_criteria.key string
Имя ключа custom_criteria.
delivery.targeted_custom_criteria.match_type string
Тип выполненного соответствия (например, «Общее», «Точное», «Префикс» и т. д.).
delivery.targeted_custom_criteria.pattern string
Шаблон, которому соответствует значение из inventory.custom_criteria.
delivery.video_fallback_index int
Индекс этого резервного видеокреатива или null.
delivery.yield_group_ids int
Идентификаторы групп доходности, которые позволили этому источнику спроса заполнить это объявление.
delivery.yield_partner_id int
Идентификатор компании, заполнявшей это объявление. Присоединяется к am360_match_company.company_id.
event_time_usec timestamp
Отметка времени конкретного события.
inventory struct
Группа полей, описывающих свойства инвентаря из рекламного запроса.
inventory.ad_unit_id int
Идентификатор рекламного блока (также известного как единица инвентаря), в котором будет отображаться реклама. Присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_path int
Путь к рекламному блоку. Рекламные блоки организованы в виде иерархического дерева, например «корневая страница/спорт/главная страница/верхняя часть». Первая запись в этом списке — это идентификатор корневого рекламного блока, уникальный для каждой сети издателя, а последняя запись — это лист. Каждая запись присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_sizes string
Запрошенный(ые) размер(а) объявления для показа в этом рекламном блоке. Может содержать такие значения, как «320 x 250», «Исходный» и «Гибкий».
inventory.custom_criteria struct
Повторяющееся поле, содержащее ключевые значения в произвольной форме, переданные через запрос объявления. Если ключ передается в запросе объявления несколько раз, каждый из них будет отображаться как отдельная запись custom_criteria.
inventory.custom_criteria.key string
Ключ этого специального критерия, передаваемого в запросе объявления.
inventory.custom_criteria.value string
Значение этого пользовательского критерия, переданное в запросе объявления.
inventory.device struct
Группа полей, описывающих устройство, которое сделало рекламный запрос.
inventory.device_category string
Тип устройства, например «Смартфон» или «Настольный компьютер».
inventory.geo struct
Группа полей, описывающих географическое положение, откуда поступил рекламный запрос.
inventory.geo.country string
Название страны, из которой поступил рекламный запрос.
inventory.geo.language string
Язык запроса.
inventory.geo.language_country string
Страна языка запроса. Может отличаться от страны, если, например, кто-то из Севильи посещает США. Часто ноль.
inventory.geo.region string
Название географического региона, из которого поступил рекламный запрос.
inventory.inventory_format bool
Название формата запрашиваемой инвентаризации. Один из вариантов «Нативная пользовательская визуализация», «Видео In-Stream», «Аудио In-Stream», «Межстраничное объявление», «С вознаграждением», «Межстраничное объявление с вознаграждением», «Открытие приложения», «Баннер» или «Якорь». Нуль, если не указано.
inventory.is_companion bool
True, если запрос был связан с другим объявлением на странице. Такие события не учитываются в отчетах Менеджера рекламы.
inventory.matched_audience_segment_ids int
Идентификаторы сегментов аудитории (иначе списки пользователей), видимые в сети издателя, которые содержат идентификатор пользователя, делающего рекламный запрос.
inventory.placement_id int
Идентификатор места размещения (группы рекламных блоков). Присоединяется к am360_match_placement.placement_id.
inventory.referer_url string
Продезинфицированный URL-адрес страницы, выдавшей рекламный запрос; для веб-запросов это примерно URL-адрес страницы, которая запросила рекламу; для запросов мобильных объявлений это произвольная строка, похожая на URL, но идентифицирующая мобильное приложение.
inventory.video_content_id int
Идентификатор видеоконтента, рядом с которым отображается реклама (определяется издателем).
inventory.video_position int
Позиция в видео, где будет воспроизводиться реклама. 1 — преролл, 3 — постролл, 4+ — мидролл в последовательном порядке.
inventory.web_property string
Код веб-ресурса, связанный с запросом объявления.
metadata struct
Группа полей, содержащих метаданные о событии.
metadata.child_network_code string
Идентифицирует дочернюю сеть Multiple Customer Management (MCM), которая управляет ресурсом, запрашивающим рекламу.
metadata.event_id string
Уникальный идентификатор для этого события во всех таблицах.
metadata.network_code string
Идентифицирует сеть издателя, которая контролирует инвентарь, заполняемый рекламным запросом.
metadata.request_id string
Идентификатор, общий для всех событий, связанных с запросом на заполнение одного рекламного блока (рекламного места). Совместно со всеми запросами и более поздними событиями, связанными с архитектурой единого запроса (SRA) или запросом модуля видео.
request_time_usec timestamp
Отметка времени первоначального запроса в Google, который стал запросом объявления.
user_id string
Назначенный Google идентификатор браузера, отправившего рекламное событие. Не может быть извлечен.
user_ppid string
Закодированный идентификатор, предоставленный издателем (PPID) из запроса объявления. Невозможно расшифровать. Не может быть извлечен.

Взаимодействия с Менеджером рекламы 360

am360_interactions
action_count int
Количество действий, совершенных пользователем. Всегда 1 для кликов.
action_duration_sec double
Продолжительность этих действий. Всегда 1.0 для кликов.
action_type string
Тип действия (один из «Клик», «Стандартный» или «Пользовательский»).
delivery struct
Группа полей, описывающих рекламу, показанную для заполнения запроса.
delivery.advertiser_company_id int
Идентификатор компании, связанной с этим заказом. Также можно найти через таблицу метаданных заказа. Только бронирование. Присоединяется к am360_match_company.company_id.
delivery.auction_id string
Если аукцион проводился для заполнения показа объявлений, связанного с этим событием, идентификатор записи аукциона. Присоединяется к am360_auctions.metadata.event_id.
delivery.bidder_name string
Название сети покупателя учетной записи участника торгов или название сторонней биржи, наполнившей объявление.
delivery.buyer_name string
Название сети покупателя или сторонней биржи, наполнившей объявление.
delivery.classified_advertiser_name string
Классифицированное Google имя рекламодателя, чье объявление было показано.
delivery.creative_id int
Идентификатор креатива с резервированием издателя, который был показан. Только бронирование
delivery.creative_serve_id string
Идентификатор показанного объявления. Если это событие было подачей креатива, будет равно event_id. Присоединяется к am360_creative_serves.metadata.event_id.
delivery.creative_size_delivered string
Размер показанного креатива.
delivery.deal_id string
Идентификатор прямой сделки, использованный при выборе этого объявления.
delivery.deal_type string
Тип прямой сделки (например, "Гарантированная программа", "Приоритетная сделка", "Частный аукцион" и т. д.).
delivery.demand_channel string
Канал спроса, по которому поступил запрос объявления (например, "Сервер объявлений", "Открытый аукцион" и т. д.)
delivery.estimated_revenue double
Оценка дохода, который издатель получит от этого события, в валюте сети издателя по умолчанию. Это целые денежные единицы, а не цена за тысячу показов.
delivery.line_item_id int
Позиция, в которой разрешен показ этого объявления. Присоединяется к am360_match_line_item.line_item_id.
delivery.optimization_type string
Тип оптимизации, примененный при выборе этого объявления (например, «Оптимизированный конкурс», «Целевая цена за тысячу показов», «Первый выбор»). Может быть нулевым
delivery.order_id int
Заказ (также известный как кампания), который содержит позицию. Присоединяется к am360_match_order.order_id.
delivery.query_id string
Идентификатор исходной записи запроса в таблице запросов. Присоединяется к am360_queries.metadata.event_id.
delivery.targeted_audience_segment_ids int
Идентификаторы сегмента аудитории (он же список пользователей), используемые при таргетинге этого объявления на пользователя, как положительные, так и отрицательные совпадения.
delivery.targeted_custom_criteria struct
Повторяющееся поле, описывающее, как custom_criteria из инвентаря использовались при таргетинге на это объявление.
delivery.targeted_custom_criteria.is_negative_match bool
Было ли отрицательное соответствие этому ключу/значению при таргетинге позиции.
delivery.targeted_custom_criteria.key string
Имя ключа custom_criteria.
delivery.targeted_custom_criteria.match_type string
Тип выполненного соответствия (например, «Общее», «Точное», «Префикс» и т. д.).
delivery.targeted_custom_criteria.pattern string
Шаблон, которому соответствует значение из inventory.custom_criteria.
delivery.video_fallback_index int
Индекс этого резервного видеокреатива или null.
delivery.yield_group_ids int
Идентификаторы групп доходности, которые позволили этому источнику спроса заполнить это объявление.
delivery.yield_partner_id int
Идентификатор компании, заполнявшей это объявление. Присоединяется к am360_match_company.company_id.
event_time_usec timestamp
Отметка времени конкретного события.
inventory struct
Группа полей, описывающих свойства инвентаря из рекламного запроса.
inventory.ad_unit_id int
Идентификатор рекламного блока (также известного как единица инвентаря), в котором будет отображаться реклама. Присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_path int
Путь к рекламному блоку. Рекламные блоки организованы в виде иерархического дерева, например «корневая страница/спорт/главная страница/верхняя часть». Первая запись в этом списке — это идентификатор корневого рекламного блока, уникальный для каждой сети издателя, а последняя запись — это лист. Каждая запись присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_sizes string
Запрошенный(ые) размер(а) объявления для показа в этом рекламном блоке. Может содержать такие значения, как «320 x 250», «Исходный» и «Гибкий».
inventory.custom_criteria struct
Повторяющееся поле, содержащее ключевые значения в произвольной форме, переданные через запрос объявления. Если ключ передается в запросе объявления несколько раз, каждый из них будет отображаться как отдельная запись custom_criteria.
inventory.custom_criteria.key string
Ключ этого специального критерия, передаваемого в запросе объявления.
inventory.custom_criteria.value string
Значение этого пользовательского критерия, переданное в запросе объявления.
inventory.device struct
Группа полей, описывающих устройство, которое сделало рекламный запрос.
inventory.device_category string
Тип устройства, например «Смартфон» или «Настольный компьютер».
inventory.geo struct
Группа полей, описывающих географическое положение, откуда поступил рекламный запрос.
inventory.geo.country string
Название страны, из которой поступил рекламный запрос.
inventory.geo.language string
Язык запроса.
inventory.geo.language_country string
Страна языка запроса. Может отличаться от страны, если, например, кто-то из Севильи посещает США. Часто ноль.
inventory.geo.region string
Название географического региона, из которого поступил рекламный запрос.
inventory.inventory_format bool
Название формата запрашиваемой инвентаризации. Один из вариантов «Нативная пользовательская визуализация», «Видео In-Stream», «Аудио In-Stream», «Межстраничное объявление», «С вознаграждением», «Межстраничное объявление с вознаграждением», «Открытие приложения», «Баннер» или «Якорь». Нуль, если не указано.
inventory.is_companion bool
True, если запрос был связан с другим объявлением на странице. Такие события не учитываются в отчетах Менеджера рекламы.
inventory.matched_audience_segment_ids int
Идентификаторы сегментов аудитории (иначе списки пользователей), видимые в сети издателя, которые содержат идентификатор пользователя, делающего рекламный запрос.
inventory.placement_id int
Идентификатор места размещения (группы рекламных блоков). Присоединяется к am360_match_placement.placement_id.
inventory.referer_url string
Продезинфицированный URL-адрес страницы, выдавшей рекламный запрос; для веб-запросов это примерно URL-адрес страницы, которая запросила рекламу; для запросов мобильных объявлений это произвольная строка, похожая на URL, но идентифицирующая мобильное приложение.
inventory.video_content_id int
Идентификатор видеоконтента, рядом с которым отображается реклама (определяется издателем).
inventory.video_position int
Позиция в видео, где будет воспроизводиться реклама. 1 — преролл, 3 — постролл, 4+ — мидролл в последовательном порядке.
inventory.web_property string
Код веб-ресурса, связанный с запросом объявления.
metadata struct
Группа полей, содержащих метаданные о событии.
metadata.child_network_code string
Идентифицирует дочернюю сеть Multiple Customer Management (MCM), которая управляет ресурсом, запрашивающим рекламу.
metadata.event_id string
Уникальный идентификатор для этого события во всех таблицах.
metadata.network_code string
Идентифицирует сеть издателя, которая контролирует инвентарь, заполняемый рекламным запросом.
metadata.request_id string
Идентификатор, общий для всех событий, связанных с запросом на заполнение одного рекламного блока (рекламного места). Совместно со всеми запросами и более поздними событиями, связанными с архитектурой единого запроса (SRA) или запросом модуля видео.
request_time_usec timestamp
Отметка времени первоначального запроса в Google, который стал запросом объявления.
user_id string
Назначенный Google идентификатор браузера, отправившего рекламное событие. Не может быть извлечен.
user_ppid string
Закодированный идентификатор, предоставленный издателем (PPID) из запроса объявления. Невозможно расшифровать. Не может быть извлечен.

Действия с совпадениями в Менеджере рекламы 360

am360_match_activity
activity_group_clicks_lookback_days int
Количество дней ретроспективного анализа для отслеживания конверсий по кликам для всех действий в группе действий, к которой принадлежит это действие.
activity_group_company_ids int
Идентификаторы компаний, объявления которых будут включены для отслеживания конверсий по действиям в группе действий, к которой принадлежит это действие. Присоединяется к am360_match_company.company_id.
activity_group_display_name string
Читаемое человеком отображаемое имя группы действий, к которой принадлежит это действие.
activity_group_id int
Уникальный идентификатор, представляющий группу действий, к которой принадлежит это действие.
activity_group_impressions_lookback_days int
Количество дней ретроспективного анализа для отслеживания конверсий по показам для всех действий в группе действий, к которой принадлежит это действие.
activity_id int
Уникальный идентификатор, представляющий это действие.
activity_type string
Удобочитаемая строка, представляющая тип активности, отслеживаемой этой активностью. Может быть одним из «Неуказанных», «Загрузок приложений Android», «Пользовательских», «Ежедневных посещений», «Загрузок приложений iOS», «Приобретенных товаров», «Просмотров страниц» или «Транзакций».
display_name string
Человекочитаемое отображаемое имя.
expected_url string
URL-адрес веб-страницы, на которой будут размещены теги этого действия.

Менеджер рекламы 360 соответствует рекламному блоку

am360_match_ad_unit
ad_unit_code string
Определяемая издателем или сгенерированная строка, используемая для идентификации этого рекламного блока.
parent_ad_unit_code_hierarchy string
Путь к коду рекламного блока, ведущий к этому рекламному блоку. Первый код в списке является корневым, а последний равен ad_unit_code.
ad_unit_id int
Уникальный идентификатор, представляющий этот рекламный блок.
display_name string
Человекочитаемое отображаемое имя.
external_set_top_box_channel_id string
Канал видео по запросу телевизионной приставки, которому соответствует этот рекламный блок во внешней системе рекламной кампании телевизионной приставки.
is_fluid bool
True, если этот рекламный блок поддерживает изменчивую рекламу.
is_interstitial bool
True, если этот рекламный блок поддерживает межстраничные объявления.
is_native bool
True, если этот рекламный блок поддерживает нативную рекламу.
parent_ad_unit_id int
Идентификатор рекламного блока на один выше этого рекламного блока в иерархии. Присоединяется к am360_match_ad_unit.ad_unit_id.

Менеджер рекламы 360 соответствует компании

am360_match_company
company_id int
Уникальный идентификатор, который представляет эту компанию.
display_name string
Понятное для человека название компании.

Позиция соответствия Менеджера рекламы 360

am360_match_line_item
cost_per_unit double
Стоимость единицы выполненного показа этой позиции в валюте сети издателя по умолчанию.
cost_type string
Метод, используемый для выставления счетов за этот LineItem. Одна из «CPA», «CPC», «CPD», «CPM», «CPMAV» или «CPM_IN_TARGET».
create_time timestamp
Дата и время создания позиции.
display_name string
Человекочитаемое отображаемое имя.
end_time timestamp
Дата и время прекращения показа позиции.
external_deal_id string
Внешний идентификатор, используемый издателем и покупателем для сделки, связанной с этой позицией. Заполняется только для кампаний с алгоритмической продажей и только после завершения сделки.
external_id string
Значение, установленное издателем, которое имеет смысл во внешних системах.
line_item_id int
Уникальный идентификатор, который представляет эту позицию.
missing_creatives bool
True, если в этой позиции отсутствует хотя бы одно ожидаемое объявление, указанное при настройке.
order_id int
Заказ (также известный как кампания), к которому принадлежит эта позиция. Присоединяется к am360_match_order.order_id.
priority int
Приоритет позиции. См. https://developers.google.com/ad-manager/api/reference/latest/ForecastService.LineItem#priority.
start_time timestamp
Дата и время начала показа позиции.

Порядок сопоставления Менеджера рекламы 360

am360_match_order
advertiser_company_id int
Рекламодатель, связанный с этим заказом. Присоединяется к am360_match_company.company_id.
agency_id int
Агентство, связанное с этим заказом. Присоединяется к company.company_id.
display_name string
Человекочитаемое отображаемое имя.
end_time_usec timestamp
Дата и время прекращения доставки заказа.
external_order_id string
Значение, установленное издателем, которое имеет смысл во внешних системах.
is_programmatic bool
Указывает, является ли заказ программным заказом.
order_id int
Уникальный идентификатор, представляющий этот заказ.
po_number string
Значение, установленное издателем для хранения номера заказа на покупку для этого заказа.
start_time_usec timestamp
Дата и время начала доставки заказа.

Место размещения, соответствующее Менеджеру рекламы 360

am360_match_placement
ad_unit_ids int
Коллекция идентификаторов рекламных блоков, составляющих это место размещения. Присоединяется к am360_match_ad_unit.ad_unit_id.
display_name string
Человекочитаемое отображаемое имя.
placement_code string
Определяемая издателем или сгенерированная строка, используемая для идентификации этого места размещения.
placement_id int
Уникальный идентификатор, представляющий это место размещения.

Запросы Менеджера рекламы 360

am360_queries
auction_id string
Идентификатор аукциона, проведенного по данному конкретному запросу. Доступно не по всем запросам. В некоторых случаях это может указывать на несуществующий аукцион. Присоединяется к am360_auctions.metadata.event_id.
event_time_usec timestamp
Отметка времени конкретного события.
inventory struct
Группа полей, описывающих свойства инвентаря из рекламного запроса.
inventory.ad_unit_id int
Идентификатор рекламного блока (также известного как единица инвентаря), в котором будет отображаться реклама. Присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_path int
Путь к рекламному блоку. Рекламные блоки организованы в виде иерархического дерева, например «корневая страница/спорт/главная страница/верхняя часть». Первая запись в этом списке — это идентификатор корневого рекламного блока, уникальный для каждой сети издателя, а последняя запись — это лист. Каждая запись присоединяется к am360_match_ad_unit.ad_unit_id.
inventory.ad_unit_sizes string
Запрошенный(ые) размер(а) объявления для показа в этом рекламном блоке. Может содержать такие значения, как «320 x 250», «Исходный» и «Гибкий».
inventory.custom_criteria struct
Повторяющееся поле, содержащее ключевые значения в произвольной форме, переданные через запрос объявления. Если ключ передается в запросе объявления несколько раз, каждый из них будет отображаться как отдельная запись custom_criteria.
inventory.custom_criteria.key string
Ключ этого специального критерия, передаваемого в запросе объявления.
inventory.custom_criteria.value string
Значение этого пользовательского критерия, переданное в запросе объявления.
inventory.device struct
Группа полей, описывающих устройство, которое сделало рекламный запрос.
inventory.device_category string
Тип устройства, например «Смартфон» или «Настольный компьютер».
inventory.geo struct
Группа полей, описывающих географическое положение, откуда поступил рекламный запрос.
inventory.geo.country string
Название страны, из которой поступил рекламный запрос.
inventory.geo.language string
Язык запроса.
inventory.geo.language_country string
Страна языка запроса. Может отличаться от страны, если, например, кто-то из Севильи посещает США. Часто ноль.
inventory.geo.region string
The name of the geographical region where the ad query came from.
inventory.inventory_format bool
The name of the format of the inventory being requested. One of 'Native Custom Rendering', 'In-stream Video', 'In-stream Audio', 'Interstitial', 'Rewarded', 'Rewarded Interstitial', 'App Open', 'Banner', or 'Anchor'. Null if unspecified.
inventory.is_companion bool
True if the query was for a companion to another ad on the page. Such events are not counted by Ad Manager Reports.
inventory.matched_audience_segment_ids int
The IDs of audience segments (aka user lists) visible to the publisher network that contain the user ID making the ad query.
inventory.placement_id int
The ID of the placement (a group of ad units). Joins to am360_match_placement.placement_id.
inventory.referer_url string
The sanitized URL of the page that issued the ad query; for web queries, this is approximately the URL of the page that requested the ad; for mobile ad queries, this is an arbitrary string that looks like a URL, but identifies the mobile app.
inventory.video_content_id int
The ID of the video content the ad is displaying against.
inventory.video_position int
The position in the video where the ad will play. 1 is preroll, 3 is postroll, and 4+ are midrolls in consecutive order.
inventory.web_property string
The web property code associated with the ad request.
is_filled bool
True if query is associated with any rows in the am360_creative_serves table.
is_video_backup bool
True if this query was for a video backup ad. Such queries are not counted by Ad Manager Reports.
metadata struct
A group of fields containing metadata about the event.
metadata.child_network_code string
Identifies the Multiple Customer Management (MCM) child network who operates the property requesting the ad.
metadata.event_id string
A unique ID for this event across all tables. May be referenced by fields in other tables.
metadata.network_code string
Identifies the publisher network that controls the inventory being filled by the ad query.
metadata.request_id string
An identifier shared by all events related to a request to fill a single ad block (aka ad slot). Shared among all queries and later events related to a Single Request Architecture (SRA) or Video Pod request.
request_time_usec timestamp
The timestamp of the initial request to Google that became the ad query.
user_id string
Google-assigned ID of the browser that sent the ad event. Cannot be extracted.
user_ppid string
Encoded Publisher Provided ID (PPID) from the ad query. Cannot be decoded. Cannot be extracted.