Feeds de viagem nos anúncios de pesquisa

Com os feeds de produtos de hotéis, aluguéis por temporada ou atividades 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 feeds de viagem (TRAVEL_FEED conjuntos de recursos) do nível do cliente por meio de CustomerAssetSet associações. Para substituir as configurações no nível do cliente de uma campanha específica, você deve adicionar TRAVEL_FEED ao campo da campanha excluded_parent_asset_set_types e gerenciar links específicos da campanha usando CampaignAssetSet.

• Herdar feeds do cliente (padrão) : mantenha o CustomerAssetSet vinculado no nível do cliente 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 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 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.
• 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.

Desativar os feeds de viagem nos anúncios de pesquisa

Se preferir não usar esse recurso, você pode usar a API Google Ads para desativar os feeds de viagem nos anúncios de pesquisa nos níveis do cliente e da 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 CustomerAssetSet links cujo tipo seja TRAVEL_FEED usando o customer_asset_set relatório:

   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 novamente no nível do cliente:

1. Para cada AssetSet (asset_set.resource_name) subjacente que você quer vincular, crie um novo CustomerAssetSet com asset_set definido como o asset_set.resource_name e customer definido como o nome do recurso do 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 novo Campaign objeto com excluded_parent_asset_set_types definido como os valores anteriores mais TRAVEL_FEED e resource_name definido como o nome do recurso da 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 todas as associações de feeds 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 você quiser ativar esse recurso novamente no nível da campanha:

1. Para cada AssetSet subjacente (asset_set.resource_name) que você quer ativar, crie um novo CampaignAssetSet com asset_set definido como o 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 que o status de ativação de uma campanha herde a configuração no nível do cliente novamente, siga estas etapas:

1. Crie um novo Campaign objeto com excluded_parent_asset_set_types sem TRAVEL_FEED na lista e resource_name definido como o nome do recurso da 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 API Google Ads v25, é possível configurar substituições de lances manuais 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 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 hotéis associado [TRAVEL_FEED conjunto de recursos]; apenas feeds de hotéis são aceitos).
• Estratégia de lances: CPC manual (BiddingStrategyType.MANUAL_CPC) somente.
  • Não é aceito em estratégias de Lances inteligentes ou automáticos (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. Lances de entidades negativas não são aceitos.
• Identificador e lance de 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 aceitos

Exemplos de código e payload

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

Ler lances de entidades usando a GAQL

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

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 performance

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ões 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