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 à découvrir" 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é est appelée « Flux de voyage dans les annonces sur le Réseau de Recherche ».

Remarque : Si vous associez votre flux de données verticales au niveau du client ou de la campagne, votre campagne pourra également utiliser les contrôles et le filtrage de l'inventaire pour les annonces verticales lorsque AI Max est activé, ou les enchères au CPC manuelles par entité pour les flux d'hôtels dans les campagnes sur le Réseau de Recherche pour le voyage lorsque vous utilisez les enchères au CPC manuelles.

Interaction entre les paramètres du client et les paramètres de la campagne

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

• Hériter des flux du client (par défaut) : conservez l'association CustomerAssetSet au niveau du client 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 n'associez pas de CampaignAssetSet au niveau de la campagne.
• Désactiver la fonctionnalité pour une campagne spécifique : ajoutez TRAVEL_FEED à Campaign.excluded_parent_asset_set_types et supprimez toutes les associations CampaignAssetSet au niveau de la campagne.
• Activer la fonctionnalité pour une campagne spécifique uniquement : supprimez l'association CustomerAssetSet au niveau du client, puis créez un lien CampaignAssetSet au niveau de la campagne pour cette campagne.
• Utiliser des flux propres à la campagne tandis que d'autres campagnes continuent d'hériter : ajoutez TRAVEL_FEED à Campaign.excluded_parent_asset_set_types de la campagne et créez un lien CampaignAssetSet au niveau de la campagne pour celle-ci.

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, procédez comme suit :

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

   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 sous-jacent (asset_set.resource_name) que vous souhaitez associer, créez un nouveau CustomerAssetSet avec asset_set défini sur le 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é du 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 nouvel Campaign objet 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.

Ensuite, supprimez 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 sous-jacent (asset_set.resource_name) que vous souhaitez activer, créez un nouveau CampaignAssetSet avec asset_set défini sur le 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.

Restaurer 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 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 le voyage à l'aide de la ressource AdGroupCriterion avec le type de critère CriterionType.VERTICAL_ADS_ITEM_BID(ad_group_criterion.entity_bid).

Prérequis et exigences de compatibilité

Pour créer et gérer des critères VERTICAL_ADS_ITEM_BID, les conditions suivantes doivent être remplies :

• Type de campagne : campagnes sur le Réseau de Recherche pour le voyage (campagnes sur le Réseau de Recherche, AdvertisingChannelType.SEARCH, avec AI Max pour les campagnes sur le Réseau de Recherche activé Campaign.ai_max_setting.enable_ai_max et un flux d'hôtels associé [TRAVEL_FEED ensemble de composants]; 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 automatiques ou intelligentes (telles que "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 d'entité négatives ne sont pas acceptées.
• Identifiant d'entité et enchère obligatoires entity_bid.item_code et cpc_bid_micros sont obligatoires lors de la création d'un critère d'enchère d'entité.

Schéma et définitions de 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)

Champ	Type	Comportement	Description
entity_bid	EntityBid	IMMUTABLE	Critère représentant un remplacement de l'enchère manuelle pour un seul article.
entity_bid.item_code	string	IMMUTABLE (obligatoire)	ID ou code spécifiant une entité d'hôtel particulière (ID de fiche d'hôtel) correspondant au flux d'hôtels partenaire (1 à 256 caractères, tronqué).
cpc_bid_micros	int64	Lecture/Écriture	Montant de l'enchère au CPC manuelle en micro-unités (par exemple, 1000000 équivaut à $1.00).
negative	bool	IMMUTABLE	Doit être false.

Remarque : Les métriques de performances (telles que metrics.impressions, metrics.clicks et metrics.cost_micros) ne sont pas renseignées ni compatibles avec les critères VERTICAL_ADS_ITEM_BID. Pour récupérer les métriques de performances par fiche, interrogez la ressource campaign ou ad_group segmentée par segments.vertical_ads_listing (voir Rapports sur les performances dans Contrôles et filtrage de l'inventaire pour les annonces verticales).

Services et opérations compatibles

Service	Méthode	Action compatible
AdGroupCriterionService	MutateAdGroupCriteria	create, update (cpc_bid_micros), remove
GoogleAdsService	Search / SearchStream	Interroger les attributs de critère, les codes d'article et les valeurs d'enchère

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 VERTICAL_ADS_ITEM_BID critères :

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 d'une enchère d'entité existante

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

Remarque : entity_bid.item_code est IMMUTABLE. Pour modifier le montant de l'enchère, mettez à jour cpc_bid_micros. Pour modifier le code d'article de l'entité, supprimez le critère et créez-en un.

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

Supprimer une enchère d'entité

Envoyez une remove opération à AdGroupCriterionService.MutateAdGroupCriteria :

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

Règles de validation et gestion des erreurs

Scénario	Déclencheur / Condition	Code d'erreur renvoyé
Campagne au CPC non manuel	Tentative de création d'une enchère d'entité dans une campagne avec des enchères automatiques ou intelligentes.	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Type de campagne non valide	Ajout d'une enchère d'entité à une campagne non sur le Réseau de Recherche (par exemple, une campagne display campagne).	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Critère négatif	Définition de negative = true pour VERTICAL_ADS_ITEM_BID.	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Code d'article ou enchère manquants	Tentative de création d'un entity_bid sans fournir de item_code ni de cpc_bid_micros.	RequestError.REQUIRED_FIELD_MISSING / FieldError.REQUIRED
Modification du code d'article	Tentative de modification de entity_bid.item_code sur un critère existant criterion.	RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD

Rapports sur les performances

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

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

Segments de dimension de séjour

Vous pouvez également segmenter les rapports sur les performances des campagnes avec des flux de voyage associés par dimensions de séjour :

• segments.advance_booking_window: période de réservation à l'avance du séjour en jours.
• segments.length_of_booking: durée de la réservation du 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).

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