Criar e gerenciar públicos-alvo

Um Audience é uma coleção reutilizável de segmentos específicos, 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 de apps. Se você quiser segmentar segmentos de público-alvo diretamente em uma campanha de display, de pesquisa, de vídeo, de hotel ou padrão do Shopping, consulte 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 de informações demográficas detalhadas
  • Segmentos de público-alvo personalizados (CustomAudienceSegment)
• Idade: AgeDimension
• Gênero: GenderDimension
• Renda familiar: HouseholdIncomeDimension
• Status parental: ParentalStatusDimension

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 resource_name retornado. Também é possível inspecionar campos mutáveis (como name) no objeto audience retornado quando response_content_type está definido como MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

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 Indicadores do grupo de recursos para saber como segmentar públicos-alvo usando indicadores do grupo de recursos.

Critério do grupo de anúncios

As campanhas Geração de Demanda e de 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. É possível segmentar públicos-alvo no nível do grupo de anúncios usando AudienceInfo critérios em AdGroupCriterion.audience definindo o campo AudienceInfo.audience (ad_group_criterion.audience.audience) como o nome do recurso de público-alvo.

Estas são 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. Essa configuração não pode ser alterada depois que 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 AudienceInfo.audience campo em AdGroupCriterion.audience como o nome do recurso do público-alvo criado em Criar públicos-alvo.

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

Você pode definir use_audience_grouped como true quando a campanha é criada. 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 de 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 de display, de pesquisa, de vídeo, de hotel e padrão do Shopping 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.