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 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 de público-alvo:

• Segmentos de público-alvo
  • Segmentos de lista de usuários
  • Segmentos de afinidade ou no mercado
  • Segmentos de eventos importantes
  • Segmentos demográficos detalhados
  • Segmentos de público-alvo personalizados
• Idade: AgeDimension
• Gênero: GenderDimension
• Renda familiar: HouseholdIncomeDimension
• Status parental: ParentalStatusDimension

Como inspecionar MutateAudienceResult para audience_id

Ao criar um público-alvo com AudienceService.MutateAudiences, cada operação retorna um MutateAudienceResult. É possível inspecionar MutateAudienceResult para receber o audience_id analisando o retornado resource_name ou inspecionando o objeto audience mutável quando response_content_type está definido como MUTABLE_RESOURCE:

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

É possível segmentar públicos-alvo no nível do grupo de anúncios usando AudienceInfo critérios definindo o audience campo em um AdGroupCriterion para o nome do recurso 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 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

É necessário 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 subsequente 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, 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 enumeração AudienceError se a validação falhar.