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 está disponível para campanhas Performance Max, Geração de demanda e para apps. Se você quiser segmentar públicos-alvo diretamente em uma campanha de display, pesquisa, vídeo, 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
- Idade:
AgeDimension - Gênero:
GenderDimension - Renda familiar:
HouseholdIncomeDimension - Status parental:
ParentalStatusDimension
Inspecione MutateAudienceResult para audience_id
Ao criar um público-alvo com
AudienceService.MutateAudiences, cada operação retorna um
MutateAudienceResult. É possível inspecionar
MutateAudienceResult para extrair o audience_id analisando o resource_name retornado. Além disso, é possível inspecionar campos mutáveis (como name) no
objeto audience retornado quando response_content_type é 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 extrair atributos de
públicos-alvo.
SELECT
audience.id,
audience.resource_name,
audience.name,
audience.status,
audience.description,
audience.dimensions,
audience.exclusion_dimension
FROM audience
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 de grupo de recursos para saber como segmentar públicos-alvo usando esses indicadores.
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. Você pode segmentar públicos-alvo no nível do grupo de anúncios usando critérios AudienceInfo em AdGroupCriterion.audience ao definir 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:
Ative 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. Essa configuração não pode ser alterada depois da criação do grupo de anúncios.
Assim, você pode adicionar AdGroupCriterion com públicos-alvo. Se esse valor não for definido como
true, sua solicitação subsequente para segmentar o público-alvo vai falhar.
Crie um AdGroupCriterion
Crie um AdGroupCriterion e defina o campo
AudienceInfo.audience em
AdGroupCriterion.audience como o nome do recurso
do público-alvo criado em Criar públicos-alvo.
Opcional: ative a segmentação por público-alvo no Campaign
Se quiser, defina 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
- Use 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 combinar vários segmentos e critérios demográficos para segmentar uma persona específica.
- Use 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 enumeração AudienceError se a
validação falhar.
AudienceError |
|||||||||
|---|---|---|---|---|---|---|---|---|---|
AUDIENCE_SEGMENT_NOT_FOUND
|
|
||||||||
DIMENSION_INVALID
|
|
||||||||
DUPLICATE_AUDIENCE_SEGMENT
|
|
||||||||
NAME_ALREADY_IN_USE
|
|
||||||||
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
|
|
||||||||
TOO_MANY_SEGMENTS
|
|
||||||||