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'articles pour les annonces verticales.

Présentation

Ce guide aborde 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 pour un secteur) au niveau du groupe d'annonces.
2. Gestion des articles pour les 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 :

• 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. Faites référence aux flux de données verticaux de lien au niveau de la campagne pour associer un flux au niveau de la campagne. L'association d'un flux de données vertical active les flux de voyage dans les annonces sur le Réseau de Recherche (TFSA) et les contrôles des annonces verticales pour la campagne.
• AI Max : le paramètre AI Max 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 et les contrôles des 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 associer le flux au niveau du client pour activer ces fonctionnalités pour toutes les campagnes de votre compte. Pour ce faire, suivez les instructions d'association au niveau du client dans le 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 le 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 des formats 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 via le champ vertical_ads_format_setting de la ressource AdGroup.

Formats disponibles

• Annonces textuelles : activées par défaut. Peuvent être désactivées.
• Liens de réservation : activation requise.
• Annonces de promotion verticale : activation requise.

Règles de validation

• Vous ne pouvez pas désactiver les trois formats simultanément pour un seul 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...

Gestion des articles pour les 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 pour les 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 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, 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 articles.
3. AdGroupCriterion : associez le SharedSet à votre AdGroup à l'aide d'un AdGroupCriterion.

Variables acceptées

Vous pouvez filtrer les entités en fonction des dimensions suivantes dans SharedCriterion :

• 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 étoiles.

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

Cet exemple crée une règle permettant d'inclure des articles à Boston ou à San Francisco, et d'exclure les hôtels 1 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 GoogleAdsService.SearchStream ou GoogleAdsService.Search méthodes. Pour l'API Google Ads, la v23 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, par exemple hôtel ou 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 les erreurs courantes que vous pouvez rencontrer lors de la configuration d'annonces verticales.