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 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, ainsi que les entités de flux ciblées à l'aide des règles de groupe d'articles des annonces verticales.

Présentation

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

1. Contrôles des formats : activez ou désactivez des formats d'annonces spécifiques (annonces textuelles, liens de réservation et annonces de promotion verticales) 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é "flux de voyage") à l'aide d'un système basé sur des règles qui implique 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 : doit être une campagne sur le Réseau de Recherche.
• Flux vertical : un flux de données vertical actif doit être associé au niveau du client ou de la campagne. Pour associer un flux au niveau de la campagne, consultez Associer des flux de données verticaux au niveau de la campagne. Associer un flux de données sectoriel active les flux de voyage dans les annonces sur le Réseau de Recherche et les commandes d'annonces sectorielles 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é dans la campagne.

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 (TFSA) et les commandes d'annonces verticales dans votre campagne, vous pouvez associer votre ensemble de composants de flux de données vertical 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 du client. Pour ce faire, suivez les instructions d'association au niveau du 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 vertical 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 verticaux actifs pour un groupe d'annonces spécifique. Cette opération est gérée via 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. Disponible uniquement pour les flux verticaux HOTELS et THINGS_TO_DO.
• Annonces de promotion pour un secteur (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 : Modifier 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...

Gestion des éléments d'annonces verticales

Pour cibler un sous-ensemble spécifique de l'inventaire de votre flux, comme "Hôtels à Boston" ou "Exclure les hôtels une é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, comme "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 l'SharedSet à votre AdGroup à l'aide d'un AdGroupCriterion (vertical_ads_item_group_rule_list).

Variables acceptées

Vous pouvez filtrer les entités en fonction des dimensions suivantes dans SharedCriterion (VerticalAdsItemGroupRuleInfo), 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 de constante de ciblage géographique (geoTargetConstants/{id} ; compatible avec tous les types de secteurs d'activité, sauf FLIGHTS).
• hotel_class : note de 1 à 5 étoiles (HOTELS uniquement).
• user_rating (à partir de v24) : note des visiteurs arrondie à l'entier inférieur, de 1 à 5 (THINGS_TO_DO uniquement).
• venue, event_participant_display_name (à partir de v24) : filtres pour le lieu de l'événement et le nom à afficher des participants (EVENTS uniquement).

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

Cet exemple Python crée une règle pour inclure les éléments situés à "Boston" ou "San Francisco", et 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...

Enchères au CPC manuelles par entité

À partir de v25, pour les campagnes sur le Réseau de Recherche pour les voyages (campagnes sur le Réseau de Recherche avec AI Max pour les campagnes sur le Réseau de Recherche activé et un flux d'hôtels associé) qui utilisent la stratégie d'enchères au CPC manuel (BiddingStrategyType.MANUAL_CPC), vous pouvez définir des remplacements de l'enchère au CPC manuel (cpc_bid_micros) pour des éléments de flux d'hôtels individuels à l'aide du critère EntityBid (ad_group_criterion.entity_bid) avec CriterionType.VERTICAL_ADS_ITEM_BID et entity_bid.item_code.

Les critères d'exclusion (negative = true), les campagnes hors Réseau de Recherche et les stratégies d'enchères automatiques ou intelligentes ne sont pas compatibles avec VERTICAL_ADS_ITEM_BID et renvoient ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Les métriques de performances ne sont pas renseignées pour les critères VERTICAL_ADS_ITEM_BID. Pour obtenir des informations détaillées sur le schéma, les requêtes GAQL et des exemples de charges utiles de mutation, consultez Enchères au CPC manuelles par entité dans le guide sur les flux de voyage dans les annonces sur le Réseau de Recherche. Pour définir des ajustements d'enchères multiplicatifs au niveau du groupe d'annonces pour les dimensions de l'itinéraire de voyage des annonces d'hôtel à l'aide de AdGroupBidModifier, consultez Ajuster les enchères avec des modificateurs d'enchères.

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'une fiche d'hôtel.
• 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 partenaire d'un Centre des partenaires (par exemple, Hotel Center) qui fournit les données du flux d'inventaire.
• segments.vertical_ads_vertical : type de secteur d'activité, 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 intervenants ou les équipes.
• segments.vertical_ads_listing_user_rating (à partir de v24) : valeur entière (de 1 à 5) spécifiant la note des visiteurs de la fiche d'annonce verticale.
• segments.vertical_ads_listing_venue (à partir de v24) : nom du lieu pour la fiche d'annonces verticales (par exemple, une salle de concert).
• segments.vertical_ads_price_tier (à partir de v25) : tranche de compétitivité tarifaire relative pour les fiches d'hôtels.
• segments.vertical_ads_rate_rule_id (à partir de v25) : identifiant de chaîne correspondant aux règles de tarification privées ou conditionnelles appliquées à l'enchère ou à l'impression.
• segments.vertical_ads_rate_type (à partir de v25) : catégorisation du type de tarif public, privé ou conditionnel.

Segments basés sur des dimensions d'itinéraire

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

• segments.advance_booking_window : période de réservation à l'avance pour le séjour, en jours.
• segments.length_of_booking : durée de la réservation pour le séjour, 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 de v25, vous pouvez récupérer les métriques suivantes pour les annonces verticales :

• metrics.vertical_ads_potential_impressions : impressions potentielles représentant le nombre total d'impressions éligibles limitées par le nombre de vues disponibles dans le contexte de la requête.
• metrics.vertical_ads_average_booking_value_micros : tarif journalier moyen pondéré par les clics en micros, taxes et frais compris, sur la durée totale du séjour.
• metrics.vertical_ads_price_difference_percentage : différence en pourcentage entre le prix proposé par l'annonceur et le prix concurrent le plus bas pour le même établissement.

Exemples de requêtes GAQL

Cette requête récupère les métriques de compétitivité et de réservation des annonces verticales, segmentées par ville de l'établissement, niveau 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 de séjour :

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 lors de la configuration d'annonces verticales :