Raporlama

Video: 2019 atölyesinde yapılan Otel Reklamları raporlarıyla ilgili konuşmaya göz atın

Google Ads API ile, ihtiyacınız olan Otel Reklamları raporlarını alacak sorgular tasarlayabilirsiniz. Daha sonra bu sorguları istemci uygulamalarınıza dahil edebilirsiniz.

Ön koşullar

Otel Reklamları için temel sorgular

Otel Reklamları raporları için Google Ads API'yi kullanma hakkında bilgi edinmek istiyorsanız bu örnek sorgulara göz atın.

Tıklama metrikleri alın

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 gibi görünür:

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

Segmentlere ayrılmış tıklama sayısı metriklerini alın

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 dizesine benzer. Tıklamalar, partnerHotelID ölçütüne göre segmentlere ayrıldığından aynı HotelPerformanceView 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 metriklerini al

Reklam gruplarına yönelik aşağıdaki örnek sorgu, son 30 gün içindeki gösterim ve tıklama sayılarını tarihe göre segmentlere ayrılmış şekilde 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 dizesine benzer. Yanıt, yalnızca WHERE ifadesi koşullarını karşılayan metrikler için filtrelenir. Tarih alanı, 30 günlük döneme dahil edilen son tarihle doldurulur.

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

Etkin reklam grubu reklamlarını alın

Reklam grubu reklamları için aşağıdaki örnek sorgu, yayınlanacak reklam gruplarını alır. Herhangi bir reklam grubunun yayınlanması için reklam grubu reklamının, reklam grubunun ve kampanyanın etkinleştirilmiş olması gerekir.

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 dizesine benzer.

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

Otel Reklamları raporlaması 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ı raporlaması için yararlı olan *_view kaynakları açıklanmaktadır. Örnek sorgular da sağlanır.

Her *_view kaynağının belirli kaynak alanları, segmentleri ve metrikleri olduğunu unutmayın. 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üne ilişkin metrikleri almak için yararlıdır.

Aşağıdaki otel grubu görünümleriyle ilgili örnek sorgu, kök düğüm ("Tüm oteller") dahil olmak üzere tüm otel listeleme grubu ağacı için listeleme grubundaki her otel için tıklama 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 dizesine benzer. case_value kök düğüm ("Tüm oteller") için tanımlanmamış olduğundan, ilk satırın "Tüm oteller" giriş grubu metriklerini, ikinci satır ise "Diğer"i temsil eden alt listeleme grubu metriklerini temsil eder.

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

Otel Performansı Görünümü

Otel Kimliği'ni temel alan bir alt bölümünüz olsa bile, bir otel gruplandırmasından gelmeyen verileri kullanarak bir otelin performans metriklerini almak istiyorsanız Otel Performansı Görünümü yararlı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 dizesine benzer. Tıklamalar, partner_hotel_id ölçütüne göre segmentlere ayrıldığından aynı otel performansı görünümü 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 ekli kitleler için performans metrikleri almak istiyorsanız kullanışlıdır.

Bunun yalnızca otel kampanyaları için değil, çeşitli kampanya türleri için genel bir görünüm olduğunu unutmayın. Bu görünüm, sonuçları hotel_date_selection_type ölçütüne göre segmentlere ayırma olanağı da sağlar. Bu segment, otel tarihinin kullanıcı tarafından mı seçildiğini yoksa Google tarafından ayarlanan arama için varsayılan bir tarih mi olduğunu belirtmek için kullanılabilir. hotel_date_selection_type ölçütüne göre segmentlere ayırırsanız yalnızca otel kampanyalarıyla ilgili sonuçlar döndürülür.

Aşağıdaki sorgu, her ad_group_criterion.user_list.user_list için 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 dizesine benzer.

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

Kampanya Kitle Görünümü

Kampanya düzeyinde eklenen kitleler için performans metrikleri almak istiyorsanız Kampanya Kitle Görünümü'nden yararlanabilirsiniz.

Bunun yalnızca otel kampanyaları için değil, çeşitli kampanya türleri için genel bir görünüm olduğunu unutmayın. Bu görünüm, sonuçları hotel_date_selection_type ölçütüne göre segmentlere ayırma olanağı da sağlar. Bu segment, otel tarihinin kullanıcı tarafından mı seçildiğini yoksa Google tarafından ayarlanan arama için varsayılan bir tarih mi olduğunu belirtmek için kullanılabilir. hotel_date_selection_type ölçütüne göre segmentlere ayırırsanız yalnızca otel kampanyalarıyla ilgili sonuçlar döndürülür.

Aşağıdaki sorgu, her campaign_criterion.user_list.user_list için 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 dizesine benzer.

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

Otel Reklamları için faydalı raporlar

Bu bölümde, Otel reklamları için özel olarak tasarlanmış çeşitli yararlı raporlar sunulmaktadır.

Performans raporları

Bu sorgular, performans verilerini almak için Otel Performans Görünümü'nden yararlanır.

hotel_performance_view, metrikleri segmentlere ayırmak için campaign kaynağını kullanmanıza olanak tanır. Örneğin, kampanyaya göre performans metrikleri 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/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"
      }
    }
  ]
}

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

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

Koşullu fiyatlar performans raporu

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

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

Türlerin açıklaması için bkz. HotelRateType.

Bir sorguya birden çok segment dahil edilebilir. Ancak döndürülen satır sayısı, ek segmentlerle ö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 dizesine benzer.

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

Fiyat rekabetçiliği raporu

Aynı otel seyahat planlarında fiyatlarınızın rakiplerinizin fiyatlarına göre durumu hakkında bilgi edinebilirsiniz.

Ö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/123456789/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 üzere 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/123456789/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

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.

Otel mutabakat raporu

Otel Mutabakat raporu, reklamveren kayıtlarıyla mutabakat sağlamak için Otel rezervasyonlarından alınan dönüşüm bilgilerini içerir. Hangi rezervasyonların iptal edildiğini veya tamamlandığını Google'a bildirmek için toplu yüklemeler aracılığıyla veri yükleyebilirsiniz. Bu rapordaki ana sütunlar aşağıdaki gibidir:

Kullanıcı Arayüzü Sütunu API Sütunu Açıklama
Rezervasyon değeri metrics.value_per_conversions_by_conversion_date Etiket tarafından bildirilen dönüşüm değeri
Dönüşüm tarihi segments.date Rezervasyon tarihi
Komisyon oranı metrics.hotel_commission_rate_micros Bir reklam gösterimi için teklif ettiğiniz rezervasyon değerinin yüzdesi
Komisyon maliyeti

status == RECONCILED veya CANCELED ise bu değer metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros olarak hesaplanabilir. Diğer tüm durumlarda bu değer, metrics.hotel_expected_commission_cost sütunundan edinilebilir veya metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date olarak hesaplanabilir.

 Konaklama için ödemeniz beklenen veya ödediğiniz tutar
Önceki
Teklifleri ayarlayın