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 tratti dai tuoi feed. Questa funzionalità è nota come feed viaggi negli annunci della rete di ricerca.

Come interagiscono le impostazioni del cliente e della campagna

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

• Eredita i feed del cliente (impostazione predefinita): mantieni collegato 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 CustomerAssetSet a livello di cliente e non collegare un CampaignAssetSet a livello di campagna.
• Disattivazione di una campagna specifica: aggiungi TRAVEL_FEED a Campaign.excluded_parent_asset_set_types e rimuovi eventuali associazioni CampaignAssetSet a livello di campagna.
• Attivazione solo di una campagna specifica: rimuovi l'associazione CustomerAssetSet a livello di cliente, quindi crea un link CampaignAssetSet a livello di campagna per quella campagna.
• Utilizza feed specifici della campagna mentre le altre campagne continuano a ereditare: aggiungi TRAVEL_FEED a Campaign.excluded_parent_asset_set_types della campagna e crea un link CampaignAssetSet a livello di campagna.

Disattivare 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 viaggi negli annunci della rete di ricerca a livello di cliente e campagna.

Disattivazione a livello di cliente

Per disattivare i feed viaggi negli annunci della rete di ricerca a livello di cliente:

1. Recupera sia customer_asset_set.resource_name sia asset_set.resource_name per tutti i CustomerAssetSet link il cui tipo è TRAVEL_FEED utilizzando il customer_asset_set report:

   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 riattivare questa funzionalità a livello di cliente:

1. Per ogni AssetSet sottostante (asset_set.resource_name) 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 di cliente:

1. Recupera excluded_parent_asset_set_types utilizzando il campaign report:

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

2. Crea un nuovo Campaign oggetto 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 eventuali associazioni di feed per i viaggi a livello di campagna:

1. Per la campagna che vuoi disattivare, recupera sia campaign_asset_set.resource_name sia 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 su campaign_asset_set.resource_name recuperato nel passaggio precedente.

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

Se vuoi riattivare questa funzionalità a livello di campagna:

1. Per ogni AssetSet sottostante (asset_set.resource_name) che vuoi attivare, crea un nuovo CampaignAssetSet con asset_set impostato su asset_set.resource_name e campaign impostato sul nome della risorsa della 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.

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

Per fare in modo che lo stato di attivazione di una campagna erediti di nuovo l'impostazione a livello di cliente:

1. Crea un nuovo Campaign oggetto con excluded_parent_asset_set_types senza TRAVEL_FEED nell'elenco e resource_name impostato su 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 le sostituzioni dell'offerta manuale basata 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).

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 AI Max per le campagne sulla rete di ricerca attivato Campaign.ai_max_setting.enable_ai_max e un feed per hotel associato [TRAVEL_FEED insieme di asset]; sono supportati solo i feed per hotel).
• Strategia di offerta: CPC manuale (BiddingStrategyType.MANUAL_CPC) solo.
  • Non è supportata nelle strategie di offerta 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.
• ID entità e offerta obbligatori: entity_bid.item_code e cpc_bid_micros sono obbligatori quando crei un criterio di offerta per entità.

Schema e definizioni dei campi

• Risorsa: AdGroupCriterion (ad_group_criterion)
• Formato del nome della risorsa: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enumerazione 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 riportati di seguito mostrano come leggere, creare, aggiornare e rimuovere i criteri VERTICAL_ADS_ITEM_BID.

Leggere le offerte per entità utilizzando GAQL

Utilizza GoogleAdsService.Search o GoogleAdsService.SearchStream per eseguire una query sui VERTICAL_ADS_ITEM_BID criteri:

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'

Creare 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"
        }
      }
    }
  ]
}

Aggiornare l'importo di un'offerta per 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"
      }
    }
  ]
}

Rimuovere 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

Report 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 recuperando i dati sul rendimento degli annunci in tutte le campagne:

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

Segmenti della dimensione itinerario

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

• segments.advance_booking_window: la finestra per prenotazione anticipata dell'itinerario in giorni.
• segments.length_of_booking: la durata della prenotazione dell'itinerario in giorni.
• segments.start_date: La data di inizio della prenotazione nel formato 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