Reporting

Video: guarda l'intervento sui report di Hotel Ads durante il 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

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 gli hotel Report sugli annunci.

Visualizza le metriche sui clic

La seguente query di esempio restituisce il numero di clic provenienti dall'hotel vista del rendimento.

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 relativa alle visualizzazioni del rendimento degli hotel ottiene clic e segmenti i risultati per 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 quindi due o più oggetti possono essere restituito 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 nelle 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 la clausola WHERE le condizioni di traffico. Il campo Data è compilato dall'ultima data inclusa nei 30 giorni punto.

{
  "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, l'annuncio, il gruppo di annunci e la campagna devono essere essere tutti abilitati.

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 viene rappresentati in risorse *_view separate, come hotel_performance_view e hotel_group_view. Questa sezione descrive le risorse *_view che vengono utili per i report di Hotel Ads. Vengono fornite anche query di esempio.

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

Vista gruppo di hotel

La vista gruppo di hotel è un criterio , 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 del gruppo di schede degli 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"), apparente che la prima riga rappresenta le metriche per "Tutti gli hotel" scheda mentre la seconda riga rappresenta le metriche del 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 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 relativa alle visualizzazioni del rendimento degli hotel ottiene clic e segmenti i risultati per 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 quindi due o più oggetti possono per la stessa vista 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 pubblico gruppo di annunci

La visualizzazione del pubblico del gruppo di annunci è utile se: Vuoi recuperare metriche sul rendimento per i segmenti di pubblico associati al gruppo di annunci. livello.

Tieni presente che questa è una visualizzazione generale di vari tipi di campagne, non solo di hotel. campagne. Questa vista consente anche di segmentare i risultati per hotel_date_selection_type, che può essere utilizzato per specificare se la data dell'hotel è stato selezionato dall'utente o era una data predefinita per la ricerca impostata da Google. Se segmenti per hotel_date_selection_type, solo i risultati delle campagne per hotel vengono restituito.

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 i segmenti di pubblico associati alla campagna. livello.

Tieni presente che questa è una visualizzazione generale di vari tipi di campagne, non solo di hotel. campagne. Questa vista consente anche di segmentare i risultati per hotel_date_selection_type, che può essere utilizzato per specificare se la data dell'hotel è stato selezionato dall'utente o era una data predefinita per la ricerca impostata da Google. Se segmenti per hotel_date_selection_type, solo i risultati delle campagne per hotel vengono restituito.

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 hotel annunci.

Rapporti sul rendimento

Queste query utilizzano la visualizzazione rendimento degli hotel per ottenere dati sul rendimento.

Un hotel_performance_view consente di utilizzare la risorsa campaign per segmentare metriche di valutazione. Ad esempio, puoi utilizzare il campo campaign.id per ottenere dati sul rendimento metriche per campagna.

Prestazioni

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

Visita HotelRateType per la descrizione dei tipi.

In una query possono essere inclusi più segmenti; tuttavia, il numero di errori restituiti possono 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 sul confronto tra i tuoi prezzi e quelli della concorrenza prezzi nella 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 per il pubblico di Google Ads elenchi. Per esempi di report Pubblico, guarda gli esempi di query in Gruppo di annunci Visualizzazione pubblico e Pubblico della campagna Vista.

Report sulla riconciliazione hotel

Il report Hotel Reconciliation contiene informazioni sulle conversioni delle prenotazioni di hotel da riconciliare con l'inserzionista record. Puoi caricare i dati tramite caricamenti collettivi per comunicare a Google quali le prenotazioni sono state annullate o completate. Le colonne principali di questo report sono che segue:

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, allora può essere calcolato come metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros. In tutti gli altri casi, questo valore può essere ottenuto metrics.hotel_expected_commission_cost colonna oppure 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