Vidéo: Regardez la vidéo de l'atelier 2019 sur les rapports sur les annonces d'hôtel
L'API Google Ads vous permet de créer des requêtes pour obtenir les rapports Hotel Ads dont vous avez besoin. Vous pouvez ensuite intégrer ces requêtes dans vos applications clientes.
Prérequis
- Découvrez le fonctionnement général des rapports et des requêtes.
- Découvrez comment effectuer des requêtes sur différentes ressources.
Requêtes de base pour Hotel Ads
Consultez ces exemples de requêtes afin de vous familiariser avec l'API Google Ads pour les rapports Hotel Ads.
Obtenir des métriques sur les clics
L'exemple de requête suivant renvoie le nombre de clics à partir de la vue des performances de l'hôtel.
SELECT metrics.clicks
FROM hotel_performance_view
Les résultats de la requête devraient ressembler à ceci:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Obtenir des métriques segmentées sur les clics
L'exemple de requête suivant sur les vues des performances d'un hôtel permet d'obtenir des clics et de segmenter les résultats par ID d'hôtel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
Les clics sont segmentés par partnerHotelID
. Par conséquent, deux objets ou plus peuvent être renvoyés pour le même hotelPerformanceView.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Obtenir les métriques d'un groupe d'annonces
L'exemple de requête suivant pour des groupes d'annonces génère les impressions et les clics au cours des 30 derniers jours, segmentés par date.
SELECT
campaign.name,
campaign.status,
ad_group.name,
segments.date,
metrics.impressions,
metrics.clicks
FROM ad_group
WHERE ad_group.type = HOTEL_ADS
AND segments.date DURING LAST_30_DAYS
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
La réponse est filtrée pour n'afficher que les métriques répondant aux conditions de la clause WHERE
. Le champ de date est renseigné avec la date de la dernière période incluse dans la période de 30 jours.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/123456789/adGroups/11111111",
"name": "test adgroup"
},
"metrics": {
"clicks": "91",
"impressions": "5145"
},
"segments": {
"date": "2020-05-10"
}
}
]
}
Activer les annonces de vos groupes d'annonces
L'exemple de requête suivant pour les annonces d'un groupe d'annonces permet d'obtenir les groupes d'annonces qui seront diffusés. Pour qu'un groupe d'annonces soit diffusé, l'annonce du groupe d'annonces, le groupe d'annonces et la campagne doivent tous être activés.
SELECT
ad_group.id,
ad_group.name,
ad_group.status,
campaign.name,
campaign.status,
ad_group_ad.status
FROM ad_group_ad
WHERE ad_group_ad.status = ENABLED
AND campaign.status = ENABLED
AND ad_group.status = ENABLED
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/123456789/adGroups/111111111111",
"id": "106121857411",
"name": "test adgroup",
"status": "ENABLED"
},
"adGroupAd": {
"resourceName": "customers/123456789/adGroupAds/111111111111~33333333333",
"status": "ENABLED",
"ad": {
"resourceName": "customers/123456789/ads/77777777777"
}
}
}
]
}
Vues utiles pour les rapports Hotel Ads
Dans les API précédentes de création de rapports Hotel Ads, vous pouviez récupérer un rapport spécifique, par exemple un rapport sur les performances. Dans l'API Google Ads, ce type de données est représenté dans des ressources *_view
distinctes, telles que hotel_performance_view
et hotel_group_view
. Cette section décrit les ressources *_view
utiles pour les rapports Hotel Ads. Des exemples de requêtes sont également fournis.
Notez que chaque ressource *_view
possède des champs de ressource, des segments et des métriques spécifiques. Consultez la documentation de la ressource *_view
spécifique avant de créer votre requête.
Vue par groupe d'hôtels
La vue du groupe d'hôtels est une vue par critères. Elle est donc utile pour récupérer des métriques pour un type de critère spécifique d'un groupe d'hôtels.
L'exemple de requête suivant pour les vues d'un groupe d'hôtels génère des clics pour chaque hôtel d'un groupe de fiches dans l'ensemble de l'arborescence de groupes d'hôtels, y compris le nœud racine ("Tous les hôtels").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
Étant donné que case_value
n'est pas défini pour le nœud racine ("Tous les hôtels"), il apparaît que la première ligne représente les métriques du groupe de fiches "Tous les hôtels", tandis que la deuxième ligne représente les métriques du groupe de fiches enfant représentant "Autre".
{
"results": [
{
"metrics": {
"clicks": "5"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111111"
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111111"
}
},
{
"metrics": {
"clicks": "0"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111112"
"listingGroup": {
"caseValue": {
"hotelId": {
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111112"
}
},
{
"metrics": {
"clicks": "3"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111113"
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111111"
}
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111113"
}
},
{
"metrics": {
"clicks": "2"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111114"
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111112"
}
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111114"
}
},
]
}
Vue "Performances de l'hôtel"
La vue des performances de l'hôtel est utile si vous souhaitez récupérer des métriques de performances pour un hôtel à l'aide de données qui ne proviennent pas d'un groupe d'hôtels, même si vous avez une subdivision basée sur l'ID de l'hôtel.
L'exemple de requête suivant sur les vues des performances d'un hôtel permet d'obtenir des clics et de segmenter les résultats par ID d'hôtel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
Les clics sont segmentés par partner_hotel_id
. Par conséquent, deux objets ou plus peuvent être renvoyés pour la même vue des performances de l'hôtel.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Vue "Audience du groupe d'annonces"
La vue de l'audience du groupe d'annonces est utile si vous souhaitez récupérer des métriques de performances pour les audiences associées au niveau du groupe d'annonces.
Notez qu'il s'agit d'une vue générale de différents types de campagnes, et pas seulement des campagnes d'hôtel. Cette vue permet également de segmenter les résultats par hotel_date_selection_type
, qui permet d'indiquer si la date de l'hôtel a été sélectionnée par l'utilisateur ou s'il s'agit d'une date par défaut pour la recherche définie par Google. Si vous segmentez par hotel_date_selection_type
, seuls les résultats des campagnes d'hôtel sont renvoyés.
La requête suivante renvoie une ligne par ad_group_criterion.user_list.user_list
.
SELECT
ad_group.id,
campaign.id,
ad_group_criterion.user_list.user_list,
segments.device,
segments.hotel_date_selection_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM ad_group_audience_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"adGroupCriterion": {
"resourceName": "customers/123456789/adGroupCriteria/23456789~789456",
"userList": {
"userList": "customers/123456789/userLists/456789"
}
},
"adGroupAudienceView": {
"resourceName": "customers/8005193609/adGroupAudienceViews/23456789~789456"
},
"segments": {
"device": "TABLET",
"hotelDateSelectionType": "USER_SELECTED"
}
}
]
}
Vue d'audience de la campagne
La vue "Audience de la campagne" est utile si vous souhaitez récupérer des métriques de performances pour les audiences associées au niveau de la campagne.
Notez qu'il s'agit d'une vue générale de différents types de campagnes, et pas seulement des campagnes d'hôtel. Cette vue permet également de segmenter les résultats par hotel_date_selection_type
, qui permet d'indiquer si la date de l'hôtel a été sélectionnée par l'utilisateur ou s'il s'agit d'une date par défaut pour la recherche définie par Google. Si vous segmentez par hotel_date_selection_type
, seuls les résultats des campagnes d'hôtel sont renvoyés.
La requête suivante renvoie une ligne par campaign_criterion.user_list.user_list
.
SELECT
campaign.id,
campaign_criterion.user_list.user_list,
segments.device,
segments.hotel_date_selection_type,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM campaign_audience_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"campaignCriterion": {
"resourceName": "customers/123456789/campaignCriteria/23456789~789456",
"userList": {
"userList": "customers/123456789/userLists/456789"
}
},
"campaignAudienceView": {
"resourceName": "customers/8005193609/campaignAudienceViews/23456789~789456"
},
"segments": {
"device": "TABLET",
"hotelDateSelectionType": "USER_SELECTED"
}
}
]
}
Rapports utiles pour Hotel Ads
Cette section fournit plusieurs rapports utiles conçus spécifiquement pour les annonces d'hôtel.
Rapports sur les performances
Ces requêtes utilisent la vue "Performances de l'hôtel" pour obtenir des données sur les performances.
Un hotel_performance_view
vous permet d'utiliser la ressource campaign
pour segmenter des métriques. Par exemple, vous pouvez utiliser le champ campaign.id
pour obtenir des métriques de performances par campagne.
Performances
Exemple de requête :
SELECT
segments.hotel_center_id,
segments.device,
segments.partner_hotel_id,
segments.hotel_check_in_day_of_week,
segments.hotel_date_selection_type,
segments.hotel_length_of_stay,
segments.hotel_booking_window_days,
metrics.search_top_impression_share,
metrics.search_absolute_top_impression_share,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value,
metrics.search_impression_share
FROM hotel_performance_view
Exemple de réponse JSON:
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "0",
"searchImpressionShare": "0.0999",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.0999",
"allConversionsValue": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "3",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "MONDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"searchImpressionShare": "1.0",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "1.0",
"allConversionsValue": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "3",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "MONDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123"
}
}
]
}
Performances avec type de clic
Exemple de requête :
SELECT
segments.click_type,
segments.hotel_center_id,
segments.device,
segments.partner_hotel_id,
segments.hotel_check_in_day_of_week,
segments.hotel_date_selection_type,
segments.hotel_length_of_stay,
segments.hotel_booking_window_days,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions,
metrics.all_conversions_value
FROM hotel_performance_view
Exemple de réponse JSON:
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123",
"clickType": "HOTEL_PRICE"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "12345",
"clickType": "HOTEL_PRICE"
}
}
]
}
Rapport sur les performances des tarifs sous conditions
La requête suivante permet d'obtenir des métriques de performances segmentées par:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Consultez la section HotelRateType
pour obtenir une description des types.
Vous pouvez inclure plusieurs segments dans une requête. Toutefois, le nombre de lignes renvoyées peut augmenter considérablement en ajoutant des segments.
SELECT
campaign.id,
segments.hotel_center_id,
segments.hotel_country,
segments.hotel_rate_rule_id,
segments.hotel_rate_type,
segments.device,
segments.partner_hotel_id,
metrics.search_top_impression_share,
metrics.search_absolute_top_impression_share,
metrics.impressions,
metrics.clicks,
metrics.cost_micros,
metrics.conversions
FROM hotel_performance_view
Les résultats de la requête doivent ressembler à la chaîne JSON suivante.
{
"results": [
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "24",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.17073170731707318"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "TABLET",
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelRateRuleId": "desktop",
"hotelRateType": "PUBLIC_RATE"
}
},
{
"campaign": {
"resourceName": "customers/123456789/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "107",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1668",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.3581201665675193"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"device": "TABLET",
"hotelCenterId": "1234",
"partnerHotelId": "1235",
"hotelRateRuleId": "desktop",
"hotelRateType": "PUBLIC_RATE"
}
}
]
}
Rapport "Compétitivité tarifaire"
Vous pouvez obtenir des insights vous permettant de comparer vos prix à ceux de vos concurrents pour le même séjour.
Exemple de requête :
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.hotel_average_lead_value_micros,
metrics.hotel_price_difference_percentage
FROM hotel_performance_view
Exemple de réponse JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Rapport sur le prix moyen réservé
Vous pouvez obtenir les données nécessaires pour calculer le prix moyen des réservations (all_conversions_value
divisé par conversions
) pour les hôtels.
Exemple de requête :
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Exemple de réponse JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Rapports "Type d'audience"
Les rapports "Type d'audience" présentent les performances des multiplicateurs d'enchères sur les listes d'audience Google Ads. Pour obtenir des exemples de rapports sur l'audience, consultez les exemples de requêtes dans les sections Vue "Audience du groupe d'annonces" et Vue "Audience de la campagne".
Rapport de rapprochement pour les hôtels
Le rapport Hotel Reconciliation contient des informations de conversion sur les réservations d'hôtel à rapprocher avec les données des annonceurs. Vous pouvez importer des données de manière groupée pour indiquer à Google les réservations annulées ou terminées. Voici les principales colonnes de ce rapport:
Colonne de l'UI | Colonne "API" | Explication |
---|---|---|
Valeur de réservation | metrics.value_per_conversions_by_conversion_date |
La valeur de conversion telle qu'elle est enregistrée par la balise |
Date de conversion | segments.date |
Date de la réservation |
Taux de commission | metrics.hotel_commission_rate_micros |
Pourcentage de la valeur de réservation sur laquelle vous définissez une enchère pour une impression d'annonce |
Frais de commission |
Si elle est définie sur |
Montant que vous devez payer ou que vous avez payé pour le séjour du client |