Video: dai un'occhiata alla conferenza sui report di Hotel Ads durante il workshop 2019
Con l'API Google Ads puoi progettare query per ottenere i report Hotel Ads di cui hai bisogno. È quindi possibile incorporare queste query nelle applicazioni client.
Prerequisiti
- Scopri come funzionano i report e le query in generale.
- Scopri come è possibile eseguire query su risorse diverse.
Query di base per Hotel Ads
Dai un'occhiata a questi esempi di query per acquisire familiarità con l'utilizzo dei report dell'API Google Ads per Hotel Ads.
Visualizza le metriche relative ai clic
La seguente query di esempio restituisce il numero di clic dalla visualizzazione sul rendimento dell'hotel.
SELECT metrics.clicks
FROM hotel_performance_view
I risultati della query avrebbero un aspetto simile a questo:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Visualizza le metriche relative ai clic segmentati
La seguente query di esempio per le viste del rendimento degli hotel ottiene i clic e segmenta i risultati in base all'ID hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Il risultato della query sarà simile alla seguente stringa JSON.
I clic vengono segmentati per partnerHotelID
, pertanto due o più oggetti possono essere
restituiti per lo stesso hotelPerformanceView.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Visualizza le metriche del gruppo di annunci
La seguente query di esempio per i gruppi di annunci riceve impressioni e clic negli ultimi 30 giorni, segmentati per data.
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
Il risultato della query sarà simile alla seguente stringa JSON.
La risposta viene filtrata solo in base alle metriche che soddisfano le condizioni della clausola WHERE
. Il campo della data viene compilato dall'ultima data inclusa nel periodo di 30 giorni.
{
"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"
}
}
]
}
Attiva gli annunci del gruppo di annunci
La seguente query di esempio relativa agli annunci a livello di gruppo di annunci restituisce i gruppi di annunci che verranno pubblicati. Per pubblicare un gruppo di annunci, è necessario attivare l'annuncio, il gruppo di annunci e la campagna del gruppo di annunci.
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
Il risultato della query sarà simile alla seguente stringa JSON.
{
"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"
}
}
}
]
}
Viste utili per i report Hotel Ads
Nelle API precedenti per i report di Hotel Ads potevi recuperare un report specifico, ad esempio un report sul rendimento. Nell'API Google Ads, questo tipo di dati è
rappresentato in risorse *_view
separate, come hotel_performance_view
e
hotel_group_view
. Questa sezione descrive le risorse *_view
che sono
utili per i report di Hotel Ads. Vengono forniti anche esempi di query.
Tieni presente che ogni risorsa *_view
ha metriche, segmenti e campi delle risorse specifici. Consulta la documentazione della risorsa *_view
specifica prima di creare la query.
Vista gruppo di hotel
La vista gruppo di hotel è una vista criteri, perciò è utile per recuperare le metriche per un tipo di criteri specifico di un gruppo di hotel.
La seguente query di esempio per le viste dei gruppi di hotel ottiene i clic per ogni hotel in un gruppo di schede per l'intero albero del gruppo di schede di hotel, incluso il nodo radice ("Tutti gli hotel").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Il risultato della query sarà simile alla seguente stringa JSON.
Dato che case_value
non è definito per il nodo principale ("Tutti gli hotel"), è
apparente che la prima riga rappresenta le metriche per il gruppo di schede "Tutti gli hotel",
mentre la seconda riga rappresenta le metriche per il gruppo di schede secondario che rappresenta "Altro".
{
"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"
}
},
]
}
Visualizzazione rendimento hotel
La visualizzazione rendimento hotel è utile se vuoi recuperare le metriche sul rendimento di un hotel utilizzando dati che non provengono da un raggruppamento, anche se hai una suddivisione basata sull'ID hotel.
La seguente query di esempio per le viste del rendimento degli hotel ottiene i clic e segmenta i risultati in base all'ID hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Il risultato della query sarà simile alla seguente stringa JSON.
I clic vengono segmentati per partner_hotel_id
, pertanto possono essere restituiti due o più oggetti per la stessa vista rendimento hotel.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Visualizzazione pubblico gruppo di annunci
La visualizzazione del pubblico del gruppo di annunci è utile se vuoi recuperare le metriche sul rendimento per i segmenti di pubblico associati a livello di gruppo di annunci.
Tieni presente che questa è una visione generale per vari tipi di campagne, non solo quelle
per hotel. Questa vista consente inoltre di segmentare i risultati in base a
hotel_date_selection_type
, che può essere utilizzato per specificare se la data dell'hotel
è stata selezionata dall'utente o era una data predefinita per la ricerca impostata da Google. Se
segmenti in base a hotel_date_selection_type
, vengono restituiti solo i risultati relativi alle campagne per hotel.
La seguente query restituisce una riga per 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
Il risultato della query sarà simile alla seguente stringa JSON.
{
"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"
}
}
]
}
Visualizzazione pubblico della campagna
La visualizzazione del pubblico della campagna è utile se vuoi recuperare le metriche sul rendimento per i segmenti di pubblico associati a livello di campagna.
Tieni presente che questa è una visione generale per vari tipi di campagne, non solo quelle
per hotel. Questa vista consente inoltre di segmentare i risultati in base a
hotel_date_selection_type
, che può essere utilizzato per specificare se la data dell'hotel
è stata selezionata dall'utente o era una data predefinita per la ricerca impostata da Google. Se
segmenti in base a hotel_date_selection_type
, vengono restituiti solo i risultati relativi alle campagne per hotel.
La seguente query restituisce una riga per 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
Il risultato della query sarà simile alla seguente stringa JSON.
{
"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"
}
}
]
}
Report utili per Hotel Ads
Questa sezione fornisce diversi report utili progettati appositamente per gli annunci di hotel.
Report sul rendimento
Queste query utilizzano la visualizzazione del rendimento dell'hotel per ottenere dati sul rendimento.
Un elemento hotel_performance_view
consente di utilizzare la risorsa campaign
per segmentare
le metriche. Ad esempio, puoi utilizzare il campo campaign.id
per ottenere metriche sul rendimento per campagna.
Esibizione
Query di esempio:
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
Esempio di risposta 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"
}
}
]
}
Rendimento con tipo di clic
Query di esempio:
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
Esempio di risposta 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"
}
}
]
}
Report sul rendimento delle tariffe agevolate
La seguente query ottiene metriche sul rendimento segmentate per:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Per una descrizione dei tipi, consulta HotelRateType
.
È possibile includere più segmenti in una query; tuttavia, il numero di righe restituite può aumentare significativamente con segmenti aggiuntivi.
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
Il risultato della query sarà simile alla seguente stringa JSON.
{
"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"
}
}
]
}
Report sulla competitività del prezzo
Puoi ottenere informazioni sul confronto tra i tuoi prezzi e quelli della concorrenza per gli stessi itinerari di hotel.
Query di esempio:
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
Esempio di risposta JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Report sui prezzi medi prenotati
Puoi ottenere i dati necessari per calcolare il prezzo medio prenotato
(all_conversions_value
diviso per conversions
) per gli hotel.
Query di esempio:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Esempio di risposta JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Report Pubblico
I report Pubblico mostrano il rendimento dei moltiplicatori di offerta negli elenchi dei segmenti di pubblico di Google Ads. Per esempi di report Pubblico, consulta le query di esempio in Visualizzazione pubblico del gruppo di annunci e nella visualizzazione del pubblico della campagna.
Report sulla riconciliazione degli hotel
Il report Riconciliazione hotel contiene le informazioni sulle conversioni delle prenotazioni di hotel da riconciliare con i record degli inserzionisti. Puoi caricare i dati tramite caricamenti collettivi per comunicare a Google quali prenotazioni sono state annullate o completate. Di seguito sono riportate le colonne principali di questo report:
Colonna UI | Colonna API | Spiegazione |
---|---|---|
Valore della prenotazione | metrics.value_per_conversions_by_conversion_date |
Il valore di conversione riportato dal tag |
Data di conversione | segments.date |
La data della prenotazione |
Tariffa di commissione | metrics.hotel_commission_rate_micros |
La percentuale del valore della prenotazione che fai per un'impressione dell'annuncio. |
Costo delle commissioni |
Se |
L'importo che devi pagare o che hai pagato per il soggiorno degli ospiti. |