Reporting

Vidéo: regardez la vidéo sur les rapports Hotel Ads de l'atelier 2019

L'API Google Ads vous permet de créer des requêtes pour générer les rapports Hotel Ads dont vous avez besoin. Vous pouvez ensuite intégrer ces requêtes dans vos applications clientes.

Conditions préalables

  • Découvrez le fonctionnement des rapports et des requêtes en général.
  • Découvrez comment différentes ressources peuvent être interrogées.

Requêtes de base pour Hotel Ads

Consultez ces exemples de requêtes afin de vous familiariser avec l'utilisation de l'API Google Ads pour les rapports Hotel Ads.

Obtenir les métriques sur les clics

L'exemple de requête suivant renvoie le nombre de clics enregistrés dans l'affichage des performances d'un hôtel.

SELECT metrics.clicks
FROM hotel_performance_view

Les résultats de la requête ressembleraient à quelque chose comme 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 pour les vues de performances d'hôtels obtient les clics et segmente 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 devraient ressembler à ceci : 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 les groupes d'annonces obtient les impressions et les clics sur les 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 devraient ressembler à ceci : La réponse n'est filtrée que pour les métriques répondant aux conditions de la clause WHERE. Le champ de date est renseigné par la dernière date 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"
      }
    }
  ]
}

Obtenir des annonces de groupes d'annonces activées

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 puisse être diffusé, son annonce, 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 devraient ressembler à ceci :

{
  "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 anciennes API de création de rapports Hotel Ads, vous pouviez récupérer un rapport spécifique, comme 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 comporte 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 du groupe d'hôtels

La vue de groupe d'hôtels est une vue de 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 de groupes d'hôtels obtient le nombre de clics pour chaque hôtel d'un groupe de fiches pour l'ensemble de l'arborescence de groupes de fiches 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 devraient ressembler à ceci : Étant donné que case_value n'est pas défini pour le nœud racine ("Tous les hôtels"), 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 les métriques de performances d'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 pour les vues de performances d'hôtels obtient les clics et segmente 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 devraient ressembler à ceci : 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 d'un 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 "Audience du groupe d'annonces" est utile si vous souhaitez récupérer les 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 pour différents types de campagnes, et pas seulement pour les campagnes d'hôtel. Cette vue permet également de segmenter les résultats par hotel_date_selection_type, ce qui permet d'indiquer si la date d'hôtel a été sélectionnée par l'utilisateur ou si elle constituait une date par défaut pour la recherche définie par Google. Si vous effectuez une segmentation par hotel_date_selection_type, seuls les résultats pour les 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 devraient ressembler à ceci :

{
  "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 "Audience de la campagne"

La vue "Audience de la campagne" est utile si vous souhaitez récupérer les 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 pour différents types de campagnes, et pas seulement pour les campagnes d'hôtel. Cette vue permet également de segmenter les résultats par hotel_date_selection_type, ce qui permet d'indiquer si la date d'hôtel a été sélectionnée par l'utilisateur ou si elle constituait une date par défaut pour la recherche définie par Google. Si vous effectuez une segmentation par hotel_date_selection_type, seuls les résultats pour les 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 devraient ressembler à ceci :

{
  "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 les annonces d'hôtels

Cette section fournit plusieurs rapports utiles conçus spécifiquement pour les annonces d'hôtels.

Rapports sur les performances

Ces requêtes utilisent la vue des performances d'hôtel pour obtenir des données sur les performances.

Un hotel_performance_view vous permet d'utiliser la ressource campaign pour segmenter les 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 obtient les 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.

Plusieurs segments peuvent être inclus dans une requête. Toutefois, le nombre de lignes renvoyées peut augmenter considérablement avec des segments supplémentaires.

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 devraient ressembler à ceci :

{
  "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 afin de comparer vos prix à ceux de vos concurrents pour les mêmes séjours d'hôtels.

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 réservé moyen

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 sur l'audience affichent les performances des multiplicateurs d'enchères dans 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 "Rapprochement de l'hôtel"

Le rapport de rapprochement de l'hôtel contient les informations de conversion issues des réservations d'hôtel à rapprocher avec les enregistrements de l'annonceur. Vous pouvez importer des données de manière groupée pour indiquer à Google quelles réservations ont été annulées ou effectuées. Les principales colonnes de ce rapport sont les suivantes:

Colonne de l'interface utilisateur Colonne "API" Explication
Valeur de réservation metrics.value_per_conversions_by_conversion_date Valeur de conversion telle qu'elle est enregistrée par la balise
Date de conversion segments.date La date de la réservation
Taux de commission metrics.hotel_commission_rate_micros Pourcentage de la valeur de réservation sur lequel vous enchérissez pour une impression d'annonce
Frais de commission

Si status == RECONCILED ou CANCELED, cette valeur peut être calculée comme suit : metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. Dans tous les autres cas, cette valeur peut être obtenue à partir de la colonne metrics.hotel_expected_commission_cost ou calculée comme suit : metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

 Montant que vous êtes censé payer ou que vous avez payé pour le séjour du client
Précédent
Ajustez les enchères