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.

Collegare i feed di dati verticali a livello di 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).

Esempio di codice: creare e collegare regole

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

• segments.vertical_ads_hotel_class: valore intero (da 1 a 5 stelle) che specifica la valutazione della categoria per una scheda di hotel.
• segments.vertical_ads_listing: identificatore per una scheda di annunci verticali specifica.
• segments.vertical_ads_listing_brand: brand associato a una scheda di annunci verticali.
• segments.vertical_ads_listing_city: la città associata alla scheda.
• segments.vertical_ads_listing_country: il paese associato alla scheda.
• segments.vertical_ads_listing_region: la regione associata alla scheda.
• segments.vertical_ads_partner_account: l'account partner all'interno di un Centro partner (ad esempio Hotel Center) che fornisce i dati del feed di inventario.
• segments.vertical_ads_vertical: il tipo verticale, ad esempio hotel o auto a noleggio.
• segments.vertical_ads_event_participant_display_names: i nomi visualizzati dei partecipanti a una scheda di eventi, ad esempio artisti, relatori o team.
• segments.vertical_ads_listing_user_rating (a partire dalla v24): valore intero (da 1 a 5) che specifica la valutazione degli utenti della scheda di annunci verticali.
• segments.vertical_ads_listing_venue (a partire dalla v24): il nome della sede per la scheda di annunci verticali (ad esempio, una sede di concerti).
• segments.vertical_ads_price_tier (a partire dalla v25): bucket di competitività dei prezzi relativi per le schede di hotel.
• segments.vertical_ads_rate_rule_id (a partire dalla v25): identificatore stringa corrispondente alle regole tariffarie private o condizionali applicate all'offerta o all'impressione.
• segments.vertical_ads_rate_type (a partire dalla v25): classificazione del tipo di tariffa pubblica, privata o condizionale.

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:

• segments.advance_booking_window: la finestra di 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 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 le date specificate dall'utente (USER_SELECTED o DEFAULT_SELECTION).

Metriche degli annunci verticali

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

• metrics.vertical_ads_potential_impressions: impressioni potenziali che rappresentano il totale delle impressioni idonee con limite di visualizzazione disponibili nel contesto della query.
• metrics.vertical_ads_average_booking_value_micros: tariffa giornaliera media ponderata per i clic in micro, incluse tasse e commissioni, per la durata totale del soggiorno.
• metrics.vertical_ads_price_difference_percentage: delta percentuale che confronta il prezzo offerto dall'inserzionista con il prezzo competitivo più basso per la stessa struttura.

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: