Rapporti

Video: Check out the Hotel Ads reporting talk from the 2019 workshop

Con l'API Google Ads, puoi progettare query per ottenere i report Hotel Ads di cui hai bisogno. Potrai quindi incorporare queste query nelle tue applicazioni client.

Prerequisiti

  • Scopri come funzionano in generale i report e le query.
  • Scopri come è possibile eseguire query su diverse risorse.

Query di base per Hotel Ads

Dai un'occhiata a queste query di esempio per acquisire familiarità con l'utilizzo dell'API Google Ads per i report Hotel Ads.

Recuperare 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 saranno simili a questi:

{
  "results": [
    {
      "metrics": {
        "clicks": "78090"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      }
    }
  ],
  "totalResultsCount": "1",
  "fieldMask": "metrics.clicks"
}

Ottenere metriche sui clic segmentati

La seguente query di esempio per le visualizzazioni del rendimento degli hotel recupera i 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 e pertanto possono essere restituiti due o più oggetti per la stessa visualizzazione hotelPerformanceView.

{
  "results": [
    {
      "metrics": {
        "clicks": "7055"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1111"
      }
    },
    {
      "metrics": {
        "clicks": "3047"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1112"
      }
    },
    ...
  ]
}

Visualizzare le metriche del gruppo di annunci

La seguente query di esempio per i gruppi di annunci recupera le impressioni e i 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 in modo da includere solo le metriche che soddisfano le condizioni della clausola WHERE. Il campo della data viene compilato con l'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"
      }
    }
  ]
}

Recupera gli annunci dei gruppi di annunci attivati

La seguente query di esempio per gli annunci dei gruppi di annunci recupera i gruppi di annunci che verranno pubblicati. Affinché un gruppo di annunci venga pubblicato, l'annuncio del gruppo di annunci, il gruppo di annunci e la campagna devono essere tutti attivati.

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"
        }
      }
    }
  ]
}

Visualizzazioni utili per i report sugli annunci per hotel

Nelle API precedenti per i report sugli annunci per hotel, era possibile 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 forniti anche esempi di query.

Tieni presente che ogni risorsa *_view ha campi, segmenti e metriche specifici. Consulta la documentazione della risorsa *_view specifica prima di creare la query.

Visualizzazione gruppo di hotel

La visualizzazione gruppo di hotel è una visualizzazione criteri, quindi è utile per recuperare le metriche per un tipo di criterio specifico di un gruppo di hotel.

La seguente query di esempio per le visualizzazioni dei gruppi di hotel riceve 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

I risultati della query saranno simili alla seguente stringa JSON. Dato che case_value non è definito per il nodo principale ("Tutti gli hotel"), è evidente 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 del rendimento degli hotel è utile se vuoi recuperare le metriche di rendimento di un hotel utilizzando dati che non provengono da un raggruppamento di hotel, anche se hai una suddivisione basata sull'ID hotel.

La seguente query di esempio per le visualizzazioni del rendimento degli hotel recupera i 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 pertanto possono essere restituiti due o più oggetti per la stessa visualizzazione del rendimento dell'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 del segmento di pubblico del gruppo di annunci

La visualizzazione del pubblico del gruppo di annunci è utile se vuoi recuperare le metriche sul rendimento dei segmenti di pubblico collegati a livello di gruppo di annunci.

Tieni presente che questa è una visualizzazione generale per vari tipi di campagne, non solo per le campagne per hotel. Questa visualizzazione consente anche di segmentare i risultati per 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 per 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 del segmento di pubblico della campagna

La visualizzazione del segmento di pubblico della campagna è utile se vuoi recuperare le metriche di rendimento per i segmenti di pubblico collegati a livello di campagna.

Tieni presente che questa è una visualizzazione generale per vari tipi di campagne, non solo per le campagne per hotel. Questa visualizzazione consente anche di segmentare i risultati per 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 per 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 appositamente per gli annunci per hotel.

Rapporti sul rendimento

Queste query utilizzano la visualizzazione del rendimento degli hotel per ottenere i 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 in base al 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 recupera le metriche sul rendimento segmentate per:

  • campaign
  • hotel_center_id
  • hotel_country
  • hotel_rate_rule_id
  • hotel_rate_type
  • device
  • partner_hotel_id

Consulta HotelRateType per una descrizione dei tipi.

In una query possono essere inclusi 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 ottenere informazioni su come i tuoi prezzi si confrontano con quelli della concorrenza negli 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 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 sul pubblico mostrano il rendimento dei moltiplicatori di offerta negli elenchi dei segmenti di pubblico di Google Ads. Per esempi di report sul pubblico, consulta le query di esempio in Visualizzazione pubblico gruppo di annunci e Visualizzazione pubblico campagna.

Report Riconciliazione hotel

Il report sulla riconciliazione degli hotel contiene informazioni sulle conversioni dalle prenotazioni di hotel da riconciliare con i record dell'inserzionista. Puoi caricare i dati tramite caricamenti collettivi per far sapere a Google quali prenotazioni sono state annullate o completate. Le colonne principali di questo report 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 utilizzi per fare offerte per un'impressione dell'annuncio
Costo delle commissioni

Se status == RECONCILED o CANCELED, questo valore può essere calcolato come metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. In tutti gli altri casi, questo valore può essere ottenuto dalla colonna metrics.hotel_expected_commission_cost o calcolato come metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date

 L'importo che devi pagare o che hai pagato per il soggiorno.
Indietro
Modifica le offerte
Avanti
Feed Viaggi per gli annunci della rete di ricerca