Esta página detalha os limites e as práticas recomendadas para gerenciar a segmentação usando a API do Display & Video 360.
Segmentação atribuída na criação do item de linha
Alguns tipos de segmentação têm valores padrão atribuídos na criação do item de linha. Esses tipos de segmentação são:
Para evitar erros, conheça o pacote completo de segmentação atribuído aos seus itens de linha na criação. É possível recuperar toda a segmentação atribuída a um item de linha usando bulkListAssignedTargetingOptions.
Algumas configurações são implícitas quando não há segmentação de um tipo atribuída. Por exemplo, se um item de linha não tiver uma opção de segmentação TARGETING_TYPE_AUTHORIZED_SELLER_STATUS atribuída, ele usará "Vendedores diretos e revendedores autorizados" ao veicular anúncios.
As opções de segmentação podem ser descontinuadas
As opções de segmentação não são estáticas. Um pequeno número de opções pode ser descontinuado periodicamente. As opções de segmentação descontinuadas não afetam a veiculação de anúncios de um item de linha. Após a descontinuação, essas opções serão removidas. As solicitações que tentarem recuperar ou atribuir essas opções vão resultar em erros.
Para evitar esses erros, verifique regularmente os IDs das opções de segmentação armazenadas. Para conservar a cota, recomendamos armazenar em cache IDs usados com frequência.
O armazenamento de IDs significa que você pode não perceber que uma opção de segmentação foi
descontinuada. Use regularmente o método get para recuperar todos os IDs de opção de segmentação armazenados e confirmar se eles ainda são compatíveis com o Display & Video 360.
Solicitações simultâneas de segmentação para o mesmo item de linha vão falhar
A tentativa de atualizar as configurações ou a segmentação atribuída a um item de linha usando solicitações simultâneas vai retornar um erro.
Para adicionar ou remover várias opções de segmentação atribuídas a um único item de linha ao mesmo tempo, use uma única solicitação bulkEditAssignedTargetingOptions. Se você quiser
atualizar as configurações e a segmentação de um item de linha, coloque seus pedidos em fila para garantir que
eles sejam enviados em sequência.
Erros comuns de segmentação
Há três causas comuns de erros ao gerenciar a segmentação usando a API do Display & Video 360.
Erros de configuração
A segmentação é limitada por restrições de configuração. Se uma solicitação tentar atualizar a segmentação para violar essas regras, ela vai retornar um erro.
Os erros de configuração geralmente são causados por uma segmentação já existente. Para evitar isso, faça o seguinte:
- Receba a segmentação atual de um determinado tipo usando uma solicitação
list. - Revise a segmentação atual. Avalie qual segmentação precisa ser adicionada ou removida para resultar na configuração desejada.
- Atualize a segmentação usando uma solicitação
bulkEditAssignedTargetingOptions.
O direcionamento herdado dos recursos principais não pode ser removido, mas pode causar esses erros.
Erros do YouTube e parceiros
Não é possível atualizar a segmentação do YouTube e parceiros usando a API Display & Video 360. As solicitações que tentarem atualizar essa segmentação vão retornar um erro.
Essa segmentação é definida como:
- Qualquer segmentação atribuída a um item de linha ou grupo de anúncios do YouTube e parceiros.
- Segmentação de anunciantes por posições de sessão e canais e vídeos individuais do YouTube.
Erros de simultaneidade
Solicitações que atualizam as configurações ou a segmentação do mesmo item de linha ao mesmo tempo podem retornar um erro.
Para evitar isso:
- Gerencie a segmentação em massa usando uma solicitação de edição em massa.
- Solicitações de fila que atualizam o mesmo item de linha. Não envie uma solicitação até que a anterior retorne uma resposta.