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 de règles de groupe d'articles pour les 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 et SharedCriterion.

Prérequis

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

Pour activer les flux de voyage dans les annonces sur le Réseau de Recherche et les contrôles des annonces verticales dans votre campagne, vous pouvez associer votre ensemble de composants de flux de données verticales au niveau de la campagne en suivant les étapes ci-dessous. Vous pouvez également activer ces fonctionnalités pour toutes les campagnes de votre compte en associant le flux au niveau client. Pour ce faire, suivez les instructions d'association au niveau client du guide sur les flux de voyage dans les annonces sur le Réseau de Recherche.

  1. Créez un objet CampaignAssetSet, en définissant asset_set sur le nom de ressource de votre ensemble de composants de flux verticaux et campaign sur le nom de ressource de votre campagne.
  2. Créez un CampaignAssetSetOperation avec create défini sur CampaignAssetSet.
  3. Envoyez l'opération à l'aide de CampaignAssetSetService.MutateCampaignAssetSets.

Pour en savoir plus sur la gestion des flux de voyage à grande échelle, consultez la documentation Flux de voyage dans les annonces sur le Réseau de Recherche.

Paramètres de format au niveau du groupe 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 : l'activation est 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...

Gérer les é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 basée sur des 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).

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

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 campagne n'a pas activé AI Max ou 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.