Controles e filtragem de inventário para anúncios verticais

Os anúncios verticais oferecem recursos especializados para campanhas de pesquisa com a IA Max para campanhas de pesquisa ativada e vinculadas a um feed vertical, como hotéis. Você pode controlar quais formatos de anúncios verticais são veiculados no nível do grupo de anúncios e quais entidades de feed são segmentadas usando regras de grupo de itens de anúncios verticais.

Visão geral

Este guia aborda dois recursos principais para gerenciar anúncios verticais:

  1. Controles de formato:ative ou desative formatos de anúncio específicos (anúncios de texto, links para reserva e anúncios de promoção vertical) no nível do grupo de anúncios.
  2. Gerenciamento de itens de anúncios verticais:filtre e segmente um inventário específico do seu feed vertical vinculado (antigamente chamado de viagem) usando um sistema baseado em regras que envolve SharedSet e SharedCriterion.

Pré-requisitos

Antes de implementar esses recursos, verifique se a campanha atende aos seguintes requisitos:

Para ativar os feeds de viagem nos anúncios de pesquisa (TFSA) e os controles de anúncios verticais na sua campanha, vincule o conjunto de recursos de feed de dados vertical no nível da campanha seguindo estas etapas. Como alternativa, para ativar esses recursos em todas as campanhas da sua conta, vincule o feed no nível do cliente seguindo as instruções de vinculação no nível do cliente no guia Feeds de viagem nos anúncios de pesquisa.

  1. Crie um objeto CampaignAssetSet, definindo asset_set como o nome do recurso do conjunto de recursos de feed vertical e campaign como o nome do recurso da sua campanha.
  2. Crie um CampaignAssetSetOperation com create definido como CampaignAssetSet.
  3. Envie a operação usando CampaignAssetSetService.MutateCampaignAssetSets.

Para mais detalhes sobre como gerenciar feeds de viagem em escala, consulte a documentação Feeds de viagem nos anúncios de pesquisa.

Controles de formato do grupo de anúncios

Você pode configurar quais formatos de anúncios verticais estão ativos para um grupo de anúncios específico. Isso é gerenciado pelo campo vertical_ads_format_setting (VerticalAdsFormatSetting) no recurso AdGroup.

Formatos disponíveis

Regras de validação

  • Não é possível desativar todos os três formatos simultaneamente para um único grupo de anúncios.
  • enable_booking_links só pode ser definido como true quando o feed vertical ativo da campanha é HOTELS ou THINGS_TO_DO.
  • Essas configurações só se aplicam a SEARCH_STANDARD e SEARCH_DYNAMIC_ADS tipos de grupo de anúncios.

Exemplo: atualizar as configurações de formato

O exemplo de Java a seguir demonstra como desativar anúncios de texto e ativar anúncios de promoção vertical para um grupo de anúncios atual:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

Gerenciamento de itens de anúncios verticais

Para segmentar um subconjunto específico do inventário do feed, como "Hotéis em Boston" ou "Excluir hotéis de 1 estrela", use regras de grupo de itens de anúncios verticais.

Como o modelo de dados funciona

O modelo de dados usa uma abordagem de critérios compartilhados:

  1. SharedSet: crie um SharedSet com o tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: adicione regras (critérios) a esse conjunto. Cada regra especifica uma dimensão, como cidade ou classe de hotel, e um valor. Também é possível criar critérios negativos para excluir itens.
  3. AdGroupCriterion: vincule o SharedSet ao seu AdGroup usando um AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensões compatíveis

É possível filtrar entidades com base nas seguintes dimensões em SharedCriterion (VerticalAdsItemGroupRuleInfo), dependendo do SharedSet's vertical_ads_item_vertical_type:

  • item_code: ID de ficha da empresa específico (compatível com todos os tipos verticais).
  • city_criterion_id, region_criterion_id, country_criterion_id: nomes de recursos constantes de segmentação por área geográfica (geoTargetConstants/{id}; compatível com todos os tipos verticais, exceto FLIGHTS).
  • hotel_class: classificação por estrelas de 1 a 5 (somente HOTELS).
  • user_rating (a partir da v24): avaliação de usuários arredondada de 1 a 5 (somente THINGS_TO_DO).
  • venue, event_participant_display_name (a partir da v24): filtros de nome de exibição do local e do participante do evento (somente EVENTS).

Este exemplo de Python cria uma regra para incluir itens em "Boston" ou "São Francisco" e excluir hotéis "1 estrela" e "2 estrelas":

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

Lances manuais de CPC por entidade

A partir de v25, para campanhas de pesquisa para viagens (campanhas de pesquisa com a IA Max para campanhas de pesquisa ativada e um feed de hotel vinculado) que usam a estratégia de lances manuais de CPC (BiddingStrategyType.MANUAL_CPC), é possível definir substituições de lances manuais de CPC (cpc_bid_micros) para itens de feed de hotel individuais usando o critério EntityBid (ad_group_criterion.entity_bid) com CriterionType.VERTICAL_ADS_ITEM_BID e entity_bid.item_code.

Critérios negativos (negative = true), campanhas que não são de pesquisa e estratégias de lances automáticos ou Lances inteligentes não são compatíveis com VERTICAL_ADS_ITEM_BID e retornam ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. As métricas de performance não são preenchidas nos critérios VERTICAL_ADS_ITEM_BID. Para detalhes completos do esquema, consultas GAQL e exemplos de payload de mutação, consulte Lances manuais de CPC por entidade no guia Feeds de viagem nos anúncios de pesquisa.

Relatórios de performance

É possível recuperar métricas de performance para anúncios verticais usando os GoogleAdsService.SearchStream ou GoogleAdsService.Search métodos.

Segmentos de anúncios verticais

Segmentos de dimensão de itinerário

A partir da v25, para anúncios verticais vinculados a feeds de viagens e acomodações, é possível segmentar relatórios de performance usando dimensões de itinerário:

Métricas de anúncios verticais

A partir de v25, é possível recuperar as seguintes métricas de anúncios verticais:

Exemplos de consultas GAQL

Essa consulta recupera métricas de reserva e competitivas de anúncios verticais segmentadas por cidade da ficha, faixa de preço e tipo de taxa:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Essa consulta segmenta métricas de performance padrão por dimensões de reserva de itinerário:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Tratamento de erros

Estes são erros comuns que podem ocorrer ao configurar anúncios verticais:

Código do erro Causa Ação recomendada
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING Todos os três formatos de anúncio (texto, link para reserva, anúncios de promoção) foram desativados simultaneamente, ou enable_booking_links foi ativado para um vertical diferente de HOTELS ou THINGS_TO_DO. Verifique se pelo menos um formato está ativado em VerticalAdsFormatSetting, e ative links para reserva apenas para feeds HOTELS ou THINGS_TO_DO.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX A campanha não tem a IA Max para campanhas de pesquisa ativada. Ative a IA Max para campanhas de pesquisa nas configurações da campanha.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED A campanha não tem um feed de dados vertical ativo. Verifique se um feed vertical válido está vinculado no nível do cliente ou da campanha
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST O nome do recurso SharedSet fornecido no AdGroupCriterion não existe ou não tem o tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST. Verifique se o nome do recurso shared_set faz referência a um SharedSet existente do tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET O SharedSet referenciado no AdGroupCriterion tem o status REMOVED. Faça referência a um SharedSet ativado do tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE A dimensão do critério usada não é compatível com o vertical específico, como a classe de hotel para aluguel de carros. Verifique se a dimensão vertical_ads_item_group_rule corresponde ao seu tipo vertical.