Partecipa con noi in diretta su Discord sul server della community Google Advertising and Measurement e su YouTube il 29 gennaio alle 16:00 CET. Parleremo delle nuove funzionalità aggiunte nella versione 23 dell'API Google Ads.

Controlli e filtri dell'inventario per gli annunci verticali

Gli annunci verticali forniscono funzionalità specializzate per le campagne sulla rete di ricerca abilitate all'AI Max 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 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:

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.
Gestione degli elementi degli annunci verticali:filtra e scegli come target un inventario specifico del tuo feed verticale (precedentemente chiamato viaggi) utilizzando un sistema basato su regole che coinvolge SharedSet andSharedCriterion`.

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 alla campagna.
AI Max:l'impostazione "AI Max" deve essere attivata nella campagna.

Controlli del formato del gruppo di annunci

Ora 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 della risorsa AdGroup.

Formati disponibili

Annunci di testo:attivati per impostazione predefinita. Può essere disattivata.
Link di prenotazione:è richiesta l'attivazione.
Annunci di promozione verticale:è richiesta l'attivazione.

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 di formattazione

Il seguente esempio mostra come disattivare gli annunci di testo e attivare gli annunci di promozione 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 dei feed, ad esempio "Hotel a Boston" o "Escludi hotel a 1 stella", devi utilizzare le regole del gruppo di elementi degli annunci verticali.

Come funziona il modello di dati

Il modello di dati utilizza un approccio basato su criteri condivisi:

SharedSet: crea un SharedSet di tipo VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
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.
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 geotargeting.
brand_text: Nome del brand.
hotel_class: valutazione a stelle (da 1 a 5).
vertical_ads_item_category: Categoria, ad esempio CONCERT.

Esempio di codice: creare e collegare regole

Questo esempio crea una regola per includere gli elementi in "Boston" o "San Francisco" ed escludere gli hotel "1 stella" e "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_LISTshared_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 metodi GoogleAdsService.SearchStream o GoogleAdsService.Search. Per l'API Google Ads, la versione 23 aggiunge segmenti specifici per 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.

Query GAQL di esempio

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 alcuni errori comuni che potresti riscontrare durante la configurazione degli annunci verticali.

Codice di errore	Causa	Azione consigliata
`INVALID_VERTICAL_ADS_FORMAT_SETTING`	Tutti e tre i formati degli annunci (testo, link di prenotazione e promozione) sono stati disattivati contemporaneamente.	Assicurati che almeno un formato sia abilitato (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 della risorsa SharedSet fornito in AdGroupCriterion non esiste.	Verifica che il nome della risorsa shared_set corrisponda a un set creato.
`VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...`	Il tipo di criterio utilizzato non è supportato per il verticale specifico, ad esempio la classificazione degli hotel per i noleggi auto.	Verifica che la dimensione `vertical_ads_item_group_rule` corrisponda al tipo di verticale.