Raporlama

Video: 2019 atölye çalışmasındaki 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. Ardından bu sorguları istemci uygulamalarınıza dahil edebilirsiniz.

Ön koşullar

Otel Reklamları için temel sorgular

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

Tıklama metriklerini alma

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

Sorgunun sonuçları şu şekilde görünür:

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

Segmentlere ayrılmış tıklama metriklerini alma

Otel performansı görünümleriyle ilgili 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür. Tıklamalar partnerHotelID ile segmentlere ayrılır. Bu nedenle, 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ıyla ilgili aşağıdaki örnek sorgu, son 30 gün içindeki gösterimleri ve tıklamaları tarihe göre segmentlere ayırarak 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür. 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"
      }
    }
  ]
}

Etkinleştirilmiş reklam grubu reklamlarını alma

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ştirilmesi 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür.

{
  "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ı raporlaması 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 gösterilir. 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 belirli *_view kaynağı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ü olduğundan otel grubunun belirli bir ölçüt türüne ait metrikleri almak için kullanışlıdır.

Otel grubu görünümleriyle ilgili 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 grubunda yer alan 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür. Kök düğüm ("Tüm oteller") için case_value tanımlanmadığından, ilk satırın "Tüm oteller" listeleme grubunun metriklerini, ikinci satırın ise "Diğer"i temsil eden alt listeleme grubunun metriklerini temsil ettiği anlaşılmaktadı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ü, Otel Kimliği'ne göre 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ümleriyle ilgili 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür. Tıklamalar partner_hotel_id ile segmentlere ayrılır. Bu nedenle, 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 eklenen kitlelerin performans metriklerini almak istediğinizde kullanışlıdır.

Bu görünümün 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'ya göre segmentlere ayırma olanağı da sunar. Bu özellik, 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 amacıyla kullanılabilir. hotel_date_selection_type ile segmentlere ayırırsanız yalnızca otel kampanyalarıyla ilgili 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür.

{
  "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üzeyinde eklenen kitlelerin performans metriklerini almak istediğinizde kullanışlıdır.

Bu görünümün 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'ya göre segmentlere ayırma olanağı da sunar. Bu özellik, 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 amacıyla kullanılabilir. hotel_date_selection_type ile segmentlere ayırırsanız yalnızca otel kampanyalarıyla ilgili 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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür.

{
  "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, özellikle otel reklamları için tasarlanmış çeşitli faydalı raporlar yer almaktadı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/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 fiyat performansı raporu

Aşağıdaki sorgu, performans metriklerini şu şekilde 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 bölümüne bakın.

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

Sorgunun sonuçları aşağıdaki JSON dizesine benzer şekilde görünür.

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

Fiyatlarınızın, aynı otel seyahat planlarındaki rakiplerinizin fiyatlarıyla nasıl karşılaştırıldığı 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 rezerve edilen fiyat raporu

Oteller için ortalama rezerve edilen fiyatı (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 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ükleme yoluyla yükleyebilirsiniz. Bu rapordaki ana sütunlar şunlardır:

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 verdiğ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 ödemenizin beklendiği veya ödediğiniz tutar
Önceki
Teklifleri ayarlayın
Sonraki
Arama Ağı Reklamları için Seyahat Feed'leri