Controlli e filtri dell'inventario per gli annunci verticali

Gli annunci verticali forniscono funzionalità specializzate per le campagne sulla rete di ricerca attivate per campagne AI Max per la rete di ricerca collegate a un feed verticale, ad esempio gli hotel. Puoi controllare quali formati degli annunci verticali vengono pubblicati a livello di gruppo di annunci e quali entità del feed vengono scelte come target utilizzando le regole del gruppo di articoli degli annunci verticali.

Panoramica

Questa guida illustra due funzionalità principali per la gestione degli annunci verticali:

  1. Controlli dei formati:attiva o disattiva formati degli annunci specifici (annunci di testo, link di prenotazione e annunci per la promozione di verticali) a livello di gruppo di annunci.
  2. Gestione degli elementi degli annunci verticali:filtra e scegli come target un inventario specifico dal tuo feed verticale (precedentemente chiamato feed di viaggio) collegato utilizzando un sistema basato su regole che prevede SharedSet e SharedCriterion.

Prerequisiti

Prima di implementare queste funzionalità, assicurati che la tua campagna soddisfi i seguenti requisiti:

  • Tipo di campagna:deve essere una campagna sulla rete di ricerca.
  • Feed verticale:un feed di dati verticale attivo deve essere collegato a livello di cliente o di campagna. Consulta Collega i feed di dati verticali a livello di campagna per collegare un feed a livello di campagna. Il collegamento di un feed di dati verticali attiva i feed viaggi negli annunci della rete di ricerca (TFSA) e i controlli degli annunci verticali per la campagna.
  • AI Max per le campagne sulla rete di ricerca:l'impostazione AI Max per le campagne sulla rete di ricerca deve essere attivata nella campagna.

Per attivare i feed viaggi negli annunci della rete di ricerca (TFSA) e i controlli degli annunci verticali all'interno della campagna, puoi collegare l'insieme di asset del feed di dati verticali a livello di campagna seguendo questi passaggi. In alternativa, per attivare queste funzionalità per tutte le campagne del tuo account, puoi collegare il feed a livello di cliente seguendo le istruzioni per il collegamento a livello di cliente riportate nella guida ai feed viaggi negli annunci della rete di ricerca.

  1. Crea un oggetto CampaignAssetSet, impostando asset_set sul nome della risorsa dell'insieme di asset del feed verticale e campaign sul nome della risorsa della campagna.
  2. Crea un CampaignAssetSetOperation con create impostato su CampaignAssetSet.
  3. Invia l'operazione utilizzando CampaignAssetSetService.MutateCampaignAssetSets.

Per maggiori dettagli sulla gestione dei feed viaggi su larga scala, consulta la documentazione relativa ai feed viaggi negli annunci della rete di ricerca.

Controlli dei formati degli annunci a livello di gruppo di annunci

Puoi configurare i formati degli annunci verticali attivi per un gruppo di annunci specifico. Questo viene gestito tramite il campo vertical_ads_format_setting (VerticalAdsFormatSetting) nella risorsa AdGroup.

Formati disponibili

  • Annunci di testo (disable_text_ads): attivati per impostazione predefinita. Può essere disattivata.
  • Link di prenotazione (enable_booking_links): attivazione obbligatoria. Supportato solo per i feed verticali HOTELS e THINGS_TO_DO.
  • Annunci per la promozione di verticali (enable_vertical_promotion_ads): attivazione obbligatoria.

Regole di convalida

  • Non puoi disattivare tutti e tre i formati contemporaneamente per un singolo gruppo di annunci.
  • enable_booking_links può essere impostato su true solo quando il feed verticale attivo della campagna è HOTELS o THINGS_TO_DO.
  • Queste impostazioni si applicano solo ai tipi di gruppi di annunci SEARCH_STANDARD e SEARCH_DYNAMIC_ADS.

Esempio: aggiorna le impostazioni del formato

Il seguente esempio di Java mostra come disattivare gli annunci di testo e attivare gli annunci di promozione verticale per un gruppo di annunci esistente:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

Gestione degli elementi degli annunci verticali

Per scegliere come target un sottoinsieme specifico dell'inventario del feed, ad esempio "Hotel a Boston" o "Escludi hotel a 1 stella", devi utilizzare le regole del gruppo di articoli degli annunci verticali.

Come funziona il modello di dati

Il modello di dati utilizza un approccio basato su criteri condivisi:

  1. SharedSet: crea un SharedSet con tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: aggiungi regole (criteri) a questo set. Ogni regola specifica una dimensione, ad esempio Città o Classe hotel, e un valore. Puoi anche creare criteri di esclusione per escludere elementi.
  3. AdGroupCriterion: collega SharedSet a AdGroup utilizzando un AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensioni supportate

Puoi filtrare le entità in base alle seguenti dimensioni in SharedCriterion (VerticalAdsItemGroupRuleInfo), a seconda della vertical_ads_item_vertical_type di SharedSet:

  • item_code: ID scheda specifico (supportato per tutti i tipi di verticali).
  • city_criterion_id, region_criterion_id, country_criterion_id: nomi delle risorse Geo Target Constant (geoTargetConstants/{id}; supportati per tutti i tipi di verticali, ad eccezione di FLIGHTS).
  • hotel_class: valutazione a stelle da 1 a 5 (solo HOTELS).
  • user_rating (a partire da v24): valutazione degli utenti arrotondata per difetto da 1 a 5 (solo THINGS_TO_DO).
  • venue, event_participant_display_name (a partire da v24): filtri per il luogo dell'evento e il nome visualizzato dei partecipanti (solo EVENTS).

Questo esempio di Python crea una regola per includere gli elementi in "Boston" o "San Francisco" ed escludere gli hotel "a 1 stella" e "a 2 stelle":

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

Offerta manuale basata su CPC per entità

A partire dal mese di v25, per le campagne sulla rete di ricerca per i viaggi (campagne sulla rete di ricerca con campagne AI Max per la rete di ricerca attivate e un feed di hotel collegato) che utilizzano la strategia di offerta offerta manuale basata su CPC (BiddingStrategyType.MANUAL_CPC), puoi impostare override delle offerte basate su CPC manuale (cpc_bid_micros) per singoli elementi del feed di hotel utilizzando il criterio EntityBid (ad_group_criterion.entity_bid) con CriterionType.VERTICAL_ADS_ITEM_BID e entity_bid.item_code.

I criteri negativi (negative = true), le campagne non sulla rete di ricerca e le strategie di offerta automatica o Smart Bidding non sono supportati per VERTICAL_ADS_ITEM_BID e restituiscono ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Le metriche sul rendimento non vengono compilate in base ai criteri VERTICAL_ADS_ITEM_BID. Per informazioni dettagliate sullo schema, sulle query GAQL e sugli esempi di payload di modifica, consulta Offerta manuale basata su CPC per entità nella guida ai feed viaggi negli annunci della rete di ricerca. Per impostare aggiustamenti delle offerte per gruppi di annunci moltiplicativi per le dimensioni degli itinerari di viaggio per gli annunci per hotel utilizzando AdGroupBidModifier, consulta Modifica le offerte con i modificatori di offerta.

Rapporti sul rendimento

Puoi recuperare le metriche sul rendimento degli annunci verticali utilizzando i metodi GoogleAdsService.SearchStream o GoogleAdsService.Search.

Segmenti di annunci verticali

Segmenti di dimensione dell'itinerario

A partire dal v25, per gli annunci verticali collegati ai feed di viaggi e alloggi, puoi segmentare i report sul rendimento utilizzando le dimensioni dell'itinerario:

Metriche degli annunci verticali

A partire dalla versione v25, puoi recuperare le seguenti metriche degli annunci verticali:

Query GAQL di esempio

Questa query recupera le metriche di competitività e prenotazione degli annunci verticali segmentate per città della scheda, fascia di prezzo e tipo di tariffa:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Questa query segmenta le metriche sul rendimento standard in base alle dimensioni di prenotazione dell'itinerario:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Gestione degli errori

Di seguito sono riportati gli errori comuni che potresti riscontrare durante la configurazione degli annunci verticali:

Codice di errore Causa Azione consigliata
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING Tutti e tre i formati degli annunci (testo, link di prenotazione, annunci di promozione) sono stati disattivati contemporaneamente oppure enable_booking_links è stato attivato per un verticale diverso da HOTELS o THINGS_TO_DO. Assicurati che sia attivato almeno un formato in VerticalAdsFormatSetting e attiva i link di prenotazione solo per i feed HOTELS o THINGS_TO_DO.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX La campagna non ha attivato campagne AI Max per la rete di ricerca. Attiva campagne AI Max per la rete di ricerca nelle impostazioni della campagna.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED La campagna non dispone di un feed di dati verticali attivo. Assicurati che un feed verticale valido sia collegato a livello di cliente o di campagna.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Il nome della risorsa SharedSet fornito in AdGroupCriterion non esiste o non è di tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST. Verifica che il nome della risorsa shared_set faccia riferimento a un SharedSet esistente di tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET La SharedSet a cui si fa riferimento in AdGroupCriterion ha lo stato REMOVED. Fai riferimento a un SharedSet abilitato di tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE La dimensione del criterio utilizzata non è supportata per il verticale specifico, ad esempio la classe dell'hotel per i noleggi auto. Verifica che la dimensione vertical_ads_item_group_rule corrisponda al tuo tipo di verticale.