É possível recuperar itens de linha do YouTube e parceiros, grupos de anúncios e recursos de anúncio, além de segmentação relevante para a veiculação de anúncios do YouTube e parceiros usando a API Display & Video 360. Os recursos e a segmentação do YouTube e parceiros só podem ser criados ou atualizados pela interface.
Esta página descreve como usar a API Display & Video 360 para identificar recursos do YouTube e parceiros e recuperar a segmentação relevante, além de como criar e atualizar recursos do YouTube e parceiros em massa usando arquivos de dados estruturados (SDFs) na interface.
Identificar recursos do YouTube e parceiros
Os recursos do YouTube e parceiros consistem em determinados tipos de itens de linha, grupos de anúncios e anúncios.
Itens de linha
Os itens de linha dos seguintes valores de LineItemType são itens de linha do YouTube e parceiros e não podem ser criados nem atualizados:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
As configurações específicas dos itens de linha do YouTube e parceiros podem ser recuperadas do campo youtubeAndPartnersSettings do recurso LineItem.
Anúncios e grupos de anúncios do YouTube
Os grupos de anúncios e anúncios do YouTube são recursos secundários dos itens de linha do YouTube e parceiros que permitem mais especificações.
Um item de linha do YouTube e parceiros pode ter vários recursos de
AdGroup, cada um com sua própria segmentação
adicional e estratégia de lances. Em cada recurso AdGroup, pode haver vários recursos AdGroupAd do mesmo formato de anúncio, cada um com suas próprias informações do criativo e lista de URLs de rastreamento adicionais.
Recuperar segmentação
A segmentação usada para veicular anúncios do YouTube e parceiros é atribuída no nível do anunciante, do item de linha e do grupo de anúncios.
A segmentação do YouTube e parceiros herdada de recursos principais não é refletida nas configurações de segmentação dos recursos secundários, como é padrão para recursos que não são do YouTube e parceiros.
Para recuperar toda a segmentação relevante para a veiculação de um anúncio do YouTube e parceiros, você precisa:
- recuperar a segmentação atribuída ao anunciante principal usando
advertisers.listAssignedTargetingOptions, - recuperar a segmentação atribuída ao item de linha principal usando
advertisers.lineItems.bulkListAssignedTargetingOptions, - e recupere a segmentação atribuída ao grupo de anúncios principal usando
advertisers.adGroups.bulkListAssignedTargetingOptions.
Tentativa de modificar a segmentação do YouTube
Assim como acontece com os recursos do YouTube e parceiros, não é possível modificar a segmentação do YouTube e parceiros usando a API Display & Video 360. Qualquer tentativa de modificar a segmentação a seguir vai retornar um erro:
- Segmentação atribuída em qualquer nível dos seguintes tipos de segmentação:
TARGETING_TYPE_SESSION_POSITION,TARGETING_TYPE_YOUTUBE_CHANNELeTARGETING_TYPE_YOUTUBE_VIDEO. - Segmentação atribuída a recursos de itens de linha do YouTube e parceiros.
- Segmentação atribuída a recursos
AdGroup.
Criar e atualizar usando o upload da interface do SDF
Embora não seja possível criar ou atualizar recursos do YouTube e parceiros usando a API Display & Video 360, é possível criar ou atualizar itens de linha, grupos de anúncios e anúncios do YouTube e parceiros em massa usando o upload de arquivos de dados estruturados (SDF) pela interface do Display & Video 360.
Esses recursos são representados em SDF pelos formatos de arquivo Item de linha, Grupo de anúncios do YouTube e Anúncio do YouTube.
É possível gerar e baixar arquivos de dados estruturados usando a API Display & Video 360. Edite as linhas atuais para fazer mudanças nos recursos existentes ou adicione novas linhas para criar recursos, e faça upload dos arquivos atualizados pela interface do Display & Video 360.