Flux de voyage dans les annonces sur le Réseau de Recherche

Lorsque vos flux de produits Hôtels, Locations de vacances ou Activités sont associés à votre compte Google Ads, Google Ads enrichit automatiquement les campagnes sur le Réseau de Recherche existantes avec les prix et les images extraits de vos flux. Cette fonctionnalité s'appelle Flux de voyage dans les annonces sur le Réseau de Recherche.

Interaction entre les paramètres client et ceux des campagnes

Par défaut, les campagnes héritent des liens de flux de voyage (ensembles de composants TRAVEL_FEED) au niveau du client via les associations CustomerAssetSet. Pour remplacer les paramètres au niveau du client pour une campagne spécifique, vous devez ajouter TRAVEL_FEED au champ excluded_parent_asset_set_types de la campagne et gérer les liens spécifiques à la campagne à l'aide de CampaignAssetSet.

• Hériter des flux client (par défaut) : conservez le CustomerAssetSet au niveau du client associé et assurez-vous que Campaign.excluded_parent_asset_set_types ne contient pas TRAVEL_FEED.
• Désactiver la fonctionnalité au niveau du client : supprimez l'association CustomerAssetSet au niveau du client et ne liez pas de CampaignAssetSet au niveau de la campagne.
• Désactiver une campagne spécifique : ajoutez TRAVEL_FEED à Campaign.excluded_parent_asset_set_types et supprimez toutes les associations CampaignAssetSet au niveau de la campagne.
• N'activer la fonctionnalité que pour une campagne spécifique : supprimez l'association CustomerAssetSet au niveau du compte client, puis créez un lien CampaignAssetSet au niveau de la campagne pour cette campagne.
• Utiliser des flux spécifiques à la campagne tout en conservant l'héritage pour les autres campagnes : ajoutez TRAVEL_FEED à Campaign.excluded_parent_asset_set_types de la campagne et créez un lien CampaignAssetSet au niveau de la campagne.

Désactiver les flux de voyage dans les annonces sur le Réseau de Recherche

Si vous préférez ne pas utiliser cette fonctionnalité, vous pouvez utiliser l'API Google Ads pour désactiver les flux de voyage dans les annonces sur le Réseau de Recherche au niveau du client et de la campagne.

Désactiver la fonctionnalité au niveau du client

Pour désactiver les flux de voyage dans les annonces sur le Réseau de Recherche au niveau du client :

1. Récupérez customer_asset_set.resource_name et asset_set.resource_name pour tous les liens CustomerAssetSet dont le type est TRAVEL_FEED à l'aide du rapport customer_asset_set :

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. Pour chaque customer_asset_set.resource_name, créez un CustomerAssetSetOperation et définissez remove sur le customer_asset_set.resource_name récupéré à l'étape précédente.

3. Envoyez une requête à CustomerAssetSetService.MutateCustomerAssetSets à l'aide des objets CustomerAssetSetOperation créés.

Si vous souhaitez réactiver cette fonctionnalité au niveau du client :

1. Pour chaque AssetSet (asset_set.resource_name) sous-jacent que vous souhaitez associer, créez un CustomerAssetSet avec asset_set défini sur asset_set.resource_name et customer défini sur le nom de ressource de votre client.
2. Pour chaque CustomerAssetSet créé à l'étape précédente, créez un CustomerAssetSetOperation avec create défini sur le CustomerAssetSet.
3. Envoyez une requête à CustomerAssetSetService.MutateCustomerAssetSets à l'aide des objets CustomerAssetSetOperation créés.

Désactiver la fonctionnalité au niveau de la campagne

Pour désactiver les flux de voyage dans les annonces sur le Réseau de Recherche au niveau de la campagne, vous devez d'abord exclure l'état d'activation hérité au niveau du client :

1. Récupérez excluded_parent_asset_set_types à l'aide du rapport campaign :

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. Créez un objet Campaign avec excluded_parent_asset_set_types défini sur les valeurs précédentes plus TRAVEL_FEED et resource_name défini sur le nom de ressource de votre campagne.

3. Créez un CampaignOperation et définissez update sur le Campaign créé précédemment et update_mask en conséquence.

4. Envoyez une requête à CampaignService.MutateCampaigns à l'aide du CampaignOperation créé à l'étape précédente.

Supprimez ensuite toutes les associations de flux de voyage au niveau de la campagne :

1. Pour la campagne que vous souhaitez désactiver, récupérez campaign_asset_set.resource_name et asset_set.resource_name pour tous les liens CampaignAssetSet dont le type est TRAVEL_FEED à l'aide du rapport campaign_asset_set :

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. Pour chaque campaign_asset_set.resource_name, créez un CampaignAssetSetOperation et définissez remove sur le campaign_asset_set.resource_name récupéré à l'étape précédente.

3. Envoyez une requête à CampaignAssetSetService.MutateCampaignAssetSets à l'aide des objets CampaignAssetSetOperation créés.

Si vous souhaitez réactiver cette fonctionnalité au niveau de la campagne :

1. Pour chaque AssetSet (asset_set.resource_name) sous-jacent auquel vous souhaitez participer, créez un CampaignAssetSet avec asset_set défini sur asset_set.resource_name et campaign défini sur le nom de ressource de votre campagne.
2. Pour chaque CampaignAssetSet créé à l'étape précédente, créez un CampaignAssetSetOperation avec create défini sur le CampaignAssetSet.
3. Envoyez une requête à CampaignAssetSetService.MutateCampaignAssetSets à l'aide des objets CampaignAssetSetOperation créés.

Rétablir l'état d'activation au niveau du client pour une campagne

Pour que l'état d'activation d'une campagne hérite à nouveau du paramètre au niveau du compte client, procédez comme suit :

1. Créez un objet Campaign avec excluded_parent_asset_set_types sans TRAVEL_FEED dans la liste et resource_name défini sur le nom de ressource de votre campagne.
2. Créez un CampaignOperation et définissez update sur le Campaign créé précédemment et update_mask en conséquence.
3. Envoyez une requête à CampaignService.MutateCampaigns à l'aide du CampaignOperation créé à l'étape précédente.

Enchères au CPC manuelles par entité

À partir de l'API Google Ads v25, vous pouvez configurer des remplacements d'enchères au CPC manuelles par entité pour les hôtels dans les campagnes sur le Réseau de Recherche pour les voyages à l'aide de la ressource AdGroupCriterion avec le type de critère CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

Conditions préalables et exigences de compatibilité

Pour créer et gérer des critères VERTICAL_ADS_ITEM_BID, vous devez remplir les conditions suivantes :

• Type de campagne : campagnes sur le Réseau de Recherche pour les voyages (campagnes sur le Réseau de Recherche, AdvertisingChannelType.SEARCH, avec les campagnes AI Max pour le Réseau de Recherche activées Campaign.ai_max_setting.enable_ai_max et un flux d'hôtels associé [ensemble d'assets TRAVEL_FEED]; seuls les flux d'hôtels sont acceptés).
• Stratégie d'enchères : CPC manuel (BiddingStrategyType.MANUAL_CPC) uniquement.
  • Non compatible avec les stratégies d'enchères intelligentes ou automatiques (comme "Maximiser les conversions", "Maximiser la valeur de conversion", "CPA cible" ou "ROAS cible").
• Critères positifs uniquement : negative doit être défini sur false. Les enchères négatives pour les entités ne sont pas acceptées.
• Identifiant et enchère d'entité requis : entity_bid.item_code et cpc_bid_micros sont requis lors de la création d'un critère d'enchère d'entité.

Schéma et définitions des champs

• Ressource : AdGroupCriterion (ad_group_criterion)
• Format du nom de la ressource : customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Énumération du type de critère : CriterionType.VERTICAL_ADS_ITEM_BID
• Message : EntityBid (ad_group_criterion.entity_bid)

Services et opérations compatibles

Exemples de code et de charge utile

Les exemples suivants montrent comment lire, créer, modifier et supprimer des critères VERTICAL_ADS_ITEM_BID.

Lire les enchères d'entité à l'aide de GAQL

Utilisez GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger les critères VERTICAL_ADS_ITEM_BID :

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

Créer une enchère d'entité

Envoyez une opération create à AdGroupCriterionService.MutateAdGroupCriteria :

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

Modifier le montant de l'enchère d'une entité existante

Envoyez une opération update avec un updateMask à AdGroupCriterionService.MutateAdGroupCriteria :

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

Supprimer une enchère d'entité

Envoyez une opération remove à AdGroupCriterionService.MutateAdGroupCriteria :

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

Règles de validation et gestion des erreurs

Rapports sur les performances

Vous pouvez utiliser ClickType.TRAVEL_ASSETS pour identifier les données de performances des annonces diffusées en tant que flux de voyage dans les annonces sur le Réseau de Recherche. Par exemple, vous pouvez récupérer les données de performances des annonces de toutes vos campagnes :

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

Segments de dimension d'itinéraire

Vous pouvez également segmenter les rapports sur les performances des campagnes associées à des flux de voyages par 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 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).

Exemple de requête

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS