Controlli e filtri dell'inventario per gli annunci verticali

Gli annunci verticali forniscono funzionalità specializzate per le campagne sulla rete di ricerca con AI Max per campagne sulla rete di ricerca attivate e collegate a un feed verticale, ad esempio gli hotel. Puoi controllare quali formati dell'annuncio verticali vengono pubblicati a livello di gruppo di annunci e quali entità del feed sono prese di mira utilizzando le regole dei gruppi di articoli degli annunci verticali.

Panoramica

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

  1. Controlli del formato: attiva o disattiva formati di annunci specifici (annunci di testo, link di prenotazione e annunci di promozione verticale) a livello di gruppo di annunci.
  2. Gestione degli elementi degli annunci verticali: filtra e scegli come target un inventario specifico dal feed verticale (in precedenza chiamato feed viaggi) collegato utilizzando un sistema basato su regole che coinvolge SharedSet e SharedCriterion.

Prerequisiti

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

  • Tipo di campagna: deve essere una campagna sulla rete di ricerca.
  • Feed verticale: un feed di dati verticali attivo deve essere collegato a livello di cliente o campagna. Consulta Collegare 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 abilita i controlli degli annunci verticali per la campagna.
  • AI Max per campagne sulla rete di ricerca: l'impostazione AI Max per campagne sulla rete di ricerca deve essere attivata nella campagna.

Per attivare i feed viaggi negli annunci della rete di ricerca (TFSA) e abilitare i controlli degli annunci verticali nella campagna, puoi collegare il set di asset del feed di dati verticali a livello di campagna seguendo questi passaggi. In alternativa, per abilitare queste funzionalità per tutte le campagne nel tuo account, puoi collegare il feed a livello di cliente seguendo le istruzioni di collegamento a livello di cliente nella guida 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 Feed viaggi negli annunci della rete di ricerca.

Controlli del formato del gruppo di annunci

Puoi configurare quali formati di annunci verticali sono attivi per un gruppo di annunci specifico. Questa operazione viene gestita tramite il vertical_ads_format_setting (VerticalAdsFormatSetting) campo nella AdGroup risorsa.

Formati disponibili

  • Annunci di testo (disable_text_ads): abilitati per impostazione predefinita. Possono essere disattivati.
  • Link di prenotazione (enable_booking_links): attivazione obbligatoria. Supportati solo per i feed verticali HOTELS e THINGS_TO_DO.
  • Annunci di promozione verticale (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 se 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: aggiornare le impostazioni del formato

Il seguente esempio in 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 dei gruppi 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 il tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: aggiungi regole (criteri) a questo set. Ogni regola specifica una dimensione, ad esempio Città o Categoria hotel, e un valore. Puoi anche creare criteri negativi per escludere gli articoli.
  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 di SharedSet's vertical_ads_item_vertical_type:

  • item_code: ID scheda specifico (supportato per tutti i tipi verticali).
  • city_criterion_id, region_criterion_id, country_criterion_id: nomi delle risorse costanti di targeting geografico (geoTargetConstants/{id}; supportati per tutti i tipi verticali tranne FLIGHTS).
  • hotel_class: valutazione a stelle da 1 a 5 (solo HOTELS).
  • user_rating (a partire dalla v24): valutazione degli utenti arrotondata per difetto da 1 a 5 (solo THINGS_TO_DO).
  • venue, event_participant_display_name (a partire dalla v24): filtri per sede dell'evento e nome visualizzato del partecipante (EVENTS only).

Questo esempio in Python crea una regola per includere gli articoli in "Boston" o "San Francisco" ed escludere gli hotel "1 stella" e "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 da v25, per le campagne sulla rete di ricerca per i viaggi (campagne AI Max per la rete di ricerca attivata e un feed hotel collegato) che utilizzano la strategia di offerta manuale basata su CPC (BiddingStrategyType.MANUAL_CPC), puoi impostare gli override dell'offerta manuale basata su CPC (cpc_bid_micros) per i singoli elementi del feed 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 inserite nei criteri VERTICAL_ADS_ITEM_BID. Per i dettagli completi dello schema, le query GAQL e gli esempi di payload di mutazione, consulta Offerta manuale basata su CPC per entità nella guida Feed viaggi negli annunci della rete di ricerca.

Rapporti sul rendimento

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

Segmenti degli annunci verticali

Segmenti delle dimensioni dell'itinerario

A partire dalla 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 v25, puoi recuperare le seguenti metriche degli annunci verticali:

Query GAQL di esempio

Questa query recupera le metriche competitive e di prenotazione degli annunci verticali segmentate per città della scheda, livello 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 Comportamento consigliato
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 almeno un formato sia attivato 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 campagne AI Max per la rete di ricerca attivata. 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 ha un feed di dati verticali attivo. Assicurati che un feed verticale valido sia collegato a livello di cliente o campagna livello.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Il nome della risorsa SharedSet fornito in AdGroupCriterion non esiste o non ha il 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 Il SharedSet a cui fa riferimento il AdGroupCriterion ha lo stato REMOVED. Fai riferimento a un SharedSet attivato 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 categoria hotel per i noleggi auto. Verifica che la dimensione vertical_ads_item_group_rule corrisponda al tipo verticale.