Bid Manager API версии 1.1 устарел в августе 2022 г. и прекратит свое существование 28 февраля 2023 г.

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

Передача данных v2.0: Формат файла

Все файлы передачи данных хранятся в виде значений, разделенных запятыми (CSV). Из-за настраиваемого характера передачи данных ваши файлы могут не содержать все поля, указанные ниже.

  • Первая строка файла всегда является строкой заголовка, содержащей имена столбцов.
  • Для полей, содержащих специальные символы, содержимое поля заключается в кавычки.
  • Отсутствующие значения остаются пустыми.
  • Строки не сортируются.
  • Таблицы соответствия для полей Дисплея и Видео 360 представлены в формате файла для чтения объектов. Подробнее о таблицах соответствия Дисплея и Видео 360…
Поля Тип Впечатление Нажмите Мероприятия Мультимедиа Описание
Active View: допустимые показы Длинная Да Нет Нет Нет Подходил ли показ для измерения видимости. Показ засчитывается, если (а) креатив объявления содержит тег Active View и (б) этот тег успешно взаимодействует с серверами Google Платформа для маркетинга во время показа.

Дополнительную информацию см. в справке Active View .
Active View: отслеживаемые показы Длинная Да Нет Нет Нет Можно ли было измерить показ с помощью Active View
Active View: показы в видимой области экрана Длинная Да Нет Нет Нет Был ли показ видимым
Идентификатор действия Длинная Нет Нет Да Нет Идентификатор тега Floodlight, связанного с событием-конверсией.
Время события Длинная Да Да Да Нет Время в микросекундах с 01 января 1970 г. 00:00:00 UTC
Тип события Нить Да Да Да Нет Содержит сведения, относящиеся к событию. Это "ПРОСМОТР" и "КЛИК" для просмотра и кликов, но может быть "КОНВЕРСИЯ" или пустое значение для событий-конверсий.
Подтип события Нить Да Да Да Нет Содержит дополнительную информацию, связанную с событием — это «VIEW» и «CLICK» для событий просмотра и нажатия, но может быть «POSTVIEW», «POSTCLICK» или пустым для событий конверсии.
ID пользователя Нить Да Да Да Нет Идентификатор отслеживания (он основан на файлах cookie браузера пользователя или идентификаторе мобильного устройства, но не раскрывает их). Это поле может быть обнулено по соображениям конфиденциальности.
Идентификатор Partner1 Нить Да Да Да Нет Зашифрованное значение Partner1
Идентификатор партнера 2 Нить Да Да Да Нет Зашифрованное значение Partner2
Состояние представления DBM Нить Да Нет Нет Нет Когда контейнеры тегов используются для сторонней проверки или показа, состояние просмотра указывает, успешно ли Дисплей и Видео 360 выиграл показ, было ли показано объявление на этом инвентаре и был ли показ отслежен Менеджером кампаний. Значение «внешний» означает, что Дисплей и Видео 360 выиграл ставку и вернул упакованный тег для показа на сайте издателя. Значение «внутренний» означает, что реклама была показана, потому что инвентарь считался безопасным для бренда. Когда произойдут оба события, будет две записи о показах. Одна запись о показе со значением «внешнее» и отсутствие соответствующей записи со значением «внутренний» означает, что сторонняя служба проверки заблокировала показ после подачи заявки. Значение "3pas_merged" означает, что показ в Дисплее и Видео 360 в оболочке успешно отслеживается Менеджером кампаний. Значение "3pas_outer" означает, что в Менеджер кампаний был отправлен запрос проверки связи, но ответа не последовало. Тем не менее Display & Video 360 все равно выиграл торги и запросил отправку креатива со стороннего рекламного сервера.
Идентификатор аукциона DBM Нить Да Да Да Нет Строка, используемая для объединения событий между типами просмотр/клик/конверсия, например "ABCDEFGH_abcdefgh-0123456789". Не предполагайте какой-либо порядок, структуру или значение значения аукциона_id.
Время запроса DBM Длинная Да Да Да Нет Временная метка Unix в микросекундах (1/1 000 000 секунды), указывающая, когда мы получили запрос объявления, например 1330403779608570, соответствует вторнику, 28 февраля 2012 года, 04:36:19.608570. Несмотря на то, что это значение одинаково для просмотра, клика и конверсии, даже оно не может быть уникальным — пожалуйста, используйте аукционный идентификатор, чтобы присоединиться к событиям.
Идентификатор рекламодателя DBM Длинная Да Да Да Нет Числовой идентификатор рекламодателя в Дисплее и Видео 360, связанный с событием, например 164332.
Идентификатор заказа на размещение в DBM Длинная Да Да Да Нет Числовой идентификатор заказа на размещение в Дисплее и Видео 360, связанного с событием, например 1079941.
Идентификатор кампании DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360 для позиции, связанной с событием, например 1155785.
Идентификатор кампании DBM Длинная Да Да Да Нет Уникальный идентификатор кампании Display & Video 360.
Идентификатор объявления в DBM Длинная Да Да Да Нет Числовой идентификатор в Дисплее и Видео 360 для креатива, связанного с событием, например 367487.
Цена предложения DBM (долл. США) Длинная Да Да Да Нет Цена предложения, отправленная на биржу в нанодолларах США. Вы можете разделить на 1 000 000 000, чтобы увидеть цену предложения в долларах США. Цена ставки – это значение, которое позиция присваивает показу до корректировки аукциона первой цены. Для позиции с фиксированной ценой за тысячу показов это фиксированная цена за тысячу показов позиции на момент назначения ставки. Несмотря на то, что ставка отправляется на биржи как значение CPM, цена ставки представлена ​​в виде цены за показ для согласованности с другими показателями.
Цена предложения DBM (валюта партнера) Длинная Да Да Да Нет Цена предложения отправляется на биржу в нано валюты партнера. Вы можете разделить на 1 000 000 000, чтобы увидеть цену предложения в долларах США. Цена ставки – это значение, которое позиция присваивает показу до корректировки аукциона первой цены. Для позиции с фиксированной ценой за тысячу показов это фиксированная цена за тысячу показов позиции на момент назначения ставки. Несмотря на то, что ставка отправляется на биржи как значение CPM, цена ставки представлена ​​в виде цены за показ для согласованности с другими показателями.
Ставка DBM (валюта рекламодателя) Длинная Да Да Да Нет Цена заявки, отправляемая на биржу в нано валюты рекламодателя. Вы можете разделить на 1 000 000 000, чтобы увидеть цену предложения в долларах США. Цена ставки – это значение, которое позиция присваивает показу до корректировки аукциона первой цены. Для позиции с фиксированной ценой за тысячу показов это фиксированная цена за тысячу показов позиции на момент назначения ставки. Несмотря на то, что ставка отправляется на биржи как значение CPM, цена ставки представлена ​​в виде цены за показ для согласованности с другими показателями.
URL-адрес DBM Нить Да Да Да Нет Необработанный URL-адрес, взятый из запроса ставки, полученного от биржи, например "http://www.example.com". Поскольку некоторые биржи маскируют URL-адрес в своих запросах ставок, это значение может быть «source_url_hidden».
Идентификатор сайта в DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360 для наиболее конкретного универсального сайта, который соответствует URL.
Язык БД Нить Да Да Да Нет Код ISO-639-1 или «zh_CN» (китайский (упрощенный)), «zh_TW» (китайский (традиционный)) или «другой», представляющий язык, связанный с событием просмотра.
Категории страниц AdX в DBM Нить Да Да Да Нет Содержит идентификаторы категорий страниц Ad Exchange, разделенные пробелом, например "65 189". Категории не могут быть взаимоисключающими
DBM, соответствующие целевым ключевым словам Нить Да Да Да Нет Строка, разделенная запятыми, содержащая список целевых ключевых слов, соответствующих странице, связанной с событием просмотра, например "яблоко, апельсин, банан". Хотя страница, связанная с событием просмотра, может соответствовать многим ключевым словам, будут включены только те, на которые был направлен таргетинг; если список ключевых слов большой, мы можем установить ограничение на количество возвращаемых ключевых слов
Идентификатор биржи DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360 для аукциона, запросившего объявление.
Внешний идентификатор источника атрибутивного инвентаря в DBM Нить Да Да Да Нет Внешний идентификатор атрибутированного источника инвентаря, который Дисплей и Видео 360 выбрал как наиболее подходящий из доступных рекламодателю, связанных с событием просмотра на основе минимальной цены и типа аукциона.
Источник инвентаря, указанный в DBM, является общедоступным логический Да Да Да Нет True, если источник инвентаря доступен всем покупателям. False в противном случае
Позиция объявления в DBM Длинная Да Да Да Нет Определяет позицию объявления на странице, если она известна. 1 обозначает верхнюю часть сгиба, 2 — нижнюю часть сгиба.
Код страны в DBM Нить Да Да Да Нет Двухбуквенный код страны ISO 3166-1, определяющий наиболее вероятную страну показа, например «США».
Идентификатор выделенной рыночной зоны (DMA) DBM Длинная Да Да Да Нет Код обозначенной торговой зоны, если он известен, например 807.
Почтовый индекс DBM Нить Да Да Да Нет Почтовый индекс, определяющий наиболее вероятный почтовый район оттиска, если он известен, например "98033". Не предполагайте уникальность в разных странах
Идентификатор штата/региона в DBM Длинная Да Да Да Нет Целое число, соответствующее целому числу штата/региона, доступному в отчетах и ​​таргетинге.
Идентификатор города в DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360, определяющий наиболее вероятный город показа.
Идентификатор операционной системы DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360, определяющий операционную систему, связанную с этим событием.
Идентификатор браузера/платформы DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360, идентифицирующий браузер, связанный с этим событием.
Минуты смещения часового пояса браузера DBM Длинная Да Да Да Нет Разница в минутах между активным часовым поясом в браузере пользователя и GMT-12, например, 1320 представляет собой часовой пояс браузера GMT+10.
Чистая скорость DBM Длинная Да Да Да Нет Числовой идентификатор Display & Video 360, представляющий скорость сети, связанную с событием просмотра.
1=Коммутируемый доступ
2=КРАЙ/2G
3=УМТС/3G
4=базовый DSL
5=HSDPA/3,5G
6=Широкополосный/4G
7=Неизвестно
Сопоставление DBM с целевыми сегментами Нить Да Да Да Нет Имена целевых списков пользователей, которые соответствуют посетителю, разделенные пробелом, например "-4 456". Если посетитель находится в списке пользователей, на которого не нацелена реклама, связанная с этим событием, он не будет включен сюда.
Идентификатор поставщика услуг Интернета в DBM Длинная Да Да Да Нет Числовой идентификатор в Дисплее и Видео 360 наиболее вероятного поставщика услуг Интернета для показа. Это значение может отсутствовать
Тип устройства DBM Длинная Да Да Да Нет Числовое значение идентифицированного типа устройства. 0 = КОМПЬЮТЕР, 1 = ДРУГОЕ, 2 = СМАРТФОН, 3 = ПЛАНШЕТ, 4 = SMARTTV, 5 = ПОДКЛЮЧЕННОЕ ТВ
Идентификатор производителя мобильного устройства в DBM Длинная Да Да Да Нет Числовой идентификатор производителя мобильного телефона. Это значение может отсутствовать
Идентификатор мобильной модели DBM Длинная Да Да Да Нет Числовой идентификатор мобильной модели. Это значение может отсутствовать
Стоимость рекламы в DBM (долл. США) Длинная Да Да Да Нет Сумма, уплаченная за показ в нано долларах США, вы можете разделить на 1 000 000 000, чтобы увидеть ее в валюте. Это значение может быть равно нулю
Стоимость рекламы в DBM (валюта партнера) Длинная Да Да Да Нет Сумма, уплаченная за показ в нано валюте партнера, вы можете разделить на 1 000 000 000, чтобы увидеть ее в валюте. Это значение может быть равно нулю
Стоимость рекламы в DBM (валюта рекламодателя) Длинная Да Да Да Нет Сумма, уплаченная за показ в нано валюты рекламодателя, вы можете разделить на 1 000 000 000, чтобы увидеть ее в валюте. Это значение может быть равно нулю
Доход в DBM (долл. США) Длинная Да Да Да Нет Общая сумма в нанодолларах США, внесенная партнерским счетом за событие просмотра. Это значение может быть равно нулю
Доход в DBM (валюта партнера) Длинная Да Да Да Нет Общая сумма в валюте партнера в нано, внесенная партнерским аккаунтом за событие просмотра. Это значение может быть равно нулю
Доход в DBM (валюта рекламодателя) Длинная Да Да Да Нет Общая сумма в нано в валюте рекламодателя, внесенная партнерским аккаунтом за событие просмотра. Это значение может быть равно нулю
Общая стоимость рекламы в DBM (долл. США) Длинная Да Да Да Нет Общая стоимость мультимедиа в нанодолларах США для события просмотра. Это значение может быть равно нулю
Общая стоимость рекламы в DBM (валюта партнера) Длинная Да Да Да Нет Общая стоимость рекламы в нано в валюте партнера для события просмотра. Это значение может быть равно нулю
Общая стоимость рекламы в DBM (валюта рекламодателя) Длинная Да Да Да Нет Общая стоимость рекламы в нано в валюте рекламодателя для события просмотра. Это значение может быть равно нулю
Плата за тысячу показов 1 в DBM (долл. США) Целое число Да Да Да Нет Плата за тысячу показов 1 в нанодолларах США. Это значение может быть равно нулю
Плата за тысячу показов 1 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за тысячу показов 1 в валюте партнера в нано. Это значение может быть равно нулю
Комиссия DBM CPM 1 (валюта рекламодателя) Длинная Да Да Да Нет Плата за тысячу показов 1 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата за тысячу показов 2 в DBM (долл. США) Длинная Да Да Да Нет Комиссия CPM 2 в нанодолларах США. Это значение может быть равно нулю
Плата за тысячу показов 2 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за тысячу показов 2 в валюте партнера в нано. Это значение может быть равно нулю
Плата за тысячу показов в DBM 2 (валюта рекламодателя) Длинная Да Да Да Нет Плата за тысячу показов 2 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата 3 за тысячу показов в DBM (долл. США) Длинная Да Да Да Нет Комиссия CPM 3 в нанодолларах США. Это значение может быть равно нулю
Плата за тысячу показов 3 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за тысячу показов 3 в валюте партнера в нано. Это значение может быть равно нулю
Плата 3 за тысячу показов в DBM (валюта рекламодателя) Длинная Да Да Да Нет Плата за тысячу показов 3 в валюте рекламодателя в нано. Это значение может быть равно нулю
Плата за тысячу показов 4 в DBM (долл. США) Длинная Да Да Да Нет Комиссия CPM 4 в нанодолларах США. Это значение может быть равно нулю
Плата за тысячу показов 4 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за тысячу показов 4 в валюте партнера в нано. Это значение может быть равно нулю
Плата за тысячу показов в DBM 4 (валюта рекламодателя) Длинная Да Да Да Нет Плата за тысячу показов 4 в валюте рекламодателя в нано. Это значение может быть равно нулю
Плата за тысячу показов 5 в DBM (долл. США) Длинная Да Да Да Нет Комиссия CPM 5 в нанодолларах США. Это значение может быть равно нулю
Плата за тысячу показов 5 в DBM (валюта партнера) Длинная Да Да Да Нет Комиссия CPM 5 в валюте партнера в нано. Это значение может быть равно нулю
Плата за тысячу показов 5 в DBM (валюта рекламодателя) Длинная Да Да Да Нет Комиссия CPM 5 в валюте рекламодателя в нано. Это значение может быть равно нулю
Плата за рекламу в DBM 1 (долл. США) Длинная Да Да Да Нет Плата за рекламу 1 в нанодолларах США. Это значение может быть равно нулю
Плата за рекламу 1 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за рекламу 1 в валюте партнера нано. Это значение может быть равно нулю
Плата за рекламу 1 в DBM (валюта рекламодателя) Длинная Да Да Да Нет Плата за рекламу 1 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата за рекламу в DBM 2 (долл. США) Длинная Да Да Да Нет Плата за рекламу 2 в нанодолларах США. Это значение может быть равно нулю
Плата за рекламу 2 в DBM (валюта партнера) Длинная Да Да Да Нет Плата за рекламу 2 в валюте партнера нано. Это значение может быть равно нулю
Плата за рекламу 2 в DBM (валюта рекламодателя) Длинная Да Да Да Нет Плата за рекламу 2 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата за рекламу в DBM 3 (долл. США) Длинная Да Да Да Нет Плата за рекламу 3 в нанодолларах США. Это значение может быть равно нулю
Плата за рекламу в DBM 3 (валюта партнера) Длинная Да Да Да Нет Плата за рекламу 3 в валюте партнера нано. Это значение может быть равно нулю
Плата за рекламу в DBM 3 (валюта рекламодателя) Длинная Да Да Да Нет Плата за рекламу 3 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата за рекламу в DBM 4 (долл. США) Длинная Да Да Да Нет Плата за рекламу 4 в нанодолларах США. Это значение может быть равно нулю
Плата за рекламу DBM 4 (валюта партнера) Длинная Да Да Да Нет Плата за рекламу 4 в валюте партнера нано. Это значение может быть равно нулю
Плата за рекламу в DBM 4 (валюта рекламодателя) Длинная Да Да Да Нет Media Fee 4 в нано валюты рекламодателя. Это значение может быть равно нулю
Плата за рекламу в DBM 5 (долл. США) Длинная Да Да Да Нет Плата за рекламу 5 в нанодолларах США. Это значение может быть равно нулю
Плата за рекламу в DBM 5 (валюта партнера) Длинная Да Да Да Нет Плата за рекламу 5 в валюте партнера нано. Это значение может быть равно нулю
Плата за рекламу в DBM 5 (валюта рекламодателя) Длинная Да Да Да Нет Media Fee 5 в нано валюты рекламодателя. Это значение может быть равно нулю
Комиссия за передачу данных в DBM (долл. США) Длинная Да Да Да Нет Стоимость любых данных, использованных для таргетинга этого показа, в нанодолларах США.
Плата за данные DBM (валюта партнера) Длинная Да Да Да Нет Стоимость любых данных, использованных для таргетинга этого показа, в валюте партнера в нано.
Плата за данные DBM (валюта рекламодателя) Длинная Да Да Да Нет Стоимость любых данных, использованных для таргетинга этого показа, в нано в валюте рекламодателя.
Стоимость к оплате в DBM (долл. США) Длинная Да Да Да Нет Общая сумма денег, выставленная партнеру, включая стоимость рекламы и расходы партнера, в нанодолларах США.
Стоимость к оплате в DBM (валюта партнера) Длинная Да Да Да Нет Общая сумма денег, выставленная партнеру, включая стоимость рекламы и расходы партнера, в валюте партнера в нано.
Стоимость к оплате в DBM (валюта рекламодателя) Длинная Да Да Да Нет Общая сумма денег, выставленная партнеру, включая стоимость рекламы и расходы партнера, в валюте рекламодателя в нано.
Идентификатор клика Google Нить Нет Да Нет Нет Тег, передаваемый с кликами по объявлению, для идентификации кампании, связанной с объявлением, для отслеживания рекламы.