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 ativada que estão vinculadas a um feed vertical, como hotéis. Você pode controlar quais formatos de anúncio 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 segmentem inventários específicos do feed vertical vinculado (antes chamado de viagem) usando um sistema baseado em regras que envolve SharedSet e SharedCriterion.

Pré-requisitos

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

• Tipo de campanha:precisa ser uma campanha de pesquisa.
• Feed vertical:um feed de dados vertical ativo precisa ser vinculado no nível do cliente ou da campanha. Consulte Vincular feeds de dados verticais no nível da campanha para vincular um feed nesse nível. A vinculação de um feed de dados vertical ativa os feeds de viagem nos anúncios de pesquisa (TFSA) e permite 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) e os controles de anúncios verticais na sua campanha, vincule o conjunto de recursos de feed de dados verticais 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 de 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 do feed vertical e campaign como o nome do recurso da 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ú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

• Anúncios de texto (disable_text_ads): ativados por padrão. Pode ser desativado.
• Links para reserva (enable_booking_links): é necessário ativar.
• Anúncios de promoção vertical (enable_vertical_promotion_ads): É necessário ativar.

Regras de validação

• Não é possível desativar todos os três formatos simultaneamente em um único grupo de anúncios.
• Essas configurações só se aplicam aos tipos de grupo de anúncios SEARCH_STANDARD e SEARCH_DYNAMIC_ADS.

Exemplo: atualizar as configurações de formato

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

// 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(
        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 seu 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 do hotel", e um valor. Você também pode 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):

• item_code: ID específico das informações do produto.
• city_criterion_id, region_criterion_id, country_criterion_id: nomes de recursos constantes de segmentação geográfica (geoTargetConstants/{id}).
• hotel_class: classificação por estrelas (1 a 5).
• user_rating, venue, event_participant_display_name (a partir de v24): filtros de classificação de eventos e listagens verticais, local e nome do participante.

Exemplo de código: criar e vincular regras

Este exemplo em 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...

Relatórios de desempenho

É possível recuperar métricas de performance para 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 um 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úncio vertical.
• segments.vertical_ads_listing_city: a cidade associada à ficha da empresa.
• segments.vertical_ads_listing_country: o país associado às informações do produto.
• segments.vertical_ads_listing_region: a região associada à ficha da empresa.
• segments.vertical_ads_partner_account: a conta de 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 vertical, como hotel ou carro alugado.
• segments.vertical_ads_event_participant_display_names (a partir de v24): os nomes de exibição dos participantes em uma lista 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 classificação do usuário da lista 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 shows).
• segments.vertical_ads_price_tier (a partir de v25): bucket de competitividade de preços relativos para anúncios de hotéis.
• segments.vertical_ads_rate_rule_id (a partir de v25): identificador de string correspondente a regras de tarifação privada ou condicional aplicadas ao lance ou à impressão.
• segments.vertical_ads_rate_type (a partir de v25): categorização do tipo de taxa pública, privada ou tarifa condicional.

Segmentos de dimensão de 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: a duração da 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 de início da reserva.
• 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, você pode 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: taxa diária média ponderada por clique em micros, incluindo tributos e taxas, durante o período total de permanência.
• metrics.vertical_ads_price_difference_percentage: Delta de porcentagem que compara o preço oferecido pelo anunciante com o preço concorrente mais baixo para a mesma propriedade.

Exemplo de consulta GAQL

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.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Tratamento de erros

Estes são erros comuns que você pode encontrar ao configurar anúncios verticais: