É possível recuperar itens de linha do YouTube e parceiros, os grupos de anúncios e os recursos de anúncios e a 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 & Partners e recuperar segmentações relevantes, além de como criar e atualizar recursos do YouTube & Partners 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 ou 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 no campo
youtubeAndPartnersSettings do recurso
LineItem.
Grupos de anúncios e anúncios do YouTube
Os grupos de anúncios e anúncios do YouTube são recursos filhos nos 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 AdGroup, cada um com sua própria segmentação
adicional e estratégia de lances. Em cada recurso AdGroup, podem ser 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.
Extrair 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 de recursos filhos, como é padrão para recursos que não são do YouTube & 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 pai usando
advertisers.lineItems.bulkListAssignedTargetingOptions, - e extrair a segmentação atribuída ao grupo de anúncios pai usando
advertisers.adGroups.bulkListAssignedTargetingOptions.
Tentar 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 do 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 aos recursos de itens de linha do YouTube e parceiros.
- Segmentação atribuída aos recursos
AdGroup.
Criar e atualizar usando o upload da interface SDF
Embora não seja possível criar ou atualizar recursos do YouTube & Partners usando a API Display & Video 360, é possível criar ou atualizar itens de linha, grupos de anúncios e anúncios do YouTube & Partners 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 fazer o download de arquivos de dados estruturados usando a API Display & Video 360. Edite as linhas para fazer mudanças nos recursos existentes ou adicione novas linhas para criar novos recursos e faça upload dos arquivos atualizados pela interface do Display & Video 360.