Bu sayfa, Cloud Translation API ile çevrilmiştir.

Raporlama

Video: 2019 atölyesinde gerçekleştirilen Otel Reklamları raporlama konuşmasına göz atın

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

Ön koşullar

Raporlama ve sorguların genel olarak nasıl işlediğini öğrenin.
Farklı kaynakların nasıl sorgulanabileceği hakkında bilgi edinin.

Otel Reklamları için temel sorgular

Otel Reklamları için Google Ads API'nin nasıl kullanıldığını öğrenmek için bu örnek sorgulara göz atın.

Tıklama metrikleri alın

Aşağıdaki örnek sorgu, otel performansı görünümündeki 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 metrikleri alın

Otel performansı görünümleri için aşağıdaki örnek sorgu tıklama 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 etiketine göre segmentlere ayrılır. Böylece 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 alma

Reklam gruplarına yönelik aşağıdaki örnek sorgu, tarihe göre segmentlere ayrılmış şekilde son 30 gün üzerinden gösterim ve tıklama 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 koşulu koşullarını karşılayan metrikler için filtrelenir. Tarih alanı, 30 günlük döneme dahil olan 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

Reklam grubu reklamlarına yönelik aşağıdaki örnek sorgu, sunulacak reklam gruplarını alır. Bir reklam grubunun yayınlanabilmesi için reklam grubu reklamının, reklam grubunun ve kampanyanın tümünü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

Önceki Otel Reklamları raporlaması API'lerinde, 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 faydalı olan *_view kaynakları açıklanmaktadır. Örnek sorgular da sağlanmıştı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 dokümanlarına 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 metriklerin alınması açısından yararlıdır.

Otel grubu görünümleriyle ilgili aşağıdaki örnek sorgu, kök düğüm ("Tüm oteller") dahil otel listeleme grubu ağacının tamamı 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" listeleme grubuna ait metrikleri, ikinci satırın ise "Diğer"i temsil eden alt listeleme grubunun metriklerini temsil ettiği açıktır.

{
  "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 Performansı Görünümü, bir otel grubuna ait olmayan verileri kullanarak bir otelle ilgili performans metriklerini almak istediğinizde (Otel Kimliğine göre bir alt bölümünüz olsa bile) kullanışlıdır.

Otel performansı görünümleri için aşağıdaki örnek sorgu tıklama 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 etiketine göre segmentlere ayrılır. Böylece 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üzeyine eklenmiş kitleler için performans metriklerini almak istediğinizde 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 sunar. Bu özellik, otel tarihinin kullanıcı tarafından mı seçildiğini yoksa Google tarafından arama için varsayılan bir tarih mi olduğunu belirtmek için kullanılabilir. hotel_date_selection_type etiketine göre segmentlere ayırırsanız yalnızca otel kampanyalarının 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 Kitle Görünümü, kampanya düzeyine eklenmiş kitleler için performans metriklerini almak istediğinizde yararlı olur.

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ış birkaç faydalı rapor 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 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/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ü ile 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, performans metriklerini şu ölçüte 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 bkz. HotelRateType.

Bir sorguya birden çok segment dahil edilebilir. Ancak, döndürülen satırların 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ındaki fiyatlarınızın rakiplerinizin fiyatlarına kıyasla ne durumda olduğu hakkında analizler 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 ayrılmış fiyat raporu

Otellerin 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/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 raporlarına ilişkin örnekler için Reklam Grubu Kitle Görünümü ve Kampanya Kitlesi 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 elde edilen dönüşüm bilgilerini içerir. Hangi rezervasyonların iptal edildiğini veya tamamlandığını Google'a bildirmek için verileri toplu yüklemeler aracılığıyla 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`	Etiketin bildirdiği dönüşüm değeri
Dönüşüm tarihi	`segments.date`	Rezervasyonun 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 elde edilebilir veya `metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date` olarak hesaplanabilir.	Konaklama için ödemeniz beklenen veya ödediğiniz tutar

Teklifleri ayarlayın