Raporlama

. Video: 2019 atölyesindeki 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

Oteller için Google Ads API'nin kullanımı hakkında bilgi edinmek üzere bu örnek sorgulara göz atın Reklam raporları.

Tıklama metrikleri alın

Aşağıdaki örnek sorgu, otelden gelen tıklamaların sayısını döndürür performans görünümü.

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ıklama ve segment alır Otel Kimliğine göre sıralanabilir.

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 iki veya daha fazla nesne aynı HotelPerformanceView için döndürüldü.

{
  "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 ilişkin aşağıdaki örnek sorgu, son 30 gün, tarihe göre segmentlere ayrılmış.

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 ifadesini karşılayan metrikler için filtrelenir koşullar. Tarih alanı, 30 gün içindeki son tarihle doldurulur geçerlidir.

{
  "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ştirilmelidir.

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ı raporlamasının önceki API'lerinde belirli bir raporu, performans raporu gibi. Google Ads API'de bu tür veriler hotel_performance_view ve*_view hotel_group_view. Bu bölümde, şu kriterlere uyan *_view kaynakları açıklanmaktadır: Bu durum, Otel Reklamları raporlaması için yararlıdır. Örnek sorgular da sağlanır.

Her *_view kaynağının belirli kaynak alanları, segmentleri ve kullanabilirsiniz. Öncesinde *_view kaynağının dokümanlarına bakın en iyisidir.

Otel Grubu Görünümü

Otel Grubu Görünümü bir ölçüttür görünümü olduğundan, metrikleri almak için seçeneğini belirleyin.

Aşağıdaki otel grubu görünümleriyle ilgili örnek sorgu, şu konumdaki her otel için tıklama alır: Kök düğüm dahil olmak üzere otel girişi grubu ağacının tamamı için bir listeleme grubu ("Tüm oteller").

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" metriklerini temsil ettiğini ve giriş grubuna ait metrikleri gösterir. İkinci satır ise alt listeleme grubuna ait metrikleri gösterir. 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 Performansı Görünümü, gelmeyen verileri kullanarak bir otelin performans metriklerini almak istiyorsanız otel kimliğine dayalı bir alt bölümünüz olsa bile bu özelliği otel gruplandırmasından ayırt edebilirsiniz.

Otel performansı görünümleri için aşağıdaki örnek sorgu, tıklama ve segment alır Otel Kimliğine göre sıralanabilir.

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 iki veya daha fazla nesne aynı otel performansı görünümü için döndürülür.

{
  "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 grubuna ekli kitlelere ilişkin performans metriklerini almak istiyorsanız seviyesinde olmalıdır.

Bunun yalnızca otel değil, çeşitli kampanya türleri için genel bir görünüm olduğunu unutmayın. kampanyaları. Bu görünüm, sonuçları aşağıdakilere göre segmentlere ayırma olanağı da sunar: Otel tarihinin geçerli olup olmadığını belirtmek için kullanılabilir: hotel_date_selection_type tarafından seçilen veya Google tarafından ayarlanan arama için varsayılan bir tarih olan değer. Eğer hotel_date_selection_type ölçütüne göre segmentlere ayırırsanız yalnızca otel kampanyalarına ilişkin sonuçlar geri döndü.

Aşağıdaki sorgu, her satır için bir satır döndürür ad_group_criterion.user_list.user_list

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ü, kampanyaya ekli kitlelere ilişkin performans metriklerini almak istiyorsanız seviyesinde olmalıdır.

Bunun yalnızca otel değil, çeşitli kampanya türleri için genel bir görünüm olduğunu unutmayın. kampanyaları. Bu görünüm, sonuçları aşağıdakilere göre segmentlere ayırma olanağı da sunar: Otel tarihinin geçerli olup olmadığını belirtmek için kullanılabilir: hotel_date_selection_type tarafından seçilen veya Google tarafından ayarlanan arama için varsayılan bir tarih olan değer. Eğer hotel_date_selection_type ölçütüne göre segmentlere ayırırsanız yalnızca otel kampanyalarına ilişkin sonuçlar geri döndü.

Aşağıdaki sorgu, her satır için bir satır döndürür campaign_criterion.user_list.user_list

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 için özel olarak tasarlanmış çeşitli yararlı raporlar sunulmaktadır reklam.

Performans raporları

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

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

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

Ayrıntılı bilgi için HotelRateType adresini ziyaret edin. ve tür açıklamaları.

Bir sorguya birden çok segment dahil edilebilir; ancak döndürülen öğelerin sayısı 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

Fiyatlarınızın rakiplerinize kıyasla ne durumda olduğu hakkında bilgi edinebilirsiniz fiyatları aynı otel seyahat planlarını kullanın.

Ö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

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

Ö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 kitlesindeki teklif çarpanlarının performansını gösterir listeler. Kitle raporu örnekleri için Reklam Grubu sekmesindeki örnek sorgulara bakın. Kitle Görünümü ve Kampanya Kitlesi Göster.

Otel mutabakat raporu

Otel Mutabakat raporu şunu içerir: reklamverenle mutabakat sağlamak için Otel rezervasyonlarından alınan dönüşüm bilgileri kayıtları. Google'ın hangi verileri toplu yüklemelerle bilmesi için rezervasyonları iptal edildi veya tamamlandı. Bu rapordaki ana sütunlar şunlardır: şöyle olur:

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ğeri 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ütunu veya metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date olarak hesaplanır

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