Participe da nossa transmissão ao vivo no Discord no servidor da comunidade de publicidade e medição do Google e no YouTube em 29 de janeiro às 10h (horário de Brasília). Vamos discutir os novos recursos adicionados na v23 da API Google Ads.

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

Os anúncios verticais oferecem recursos especializados para campanhas de pesquisa ativadas pela IA Max 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:

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.
Gerenciamento de itens de anúncios verticais:filtre e segmente inventários específicos do seu feed vertical vinculado (antes chamado de viagem) usando um sistema baseado em regras que envolve SharedSet andSharedCriterion`.

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 à campanha.
IA Max:a configuração "IA Max" precisa estar ativada na campanha.

Controles de formato do grupo de anúncios

Agora é 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 no recurso AdGroup.

Formatos disponíveis

Anúncios de texto:ativados por padrão. Pode ser desativado.
Links para reserva:é necessário ativar.
Anúncios de promoção vertical:é 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 STANDARD e SEARCH_DYNAMIC_ADS.

Exemplo: atualizar as configurações de formato

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

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .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 seu inventário de feed, como "Hotéis em Boston" ou "Excluir hotéis de uma 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:

SharedSet: crie um SharedSet com o tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
SharedCriterion: adicione regras (critérios) a este conjunto. Cada regra especifica uma dimensão, como "Cidade" ou "Classe do hotel", e um valor. Também é possível criar critérios negativos para excluir itens.
AdGroupCriterion: vincule o SharedSet ao AdGroup usando um AdGroupCriterion.

Dimensões compatíveis

É possível filtrar entidades com base nas seguintes dimensões em SharedCriterion:

item_code: ID específico da página de detalhes.
city_criterion_id, region_criterion_id, country_criterion_id: constantes de segmentação geográfica.
brand_text: nome da marca.
hotel_class: nota com estrelas (1 a 5).
vertical_ads_item_category: categoria, como CONCERT.

Exemplo de código: criar e vincular regras

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

Python

# 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_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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

É possível recuperar métricas de performance para anúncios verticais usando os métodos GoogleAdsService.SearchStream ou GoogleAdsService.Search. Para a API Google Ads, a v23 adiciona segmentos específicos para relatórios detalhados.

Novos segmentos

segments.vertical_ads_listing_city: a cidade associada à ficha.
segments.vertical_ads_vertical_type: o tipo vertical, como hotel ou carro alugado.

Exemplo de consulta GAQL

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
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
`INVALID_VERTICAL_ADS_FORMAT_SETTING`	Os três formatos de anúncio (texto, link para reserva e promoção) foram desativados simultaneamente.	Verifique se pelo menos um formato está ativado (definido como "true") no `VerticalAdsFormatSetting`.
`VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...`	A campanha não tem a IA Max ativada ou não tem um feed vertical ativo.	Ative a IA Max nas configurações da campanha e verifique se um feed vertical válido está vinculado.
`VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST`	O nome do recurso SharedSet fornecido no AdGroupCriterion não existe.	Verifique se o nome do recurso shared_set corresponde a um conjunto criado.
`VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...`	O tipo de critério usado não é compatível com o setor específico, como classe de hotel para aluguel de carros.	Verifique se a dimensão `vertical_ads_item_group_rule` corresponde ao tipo de vertical.