Controlli e filtri dell'inventario per gli annunci verticali

Gli annunci verticali forniscono funzionalità specializzate per le campagne sulla rete di ricerca abilitate 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 puoi controllare quali entità feed vengono prese di mira utilizzando le regole dei gruppi di elementi degli annunci verticali.

Panoramica

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

1. Controlli del formato:attiva o disattiva formati dell'annuncio specifici (annunci di testo, link di prenotazione e annunci per la 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 collegato (precedentemente chiamato viaggi) 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 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 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 nel tuo account, puoi collegare il feed a livello di cliente seguendo le istruzioni per il collegamento a livello di cliente 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 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 del formato del 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 disattivato.
• Link di prenotazione (enable_booking_links): È richiesta l'attivazione. Supportato solo per i feed verticali HOTELS e THINGS_TO_DO.
• Annunci per la promozione verticale (enable_vertical_promotion_ads): attivazione obbligatoria.

Regole di convalida

• Non puoi disattivare contemporaneamente tutti e tre i formati per un singolo gruppo di annunci.
• enable_booking_links può essere impostato solo su true 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: aggiornare le impostazioni del formato

Il seguente esempio 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 insieme. Ogni regola specifica una dimensione, ad esempio Città o Categoria hotel, e un valore. Puoi anche creare criteri negativi per escludere elementi.
3. AdGroupCriterion: collega SharedSet al tuo 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 del SharedSet's vertical_ads_item_vertical_type:

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

Esempio di codice: crea e collega regole

Questo esempio di Python crea una regola per includere gli elementi 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 dal giorno v25, per le campagne sulla rete di ricerca per i viaggi (campagne sulla rete di ricerca con AI Max per le campagne sulla rete di ricerca abilitato e un feed hotel collegato) che utilizzano la strategia di offerta CPC manuale (BiddingStrategyType.MANUAL_CPC), puoi impostare override dell'offerta CPC manuale (cpc_bid_micros) per 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 Smart Bidding o automatiche 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, query GAQL ed esempi di payload di mutazione, consulta Offerta manuale basata su CPC per entità nella guida ai feed viaggi negli annunci della rete di ricerca.

Rapporti sul rendimento

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

Segmenti degli annunci verticali

• segments.vertical_ads_hotel_class: valore intero (da 1 a 5 stelle) che specifica la classificazione per categoria di una scheda hotel.
• segments.vertical_ads_listing: identificatore di una scheda di annunci verticali specifica.
• segments.vertical_ads_listing_brand: brand associato a una scheda di annunci verticale.
• 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 Partner Center (ad esempio Hotel Center) che fornisce i dati del feed di inventario.
• segments.vertical_ads_vertical: il tipo di verticale, ad esempio hotel o auto a noleggio.
• segments.vertical_ads_event_participant_display_names: I nomi visualizzati dei partecipanti a una scheda evento, ad esempio artisti, oratori o team.
• segments.vertical_ads_listing_user_rating (a partire dal giorno 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 dal giorno v24): il nome della sede dell'elenco di annunci verticali (ad esempio, una sede di concerti).
• segments.vertical_ads_price_tier (a partire da v25): bucket di competitività relativa del prezzo per le schede di hotel.
• segments.vertical_ads_rate_rule_id (a partire dal v25): identificatore stringa corrispondente alle regole tariffarie private o condizionali applicate all'offerta o all'impressione.
• segments.vertical_ads_rate_type (a partire da v25): classificazione del tipo di tariffa pubblica, privata o condizionale.

Segmenti di dimensione itinerario

A partire dal giorno 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 per prenotazione anticipata dell'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).

Metriche degli annunci verticali

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

• metrics.vertical_ads_potential_impressions: Impressioni potenziali che rappresentano le impressioni idonee totali con limite di visualizzazione disponibili nel contesto della query.
• metrics.vertical_ads_average_booking_value_micros: Tariffa giornaliera media ponderata in base ai clic in micro, incluse tasse e commissioni, per l'intera durata del soggiorno.
• metrics.vertical_ads_price_difference_percentage: Delta percentuale che confronta il prezzo offerto dall'inserzionista con il prezzo concorrente più basso per la stessa proprietà.

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 standard sul rendimento in base alle dimensioni della 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 alcuni errori comuni che potresti riscontrare durante la configurazione degli annunci verticali: