С помощью API Display & Video 360 можно извлекать позиции YouTube и партнеров, их группы объявлений и рекламные ресурсы, а также таргетинг, соответствующий показу рекламы YouTube и партнеров. Ресурсы и таргетинг YouTube и партнеров можно создавать или обновлять только через пользовательский интерфейс .
На этой странице описывается, как использовать API Display & Video 360 для определения ресурсов YouTube и партнеров и получения соответствующего таргетинга, а также как создавать и обновлять ресурсы YouTube и партнеров в больших объемах с помощью структурированных файлов данных (SDF) в пользовательском интерфейсе.
Определите ресурсы YouTube и партнеров
Ресурсы YouTube и партнеров состоят из определенных типов позиций, групп объявлений и объявлений .
Позиции
Позиции со следующими значениями LineItemType являются позициями YouTube и партнеров и не могут быть созданы или обновлены :
-
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY -
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Настройки, специфичные для позиций YouTube и партнеров, можно получить из поля youtubeAndPartnersSettings ресурса LineItem .
Группы объявлений и реклама YouTube
Группы объявлений и рекламные объявления YouTube являются дочерними ресурсами в позициях YouTube и партнеров, которые допускают дополнительную спецификацию.
В позиции YouTube и партнёрских программ может быть несколько ресурсов AdGroup , каждый со своей собственной дополнительной стратегией таргетинга и назначения ставок . В каждом ресурсе AdGroup может быть несколько ресурсов AdGroupAd одного и того же формата объявления , каждый со своей собственной информацией о креативе и списком дополнительных URL-адресов отслеживания .
Получить таргетинг
Таргетинг, используемый для показа рекламы YouTube и партнеров, назначается на уровне рекламодателя, уровне позиции и уровне группы объявлений.
Настройки таргетинга YouTube и партнеров, унаследованные от родительских ресурсов, не отражаются в настройках таргетинга дочерних ресурсов, как это стандартно для ресурсов, не относящихся к YouTube и партнерам .
Чтобы получить все настройки таргетинга, имеющие отношение к показу рекламы на YouTube и партнерских ресурсах, необходимо:
- получить таргетинг, назначенный родительскому рекламодателю, используя
advertisers.listAssignedTargetingOptions, - получить таргетинг, назначенный родительской позиции, с помощью
advertisers.lineItems.bulkListAssignedTargetingOptions, - и получить таргетинг, назначенный родительской группе объявлений, с помощью
advertisers.adGroups.bulkListAssignedTargetingOptions.
Попытка изменить таргетинг YouTube
Как и в случае с ресурсами YouTube и партнёров, вы не можете изменить таргетинг YouTube и партнёров с помощью API Display & Video 360. Любая попытка изменить следующие настройки таргетинга приведёт к ошибке:
- Нацеливание назначается на любом уровне из следующих типов нацеливания :
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNELиTARGETING_TYPE_YOUTUBE_VIDEO. - Таргетинг назначен ресурсам позиций YouTube и партнеров .
- Таргетинг назначен ресурсам
AdGroup.
Создание и обновление с помощью загрузки пользовательского интерфейса SDF
Хотя вы не можете создавать или обновлять ресурсы YouTube и партнеров с помощью API Display & Video 360, вы можете создавать или обновлять позиции, группы объявлений и объявления YouTube и партнеров оптом, используя загрузку структурированных файлов данных (SDF) через пользовательский интерфейс Display & Video 360 .
Эти ресурсы представлены в SDF через форматы файлов Line Item , Youtube Ad Group и YouTube Ad .
Вы можете создавать и загружать структурированные файлы данных с помощью API Display & Video 360. Редактируйте существующие строки, чтобы внести изменения в существующие ресурсы, или добавляйте новые строки для создания новых ресурсов, а затем загружайте обновлённые файлы через пользовательский интерфейс Display & Video 360.