Commandes et filtrage de l'inventaire pour les annonces verticales

Les annonces verticales offrent des fonctionnalités spécialisées pour les campagnes sur le Réseau de Recherche compatibles avec AI Max et associées à un flux vertical, comme les hôtels. Vous pouvez contrôler les formats d'annonces verticales diffusés au niveau du groupe d'annonces, et les entités de flux ciblées à l'aide des règles de groupe d'articles des annonces verticales.

Présentation

Ce guide aborde deux fonctionnalités principales pour gérer les annonces verticales :

1. Commandes de format : activez ou désactivez des formats d'annonces spécifiques (annonces textuelles, liens de réservation et annonces de promotion verticale) au niveau du groupe d'annonces.
2. Gestion des éléments d'annonces verticales : filtrez et ciblez un inventaire spécifique à partir de votre flux vertical associé (anciennement appelé "voyages") à l'aide d'un système basé sur des règles impliquant SharedSet andSharedCriterion`.

Prérequis

Avant d'implémenter ces fonctionnalités, assurez-vous que votre campagne répond aux exigences suivantes :

• Type de campagne : il doit s'agir d'une campagne sur le Réseau de Recherche.
• Flux verticaux : un flux de données verticales actif doit être associé à la campagne.
• AI Max : le paramètre "AI Max" doit être activé au niveau de la campagne.

Remarque : Si vous essayez de modifier les paramètres de contrôle du format dans des campagnes sans AI Max ni flux de données sectoriel actif, des erreurs VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED se produiront. De même, si vous essayez de modifier la gestion des articles dans de telles campagnes, des erreurs VERTICAL_ADS_ITEM_GROUP_RULE_LIST_NOT_SUPPORTED s'afficheront.

Paramètres de format des groupes d'annonces

Vous pouvez désormais configurer les formats d'annonces verticales actifs pour un groupe d'annonces spécifique. Cette opération est gérée par le champ vertical_ads_format_setting de la ressource AdGroup.

Formats disponibles

• Annonces textuelles : activées par défaut. Peut être désactivé.
• Liens de réservation : activation requise.
• Annonces de promotion verticale : activation requise.

Règles de validation

• Vous ne pouvez pas désactiver les trois formats simultanément pour un même groupe d'annonces.
• Ces paramètres ne s'appliquent qu'aux types de groupes d'annonces STANDARD et SEARCH_DYNAMIC_ADS.

Exemple : Mettre à jour les paramètres de format

L'exemple suivant montre comment désactiver les annonces textuelles et activer les annonces de promotion verticale pour un groupe d'annonces existant.

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

Gestion des éléments d'annonces verticales

Pour cibler un sous-ensemble spécifique de votre inventaire de flux, comme "Hôtels à Boston" ou "Exclure les hôtels 1 étoile", vous devez utiliser des règles de groupe d'articles pour les annonces verticales.

Fonctionnement du modèle de données

Le modèle de données utilise une approche à critères partagés :

1. SharedSet : crée un SharedSet de type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion : ajoutez des règles (critères) à cet ensemble. Chaque règle spécifie une dimension (par exemple, "Ville" ou "Catégorie d'hôtel") et une valeur. Vous pouvez également créer des critères négatifs pour exclure des éléments.
3. AdGroupCriterion : associez le SharedSet à votre AdGroup à l'aide d'un AdGroupCriterion.

Variables acceptées

Dans SharedCriterion, vous pouvez filtrer les entités en fonction des dimensions suivantes :

• item_code : ID de fiche spécifique.
• city_criterion_id, region_criterion_id, country_criterion_id : constantes de ciblage géographique.
• brand_text : nom de la marque.
• hotel_class : note (de 1 à 5).
• vertical_ads_item_category : catégorie, telle que CONCERT.

Exemple de code : créer et associer des règles

Cet exemple crée une règle permettant d'inclure les éléments à "Boston" ou "San Francisco" et d'exclure les hôtels "1 étoile" et "2 étoiles".

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

Rapports

Vous pouvez récupérer les métriques de performances des annonces verticales à l'aide des méthodes GoogleAdsService.SearchStream ou GoogleAdsService.Search. Pour l'API Google Ads, la version 23 ajoute des segments spécifiques pour des rapports plus précis.

Nouveaux segments

• segments.vertical_ads_listing_city : ville associée à la fiche.
• segments.vertical_ads_vertical_type : type de secteur vertical, tel qu'un hôtel ou une voiture de location.

Exemple de requête 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

Gestion des exceptions

Voici quelques erreurs courantes que vous pouvez rencontrer lorsque vous configurez des annonces verticales.

Code d'erreur	Cause	Action recommandée
INVALID_VERTICAL_ADS_FORMAT_SETTING	Les trois formats d'annonces (textuelles, avec lien de réservation et de promotion) ont été désactivés simultanément.	Assurez-vous qu'au moins un format est activé (défini sur "true") dans VerticalAdsFormatSetting.
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...	La fonctionnalité AI Max n'est pas activée dans la campagne ou celle-ci ne dispose pas d'un flux vertical actif.	Activez AI Max dans les paramètres de la campagne et assurez-vous qu'un flux vertical valide est associé.
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	Le nom de ressource SharedSet fourni dans AdGroupCriterion n'existe pas.	Vérifiez que le nom de ressource shared_set correspond à un ensemble créé.
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...	Le type de critère utilisé n'est pas compatible avec le secteur spécifique (par exemple, la catégorie d'hôtel pour les locations de voiture).	Vérifiez que la dimension vertical_ads_item_group_rule correspond à votre type de secteur.