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, Geração de Demanda e para apps. 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:

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 grupos de recursos.

Critério do grupo de anúncios

As campanhas Geração de Demanda e para apps permitem adicionar um critério de grupo de anúncios de público-alvo usando AdGroupCriterion para segmentar públicos-alvo ou fornecer indicadores de público-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 informações demográficas 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, Geração de Demanda e para apps, 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, 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 se há nomes de públicos-alvo 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 saber os limites do número de segmentos por público-alvo.