Объяснение формата см. в обзоре .
Поле | Необходимый | Тип | Записываемый | Описание | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Идентификатор позиции | Требуется только при редактировании существующих позиций. | целое число | Нет | Числовое значение идентификатора позиции. Если оставить это поле пустым, будет создана новая позиция с уникальным идентификатором. При создании новых позиций можно использовать настраиваемый идентификатор для назначения групп объявлений TrueView новой позиции. Формат настраиваемого идентификатора: «ext[настраиваемый идентификатор]», например, ext123. После загрузки и обработки файла все настраиваемые идентификаторы будут заменены идентификаторами, назначенными DBM, а объекты будут связаны (например, группа объявлений с позицией) на основе настраиваемых идентификаторов. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Идентификатор Io | Да | целое число | Нет | Числовое значение идентификатора заказа на размещение. Вы можете указать пользовательский идентификатор (например, «ext[пользовательский идентификатор заказа на размещение]») для заказа на размещение, создаваемого одновременно с этой позицией. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Имя Ио | Нет | нить | Нет | Название заказа на размещение | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тип | Да | нить | Да | Тип записи. Доступна только для записи при создании, но не для редактирования.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Подтип | Да | нить | Да | Поле, необходимое для различения позиций в разных форматах
«Действие» несовместимо с позициями TrueView. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Имя | Да | нить | Да | Название записи. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Метка времени | Требуется при редактировании существующих записей | целое число | Нет | Метка времени записи. Она используется системой для проверки того, что запись не изменилась между загрузкой и выгрузкой. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Статус | Да | нить | Да | Настройка статуса для записи.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Дата начала | Да | нить | Да | Метка времени для даты начала полета записи в формате ММ/ДД/ГГГГ или «Как в заказе на вставку», чтобы использовать ту же дату начала, что и в родительском заказе на вставку. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Дата окончания | Да | нить | Да | Метка времени для даты окончания полета записи в формате ММ/ДД/ГГГГ или «Как в заказе на вставку», чтобы использовать ту же дату окончания, что и в родительском заказе на вставку. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тип бюджета | Да | нить | Да | Указывает, основан ли бюджет на денежном выражении или на показах. Если для заказа на размещение для этой записи включено автоматическое распределение бюджета, вы можете выбрать значение «Автоматически», чтобы DBM автоматически рассчитывал бюджет для этой записи.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сумма бюджета | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». | плавать | Да | Положительная сумма бюджета для данного типа бюджета. Это может быть простое целое число для количества показов или число с плавающей точкой для денежной суммы. Валюты будут отображаться в валюте рекламодателя в стандартных единицах (а не в 1/1 000 000 денежной единицы). Если для записи установлено «автоматическое» распределение бюджета, вы можете указать минимальную сумму расходов (например, «потратить не менее» этой суммы). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Шаги | Да | нить | Да | Период времени, используемый для расходования суммы по темпу.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Скорость стимуляции | Да | нить | Да | Скорость шага для этой записи.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сумма темпа | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». Обязательно, если «Тип» — «TrueView», а «Тайминг» — «Ежедневный». | плавать | Да | Сумма, которую нужно потратить за период времени, заданный типом темпа. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Частота включена | Да | нить | Да | Включает/отключает ограничение частоты показов на основе количества показов для позиции.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Частота воздействия | Требуется, если «Частота включена» имеет значение «ИСТИНА» | целое число | Да | Положительное целое число для количества показов за заданную частоту, то есть x в «Показать x показов за период y». | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Период частоты | Требуется, если «Частота включена» имеет значение «ИСТИНА» | нить | Да | Указывает единицу измерения периода для ограничения частоты показов. Для позиций TrueView поддерживаются следующие периоды: дни, недели и месяцы.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Частота Количество | Требуется, если «Частота включена» имеет значение «ИСТИНА» | целое число | Да | Положительное целое число, указывающее длительность периода частоты, то есть y в поле «Показать x показов за период y». Эта величина не поддерживается для позиций TrueView. Периоды ограничения частоты показов должны составлять 30 дней или меньше. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Частота просмотра TrueView включена | Обязательно, если «Тип» — «TrueView» | нить | Да | Включает/отключает ограничение частоты показов на основе просмотров для позиции TrueView.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Просмотр Частота Экспозиций | Требуется, если для параметра «TrueView View Frequency Enabled» установлено значение «TRUE». | целое число | Да | Положительное целое число для количества просмотров TrueView, то есть x в «Показать x просмотров за период». | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Период частоты просмотра TrueView | Требуется, если для параметра «TrueView View Frequency Enabled» установлено значение «TRUE». | нить | Да | Указывает единицу времени для ограничения частоты показов TrueView на основе просмотров.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Модель дохода партнера | Нет | нить | Да | Модель дохода партнёра — это механизм управления расчётом дохода в Bid Manager. Используйте модель дохода партнёра для отслеживания наценки на ваши услуги. Столбец «Сумма дохода партнёра» необходимо указать, если выбран столбец «Модель дохода партнёра».
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сумма дохода партнера | Требуется только в том случае, если указан столбец «Модель дохода партнера». | плавать | Да | Положительное число с плавающей точкой, соответствующее модели дохода партнёра. Применимо только при указании столбца «Модель дохода партнёра». | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тип подсчета конверсий | Обязательно, если «Тип» — «Дисплей», «Видео», «Аудио» или «TrueView». | нить | Да | Выберите типы конверсий, которые будут учитываться.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Процент подсчета конверсий | Обязательно, если «Тип» — «Дисплей», «Видео», «Аудио» или «TrueView». | плавать | Да | Укажите процент для типа подсчёта «Count %». Отформатируйте процент как число с плавающей точкой (3,123% = 3,123) с точностью до тысяч (3 знака после запятой). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Идентификаторы активности Floodlight для конверсий | Нет | строка, список списков | Да | Действия Floodlight, используемые для конверсий, и связанные с ними настройки. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Список формата списка = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);). Это поле невозможно обновить, если задан столбец «Идентификатор алгоритма». Попытка сделать это приведёт к ошибке. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Идентификатор основной модели атрибуции | Нет | целое число | Да | Идентификатор модели атрибуции, используемый для связанной позиции. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сборы | Нет | строка, список списков | Да | Все сборы для этой записи. Формат списка = (Категория сбора; Сумма сбора; Тип сбора; Выставлен счёт;).
Пример '(CPM; 2; Комиссия Display & Video 360; Ложь); (Медиа; 13; По умолчанию; Истина);'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Интеграционный код | Нет | нить | Да | Дополнительный код для отслеживания. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Подробности | Нет | нить | Да | Данные записи в строковом формате. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Тип стратегии ставок | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». | нить | Да | Выберите одну из применимых стратегий ставок:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Значение стратегии ставок | Обязательно, если только «Тип стратегии ставок» не равен «Минимизация», «Максимизация» или «Тип» не равен «TrueView». | плавать | Да | Для типов стратегий «Удар», «Оптимизация VCPM» и «Фиксированная» выберите значение целевой ставки. Обратите внимание, что для типа стратегии ставки «Минимизировать» или «Максимизировать» значение стратегии ставки не требуется. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Отдел стратегии ставок | Обязательно, если «Тип стратегии ставок» — «Победить», «Минимизировать» или «Максимизировать». | нить | Да | Для типов стратегий «Победа», «Минимизация» или «Максимизация» выберите соответствующую единицу измерения:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Стратегия ставок «Не превышать» | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». | плавать | Да | Установите значение CPM «не превышать». Если равно 0, параметр «не превышать» отключен. Доступно только при выборе стратегии назначения ставок «Минимизировать», «Максимизировать» или «Превзойти». | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Применить минимальную цену для сделок | Обязательно, если «Тип стратегии ставок» — «Минимизировать» или «Максимизировать». | нить | Да | Стоит ли отдавать приоритет сделкам по сравнению с инвентарем на открытом аукционе
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Идентификатор алгоритма | Требуется, когда для «Блока стратегии ставок» задано индивидуальное значение/стоимость показов | целое число | Да | Этот соответствующий идентификатор алгоритма должен использоваться, когда для единицы стратегии ставок задано пользовательское значение/стоимость показов. Любые действия Floodlight, используемые в алгоритме, назначенном этому столбцу, должны быть включены в столбец «Идентификаторы действий Floodlight для конверсий». Попытка назначить алгоритм без корректного обновления столбца «Идентификаторы действий Floodlight для конверсий» приведёт к ошибке. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Творческие задания | Нет | строка, список | Да | Список идентификаторов креативов, которые следует назначить записи. В этом столбце используются идентификаторы Формат списка = (Creative.creativeId; Creative.creativeId; и т.д.). Этот список формируется в порядке возрастания номеров. При загрузке пользователи также могут включать идентификаторы мест размещения Менеджера кампаний 360. Идентификаторам мест размещения должны предшествовать буквы «CM», например, «CM789». | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Географический таргетинг — включить | Нет | строка, список | Да | Список географических регионов для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Географический таргетинг — Исключить | Нет | строка, список | Да | Список географических регионов, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Географическое положение Региональный список местоположений Таргетинг - Включить | Нет | строка, список | Да | Список идентификаторов георегиональных местоположений для включения. Формат списка = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Географическое положение Региональный список местоположений Таргетинг - Исключить | Нет | строка, список | Да | Список идентификаторов георегиональных местоположений для исключения. Формат списка = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Нацеливание на расстояние | Нет | строка, список списков | Да | Список целей сближения в формате "(Широта; Долгота; Радиус; Единица измерения; Полный адрес;);". Широта находится в диапазоне от -90 до 90 градусов (включительно); Долгота находится в диапазоне от -180 до 180 градусов (включительно); Радиус — это расстояние от 1 до 500 (включительно) в единицах измерения; Единица измерения может быть "ми" или "км"; Полный адрес указывать необязательно. Например: "(38.907192; -77.03687; 1.0; миля; Вашингтон, округ Колумбия, США;); (40.712775; -74.005972; 20.5; км; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; миля; ;);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по списку местоположений с учетом близости | Нет | строка, список списков | Да | Список целевых списков близости для заказов на размещение или позиций Non-TrueView, каждый в формате "(ProximityListId; Радиус; Единица; );". ProximityListId — это идентификатор списка местоположений в ресурсах рекламодателя. Радиус — это расстояние от 1 до 500 (включительно) в единицах измерения. Единицей измерения может быть "миля" или "км". Существует ограничение на таргетинг двух списков местоположений на одну сущность вместе со списками региональных местоположений по географии. Например: "(10041691678; 20.0; миля;); (10038858567; 20.5; км;);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Языковой таргетинг — включить | Нет | строка, список | Да | Список языков для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Языковой таргетинг — исключить | Нет | строка, список | Да | Список языков, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Нацеливание на устройство — включить | Нет | строка, список | Да | Список устройств для включения в таргетинг. В этом столбце используются идентификаторы ресурсов
Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на устройство — Исключить | Нет | строка, список | Да | Список устройств, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов
Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на браузер — включить | Нет | строка, список | Да | Список браузеров для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на браузер — Исключить | Нет | строка, список | Да | Список браузеров для исключения из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Метки цифрового контента — Исключить | Нет | строка, список | Да | Список меток цифрового контента, которые следует исключить. Формат списка = (G;PG; и т.д.).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Настройка чувствительности безопасности бренда | Нет | нить | Да | Выберите настройку чувствительности, чтобы блокировать инвентарь в зависимости от тематики окружающего его контента.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Пользовательские настройки безопасности бренда | Обязательно, если для параметра «Пользовательская настройка безопасности бренда» установлено значение «Использовать пользовательскую настройку». | строка, список | Да | Если настройка чувствительности безопасности бренда установлена на «Использовать пользовательский», укажите список стандартных классификаторов контента. Например, (Сексуальное; Алкоголь; Табак и т. д.).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сторонние службы проверки | Нет | нить | Да | Поставщик услуг стороннего подтверждения подлинности.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Сторонние этикетки проверки | Нет | строка, список | Да | Если для параметра «Службы стороннего верифицирования» не задано значение «Нет», укажите список меток , поддерживаемых выбранным поставщиком. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг каналов — включить | Нет | строка, список | Да | Список каналов для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (Канал.channelId; Канал.channelId; и т. д.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг каналов - Исключить | Нет | строка, список | Да | Список каналов для исключения из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (Канал.channelId; Канал.channelId; и т. д.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на сайт - Включить | Нет | строка, список | Да | Список сайтов для включения в таргетинг. Список представляет собой строки URL-адресов. Формат списка = (someurl.com; someurltwo.com; и т.д.). Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на сайт - Исключить | Нет | строка, список | Да | Список сайтов, которые следует исключить из таргетинга. Список представляет собой строки URL-адресов. Формат списка = (someurl.com; someurltwo.com; и т.д.). Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг приложений — включить | Нет | строка, список | Да | Список приложений для включения в таргетинг. Список представляет собой объединенные строки, содержащие название платформы приложения и идентификатор платформы приложения. Для определения платформы приложения используются следующие значения:
Объединенная строка платформы приложения и идентификатора разделяется двоеточием, например: Формат списка = (APP:com.google.android.gm; APP:422689480; и т.д.). Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг приложений — Исключить | Нет | строка, список | Да | Список приложений, которые следует исключить из таргетинга. Список представляет собой объединенные строки, содержащие название платформы приложения и идентификатор платформы приложения. Для определения платформы приложения используются следующие значения:
Объединенная строка платформы приложения и идентификатора разделяется двоеточием, например: Формат списка = (APP:com.google.android.gm; APP:422689480; и т.д.). Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг коллекции приложений — включить | Нет | строка, список | Да | Список коллекций приложений для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг коллекции приложений — Исключить | Нет | строка, список | Да | Список коллекций приложений для исключения из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т. д.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по категориям — включить | Нет | строка, список | Да | Список категорий для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по категориям — Исключить | Нет | строка, список | Да | Список категорий, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов TargetingOption API Display & Video 360 для типа таргетинга TARGETING_TYPE_CATEGORY .Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по жанру контента — включить | Нет | строка, список | Да | Список жанров контента для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по жанру контента — Исключить | Нет | строка, список | Да | Список жанров контента, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по ключевым словам — включить | Нет | строка, список | Да | Список ключевых слов для включения в таргетинг. Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по ключевым словам — Исключить | Нет | строка, список | Да | Список ключевых слов, которые следует исключить из таргетинга. Этот список формируется в алфавитном порядке по возрастанию. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по списку ключевых слов — Исключить | Нет | строка, список | Да | Список минус-слов, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Формат списка = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; и т. д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Оптимизированный таргетинг | Нет | нить | Да | Включить оптимизированный таргетинг.
Оптимизированный таргетинг совместим не со всеми стратегиями назначения ставок. Этот столбец должен иметь значение «ЛОЖЬ», если:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг аудитории - Включить | Нет | строка, список списка пар | Да | Список списков аудитории для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Для списков собственной аудитории каждая аудитория представлена парой FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId и параметра давности. Пара имеет вид (1;1д;), где 1д — это пример давности, представляющий давность в 1 день. Давность недоступна для сторонних аудиторий, поэтому формат списка — (3;);(4;);. Для объединения групп аудиторий по операторам «И» и «ИЛИ» следуйте этому примеру: Чтобы объединить пары с давностью и без давности: '((1;1д;);(2;365д;));((3;);(4;5м;);(5;все;));'. Это означает (список 1 с давностью в 1 день ИЛИ список 2 с давностью в 365 дней) И (список 3 без указанной давности ИЛИ список 4 с давностью в 5 минут ИЛИ список 5 со всеми пользователями). Допустимые значения новизны:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Выбор целевой аудитории — Исключить | Нет | строка, список списка пар | Да | Список списков аудитории для исключения из таргетинга. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Каждая аудитория представлена парой FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId и параметром давности, если список аудитории — это список аудитории 1P. Пара имеет вид (1;1d;), где 1d — это выборка давности, соответствующая 1 дню. Однако для аудиторий 3P давность недоступна, поэтому формат списка выглядит следующим образом: (3;);(4;);. Формат списка = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; давность необязательно;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; давность необязательно;);) Допустимые значения новизны:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по интересам и целевому рынку — включить | Нет | строка, список | Да | Список списков аудитории по интересам и/или целевого рынка, которые следует включить. Идентификаторы списков аудитории можно получить из интерфейса Display & Video 360. Формат списка = (ID аудитории; ID аудитории; и т. д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по интересам и целевому рынку — исключить | Нет | строка, список | Да | Список списков целевой аудитории и/или аудитории заинтересованных покупателей, которые следует исключить. Идентификаторы списков аудитории можно получить из интерфейса Display & Video 360. Формат списка = (ID аудитории; ID аудитории; и т. д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Комбинированный таргетинг аудитории | Нет | строка, список | Да | Список объединенных списков целевой аудитории. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Формат списка = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; и т. д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Нацеливание по пользовательскому списку | Нет | строка, список | Да | Список пользовательских списков для таргетинга. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Формат списка = (CustomList.customListId; CustomList.customListId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Выбор источника инвентаря — варианты авторизованного продавца | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». | нить | Да | Настройка таргетинга на авторизованных прямых продавцов, авторизованных прямых продавцов и реселлеров или авторизованных продавцов и неизвестных продавцов. «Авторизованный прямой» означает, что таргетинг будет направлен только на авторизованных продавцов. «Авторизованные прямые продавцы и реселлеры» означает, что таргетинг будет направлен на авторизованных продавцов и реселлеров. «Авторизованный и неучаствующий издатель» означает, что таргетинг будет направлен на авторизованных продавцов, реселлеров и неизвестных продавцов.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на источник инвентаря — включить | Обязательно, если «Тип» — «Дисплей», «Видео» или «Аудио». | строка, список | Да | Список источников инвентаря, бирж и суббирж для включения в таргетинг. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Формат списка = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; и т. д.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на источник инвентаря — исключить | Нет | строка, список | Да | Список источников инвентаря, бирж и суббирж, которые следует исключить из таргетинга. В этом столбце используются идентификаторы ресурсов Display & Video 360 API Формат списка = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; и т. д.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Выбор источника инвентаря — нацельтесь на новые биржи | Нет | нить | Да | Настройка для выхода на новые биржи.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Включает таргетинг частных групп сделок | Нет | строка, список | Да | Список идентификаторов групп сделок для включения в таргетинг. Идентификаторы групп сделок можно найти в разделе «Группы сделок» на вкладке «Мой инвентарь» и в разделе «Группы» в настройках источника инвентаря в позициях, заказах на размещение и кампаниях. Формат списка = (DealGroupId; DealGroupId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на часть суток | Нет | строка, список | Да | Список идентификаторов, где каждый идентификатор части суток построен в следующем формате: daypart_id = base_dayparting_id + (дней_с_понедельника * 10000) + (начало * 100) + конец Пределы переменных:
Для новых сущностей время будет установлено в соответствии с часовым поясом ваших пользователей (т. е. «Местный»). Для существующих сущностей часовой пояс не изменится. Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Часовой пояс таргетинга на часть суток | Обязательно, если включен «Таргетинг на время суток» | нить | Да | Часовой пояс, используемый для таргетинга по времени суток.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на окружающую среду | Нет | строка, список | Да | Список целевых сред. Выберите одно или несколько приемлемых значений. Обратите внимание, что вариант «Веб не оптимизирован» невозможно выбрать, не выбрав вариант «Веб».
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Видимость Omid Targeting включена | Нет | нить | Да | Позволяет нацеливать только те показы, которые можно измерить с помощью открытого стандарта измерений.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Active View с таргетингом на видимость | Нет | нить | Да | Прогнозируемые проценты видимости. Проценты представлены в виде чисел с плавающей точкой. Один из вариантов: {0,1, 0,2, 0,3, 0,4, 0,5, 0,6, 0,7, 0,8, 0,9}. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Позиционный таргетинг — на экране | Нет | строка, список | Да | Таргетинг на позиции рекламы на экране. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Позиционный таргетинг — отображение позиции в контенте | Нет | строка, список | Да | Отображение целевых позиций рекламного контента. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Позиционный таргетинг — позиция видео в контенте | Нет | строка, список | Да | Позиции таргетинга видеорекламы. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Позиционный таргетинг — позиция аудио в контенте | Нет | строка, список | Да | Позиции аудиорекламы для таргетинга. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ориентация на размер видеоплеера | Нет | строка, список | Да | Список размеров плеера для видеорекламы. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на длительность контента | Нет | строка, список | Да | Список длительностей контента для целевой аудитории. Единица измерения — минуты. Выберите одно или несколько приемлемых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг по типу потока контента | Нет | строка, список | Да | Список типов потоков контента для таргетинга. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на тип аудиоконтента | Нет | строка, список | Да | Список типов аудиоконтента для целевого использования. Выберите одно или несколько допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Демографический таргетинг: пол | Нет | строка, список | Да | Список полов для таргетинга. Выберите одно или несколько приемлемых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Возраст демографического таргетинга | Нет | строка, список | Да | Ориентируйтесь на возрастной диапазон пользователей. Укажите диапазон «от/до», выбрав один возраст «От» и один возраст «До», а также укажите, следует ли включать неизвестные возрасты (true/false). См. список допустимых возрастов «От/до». Пример 1: чтобы выбрать возраст 18–55 лет и включить неизвестный возраст, укажите формат {От; По; Включить неизвестный True/False} = 18;55;true; Пример 2: чтобы охватить только пользователей старше 35 лет и исключить неизвестный возраст, укажите следующее = 35;+;false;. Допустимые значения для From:
Допустимые значения для To:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Демографический таргетинг: доход домохозяйства | Нет | строка, список | Да | Выберите диапазон доходов домохозяйства. Укажите диапазон «от» до «до», выбрав один верхний и один нижний диапазоны доходов, а также укажите, следует ли включать домохозяйства с неизвестным доходом (истина/ложь). См. список допустимых верхних и нижних диапазонов. Пример 1: чтобы охватить от 10% до 50% верхних домохозяйств и включить домохозяйства с неизвестным доходом, укажите формат {Верхняя_часть_диапазона; Нижняя_часть_диапазона; Включить неизвестное True/False} = Верхние 10%;41–50%;true; Пример 2: чтобы охватить только нижние 50% домохозяйств и исключить домохозяйства с неизвестным доходом, укажите формат {Верхняя_часть_диапазона; Нижняя_часть_диапазона; Включить неизвестное True/False} = Нижние 50%;Нижние 50%;истина; Допустимые значения Top_of_Range/Bottom_of_Range:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Демографический таргетинг: родительский статус | Да | строка, список | Да | Список родительских статусов для поиска. Выберите одно или несколько приемлемых значений.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг скорости соединения | Нет | нить | Да | Ориентируйтесь на определённую скорость соединения. Выберите одно из допустимых значений:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на оператора связи - Включить | Нет | строка, список | Да | Список интернет-провайдеров и операторов связи, на которых следует нацелиться. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Таргетинг на оператора связи — исключить | Нет | строка, список | Да | Список интернет-провайдеров и операторов, которых следует исключить. В этом столбце используются идентификаторы ресурсов Формат списка = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; и т.д.). Этот список формируется в порядке возрастания номеров. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Множители ставок | Нет | строка, список списков | Нет | Множители ставок больше не поддерживаются для новых позиций. Этот столбец больше не доступен для записи. Все множители ставок для этой записи. Формат списка = (тип строки; ID критерия; значение множителя ставки); (тип строки; ID критерия; значение множителя ставки);. Значения множителей ставки могут находиться в диапазоне от 0,1 до 10,0. Допустимые типы строк и соответствующие им идентификаторы критериев перечислены в следующей таблице:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Video Ad Formats | Yes for TrueView Line Items | нить | Да | The video ad format of the line item. In-stream / In-feed Video are TrueView video ad types sold on a CPV basis. In-stream / Bumper are TrueView video ad types sold on a CPM basis. Bumpers are 6-second or less video ads sold on a CPM basis. Non-skippable video ads are in-stream ads between 6 and 15 seconds sold on a CPM basis. In-stream / Bumper / Non-skippable video ads are acceptable TrueView video ad types for Target Frequency line items sold on a CPM basis. Responsive video ads are ad types that serve as multiple formats.
New 'Reach' line items must use 'Responsive'. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Bid Strategy Type | Yes for TrueView Line Items | нить | Да | Select one of the applicable TrueView bid strategies:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Bid Strategy Value | Yes for TrueView Line Items | плавать | Да | For the Target CPA or Target ROAS bid strategy type, choose a value for the target bid. For the other "TrueView Bid Strategy Type" values or non-TrueView line items this column should be 0 when uploading. For Target ROAS, this column should be the percentage as a fraction, eg, if you want Target ROAS to be 150%, put 1.5 to this column. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Mobile Bid Adjustment Option | Нет | нить | Да | The direction in which to adjust bids for display on mobile devices.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Mobile Bid Adjustment Percentage | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | целое число | Да | Bid adjustment to increase chances of showing ads on mobile. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Desktop Bid Adjustment Option | Нет | нить | Да | The direction in which to adjust bids for display on desktop devices.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Desktop Bid Adjustment Percentage | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | целое число | Да | Bid adjustment to increase chances of showing ads on desktop. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Tablet Bid Adjustment Option | Нет | нить | Да | The direction in which to adjust bids for display on tablets.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Tablet Bid Adjustment Percentage | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | целое число | Да | Bid adjustment to increase chances of showing ads on tablet. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Connected TV Bid Adjustment Option | Нет | нить | Да | The direction in which to adjust bids for display on connected TVs.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Connected TV Bid Adjustment Percentage | Yes when TrueView Bid Strategy Type is Target CPA or Maximize Conversions | целое число | Да | Bid adjustment to increase chances of showing ads on connected TVs. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Category Exclusions Targeting | Нет | string, list | Нет | List of categories to exclude. List format = Embedded Videos; Families; etc.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Content Filter | Нет | нить | Нет | TrueView content filter.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Inventory Source Targeting | Нет | string, list | Да | Lists of TrueView inventory sources to include
'Video Partners' must be included for Demand Gen line items. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Viewability Vendor | Required only when editing existing TrueView line items | string, list of lists | Да | Third-party vendor measuring viewability for TrueView line item. If this is left empty during TrueView line item creation and there is a default viewability vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Viewability Reporting ID | Yes when third-party viewability vendor is not 'None' | нить | Да | ID used by your third-party viewability vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Safety Vendor | Required only when editing existing TrueView line items | string, list of lists | Да | Third-party vendor measuring brand safety for TrueView line item. If this is left empty during TrueView line item creation and there is a default brand safety vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Safety Reporting ID | Yes when third-party brand safety vendor is not 'None' | нить | Да | ID used by your third-party brand safety vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Reach Vendor | Required only when updating existing TrueView line items | string, list of lists | Да | Third-party vendor measuring reach for TrueView line item. If this is left empty during TrueView line item creation and there is a default reach vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Reach Reporting ID | Yes when third-party reach vendor is not 'None' | нить | Да | ID used by your third-party reach vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Lift Vendor | Required only when updating existing TrueView line items | string, list of lists | Да | Third-party vendor measuring brand lift for TrueView line item. If this is left empty during TrueView line item creation and there is a default brand lift vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Lift Reporting ID | Yes when third-party brand lift vendor is not 'None' | нить | Да | ID used by your third-party brand lift vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Target Frequency Count | Yes when the line item subtype is Target Frequency | целое число | Да | The target frequency count set for a Target Frequency type YouTube line item. This field can only be set with different set of values based on the time window. For YouTube line items that are not of type Target Frequency, this field should be empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Target Frequency Time Window | Yes when the line item subtype is Target Frequency | нить | Да | The target frequency time window for a Target Frequency type YouTube line item. This field can be set to Weekly or Monthly for now. For YouTube line items that are not of type Target Frequency, this field should be empty.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Video Ad Inventory Control | Yes when the line item subtype is Reach | string, list | Да | The video ad inventory control for this line item. Select one or more of the acceptable ad format values:
|