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 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. 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 sectorielles 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é au niveau de 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 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.
• 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.
• 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(
        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 :

• item_code : ID de la fiche spécifique.
• city_criterion_id, region_criterion_id, country_criterion_id : noms de ressources Geo Target Constant (geoTargetConstants/{id}).
• hotel_class : note (de 1 à 5).
• user_rating, venue, event_participant_display_name (à partir du v24) : filtres pour l'évaluation des événements et des fiches verticales, le lieu et le nom des participants.

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

Cet exemple Python crée une règle permettant d'inclure les éléments situés à Boston ou à San Francisco, et d'exclure les hôtels une et deux é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 (à partir du v24) : noms à afficher des participants à une liste d'événements, tels que des artistes, des conférenciers ou des é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'annonces verticales.
• 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.

Exemple de requête GAQL

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.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
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 :