Lorsque vos flux de produits d'hôtels, de locations de vacances ou d'activités à découvrir sont associés à votre compte Google Ads, Google Ads ajoute automatiquement des informations sur les prix et des images issues de vos flux à vos campagnes sur le Réseau de Recherche existantes. Cette fonctionnalité est appelée flux de voyage dans les annonces sur le Réseau de Recherche.
Interaction entre les paramètres client et les paramètres de campagne
Par défaut, les campagnes héritent des liens de flux de voyage (ensembles de composants TRAVEL_FEED) du 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 l'association au niveau du client
CustomerAssetSetet assurez-vous queCampaign.excluded_parent_asset_set_typesne contient pasTRAVEL_FEED. - Désactiver la fonctionnalité au niveau du client : supprimez l'association
CustomerAssetSetau niveau du client et n'associez pas deCampaignAssetSetau niveau de la campagne. - Désactiver une campagne spécifique : ajoutez
TRAVEL_FEEDàCampaign.excluded_parent_asset_set_typeset supprimez toutes les associationsCampaignAssetSetau niveau de la campagne. - Activer la fonctionnalité pour une campagne spécifique uniquement : supprimez l'association
CustomerAssetSetau niveau du client, puis créez un lienCampaignAssetSetau 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_FEEDauCampaign.excluded_parent_asset_set_typesde la campagne, puis créez un lienCampaignAssetSetau 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, procédez comme suit :
Récupérez
customer_asset_set.resource_nameetasset_set.resource_namepour tous les liensCustomerAssetSetdont le type estTRAVEL_FEEDà l'aide du rapportcustomer_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'Pour chaque
customer_asset_set.resource_name, créez unCustomerAssetSetOperationet définissezremovesur lecustomer_asset_set.resource_namerécupéré à l'étape précédente.Envoyez une requête à
CustomerAssetSetService.MutateCustomerAssetSetsà l'aide des objetsCustomerAssetSetOperationcréés.
Si vous souhaitez réactiver cette fonctionnalité au niveau du client :
- Pour chaque
AssetSet(asset_set.resource_name) sous-jacent que vous souhaitez associer, créez unCustomerAssetSetavecasset_setdéfini surasset_set.resource_nameetcustomerdéfini sur le nom de ressource de votre client. - Pour chaque
CustomerAssetSetcréé à l'étape précédente, créez unCustomerAssetSetOperationaveccreatedéfini surCustomerAssetSet. - Envoyez une requête à
CustomerAssetSetService.MutateCustomerAssetSetsà l'aide des objetsCustomerAssetSetOperationcréé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 :
Récupérez
excluded_parent_asset_set_typesà l'aide du rapportcampaign:SELECT campaign.excluded_parent_asset_set_types FROM campaign WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'Créez un objet
Campaignavecexcluded_parent_asset_set_typesdéfini sur les valeurs précédentes plusTRAVEL_FEEDetresource_namedéfini sur le nom de ressource de votre campagne.Créez un
CampaignOperationet définissezupdatesur lesCampaignetupdate_maskprécédemment créés.Envoyez une requête à
CampaignService.MutateCampaignsà l'aide duCampaignOperationcréé à l'étape précédente.
Ensuite, supprimez toutes les associations de flux de voyage au niveau de la campagne :
Pour la campagne que vous souhaitez désactiver, récupérez
campaign_asset_set.resource_nameetasset_set.resource_namepour tous les liensCampaignAssetSetdont le type estTRAVEL_FEEDà l'aide du rapportcampaign_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'Pour chaque
campaign_asset_set.resource_name, créez unCampaignAssetSetOperationet définissezremovesur lecampaign_asset_set.resource_namerécupéré à l'étape précédente.Envoyez une requête à
CampaignAssetSetService.MutateCampaignAssetSetsà l'aide des objetsCampaignAssetSetOperationcréés.
Si vous souhaitez réactiver cette fonctionnalité au niveau de la campagne :
- Pour chaque
AssetSet(asset_set.resource_name) sous-jacent que vous souhaitez activer, créez unCampaignAssetSetavecasset_setdéfini surasset_set.resource_nameetcampaigndéfini sur le nom de ressource de votre campagne. - Pour chaque
CampaignAssetSetcréé à l'étape précédente, créez unCampaignAssetSetOperationaveccreatedéfini surCampaignAssetSet. - Envoyez une requête à
CampaignAssetSetService.MutateCampaignAssetSetsà l'aide des objetsCampaignAssetSetOperationcréé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 défini au niveau du client, procédez comme suit :
- Créez un objet
Campaignavecexcluded_parent_asset_set_typessansTRAVEL_FEEDdans la liste etresource_namedéfini sur le nom de ressource de votre campagne. - Créez un
CampaignOperationet définissezupdatesur lesCampaignetupdate_maskprécédemment créés. - Envoyez une requête à
CampaignService.MutateCampaignsà l'aide duCampaignOperationcréé à l'étape précédente.
Enchères au CPC manuelles par entité
À partir de la version v25 de l'API Google Ads, 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). Pour définir des ajustements d'enchères multiplicatifs au niveau du groupe d'annonces pour les dimensions d'itinéraire de voyage à l'aide de AdGroupBidModifier, consultez Ajuster les enchères avec des modificateurs d'enchères.
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 les voyages (campagnes sur le Réseau de Recherche,
AdvertisingChannelType.SEARCH, avec AI Max pour les campagnes sur le Réseau de Recherche activé viaCampaign.ai_max_setting.enable_ai_maxet un ensemble de composants de flux d'hôtelTRAVEL_FEEDassocié ; seuls les flux d'hôtel 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 (comme "Maximiser les conversions", "Maximiser la valeur de conversion", "CPA cible" ou "ROAS cible").
- Critères positifs uniquement :
negativedoit être défini surfalse. Les enchères d'entités négatives ne sont pas acceptées. - Identifiant d'entité et enchère obligatoires :
entity_bid.item_codeetcpc_bid_microssont obligatoires 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)
| Champ | Type | Comportement | Description |
|---|---|---|---|
entity_bid |
EntityBid |
IMMUTABLE |
Critère représentant un remplacement manuel de l'enchère pour un seul élément. |
entity_bid.item_code |
string |
IMMUTABLE (obligatoire) |
ID ou code spécifiant une entité d'hôtel particulière (ID de la fiche d'hôtel) correspondant au flux d'hôtels du 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 |
Services et opérations compatibles
| Service | Méthode | Actions compatibles |
|---|---|---|
AdGroupCriterionService |
MutateAdGroupCriteria |
create, update
(cpc_bid_micros), remove |
GoogleAdsService |
Search
/ SearchStream |
Attributs des critères de requête, codes d'article et 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 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"
}
}
}
]
}
Mettre à jour le montant d'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
| Scénario | Déclencheur/Condition | Code d'erreur renvoyé |
|---|---|---|
| Campagne au CPC non manuel | Tentative de création d'une enchère d'entité sur 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 qui n'est pas diffusée sur le Réseau de Recherche (par exemple, une campagne display). | ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT |
| Critère à exclure | 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 de entity_bid sans fournir item_code ni cpc_bid_micros. |
RequestError.REQUIRED_FIELD_MISSING
/ FieldError.REQUIRED |
| Modification du code de l'article | Tentative de mise à jour de entity_bid.item_code sur un critère existant. |
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 en récupérant 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 d'itinéraire
Vous pouvez également segmenter les rapports sur les performances des campagnes avec des flux de voyage associés en fonction des dimensions de l'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 le séjour, en jours.segments.start_date: date de début de la réservation au formatyyyy-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_SELECTEDouDEFAULT_SELECTION).
À partir de v26, vous pouvez interroger les métriques metrics.search_top_impression_share et metrics.search_click_share avec ces segments de dimension d'itinéraire.
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,
metrics.search_top_impression_share,
metrics.search_click_share
FROM campaign
WHERE segments.date DURING LAST_30_DAYS