Otel Reklamları raporları

Google Ads API ile ihtiyacınız olan Otel Reklamları raporlarını almak için sorgular tasarlayabilirsiniz. Ardından bu sorguları istemci uygulamalarınıza dahil edebilirsiniz.

Ön koşullar

• Raporlama ve sorguların genel olarak nasıl çalıştığını öğrenin.
• Farklı kaynakların nasıl sorgulanabileceğini öğrenin.

Otel reklamları için temel sorgular

Otel Reklamları raporları için Google Ads API'yi kullanma hakkında bilgi edinmek üzere aşağıdaki örnek sorgulara göz atın.

Tıklama metriklerini alma

Aşağıdaki örnek sorgu, otel performans görünümünden tıklama sayısını döndürür.

SELECT metrics.clicks
FROM hotel_performance_view

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer:

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

Reklam grubu metriklerini alma

Reklam grupları için aşağıdaki örnek sorgu, son 30 gün içindeki gösterimleri ve tıklamaları tarihe göre segmentlere ayrılmış olarak alır.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer. Yanıt, yalnızca WHERE yan tümcesi koşullarını karşılayan metrikler için filtrelenir. segments.date seçildiğinden sorgu, 30 günlük aralıkta her gün için bir satır döndürür.

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

Etkin reklam grubu reklamlarını alma

Reklam grubu reklamları için aşağıdaki örnek sorgu, yayınlanacak reklam gruplarını alır. Bir reklam grubunun yayınlanabilmesi için reklam grubu reklamının, reklam grubunun ve kampanyanın etkinleştirilmesi gerekir.

Not: ad_group için ad_group_ad yoksa bir tane oluşturulmalıdır. ad_group_ad.status = ENABLED filtresini kaldırarak bunu kontrol edebilirsiniz.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer:

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

Otel reklamları raporları için faydalı görünümler

Otel Reklamları raporları için önceki API'lerde, performans raporu gibi belirli bir raporu alabiliyordunuz. Google Ads API'de bu tür veriler, hotel_performance_view ve hotel_group_view gibi ayrı *_view kaynaklarında temsil edilir. Bu bölümde, Otel Reklamları raporları için yararlı olan *_view kaynakları ve örnek sorgular açıklanmaktadır.

Not: Her *_view kaynağının belirli kaynak alanları, segmentleri ve metrikleri vardır. Sorgunuzu oluşturmadan önce ilgili *_view kaynağının belgelerine bakın.

Otel Grubu Görünümü

Otel Grubu Görünümü bir ölçüt görünümüdür. Bu nedenle, bir otel grubunun belirli bir ölçüt türüyle ilgili metrikleri almak için kullanışlıdır.

Otel grubu görüntülemeleri için aşağıdaki örnek sorgu, kök düğüm ("Tüm oteller") dahil olmak üzere tüm otel listeleme grubu ağacındaki bir listeleme grubundaki her otel için tıklama sayısını alır.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer. Kök düğüm ("Tüm oteller") için case_value tanımlanmadığından ilk satır "Tüm oteller" listeleme grubunun metriklerini, ikinci satır ise "Diğer"i temsil eden alt listeleme grubunun metriklerini gösterir.

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

Otel Performansı Görünümü

Otel Performansı Görünümü, otel kimliğine dayalı bir alt bölümünüz olsa bile otel gruplandırmasından gelmeyen verileri kullanarak bir otelin performans metriklerini almak istediğinizde kullanışlıdır.

Otel performansı görünümleri için aşağıdaki örnek sorgu, tıklamaları alır ve sonuçları otel kimliğine göre segmentlere ayırır.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer. Tıklamalar partner_hotel_id (REST JSON'da partnerHotelId) ile segmentlere ayrılır. Bu nedenle, aynı hotel_performance_view için iki veya daha fazla nesne döndürülebilir.

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

Reklam Grubu Kitle Görünümü

Reklam Grubu Kitle Görünümü, reklam grubu düzeyinde eklenen kitlelerin performans metriklerini almak istediğinizde kullanışlıdır.

Not: Bu, yalnızca otel kampanyaları için değil, çeşitli kampanya türleri için genel bir görünümdür. Bu görünümde, sonuçları hotel_date_selection_type ölçütüne göre segmentlere ayırma olanağı da sunulur. Bu ölçüt, otel tarihinin kullanıcı tarafından mı seçildiğini yoksa Google tarafından belirlenen varsayılan bir arama tarihi mi olduğunu belirtir. hotel_date_selection_type segmentine göre segmentlere ayırırsanız yalnızca otel kampanyalarının sonuçları döndürülür.

Aşağıdaki sorgu, ad_group_criterion.user_list.user_list başına bir satır döndürür.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer:

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

Kampanya Kitle Görünümü

Kampanya Kitle Görünümü, kampanya düzeyinde eklenen kitlelerin performans metriklerini almak istediğinizde kullanışlıdır.

Not: Bu, yalnızca otel kampanyaları için değil, çeşitli kampanya türleri için genel bir görünümdür. Bu görünümde, sonuçları hotel_date_selection_type değerine göre segmentlere ayırma olanağı da sunulur. Bu değer, otel tarihinin kullanıcı tarafından mı seçildiğini yoksa Google tarafından belirlenen varsayılan bir arama tarihi mi olduğunu belirtir. hotel_date_selection_type segmentine göre segmentlere ayırırsanız yalnızca otel kampanyalarının sonuçları döndürülür.

Aşağıdaki sorgu, campaign_criterion.user_list.user_list başına bir satır döndürür.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer:

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

Otel Reklamları için faydalı raporlar

Bu bölümde, Otel Reklamları için özel olarak tasarlanmış birkaç faydalı rapor sunulmaktadır.

Performans raporları

Bu sorgular, performans verilerini almak için Otel Performansı görünümünü kullanır.

hotel_performance_view, metrikleri segmentlere ayırmak için campaign kaynağını kullanmanıza olanak tanır. Örneğin, kampanyaya göre performans metriklerini almak için campaign.id alanını kullanabilirsiniz.

Performans

Örnek sorgu:

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

Örnek JSON yanıtı:

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

Tıklama türüne göre performans

Not: metrics.search_impression_share kullanıyorsanız click_type ölçütüne göre segmentasyon yapamazsınız.

Örnek sorgu:

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

Örnek JSON yanıtı:

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

Koşullu fiyatlar performans raporu

Aşağıdaki sorgu, performans metriklerini şu ölçütlere göre segmentlere ayırır:

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

Türlerin açıklaması için HotelRateType başlıklı makaleyi inceleyin.

Bir sorguya birden fazla segment dahil edilebilir. Ancak ek segmentlerle birlikte döndürülen satır sayısı önemli ölçüde artabilir.

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

Sorgudan elde edilen sonuçlar aşağıdaki JSON yanıtına benzer:

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

Fiyat rekabetçiliği raporu

Aynı otel seyahat planlarında fiyatlarınızın rakiplerinizin fiyatlarıyla nasıl karşılaştırıldığına dair analizler alabilirsiniz.

Örnek sorgu:

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

Örnek JSON yanıtı:

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

Ortalama rezervasyon fiyatı raporu

Oteller için ortalama rezervasyon fiyatını (all_conversions_value bölü conversions) hesaplamak için gereken verileri alabilirsiniz.

Örnek sorgu:

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

Örnek JSON yanıtı:

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

Dönüşüm ve maliyet performansı raporu

Aşağıdaki sorgu, otel reklamlarınızın genel dönüşüm ve maliyet performansını alır. Bu, finansal performansı ve ROAS'ı değerlendirmek için kullanışlıdır.

Örnek sorgu:

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

Örnek JSON yanıtı:

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

Kitle raporları

Kitle raporları, Google Ads kitle listelerindeki teklif çarpanlarının performansını gösterir. Kitle raporu örnekleri için Reklam Grubu Kitle Görünümü ve Kampanya Kitle Görünümü'ndeki örnek sorgulara bakın.