Video: guarda l'intervento sui report di Hotel Ads del workshop del 2019
Con l'API Google Ads, puoi progettare query per ottenere i report Hotel Ads di cui hai bisogno. Puoi quindi incorporare queste query nelle applicazioni client.
Prerequisiti
- Scopri come funzionano i report e le query in generale.
- Scopri come eseguire query su risorse diverse.
Query di base per gli annunci per hotel
Dai un'occhiata a questi esempi di query per acquisire familiarità con l'utilizzo dell'API Google Ads per i report sugli annunci per hotel.
Visualizza le metriche sui clic
La seguente query di esempio restituisce il numero di clic dalla visualizzazione del rendimento dell'hotel.
SELECT metrics.clicks
FROM hotel_performance_view
I risultati della query sarebbero simili ai seguenti:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Ottieni metriche sui clic segmentate
La seguente query di esempio per le visualizzazioni del rendimento degli hotel ottiene clic e segmenta i risultati in base all'ID hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
I risultati della query saranno simili alla seguente stringa JSON.
I clic sono segmentati per partnerHotelID
, pertanto possono essere
restituiti due o più oggetti 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 ottiene 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
I risultati della query saranno simili alla seguente stringa JSON.
La risposta viene filtrata solo per le metriche che soddisfano le condizioni della clausola WHERE
. Il campo Data è 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 annunci del gruppo di annunci
La seguente query di esempio per gli annunci del gruppo di annunci restituisce i gruppi di annunci che verranno pubblicati. Per poter pubblicare qualsiasi gruppo di annunci, è necessario attivare tutti gli annunci, il gruppo di annunci e la campagna.
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
I risultati della query saranno simili 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 di 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
utili per i report di Hotel Ads. Vengono fornite anche query di esempio.
Tieni presente che ogni risorsa *_view
ha metriche, segmenti e campi di risorse specifici. Consulta la documentazione per la risorsa *_view
specifica prima
di creare la tua query.
Vista gruppo di hotel
La vista gruppo di hotel è una vista criteri, perciò è utile per recuperare metriche per un tipo di criteri specifico di un gruppo di hotel.
La seguente query di esempio per le visualizzazioni dei gruppi di hotel ottiene clic per ogni hotel in un gruppo di schede per l'intera struttura ad albero dei gruppi di hotel, incluso il nodo principale ("Tutti gli hotel").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
I risultati della query saranno simili alla seguente stringa JSON.
Dato che case_value
non è definito per il nodo principale ("Tutti gli hotel"), è apparentemente che la prima riga rappresenti le metriche per il gruppo di schede "Tutti gli hotel", mentre la seconda
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 di hotel, anche se disponi di una suddivisione basata sull'ID hotel.
La seguente query di esempio per le visualizzazioni del rendimento degli hotel ottiene clic e segmenta i risultati in base all'ID hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
I risultati della query saranno simili alla seguente stringa JSON.
I clic sono segmentati per partner_hotel_id
e, di conseguenza, possono essere restituiti due o più oggetti per la stessa visualizzazione del rendimento degli 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 per recuperare metriche sul rendimento per segmenti di pubblico associati a livello di gruppo di annunci.
Tieni presente che questa è una visualizzazione generale per vari tipi di campagne, non solo per quelle
per hotel. Questa vista consente anche 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
per le 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
I risultati della query saranno simili 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 pubblico della campagna è utile se vuoi recuperare metriche sul rendimento per segmenti di pubblico associati a livello di campagna.
Tieni presente che questa è una visualizzazione generale per vari tipi di campagne, non solo per quelle
per hotel. Questa vista consente anche 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
per le 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
I risultati della query saranno simili 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 specificamente per gli annunci per hotel.
Report sul rendimento
Queste query utilizzano la visualizzazione rendimento degli hotel per ottenere dati sul rendimento.
Un hotel_performance_view
ti 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.
Rendimento
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 il 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 le metriche sul rendimento segmentate per:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Consulta la pagina HotelRateType
per una
descrizione dei tipi.
In una query è possibile includere più segmenti; tuttavia, il numero di righe restituite può aumentare in modo significativo 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
I risultati della query saranno simili 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 confrontare i tuoi prezzi con 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 sul prezzo medio prenotato
Puoi ottenere i dati necessari per calcolare il prezzo medio prenotato
(all_conversions_value
diviso 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, guarda le query di esempio in Visualizzazione pubblico del gruppo di annunci e Visualizzazione del pubblico della campagna.
Report sulla riconciliazione hotel
Il report sulla riconciliazione degli hotel contiene informazioni sulle conversioni relative alle prenotazioni di hotel da riconciliare con i record dell'inserzionista. Puoi caricare i dati tramite caricamenti collettivi per comunicare a Google quali prenotazioni sono state annullate o completate. Le colonne principali di questo rapporto sono le seguenti:
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 offerte per un'impressione dell'annuncio |
Costo delle commissioni |
Se |
L'importo che devi pagare o che hai pagato per il soggiorno dell'ospite |