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 que estão vinculadas a um feed vertical, como hotéis. É possível controlar quais formatos de anúncios verticais são veiculados no nível do grupo de anúncios e quais entidades do feed são segmentadas usando as 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 inventários específicos do seu feed vertical (antes chamado de feed de viagens) vinculado 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:

• Tipo de campanha:precisa ser uma campanha de pesquisa.
• Feed vertical:um feed de dados vertical ativo precisa estar vinculado no nível do cliente ou da campanha. Consulte Vincular feeds de dados verticais no nível da campanha para saber como fazer isso. A vinculação de um feed de dados vertical ativa os feeds de viagem nos anúncios de pesquisa (TFSA) e os controles de anúncios verticais para a campanha.
• IA Max para campanhas de pesquisa:a configuração da IA Max para campanhas de pesquisa precisa estar ativada na campanha.

Vincular feeds de dados verticais no nível da campanha

Para ativar os feeds de viagem nos anúncios de pesquisa (TFSA, na sigla em inglês) e os controles de anúncios verticais na sua campanha, vincule o conjunto de recursos do feed de dados verticais no nível da campanha seguindo as etapas abaixo. 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 seu 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 grande escala, consulte a documentação Feeds de viagem nos anúncios de pesquisa.

Controles de formato do grupo de anúncios

É possível configurar quais formatos de anúncio vertical 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

• Anúncios de texto (disable_text_ads): ativados por padrão. Pode ser desativado.
• Links para reserva (enable_booking_links): ativação necessária. Compatível apenas com feeds verticais HOTELS e THINGS_TO_DO.
• Anúncios de promoção do setor (enable_vertical_promotion_ads): ativação necessária.

Regras de validação

• Não é possível desativar 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 se aplicam apenas aos tipos de grupo de anúncios SEARCH_STANDARD e SEARCH_DYNAMIC_ADS.

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:

// 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 as 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 "Classificação do hotel", e um valor. Também é possível criar critérios negativos para excluir itens.
3. AdGroupCriterion: vincule o SharedSet ao 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 vertical_ads_item_vertical_type do SharedSet:

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

Exemplo de código: criar e vincular regras

Este exemplo em Python cria uma regra para incluir itens em "Boston" ou "San Francisco" e excluir hotéis de "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 viagem (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 individuais do feed de hotel 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 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 de 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. Para definir ajustes multiplicativos de lance de grupo de anúncios em dimensões de itinerário de viagem para anúncios de hotel usando AdGroupBidModifier, consulte Ajustar lances com modificadores de lance.

Relatórios de desempenho

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

Segmentos de anúncios verticais

• segments.vertical_ads_hotel_class: valor inteiro (de 1 a 5 estrelas) que especifica a classificação de uma ficha de hotel.
• segments.vertical_ads_listing: identificador de uma ficha de anúncio vertical específica.
• segments.vertical_ads_listing_brand: marca associada a uma listagem de anúncios verticais.
• segments.vertical_ads_listing_city: a cidade associada à listagem.
• segments.vertical_ads_listing_country: o país associado à ficha da empresa.
• segments.vertical_ads_listing_region: a região associada à listagem.
• segments.vertical_ads_partner_account: a conta do parceiro em uma Central de Parceiros (por exemplo, Central para Hotéis) que fornece dados de feed de inventário.
• segments.vertical_ads_vertical: o tipo de setor, como hotel ou aluguel de carros.
• segments.vertical_ads_event_participant_display_names: os nomes de exibição dos participantes em uma listagem de eventos, como artistas, palestrantes ou equipes.
• segments.vertical_ads_listing_user_rating (a partir de v24): valor inteiro (de 1 a 5) que especifica a avaliação de usuários da ficha de anúncios verticais.
• segments.vertical_ads_listing_venue (a partir de v24): o nome do local para a listagem de anúncios verticais (por exemplo, um local de show).
• segments.vertical_ads_price_tier (a partir de v25): bucket de competitividade de preço relativo para informações de hotéis.
• segments.vertical_ads_rate_rule_id (a partir de v25): identificador de string correspondente às regras de taxa privada ou condicional aplicadas ao lance ou à impressão.
• segments.vertical_ads_rate_type (a partir de v25): categorização do tipo de tarifa pública, privada ou condicional.

Segmentos de dimensão do itinerário

A partir de v25, para anúncios verticais vinculados a feeds de viagens e acomodações, você pode segmentar relatórios de performance usando dimensões de itinerário:

• segments.advance_booking_window: o período de reserva antecipada do itinerário em dias.
• segments.length_of_booking: o período de reserva do itinerário em dias.
• segments.start_date: a data de início da reserva formatada como yyyy-MM-dd.
• segments.start_day_of_week: o dia da semana em que a reserva começa.
• segments.user_set_dates: indica se as datas especificadas pelo usuário foram selecionadas (USER_SELECTED ou DEFAULT_SELECTION).

Métricas de anúncios verticais

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

• metrics.vertical_ads_potential_impressions: impressões em potencial que representam o total de impressões qualificadas com limite de visualização disponíveis no contexto da consulta.
• metrics.vertical_ads_average_booking_value_micros: é a tarifa diária média ponderada por cliques em micros, incluindo tributos e taxas, durante toda a duração da estadia.
• metrics.vertical_ads_price_difference_percentage: porcentagem de diferença entre o preço oferecido pelo anunciante e o menor preço da concorrência para a mesma propriedade.

Exemplos de consultas GAQL

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

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 as 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: