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 attivate collegate a un feed verticale, ad esempio gli hotel. Puoi controllare quali formati di annunci verticali vengono pubblicati a livello di gruppo di annunci e quali entità del feed vengono scelte come target 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 dei formati: attiva o disattiva formati di annunci specifici (annunci di testo, link di prenotazione e annunci di promozione per il verticale) a livello di gruppo di annunci.
  2. Gestione degli elementi degli annunci verticali: filtra e scegli come target inventari specifici 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:

Per attivare i feed viaggi negli annunci della rete di ricerca (TFSA) e abilitare i controlli degli annunci verticali nella campagna, puoi collegare l'insieme di asset del feed di dati verticali a livello di campagna seguendo i passaggi riportati di seguito. 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 risorsa dell'insieme di asset del feed verticale e campaign sul nome risorsa della campagna.
  2. Crea un CampaignAssetSetOperation con create impostato su CampaignAssetSet.
  3. Invia l'operazione utilizzando CampaignAssetSetService.MutateCampaignAssetSets.

Per ulteriori 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 dei gruppi di annunci

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

Formati disponibili

  • Annunci di testo: attivati per impostazione predefinita. Possono essere disattivati.
  • Link di prenotazione: è necessario attivare la funzionalità.
  • Annunci di promozione per il verticale: è necessario attivare la funzionalità.

Regole di convalida

  • Non puoi disattivare tutti e tre i formati contemporaneamente per un singolo gruppo di annunci.
  • Queste impostazioni si applicano solo ai tipi di gruppi di annunci STANDARD e SEARCH_DYNAMIC_ADS.

Esempio: aggiornare le impostazioni dei formati

L'esempio seguente mostra come disattivare gli annunci di testo e attivare gli annunci di promozione per il verticale per un gruppo di annunci esistente.

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .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 di feed, ad esempio "Hotel a Boston" o "Escludi hotel a 1 stella", devi utilizzare le regole dei 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 il tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: aggiungi regole (criteri) a questo insieme. Ogni regola specifica una dimensione, ad esempio la città o la categoria dell'hotel, e un valore. Puoi anche creare criteri negativi per escludere gli elementi.
  3. AdGroupCriterion: collega SharedSet a AdGroup utilizzando un AdGroupCriterion.

Dimensioni supportate

Puoi filtrare le entità in base alle seguenti dimensioni in SharedCriterion:

  • item_code: ID scheda specifico.
  • city_criterion_id, region_criterion_id, country_criterion_id: costanti di targeting geografico.
  • brand_text: nome del brand.
  • hotel_class: valutazione a stelle (da 1 a 5).

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

Python

# 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
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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

Puoi recuperare le metriche sul rendimento per gli annunci verticali utilizzando i GoogleAdsService.SearchStream o GoogleAdsService.Search metodi. Per l'API Google Ads, la v23 aggiunge segmenti specifici per i report granulari.

Nuovi segmenti

  • segments.vertical_ads_listing_city: la città associata alla scheda.
  • segments.vertical_ads_vertical_type: il tipo di verticale, ad esempio hotel o auto a noleggio.

Esempio di query GAQL

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
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
INVALID_VERTICAL_ADS_FORMAT_SETTING Tutti e tre i formati degli annunci (testo, link di prenotazione, annunci di promozione) sono stati disattivati contemporaneamente. Assicurati che almeno un formato sia attivato (impostato su true) in VerticalAdsFormatSetting.
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_... La campagna non ha AI Max attivato o non ha un feed verticale attivo. Attiva AI Max nelle impostazioni della campagna e assicurati che sia collegato un feed verticale valido.
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Il nome risorsa SharedSet fornito in AdGroupCriterion non esiste. Verifica che il nome risorsa shared_set corrisponda a un insieme creato.
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED... Il tipo di criterio utilizzato non è supportato per il verticale specifico, ad esempio la categoria dell'hotel per i noleggi auto. Verifica che la dimensione vertical_ads_item_group_rule corrisponda al tipo di verticale.