É possível recuperar os itens de linha do YouTube e parceiros, os grupos de anúncios e os recursos de anúncios deles, além de segmentações relevantes 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 na IU.
Esta página descreve como usar a API Display & Video 360 para identificar recursos do YouTube e parceiros e recuperar segmentação relevante, além de como criar e atualizar recursos do YouTube e parceiros em massa usando arquivos de dados estruturados (SDF, na sigla em inglês) na interface.
Identificar os 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 com os 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 para itens de linha do YouTube e parceiros podem ser recuperadas no campo
youtubeAndPartnersSettings do
recurso LineItem.
Anúncios e grupos de anúncios do YouTube
Anúncios e grupos de anúncios do YouTube são recursos secundários dos itens de linha do YouTube e parceiros que permitem especificações adicionais.
Um item de linha do YouTube e parceiros pode ter vários recursos
AdGroup, cada um com a própria segmentação
adicional e estratégia de lances. Em cada AdGroup, pode haver vários recursos AdGroupAd do mesmo formato de anúncio, cada um com as próprias informações do criativo e lista de outros URLs de rastreamento.
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 pai não é refletida nas configurações de segmentação de recursos filhos, como é o padrão para recursos que não são do YouTube e de parceiros.
Para recuperar todas as segmentações relevantes para a veiculação de um anúncio do YouTube & Partners, você precisa:
- recuperar a segmentação atribuída ao anunciante pai usando
advertisers.listAssignedTargetingOptions; - recuperar a segmentação atribuída ao item de linha pai usando
advertisers.lineItems.bulkListAssignedTargetingOptions; - e recuperar a segmentação atribuída ao grupo de anúncios pai usando
advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions.
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 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 do
AdGroup.
Criar e atualizar usando o upload de interface do SDF
Não é possível criar nem atualizar recursos do YouTube e parceiros usando a API Display & Video 360, mas você pode 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, na sigla em inglês) na IU do Display & Video 360.
Esses recursos são representados no SDF nos formatos de arquivo de 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 existentes para alterar os recursos existentes ou adicione novas linhas para criar novos recursos e faça upload dos arquivos atualizados por meio da IU do Display & Video 360.