Rapports

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.

Prérequis

Requêtes de base pour Hotel Ads

Consultez ces exemples de requêtes pour vous familiariser avec l'API Google Ads pour les hôtels Rapports sur les annonces

Obtenir les métriques sur les clics

L'exemple de requête suivant renvoie le nombre de clics effectués depuis l'hôtel des performances.

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 des clics et des segments 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 pour le même hôtelPerformanceView.

{
  "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 génère des impressions et des clics au cours des 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 devraient ressembler à ceci : La réponse n'est filtrée que pour les métriques correspondant à la clause WHERE. et conditions d'exploitation. Le champ de date contient les données correspondant à la dernière date incluse dans les 30 jours période.

{
  "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 soit diffusé, l'annonce, le groupe d'annonces et la campagne doivent : être tous 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 sur les annonces d'hôtels, vous pouviez récupérer tel qu'un rapport sur les performances. Dans l'API Google Ads, ce type de données représentées dans des ressources *_view distinctes, telles que hotel_performance_view et hotel_group_view Cette section décrit les ressources *_view qui sont 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. Consultez la documentation de la ressource *_view spécifique avant de pour construire votre requête.

Vue du groupe d'hôtels

La vue de groupe d'hôtels est un critère , ce qui permet d'extraire des métriques utiles 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 génère des clics pour chaque hôtel de Un groupe de fiches pour l'ensemble de l'arborescence des 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"), il est la première ligne représente les métriques pour "Tous les hôtels" fiche tandis que la deuxième ligne indique 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 d'un groupe d'hôtels, même si vous avez défini 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 des clics et des segments 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, ce qui signifie que deux objets ou plus peuvent 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 "Audience" d'un groupe d'annonces est utile si vous : Vous souhaitez récupérer les métriques de performances pour les audiences associées au groupe d'annonces. d'application.

Notez qu'il s'agit d'une vue générale pour différents types de campagnes, pas seulement pour les campagnes d'hôtel. campagnes. Cette vue vous 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 correspondait à une date par défaut pour la recherche définie par Google. Si vous segmentez par hotel_date_selection_type, seuls les résultats pour les campagnes d'hôtel sont renvoyé.

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 : Vous souhaitez récupérer les métriques de performances pour les audiences associées à la campagne. d'application.

Notez qu'il s'agit d'une vue générale pour différents types de campagnes, pas seulement pour les campagnes d'hôtel. campagnes. Cette vue vous 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 correspondait à une date par défaut pour la recherche définie par Google. Si vous segmentez par hotel_date_selection_type, seuls les résultats pour les campagnes d'hôtel sont renvoyé.

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 contient plusieurs rapports utiles, spécialement conçus pour les campagnes annonces.

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 métriques. Par exemple, vous pouvez utiliser le champ campaign.id pour obtenir les 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 HotelRateType pour découvrir la description des types.

Une requête peut inclure plusieurs segments. Toutefois, le nombre d'entrées le nombre de lignes peut augmenter de façon significative 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 prix sur le même 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 réservé (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" affichent les performances des multiplicateurs d'enchères pour l'audience Google Ads . Pour obtenir des exemples de rapports sur l'audience, consultez les exemples de requêtes dans la section Groupe d'annonces Vue "Audience" et Audience de la campagne vue.

Rapport "Rapprochement de l'hôtel"

Le rapport sur le rapprochement de l'hôtel contient les informations de conversion issues des réservations d'hôtel afin de les rapprocher de l'annonceur d'enregistrements. Vous pouvez effectuer des importations groupées pour indiquer à Google réservations ont été annulées ou terminées. Les principales colonnes de ce rapport sont les suivantes : ce qui suit:

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 la valeur est status == RECONCILED ou CANCELED, 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 metrics.hotel_expected_commission_cost colonne, ou calculé 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