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 activées avec AI Max pour les campagnes sur le Réseau de Recherche 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'éléments d'annonces verticales.

Présentation

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

1. Options de format : activez ou désactivez des formats d'annonces spécifiques (annonces textuelles, liens de réservation et annonces de promotion de voyages) 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 :

• 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é au niveau du client ou de la campagne. Consultez Associer des flux de données verticaux au niveau de la campagne pour associer un flux au niveau de la campagne. L'association d'un flux de données verticales active les flux de voyage dans les annonces sur le Réseau de Recherche et permet d'utiliser les commandes d'annonces verticales pour la campagne.
• AI Max pour les campagnes sur le Réseau de Recherche : le paramètre "AI Max pour les campagnes sur le Réseau de Recherche" doit être activé au niveau de la campagne.

Remarque : Si vous modifiez les paramètres de contrôle du format d'une campagne sans AI Max pour les campagnes sur le Réseau de Recherche ni flux de données sectoriel actif, l'opération échoue et les codes d'erreur VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX ou VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED s'affichent. De même, l'ajout d'une règle de groupe d'articles avec une dimension non disponible pour le type de verticale échoue et renvoie VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE.

Associer des flux de données verticaux au niveau de la campagne

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 dans le 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 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 sur les flux de voyage dans les annonces sur le Réseau de Recherche.

Paramètres de format au niveau du groupe d'annonces

Vous pouvez 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 (VerticalAdsFormatSetting) de la ressource AdGroup.

Formats disponibles

• Annonces textuelles (disable_text_ads) : activées par défaut. Peut être désactivée.
• Liens de réservation (enable_booking_links) : activation requise. Compatible uniquement avec les flux verticaux HOTELS et THINGS_TO_DO.
• Annonces promotionnelles verticales (enable_vertical_promotion_ads) : activation requise.

Règles de validation

• Vous ne pouvez pas désactiver les trois formats simultanément pour un même groupe d'annonces.
• enable_booking_links ne peut être défini sur true que lorsque le flux vertical actif de la campagne est HOTELS ou THINGS_TO_DO.
• Ces paramètres ne s'appliquent qu'aux types de groupes d'annonces SEARCH_STANDARD et SEARCH_DYNAMIC_ADS.

Exemple : Mettre à jour les paramètres de format

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

// 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(
        AdGroup.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éez 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 SharedSet à votre AdGroup à l'aide d'un AdGroupCriterion (vertical_ads_item_group_rule_list).

Variables acceptées

Dans SharedCriterion (VerticalAdsItemGroupRuleInfo), vous pouvez filtrer les entités en fonction des dimensions suivantes, selon le vertical_ads_item_vertical_type de SharedSet :

• item_code : ID de fiche spécifique (compatible avec tous les types de secteurs).
• city_criterion_id, region_criterion_id, country_criterion_id : noms de ressources constantes de ciblage géographique (geoTargetConstants/{id} ; compatibles avec tous les types de secteurs verticaux, sauf FLIGHTS).
• hotel_class : note de 1 à 5 étoiles (HOTELS uniquement).
• user_rating (à partir du v24) : note arrondie de l'utilisateur pour le sol, de 1 à 5 (THINGS_TO_DO uniquement).
• venue, event_participant_display_name (à partir du v24) : filtres pour le nom à afficher du lieu et des participants à l'événement (EVENTS uniquement).

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

Cet exemple Python 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" :

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

Rapports sur les performances

Vous pouvez récupérer les métriques de performances des annonces verticales à l'aide des méthodes GoogleAdsService.SearchStream ou GoogleAdsService.Search.

Segments d'annonces verticales

• segments.vertical_ads_hotel_class : valeur entière (de 1 à 5 étoiles) spécifiant la catégorie d'un établissement hôtelier.
• segments.vertical_ads_listing : identifiant d'une fiche d'annonce verticale spécifique.
• segments.vertical_ads_listing_brand : marque associée à une fiche d'annonce verticale.
• segments.vertical_ads_listing_city : ville associée à la fiche.
• segments.vertical_ads_listing_country : pays associé à la fiche.
• segments.vertical_ads_listing_region : région associée à la fiche.
• segments.vertical_ads_partner_account : compte de partenaire dans Partner Center (par exemple, Hotel Center) qui fournit des données de flux d'inventaire.
• segments.vertical_ads_vertical : type de verticale, par exemple "hôtel" ou "voiture de location".
• segments.vertical_ads_event_participant_display_names : noms à afficher des participants à un événement, tels que les artistes, les conférenciers ou les équipes.
• segments.vertical_ads_listing_user_rating (à partir du v24) : valeur entière (de 1 à 5) indiquant la note attribuée par l'utilisateur à la fiche d'annonce verticale.
• segments.vertical_ads_listing_venue (à partir du v24) : nom du lieu pour la fiche d'annonces verticales (par exemple, une salle de concert).
• segments.vertical_ads_price_tier (à partir du v25) : catégorie de compétitivité tarifaire relative pour les fiches d'hôtels.
• segments.vertical_ads_rate_rule_id (à partir du v25) : identifiant de chaîne correspondant aux règles d'offres privées ou conditionnelles appliquées à l'enchère ou à l'impression.
• segments.vertical_ads_rate_type (à partir du v25) : catégorisation du type de tarif public, privé ou conditionnel.

Segments de dimension "Itinéraire"

À partir du v25, pour les annonces verticales associées à des flux de voyages et d'hébergements, vous pouvez segmenter les rapports sur les performances à l'aide des dimensions d'itinéraire :

• segments.advance_booking_window : fenêtre de réservation anticipée pour l'itinéraire, en jours.
• segments.length_of_booking : durée de la réservation pour l'itinéraire, en jours.
• segments.start_date : date de début de la réservation au format yyyy-MM-dd.
• segments.start_day_of_week : jour de la semaine de début de la réservation.
• segments.user_set_dates : indique si des dates spécifiées par l'utilisateur ont été sélectionnées (USER_SELECTED ou DEFAULT_SELECTION).

Métriques des annonces verticales

À partir du v25, vous pouvez récupérer les métriques suivantes sur les annonces verticales :

• metrics.vertical_ads_potential_impressions : nombre potentiel d'impressions représentant le nombre total d'impressions éligibles limitées par le plafond de vues disponibles dans le contexte de la requête.
• metrics.vertical_ads_average_booking_value_micros : taux quotidien moyen pondéré par les clics en micros, incluant les taxes et les frais, sur la durée totale du séjour.
• metrics.vertical_ads_price_difference_percentage : delta en pourcentage comparant le prix proposé par l'annonceur au prix concurrent le plus bas pour le même établissement.

Remarque : Les métriques metrics.vertical_ads_* et les segments de dimension d'itinéraire (segments.advance_booking_window, segments.length_of_booking, segments.start_date, segments.start_day_of_week et segments.user_set_dates) ne peuvent pas être sélectionnés ensemble dans la même requête GAQL.

Exemples de requêtes GAQL

Cette requête récupère les métriques de réservation et de compétitivité des annonces verticales segmentées par ville de la fiche, tranche de prix et type de tarif :

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Cette requête segmente les métriques de performances standards par dimensions de réservation d'itinéraire :

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.clicks,
  metrics.all_conversions_value
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
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING	Les trois formats d'annonce (textuelle, avec lien de réservation et promotionnelle) ont été désactivés simultanément, ou enable_booking_links a été activé pour un secteur d'activité autre que HOTELS ou THINGS_TO_DO.	Assurez-vous qu'au moins un format est activé dans VerticalAdsFormatSetting et n'activez les liens de réservation que pour les flux HOTELS ou THINGS_TO_DO.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX	La fonctionnalité AI Max pour les campagnes sur le Réseau de Recherche n'est pas activée dans la campagne.	Activez AI Max pour les campagnes sur le Réseau de Recherche dans les paramètres de la campagne.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED	La campagne ne comporte pas de flux de données verticales actif.	Assurez-vous qu'un flux vertical valide est associé au niveau du client ou de la campagne.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	Le nom de ressource SharedSet fourni dans AdGroupCriterion n'existe pas ou n'est pas de type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.	Vérifiez que le nom de ressource shared_set fait référence à un SharedSet existant de type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET	Le SharedSet référencé dans AdGroupCriterion a l'état REMOVED.	Faites référence à un SharedSet activé de type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE	La dimension de critère utilisée n'est pas acceptée pour le secteur spécifique, comme 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.