Segmentação por público-alvo

As campanhas Geração de demanda oferecem recursos exclusivos de segmentação por público-alvo que não são compatíveis com outros tipos de campanha.

Por exemplo, você pode usar segmentos de público-alvo semelhante para segmentar usuários que compartilham características com seus clientes atuais. Leia mais sobre segmentos semelhantes no artigo da Central de Ajuda Usar segmentos semelhantes para aumentar seu público-alvo.

Além disso, é possível configurar a segmentação por público-alvo no nível do grupo de anúncios usando AdGroupCriterion.

Critérios de segmentação de AudienceInfo

Para segmentar um público-alvo em um grupo de anúncios Geração de demanda, siga estas etapas:

1. Ao criar o AdGroup de destino, defina audience_setting.use_audience_grouped como true. Essa configuração é imutável depois que o grupo de anúncios é criado. Você também pode definir campaign.audience_setting.use_audience_grouped como true ao criar a campanha para evitar exclusões de segmento e demográficas no nível da campanha.
2. Crie ou recupere um recurso Audience usando AudienceService e obtenha o nome ou ID do recurso.
3. Crie um AdGroupCriterion com um critério AudienceInfo cujo campo audience está definido como o nome do recurso do público-alvo.

Inspecionar MutateAudienceResult e anexar AudienceInfo

Ao criar um público-alvo com AudienceService.MutateAudiences, cada operação retorna um MutateAudienceResult. É possível extrair o audience_id analisando o resource_name retornado e inspecionar campos mutáveis (como name) no objeto audience retornado quando response_content_type é definido como MUTABLE_RESOURCE. Em seguida, atribua o resource_name a um AdGroupCriterion em um AdGroup criado com audience_setting.use_audience_grouped definido como true e encapsule o AdGroupCriterion em um AdGroupCriterionOperation transmitido para AdGroupCriterionService.MutateAdGroupCriteria:

# Step 1: Inspect MutateAudienceResult to get resource_name and audience_id.
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 with resource_name '{resource_name}' "
        f"and audience_id '{audience_id}'."
    )

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

    # Step 2: Target the audience at the ad group level with AdGroupCriterion.
    # The target AdGroup must have audience_setting.use_audience_grouped = True
    # set when the ad group is created.
    ad_group_criterion_operation = client.get_type("AdGroupCriterionOperation")
    ad_group_criterion = ad_group_criterion_operation.create
    ad_group_criterion.ad_group = ad_group_resource_name
    ad_group_criterion.audience.audience = resource_name

    ad_group_criterion_service = client.get_service("AdGroupCriterionService")
    ad_group_criterion_service.mutate_ad_group_criteria(
        customer_id=customer_id,
        operations=[ad_group_criterion_operation],
    )