Criar e gerenciar públicos-alvo

Um Audience é uma coleção reutilizável de segmentos focados , segmentação demográfica e exclusões. A segmentação por público-alvo é compatível com as campanhas Performance Max e Geração de Demanda. Se você quiser segmentar segmentos de público-alvo diretamente em uma campanha padrão do Shopping, de display, de pesquisa, de vídeo ou de hotel, acesse Segmentos de público-alvo.

Criar públicos-alvo

Crie e atualize um público-alvo usando o AudienceService. Cada Audience precisa ter um nome exclusivo. Esse público-alvo reutilizável permite uma combinação de várias dimensões de público-alvo:

Recuperar públicos-alvo

Assim como outros recursos, você pode usar GoogleAdsService.SearchStream para recuperar atributos de públicos-alvo.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Segmentar públicos-alvo

Os públicos-alvo podem ser segmentados de várias maneiras, dependendo do tipo de campanha.

Indicadores do grupo de recursos

As campanhas Performance Max usam um AssetGroupSignal para segmentar públicos-alvo. Consulte o guia Grupos de recursos para saber como segmentar públicos-alvo usando indicadores de grupo de recursos.

Critério do grupo de anúncios

As campanhas Geração de Demanda aceitam a adição de critérios de grupo de anúncios de público-alvo usando AdGroupCriterion para segmentar públicos-alvo.

Confira as etapas para configurar a segmentação por público-alvo:

Ativar a segmentação por público-alvo no AdGroup

Você precisa ativar a segmentação por público-alvo no AdGroup definindo use_audience_grouped como true quando o grupo de anúncios é criado.

Isso permite adicionar AdGroupCriterion com públicos-alvo. Se esse valor não estiver definido como true, a solicitação posterior para segmentar o público-alvo vai falhar.

Criar um AdGroupCriterion

Crie um AdGroupCriterion e defina o audience campo como o nome do recurso do público-alvo criado anteriormente neste guia.

Opcional: ativar a segmentação por público-alvo na campanha

Você também pode definir use_audience_grouped como true ao criar a campanha. Com essa configuração, você recebe um erro se tentar adicionar critérios que excluam segmentos e dados demográficos no nível da campanha.

Práticas recomendadas

  • Usar públicos-alvo para criar personas. Os públicos-alvo são mais bem usados em campanhas Performance Max e Geração de Demanda, em que você quer sobrepor vários segmentos e critérios demográficos para segmentar uma persona específica.
  • Usar segmentos de público-alvo para segmentação direta. Para campanhas padrão do Shopping, de display, de pesquisa, de vídeo e de hotel ou quando você só precisa segmentar um único segmento (como uma lista de remarketing), use Segmentos de público-alvo em vez de Públicos-alvo.

Erros comuns

Ao criar ou atualizar um Audience, a API Google Ads valida a solicitação e retorna erros da AudienceError enumeração se a validação falhar.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Resumo Um segmento de público-alvo na solicitação não foi encontrado.
Causas comuns Referenciar um ID de segmento que não existe ou está inacessível.
Como proceder Verifique se todos os IDs de segmento existem e estão acessíveis antes de criar ou atualizar um público-alvo.
Dicas de prevenção Valide os IDs de segmento antes de incluí-los em um público-alvo.
DIMENSION_INVALID
Resumo Uma dimensão de público-alvo é inválida.
Causas comuns Incluir detailed_demographic em exclusion_dimension.
Como proceder Use apenas user_list para exclusões em exclusion_dimension.
Dicas de prevenção Verifique se apenas user_list é usado em exclusion_dimension ao criar ou atualizar um público-alvo.
DUPLICATE_AUDIENCE_SEGMENT
Resumo O público-alvo contém segmentos duplicados.
Causas comuns Adicionar o mesmo segmento várias vezes ao mesmo público-alvo.
Como proceder Remova os segmentos duplicados da definição de público-alvo.
Dicas de prevenção Verifique se todos os segmentos em um público-alvo são exclusivos.
NAME_ALREADY_IN_USE
Resumo O nome do público-alvo já está em uso.
Causas comuns Tentar criar vários públicos-alvo com o mesmo nome.
Como proceder Use um nome exclusivo ao criar um público-alvo.
Dicas de prevenção Verifique os nomes de público-alvo atuais antes de criar um novo.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Resumo O público-alvo contém muitas dimensões do mesmo tipo.
Causas comuns Incluir várias dimensões do mesmo tipo (por exemplo, várias dimensões de idade) em um público-alvo.
Como proceder Verifique se a definição do público-alvo contém apenas uma dimensão de cada tipo.
Dicas de prevenção Revise a definição do público-alvo para garantir que nenhum tipo de dimensão duplicado seja incluído.
TOO_MANY_SEGMENTS
Resumo O público-alvo contém muitos segmentos.
Causas comuns Exceder o número máximo permitido de segmentos em um público-alvo.
Como proceder Reduza o número de segmentos na definição do público-alvo.
Dicas de prevenção Consulte a documentação para conferir os limites do número de segmentos por público-alvo.