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 de cliente e de campanha interagem

Por padrão, as campanhas herdam links de feed de viagens (conjuntos de recursos TRAVEL_FEED) do nível do cliente por associações CustomerAssetSet. Para substituir as configurações no nível do cliente em 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.

• Herde os feeds de clientes (padrão): mantenha o CustomerAssetSet no nível do cliente vinculado e garanta que o Campaign.excluded_parent_asset_set_types não contenha TRAVEL_FEED.
• Desativar no nível do cliente:remova a associação CustomerAssetSet no nível do cliente e não vincule uma 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 CustomerAssetSet no nível do cliente e crie um link CampaignAssetSet no nível da campanha.
• Use 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.

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 cujo 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 quiser ativar esse recurso novamente no nível do cliente:

1. Para cada AssetSet (asset_set.resource_name) 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 o 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 exclua 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 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 e update_mask criados anteriormente, respectivamente.

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 cujo tipo seja 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 quiser ativar esse recurso novamente no nível da campanha:

1. Para cada AssetSet (asset_set.resource_name) subjacente 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 o 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 fazer com 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 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 e update_mask criados anteriormente, respectivamente.
3. Envie uma solicitação para CampaignService.MutateCampaigns usando o CampaignOperation criado na etapa anterior.

Lances manuais de CPC por entidade

A partir da API Google Ads v25, é possível configurar substituições manuais de lances de CPC por entidade para hotéis em campanhas de pesquisa para viagens usando o recurso AdGroupCriterion com o tipo de critério CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

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 viagens (campanhas de pesquisa, AdvertisingChannelType.SEARCH, com a IA Max para campanhas de pesquisa ativada Campaign.ai_max_setting.enable_ai_max e um feed de hotel associado [conjunto de recursos TRAVEL_FEED]; somente feeds de hotel são aceitos).
• Estratégia de lances:CPC manual (BiddingStrategyType.MANUAL_CPC) apenas.
  • Não é compatível com estratégias de lances automáticas ou de estratégia de Lances Inteligentes, como Maximizar Conversões, Maximizar o Valor de Conversão, CPA desejado ou ROAS desejado.
• Somente critérios positivos:negative precisa ser definido como false. Não é possível fazer lances negativos de entidades.
• Identificador e lance da entidade 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}
• Enumeração do tipo 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 GAQL

Use GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar critérios 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 um valor de lance de 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

Você pode usar 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 de itinerário

Também é possível segmentar relatórios de performance para 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 de início da reserva.
• 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