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 avec AI Max activé 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 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. Contrôles de format : 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é "voyage") à 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 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 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 Flux de voyage dans les annonces sur le Réseau de Recherche.

Contrôles de format des groupes 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 via le vertical_ads_format_setting (VerticalAdsFormatSetting) champ de la AdGroup ressource.

Formats disponibles

Règles de validation

  • Vous ne pouvez pas désactiver les trois formats simultanément pour un seul 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 verticales 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 votre inventaire de flux, par exemple "Hôtels à Boston" ou "Exclure les hôtels 1 étoile", vous devez utiliser des règles de groupe d'articles d'annonces verticales.

Fonctionnement du modèle de données

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

  1. SharedSet : créez un SharedSet avec le type VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: ajoutez des règles (critères) à cet ensemble. Chaque règle spécifie une dimension, telle que la ville ou la 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 (vertical_ads_item_group_rule_list).

Variables acceptées

Vous pouvez filtrer les entités en fonction des dimensions suivantes dans SharedCriterion (VerticalAdsItemGroupRuleInfo), en fonction du SharedSet's vertical_ads_item_vertical_type :

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

Cet exemple Python crée une règle permettant d'inclure des é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...

Enchères au CPC manuelles par entité

À partir de la version 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 négatifs (negative = true), les campagnes non sur le 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 sur les critères VERTICAL_ADS_ITEM_BID. Pour obtenir des informations complètes sur le schéma, les requêtes GAQL et les exemples de charges utiles de mutation, consultez Enchères au CPC manuelles par entité dans le guide Flux de voyage dans les annonces sur le Réseau de Recherche.

Rapports sur les performances

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

Segments d'annonces verticales

Segments de dimension de séjour

À partir de la version 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 de séjour :

Métriques d'annonces verticales

À partir de v25, vous pouvez récupérer les métriques d'annonces verticales suivantes :

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 la fiche, catégorie 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 les erreurs courantes que vous pouvez rencontrer lors de la configuration d'annonces verticales :

Code d'erreur Cause Action recommandée
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING Les trois formats d'annonces (textuelles, liens de réservation et annonces de promotion) ont été désactivés simultanément, ou enable_booking_links a été activé pour un type vertical 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 HOTELS ou THINGS_TO_DO flux.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX AI Max pour les campagnes sur le Réseau de Recherche n'est pas activé pour 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 dispose pas de flux de données vertical actif. Assurez-vous qu'un flux vertical valide est associé au niveau du client ou de la campagne niveau.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Le nom de ressource SharedSet fourni dans le 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 le 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 compatible avec le type vertical spécifique, par exemple la catégorie d'hôtel pour les locations de voitures. Vérifiez que la dimension vertical_ads_item_group_rule correspond à votre type vertical.