Controlli e filtri dell'inventario per gli annunci verticali

Gli annunci verticali forniscono funzionalità specializzate per le campagne sulla rete di ricerca abilitate ad AI Max per campagne sulla 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 scelte come target utilizzando le regole dei gruppi di elementi degli annunci verticali.

Panoramica

Questa guida tratta 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 del 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. Questa operazione viene gestita 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): attivazione obbligatoria.
• 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.
• 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(
        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 del tuo inventario del feed, ad esempio "Hotel a Boston" o "Escludi hotel a 1 stella", devi utilizzare le regole per i gruppi di elementi 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):

• item_code: ID scheda specifico.
• city_criterion_id, region_criterion_id, country_criterion_id: Nomi delle risorse costanti di targeting geografico (geoTargetConstants/{id}).
• hotel_class: valutazione a stelle (da 1 a 5).
• user_rating, venue, event_participant_display_name (a partire da v24): filtri per valutazione di eventi e schede verticali, sede e nome dei partecipanti.

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...

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 di un 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 (a partire dal giorno v24): i nomi visualizzati dei partecipanti a un elenco di eventi, ad esempio artisti, oratori o squadre.
• 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 della scheda di annunci verticali (ad esempio, una sede di concerti).
• segments.vertical_ads_price_tier (a partire dal giorno 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 dal giorno 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

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.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
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: