Feed viaggi negli annunci della rete di ricerca

Con i feed dei prodotti Hotel, Case vacanze o Cose da fare collegati al tuo account Google Ads, Google Ads arricchisce automaticamente le campagne sulla rete di ricerca esistenti con prezzi e immagini estratti dai tuoi feed. Questa funzionalità è nota come feed viaggi negli annunci della rete di ricerca.

Interazione tra le impostazioni del cliente e quelle della campagna

Per impostazione predefinita, le campagne ereditano i link dei feed per i viaggi (insiemi di asset TRAVEL_FEED) dal livello cliente tramite le associazioni CustomerAssetSet. Per sostituire le impostazioni a livello di cliente per una campagna specifica, devi aggiungere TRAVEL_FEED al campo excluded_parent_asset_set_types della campagna e gestire i link specifici per la campagna utilizzando CampaignAssetSet.

• Eredita i feed dei clienti (impostazione predefinita): mantieni il collegamento CustomerAssetSet a livello di cliente e assicurati che Campaign.excluded_parent_asset_set_types non contenga TRAVEL_FEED.
• Disattivazione a livello di cliente:rimuovi l'associazione a livello di cliente CustomerAssetSet e non collegare un'associazione a livello di campagna CampaignAssetSet.
• Disattiva una campagna specifica: aggiungi TRAVEL_FEED a Campaign.excluded_parent_asset_set_types e rimuovi tutte le associazioni CampaignAssetSet a livello di campagna.
• Attiva solo una campagna specifica:rimuovi l'associazione a livello di cliente CustomerAssetSet e poi crea un link a livello di campagna CampaignAssetSet per la campagna in questione.
• Utilizza i feed specifici per la campagna mentre le altre campagne continuano a ereditare:aggiungi TRAVEL_FEED alla Campaign.excluded_parent_asset_set_types della campagna e crea un link CampaignAssetSet a livello di campagna.

Disattiva i feed viaggi negli annunci della rete di ricerca

Se preferisci non utilizzare questa funzionalità, puoi utilizzare l'API Google Ads per disattivare i feed per i viaggi negli annunci della rete di ricerca a livello di cliente e di campagna.

Disattivazione a livello di cliente

Per disattivare i feed viaggi negli annunci della rete di ricerca a livello di cliente, segui questi passaggi:

1. Recupera sia customer_asset_set.resource_name che asset_set.resource_name per tutti i link CustomerAssetSet il cui tipo è TRAVEL_FEED utilizzando il report 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. Per ogni customer_asset_set.resource_name, crea un CustomerAssetSetOperation e imposta remove su customer_asset_set.resource_name recuperato nel passaggio precedente.

3. Invia una richiesta a CustomerAssetSetService.MutateCustomerAssetSets utilizzando gli oggetti CustomerAssetSetOperation creati.

Se vuoi attivare di nuovo questa funzionalità a livello di cliente:

1. Per ogni AssetSet (asset_set.resource_name) sottostante che vuoi collegare, crea un nuovo CustomerAssetSet con asset_set impostato su asset_set.resource_name e customer impostato sul nome della risorsa del tuo cliente.
2. Per ogni CustomerAssetSet creato nel passaggio precedente, crea un CustomerAssetSetOperation con create impostato su CustomerAssetSet.
3. Invia una richiesta a CustomerAssetSetService.MutateCustomerAssetSets utilizzando gli oggetti CustomerAssetSetOperation creati.

Disattivazione a livello di campagna

Per disattivare i feed viaggi negli annunci della rete di ricerca a livello di campagna, devi prima escludere lo stato di attivazione ereditato dal livello cliente:

1. Recupera excluded_parent_asset_set_types utilizzando il report campaign:

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

2. Crea un nuovo oggetto Campaign con excluded_parent_asset_set_types impostato sui valori precedenti più TRAVEL_FEED e resource_name impostato sul nome della risorsa della campagna.

3. Crea un CampaignOperation e imposta update sul Campaign creato in precedenza e update_mask di conseguenza.

4. Invia una richiesta a CampaignService.MutateCampaigns utilizzando il CampaignOperation creato nel passaggio precedente.

Poi, rimuovi tutte le associazioni di feed per i viaggi a livello di campagna:

1. Per la campagna per cui vuoi disattivare la funzionalità, recupera sia campaign_asset_set.resource_name che asset_set.resource_name per tutti i link CampaignAssetSet il cui tipo è TRAVEL_FEED utilizzando il report 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. Per ogni campaign_asset_set.resource_name, crea un CampaignAssetSetOperation e imposta remove sul campaign_asset_set.resource_name recuperato nel passaggio precedente.

3. Invia una richiesta a CampaignAssetSetService.MutateCampaignAssetSets utilizzando gli oggetti CampaignAssetSetOperation creati.

Se vuoi attivare di nuovo questa funzionalità a livello di campagna:

1. Per ogni AssetSet (asset_set.resource_name) sottostante per cui vuoi attivare l'attivazione, crea un nuovo CampaignAssetSet con asset_set impostato su asset_set.resource_name e campaign impostato sul nome della risorsa della tua campagna.
2. Per ogni CampaignAssetSet creato nel passaggio precedente, crea un CampaignAssetSetOperation con create impostato su CampaignAssetSet.
3. Invia una richiesta a CampaignAssetSetService.MutateCampaignAssetSets utilizzando gli oggetti CampaignAssetSetOperation creati.

Ripristina lo stato di attivazione a livello di cliente per una campagna

Per fare in modo che lo stato di attivazione di una campagna erediti nuovamente l'impostazione a livello di cliente, segui questi passaggi:

1. Crea un nuovo oggetto Campaign con excluded_parent_asset_set_types senza TRAVEL_FEED nell'elenco e resource_name impostato sul nome della risorsa della campagna.
2. Crea un CampaignOperation e imposta update sul Campaign creato in precedenza e update_mask di conseguenza.
3. Invia una richiesta a CampaignService.MutateCampaigns utilizzando il CampaignOperation creato nel passaggio precedente.

Offerta manuale basata su CPC per entità

A partire dall'API Google Ads v25, puoi configurare gli override delle offerte manuali basate su CPC per entità per gli hotel nelle campagne sulla rete di ricerca per i viaggi utilizzando la risorsa AdGroupCriterion con il tipo di criterio CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). Per impostare gli aggiustamenti delle offerte per gruppo di annunci moltiplicativi in base alle dimensioni dell'itinerario di viaggio utilizzando AdGroupBidModifier, consulta Modifica le offerte con i modificatori di offerta.

Prerequisiti e requisiti di compatibilità

Per creare e gestire i criteri VERTICAL_ADS_ITEM_BID, devono essere soddisfatte le seguenti condizioni:

• Tipo di campagna: campagne sulla rete di ricerca per i viaggi (campagne sulla rete di ricerca, AdvertisingChannelType.SEARCH, con campagne AI Max per la rete di ricerca attivato tramite Campaign.ai_max_setting.enable_ai_max e un insieme di asset del feed degli hotel TRAVEL_FEED associato; sono supportati solo i feed degli hotel).
• Strategia di offerta: solo CPC manuale (BiddingStrategyType.MANUAL_CPC).
  • Non supportato nelle strategie di offerte automatiche o Smart Bidding (ad esempio Massimizza le conversioni, Massimizza il valore di conversione, CPA target o ROAS target).
• Solo criteri positivi: negative deve essere impostato su false. Le offerte per entità negative non sono supportate.
• Identificatore entità e offerta obbligatori: entity_bid.item_code e cpc_bid_micros sono obbligatori quando crei un criterio di offerta per l'entità.

Definizioni di schema e campi

• Risorsa: AdGroupCriterion (ad_group_criterion)
• Formato del nome della risorsa: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enum del tipo di criterio: CriterionType.VERTICAL_ADS_ITEM_BID
• Messaggio: EntityBid (ad_group_criterion.entity_bid)

Servizi e operazioni supportati

Esempi di codice e payload

Gli esempi seguenti mostrano come leggere, creare, aggiornare e rimuovere i criteri VERTICAL_ADS_ITEM_BID.

Leggi le offerte per entità utilizzando GAQL

Utilizza GoogleAdsService.Search o GoogleAdsService.SearchStream per eseguire query sui criteri 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'

Crea un'offerta per entità

Invia un'operazione create a AdGroupCriterionService.MutateAdGroupCriteria:

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

Aggiorna l'importo dell'offerta di un'entità esistente

Invia un'operazione update con un updateMask a AdGroupCriterionService.MutateAdGroupCriteria:

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

Rimuovi un'offerta per entità

Invia un'operazione remove a AdGroupCriterionService.MutateAdGroupCriteria:

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

Regole di convalida e gestione degli errori

Rapporti sul rendimento

Puoi utilizzare ClickType.TRAVEL_ASSETS per identificare i dati sul rendimento degli annunci pubblicati come feed viaggi negli annunci della rete di ricerca, ad esempio per recuperare i dati sul rendimento degli annunci in tutte le tue campagne:

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

Segmenti di dimensione dell'itinerario

Puoi anche segmentare i report sul rendimento per le campagne con feed di viaggi collegati in base alle dimensioni dell'itinerario:

• segments.advance_booking_window: la finestra per prenotazione anticipata per l'itinerario in giorni.
• segments.length_of_booking: la durata della prenotazione per l'itinerario in giorni.
• segments.start_date: la data di inizio della prenotazione formattata come yyyy-MM-dd.
• segments.start_day_of_week: il giorno della settimana di inizio della prenotazione.
• segments.user_set_dates: indica se sono state selezionate date specificate dall'utente (USER_SELECTED o DEFAULT_SELECTION).

Esempio di query

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