Critérios

Os critérios de segmentação podem ser definidos em três níveis diferentes:

• No nível da campanha.
• No nível do grupo de anúncios.
• No nível do cliente.

Nem todos os tipos de critérios podem ser definidos em todos os níveis. Alguns, por exemplo, só podem ser definidos no nível da campanha. Além disso, alguns critérios só podem ser usados para segmentação negativa, e outros só podem ser usados para segmentação positiva.

Critérios aceitos por nível

A tabela a seguir descreve o uso permitido de todos os tipos de critério:

Diferenças de versão

Vários tipos de critérios e comportamentos de validação são diferentes nas versões compatíveis da API Google Ads:

• v26 e mais recentes:
  • Oferece suporte a require_eu_political_advertising_declaration em CampaignCriterion e AdGroupCriterion para determinar se um critério exige uma declaração de propaganda política na UE no nível da campanha.
  • Usa dimensões de viagem independentes de categoria em AdGroupBidModifier e motivos de erro independentes de categoria em CriterionError (substituindo critérios e códigos do erro específicos de Hotéis na v25 e anteriores).
• v25 e mais recentes:aceita o critério EntityBid (entity_bid) em AdGroupCriterion com o tipo de critério VERTICAL_ADS_ITEM_BID para definir lances no nível do item para entidades de viagem em anúncios verticais.
• v24 e mais recentes:
  • Oferece suporte a RetailFilterBundle (AdGroupCriterion.retail_filter_bundle e AssetGroupListingGroupFilter.Dimension.retail_filter_bundle) e RetailFilter (SharedCriterion.retail_filter) para filtragem de produtos com base em tags (somente contas na lista de permissões).
  • Oferece suporte às dimensões de regra user_rating, venue e event_participant_display_name em VerticalAdsItemGroupRuleInfo no SharedCriterion.
  • Oferece suporte a AssetGroupSignal.local_services_id e AssetGroupSignal.vertical_ads_item_group_rule_list (na lista de permissões) para indicadores de grupos de recursos das campanhas Performance Max.
  • Retorna CriterionError.CANNOT_EXCLUDE_ALL_TARGETS ao tentar excluir todas as segmentações em uma dimensão demográfica (AgeRangeInfo, GenderInfo, IncomeRangeInfo ou ParentalStatusInfo).
  • Retorna CriterionError.CANNOT_TARGET_LANGUAGE ao tentar segmentar um idioma não permitido.
  • Retorna CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN ao tentar remover todos os locais de uma campanha Performance Max de Serviços Locais.

Critérios de segmentação de informações do público-alvo

É possível segmentar públicos-alvo no nível do grupo de anúncios usando critérios AudienceInfo em AdGroupCriterion.audience. Defina ad_group_criterion.audience.audience como o nome do recurso do Audience que você quer segmentar. Para usar os critérios de AudienceInfo em um AdGroupCriterion, defina ad_group.audience_setting.use_audience_grouped = true ao criar o grupo de anúncios (essa configuração é imutável após a criação). Também é possível definir campaign.audience_setting.use_audience_grouped = true ao criar a campanha para evitar exclusões demográficas e de segmento no nível da campanha.

Inspecionar MutateAudienceResult

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, e é possível inspecionar campos mutáveis (como name) no objeto audience retornado 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 = 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}")

Critérios de segmentação por idioma

É possível segmentar idiomas de forma positiva usando os critérios LanguageInfo no nível da campanha (CampaignCriterion.language) ou do grupo de anúncios (AdGroupCriterion.language) definindo language_constant como um nome de recurso LanguageConstant segmentável (no formato languageConstants/{criterion_id}; consulte os códigos de idioma compatíveis). Na v24 e em versões mais recentes, tentar segmentar um idioma não permitido ou não segmentável retorna CriterionError.CANNOT_TARGET_LANGUAGE.

A compatibilidade com LanguageInfo depende do tipo de campanha:

• Tipos de campanha compatíveis:é possível segmentar idiomas em tipos de campanha qualificados, como de display, de vídeo, Performance Max (no nível da campanha, aplica-se a canais que não são de pesquisa), campanhas para apps (no nível da campanha) e campanhas Geração de Demanda (no nível do grupo de anúncios por padrão ou no nível da campanha, dependendo de DemandGenCampaignSettings.upgraded_targeting).
• Campanhas de pesquisa (AdvertisingChannelType.SEARCH), IA Max para campanhas de pesquisa e anúncios Performance Max na Pesquisa Google:não é possível usar a segmentação por idioma manual. Em vez disso, os anúncios mostrados na Pesquisa Google são automaticamente associados aos usuários com base no idioma dos criativos de anúncios e das páginas de destino, além das preferências de idioma do usuário:
  • Criar ou atualizar critérios:as tentativas de criar ou atualizar um critério LanguageInfo em uma campanha de pesquisa falham com um erro ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT.
  • Consultar e remover critérios legados:os critérios CampaignCriterion.language atuais nas campanhas de pesquisa ainda são retornados nas respostas de consulta, mesmo que não sejam usados para veiculação de anúncios. Embora a interface do Google Ads não ofereça um campo de segmentação por idioma para campanhas de pesquisa, é possível remover critérios legados de CampaignCriterion.language usando CampaignCriterionService.