Segnalazione

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 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 dell'ospite
Indietro
Modifica le offerte