Вы можете получить позиции YouTube и партнеры, их группы объявлений и рекламные ресурсы, а также таргетинг, соответствующий показу рекламы YouTube и партнеры, с помощью Display & Video 360 API. Ресурсы и таргетинг 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.bulkListAdGroupAssignedTargetingOptions.
Попытка изменить таргетинг 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 в форматах файлов «Позиция» , «Группа объявлений YouTube » и «Объявление YouTube» .
Вы можете создавать и загружать файлы структурированных данных с помощью API Display & Video 360 . Отредактируйте существующие строки, чтобы внести изменения в существующие ресурсы, или добавьте новые строки для создания новых ресурсов, а также загрузите обновленные файлы через интерфейс Display & Video 360.