Feeds de viagem nos anúncios de pesquisa

Com os feeds de produtos de hotéis, aluguéis por temporada ou Coisas Legais para Fazer vinculados à sua conta do Google Ads, o Google Ads enriquece automaticamente as campanhas de pesquisa com preços e imagens extraídos dos seus feeds. Esse recurso é conhecido como feeds de viagem nos anúncios de pesquisa.

Como as configurações do cliente e da campanha interagem

Por padrão, as campanhas herdam links de feed de viagens (conjuntos de recursos TRAVEL_FEED) do nível do cliente por meio de associações CustomerAssetSet. Para substituir as configurações no nível do cliente de uma campanha específica, adicione TRAVEL_FEED ao campo excluded_parent_asset_set_types da campanha e gerencie os links específicos da campanha usando CampaignAssetSet.

• Herdar feeds do cliente (padrão): mantenha o CustomerAssetSet no nível do cliente vinculado e verifique se Campaign.excluded_parent_asset_set_types não contém TRAVEL_FEED.
• Desativar no nível do cliente:remova a associação de CustomerAssetSet no nível do cliente e não vincule um CampaignAssetSet no nível da campanha.
• Desativar uma campanha específica:adicione TRAVEL_FEED a Campaign.excluded_parent_asset_set_types e remova todas as associações de CampaignAssetSet no nível da campanha.
• Ativar apenas uma campanha específica:remova a associação de CustomerAssetSet no nível do cliente e crie um link de CampaignAssetSet no nível da campanha para essa campanha.
• Usar feeds específicos da campanha enquanto outras campanhas continuam herdando:adicione TRAVEL_FEED ao Campaign.excluded_parent_asset_set_types da campanha e crie um link CampaignAssetSet no nível da campanha para ela.

Desativar os feeds de viagem nos anúncios de pesquisa

Se preferir não usar esse recurso, use a API Google Ads para desativar os feeds de viagem nos anúncios de pesquisa nos níveis de cliente e campanha.

Desativar no nível do cliente

Para desativar os feeds de viagem nos anúncios de pesquisa no nível do cliente, faça o seguinte:

1. Recupere customer_asset_set.resource_name e asset_set.resource_name para todos os links CustomerAssetSet do tipo TRAVEL_FEED usando o relatório customer_asset_set:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. Para cada customer_asset_set.resource_name, crie um CustomerAssetSetOperation e defina remove como o customer_asset_set.resource_name recuperado na etapa anterior.

3. Envie uma solicitação para CustomerAssetSetService.MutateCustomerAssetSets usando os objetos CustomerAssetSetOperation criados.

Se você quiser ativar esse recurso no nível do cliente novamente:

1. Para cada AssetSet (asset_set.resource_name) subjacente que você quer vincular, crie um novo CustomerAssetSet com asset_set definido como asset_set.resource_name e customer definido como o nome do recurso do seu cliente.
2. Para cada CustomerAssetSet criado na etapa anterior, crie um CustomerAssetSetOperation com create definido como CustomerAssetSet.
3. Envie uma solicitação para CustomerAssetSetService.MutateCustomerAssetSets usando os objetos CustomerAssetSetOperation criados.

Desativar no nível da campanha

Para desativar os feeds de viagem nos anúncios de pesquisa no nível da campanha, primeiro é necessário excluir o status de ativação herdado do nível do cliente:

1. Recupere excluded_parent_asset_set_types usando o relatório campaign:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. Crie um novo objeto Campaign com excluded_parent_asset_set_types definido como os valores anteriores mais TRAVEL_FEED e resource_name definido como o nome do recurso da sua campanha.

3. Crie um CampaignOperation e defina update como o Campaign criado anteriormente e update_mask de acordo.

4. Envie uma solicitação para CampaignService.MutateCampaigns usando o CampaignOperation criado na etapa anterior.

Em seguida, remova as associações de feed de viagem no nível da campanha:

1. Para a campanha que você quer desativar, recupere campaign_asset_set.resource_name e asset_set.resource_name para todos os links CampaignAssetSet do tipo TRAVEL_FEED usando o relatório campaign_asset_set:

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. Para cada campaign_asset_set.resource_name, crie um CampaignAssetSetOperation e defina remove como o campaign_asset_set.resource_name recuperado na etapa anterior.

3. Envie uma solicitação para CampaignAssetSetService.MutateCampaignAssetSets usando os objetos CampaignAssetSetOperation criados.

Se você quiser ativar esse recurso no nível da campanha novamente:

1. Para cada AssetSet (asset_set.resource_name) que você quer ativar, crie um novo CampaignAssetSet com asset_set definido como asset_set.resource_name e campaign definido como o nome do recurso da sua campanha.
2. Para cada CampaignAssetSet criado na etapa anterior, crie um CampaignAssetSetOperation com create definido como CampaignAssetSet.
3. Envie uma solicitação para CampaignAssetSetService.MutateCampaignAssetSets usando os objetos CampaignAssetSetOperation criados.

Restaurar o status de ativação no nível do cliente para uma campanha

Para que o status de ativação de uma campanha herde novamente a configuração no nível do cliente, siga estas etapas:

1. Crie um novo objeto Campaign com excluded_parent_asset_set_types sem TRAVEL_FEED na lista e resource_name definido como o nome do recurso da sua campanha.
2. Crie um CampaignOperation e defina update como o Campaign criado anteriormente e update_mask de acordo.
3. Envie uma solicitação para CampaignService.MutateCampaigns usando o CampaignOperation criado na etapa anterior.

Lances manuais de CPC por entidade

A partir da versão v25 da API Google Ads, é possível configurar substituições de lance manual de CPC por entidade para hotéis em campanhas de pesquisa para viagem usando o recurso AdGroupCriterion com o tipo de critério CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). Para definir ajustes multiplicativos de lance de grupo de anúncios em dimensões de itinerário de viagem usando AdGroupBidModifier, consulte Ajustar lances com modificadores de lance.

Pré-requisitos e requisitos de compatibilidade

Para criar e gerenciar critérios de VERTICAL_ADS_ITEM_BID, as seguintes condições precisam ser atendidas:

• Tipo de campanha:campanhas de pesquisa para viagem (campanhas de pesquisa, AdvertisingChannelType.SEARCH, com a IA Max para campanhas de pesquisa ativada por meio de Campaign.ai_max_setting.enable_ai_max e um conjunto de recursos de feed de hotel TRAVEL_FEED associado; somente feeds de hotel são aceitos).
• Estratégia de lances:somente CPC manual (BiddingStrategyType.MANUAL_CPC).
  • Não é compatível com estratégias de lances automáticas ou inteligentes (como Maximizar conversões, Maximizar o valor da conversão, CPA desejado ou ROAS desejado).
• Somente critérios positivos:negative precisa ser definido como false. Não é possível usar lances de entidade negativos.
• Identificador de entidade e lance obrigatórios:entity_bid.item_code e cpc_bid_micros são obrigatórios ao criar um critério de lance de entidade.

Definições de esquema e campo

• Recurso: AdGroupCriterion (ad_group_criterion)
• Formato do nome do recurso: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Tipo enumerado de critério: CriterionType.VERTICAL_ADS_ITEM_BID
• Mensagem:EntityBid (ad_group_criterion.entity_bid)

Serviços e operações compatíveis

Exemplos de código e payload

Os exemplos a seguir mostram como ler, criar, atualizar e remover critérios de VERTICAL_ADS_ITEM_BID.

Ler lances de entidade usando a GAQL

Use GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar os critérios de VERTICAL_ADS_ITEM_BID:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

Criar um lance de entidade

Envie uma operação create para AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

Atualizar o valor do lance de uma entidade

Envie uma operação update com um updateMask para AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

Remover um lance de entidade

Envie uma operação remove para AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

Regras de validação e tratamento de erros

Relatórios de desempenho

Use ClickType.TRAVEL_ASSETS para identificar dados de performance de anúncios veiculados como feeds de viagem nos anúncios de pesquisa, como buscar dados de performance dos anúncios em todas as suas campanhas:

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

Segmentos de dimensão do itinerário

Também é possível segmentar relatórios de performance de campanhas com feeds de viagem vinculados por dimensões de itinerário:

• segments.advance_booking_window: a janela de reserva futura 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 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).

Amostra de consulta

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS