Berichte zu Hotelanzeigen

Mit der Google Ads API können Sie Abfragen erstellen, um die gewünschten Berichte zu Hotelanzeigen zu erhalten. Diese Abfragen können Sie dann in Ihre Clientanwendungen einbinden.

Vorbereitung

• Berichterstellung und Abfragen im Allgemeinen
• Informationen zum Abfragen verschiedener Ressourcen

Einfache Abfragen für Hotelanzeigen

Sehen Sie sich diese Beispielabfragen an, um sich mit der Verwendung der Google Ads API für Hotelanzeigenberichte vertraut zu machen.

Messwerte für Klicks abrufen

In der folgenden Beispielabfrage wird die Anzahl der Klicks aus der Ansicht „Hotelleistung“ zurückgegeben.

SELECT metrics.clicks
FROM hotel_performance_view

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort:

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

Anzeigengruppenmesswerte abrufen

Mit der folgenden Beispielabfrage für Anzeigengruppen werden Impressionen und Klicks der letzten 30 Tage nach Datum segmentiert abgerufen.

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

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort. Die Antwort wird so gefiltert, dass nur die Messwerte angezeigt werden, die die Bedingungen der WHERE-Klausel erfüllen. Da segments.date ausgewählt ist, gibt die Abfrage eine Zeile pro Tag im 30-tägigen Zeitraum zurück.

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/adGroups/11111111",
        "name": "test adgroup"
      },
      "metrics": {
        "clicks": "91",
        "impressions": "5145"
      },
      "segments": {
        "date": "2020-05-10"
      }
    }
  ]
}

Aktivierte Anzeigen in Anzeigengruppen abrufen

Mit der folgenden Beispielabfrage für Anzeigen in Anzeigengruppen werden die Anzeigengruppen abgerufen, die ausgeliefert werden. Damit eine Anzeigengruppe ausgeliefert werden kann, müssen die Anzeige in der Anzeigengruppe, die Anzeigengruppe und die Kampagne aktiviert sein.

Hinweis: Wenn ein ad_group keine ad_group_ad hat, muss eine erstellt werden. Sie können dies prüfen, indem Sie den Filter ad_group_ad.status = ENABLED entfernen.

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

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/1234567890/adGroups/11111111",
        "id": "11111111",
        "name": "test adgroup",
        "status": "ENABLED"
      },
      "adGroupAd": {
        "resourceName": "customers/1234567890/adGroupAds/11111111~33333333",
        "status": "ENABLED",
        "ad": {
          "resourceName": "customers/1234567890/ads/77777777"
        }
      }
    }
  ]
}

Nützliche Ansichten für Berichte zu Hotelanzeigen

In früheren APIs für Berichte zu Hotelanzeigen konnten Sie einen bestimmten Bericht abrufen, z. B. einen Leistungsbericht. In der Google Ads API werden diese Daten in separaten *_view-Ressourcen wie hotel_performance_view und hotel_group_view dargestellt. In diesem Abschnitt werden die *_view-Ressourcen beschrieben, die für Berichte zu Hotelanzeigen nützlich sind, und es werden Beispielabfragen aufgeführt.

Hinweis: Jede *_view-Ressource hat spezifische Ressourcenfelder, Segmente und Messwerte. Lesen Sie die Dokumentation für die jeweilige *_view-Ressource, bevor Sie die Abfrage erstellen.

Hotelgruppenansicht

Die Hotelgruppenansicht ist eine Kriterienansicht und eignet sich daher zum Abrufen von Messwerten für einen bestimmten Kriterientyp einer Hotelgruppe.

In der folgenden Beispielabfrage für Hotelgruppenansichten werden Klicks für jedes Hotel in einer Eintragsgruppe für die gesamte Baumstruktur der Hotel-Eintragsgruppe abgerufen, einschließlich des Stammknotens („Alle Hotels“).

SELECT
  metrics.clicks,
  ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort. Da case_value für den Stammknoten („Alle Hotels“) nicht definiert ist, stellt die erste Zeile die Messwerte für die Eintragsgruppe „Alle Hotels“ dar, während die zweite Zeile die Messwerte für die untergeordnete Eintragsgruppe „Sonstige“ enthält.

{
  "results": [
    {
      "metrics": {
        "clicks": "5"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111111"
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111111"
      }
    },
    {
      "metrics": {
        "clicks": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111112",
        "listingGroup": {
          "caseValue": {
            "hotelId": {}
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111112"
      }
    },
    {
      "metrics": {
        "clicks": "3"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111113",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111111"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111113"
      }
    },
    {
      "metrics": {
        "clicks": "2"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/2222222~1111114",
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111112"
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/2222222~1111114"
      }
    }
  ]
}

Hotelleistung – Ansicht

Die Hotel Performance View ist nützlich, wenn Sie Leistungsmesswerte für ein Hotel mit Daten abrufen möchten, die nicht aus einer Hotelgruppierung stammen, auch wenn Sie eine Unterteilung nach Hotel-ID haben.

In der folgenden Beispielabfrage für Hotel-Leistungsansichten werden Klicks abgerufen und die Ergebnisse nach Hotel-ID segmentiert.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort. Die Klicks werden nach partner_hotel_id (partnerHotelId in REST JSON) segmentiert, sodass für dieselbe hotel_performance_view zwei oder mehr Objekte zurückgegeben werden können.

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

Zielgruppenansicht für Anzeigengruppen

Die Anzeigengruppen-Zielgruppenansicht ist nützlich, wenn Sie Leistungsmesswerte für Zielgruppen abrufen möchten, die auf Anzeigengruppenebene angehängt sind.

Hinweis: Dies ist eine allgemeine Ansicht für verschiedene Kampagnentypen, nicht nur für Hotelkampagnen. In dieser Ansicht können Sie die Ergebnisse auch nach hotel_date_selection_type segmentieren. Damit wird angegeben, ob das Hoteldatum vom Nutzer ausgewählt wurde oder ob es sich um ein von Google festgelegtes Standarddatum für die Suche handelt. Wenn Sie nach hotel_date_selection_type segmentieren, werden nur Ergebnisse für Hotelkampagnen zurückgegeben.

Die folgende Abfrage gibt eine Zeile pro ad_group_criterion.user_list.user_list zurück.

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

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "adGroupAudienceView": {
        "resourceName":
          "customers/1234567890/adGroupAudienceViews/23456789~789456"
      },
      "segments": {
        "device": "TABLET",
        "hotelDateSelectionType": "USER_SELECTED"
      }
    }
  ]
}

Kampagnen-Zielgruppenansicht

Die Kampagnen-Zielgruppenansicht ist nützlich, wenn Sie Leistungsmesswerte für Zielgruppen abrufen möchten, die auf Kampagnenebene angehängt sind.

Hinweis : Dies ist eine allgemeine Ansicht für verschiedene Kampagnentypen, nicht nur für Hotelkampagnen. In dieser Ansicht können Sie die Ergebnisse auch nach hotel_date_selection_type segmentieren. Damit wird angegeben, ob das Hoteldatum vom Nutzer ausgewählt wurde oder ob es sich um ein von Google festgelegtes Standarddatum für die Suche handelt. Wenn Sie nach hotel_date_selection_type segmentieren, werden nur Ergebnisse für Hotelkampagnen zurückgegeben.

Die folgende Abfrage gibt eine Zeile pro campaign_criterion.user_list.user_list zurück.

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

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "campaignCriterion": {
        "resourceName": "customers/1234567890/campaignCriteria/23456789~789456",
        "userList": {
          "userList": "customers/1234567890/userLists/456789"
        }
      },
      "campaignAudienceView": {
        "resourceName":
          "customers/1234567890/campaignAudienceViews/23456789~789456"
      },
      "segments": {
        "device": "TABLET",
        "hotelDateSelectionType": "USER_SELECTED"
      }
    }
  ]
}

Nützliche Berichte für Hotelanzeigen

In diesem Abschnitt finden Sie mehrere nützliche Berichte, die speziell für Hotelanzeigen entwickelt wurden.

Leistungsberichte

In diesen Abfragen wird die Ansicht „Hotel Performance“ verwendet, um Leistungsdaten abzurufen.

Mit einem hotel_performance_view können Sie die Ressource campaign verwenden, um Messwerte zu segmentieren. Mit dem Feld campaign.id können Sie beispielsweise Leistungsmesswerte nach Kampagne abrufen.

Leistung

Beispielabfrage:

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

Beispiel für eine JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/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/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/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/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    }
  ]
}

Leistung nach Klicktyp

Hinweis: Wenn Sie metrics.search_impression_share verwenden, können Sie nicht nach click_type segmentieren.

Beispielabfrage:

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

Beispiel für eine JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123",
        "clickType": "HOTEL_PRICE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "12345",
        "clickType": "HOTEL_PRICE"
      }
    }
  ]
}

Leistungsbericht zu nutzerabhängigen Preisen

Mit der folgenden Abfrage werden Leistungsmesswerte abgerufen, die nach folgenden Kriterien segmentiert sind:

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

Eine Beschreibung der Typen finden Sie unter HotelRateType.

Eine Abfrage kann mehrere Segmente enthalten. Die Anzahl der zurückgegebenen Zeilen kann sich jedoch mit zusätzlichen Segmenten erheblich erhöhen.

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

Die Ergebnisse der Abfrage sehen in etwa so aus wie die folgende JSON-Antwort:

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "24",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.17073170731707318"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/1234567890/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "107",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1668",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.3581201665675193"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "1235",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    }
  ]
}

Bericht zur Wettbewerbsfähigkeit von Preisen

Sie können sich Statistiken dazu ansehen, wie Ihre Preise im Vergleich zu den Preisen von Mitbewerbern für dieselben Hotelreisepläne abschneiden.

Beispielabfrage:

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

Beispiel für eine JSON-Antwort:

{
  "results": [
    {
      "metrics": {
        "hotelAverageLeadValueMicros": "96416341.829268292",
        "hotelPriceDifferencePercentage": "-0.014627310872986811"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

Bericht zum durchschnittlichen Buchungspreis

Sie können die Daten abrufen, die für die Berechnung des durchschnittlichen Buchungspreises (all_conversions_value geteilt durch conversions) für Hotels erforderlich sind.

Beispielabfrage:

SELECT
  segments.hotel_center_id,
  segments.partner_hotel_id,
  segments.hotel_price_bucket,
  metrics.all_conversions_value,
  metrics.conversions
FROM hotel_performance_view

Beispiel für eine JSON-Antwort:

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "123.5",
        "conversions": "1"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

Bericht zur Conversion- und Kostenleistung

Mit der folgenden Abfrage erhalten Sie die Gesamtleistung Ihrer Hotelanzeigen in Bezug auf Conversions und Kosten. Das ist nützlich, um die finanzielle Leistung und den ROAS zu bewerten.

Beispielabfrage:

SELECT
  segments.date,
  segments.partner_hotel_id,
  metrics.all_conversions_value,
  metrics.cost_micros,
  metrics.conversions
FROM hotel_performance_view
WHERE segments.date DURING LAST_30_DAYS

Beispiel für eine JSON-Antwort:

{
  "results": [
    {
      "metrics": {
        "allConversionsValue": "250.0",
        "costMicros": "15000000",
        "conversions": "2.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

Zielgruppenberichte

In Zielgruppenberichten sehen Sie die Leistung von Gebotsfaktoren für Google Ads-Zielgruppenlisten. Beispiele für Zielgruppenberichte finden Sie in den Beispielabfragen unter Ad Group Audience View und Campaign Audience View.