Video: Xem bài nói chuyện về báo cáo Quảng cáo khách sạn trong hội thảo năm 2019
Với API Google Ads, bạn có thể thiết kế các truy vấn để nhận báo cáo Quảng cáo khách sạn mà bạn cần. Sau đó, bạn có thể kết hợp các truy vấn này vào ứng dụng khách của mình.
Điều kiện tiên quyết
- Tìm hiểu cách hoạt động của báo cáo và truy vấn nói chung.
- Tìm hiểu cách truy vấn các tài nguyên khác nhau.
Truy vấn cơ bản cho Quảng cáo khách sạn
Hãy xem những truy vấn mẫu này để làm quen với cách sử dụng Google Ads API cho báo cáo Quảng cáo khách sạn.
Nhận chỉ số lượt nhấp
Truy vấn ví dụ sau đây trả về số lượt nhấp từ chế độ xem hiệu suất của khách sạn.
SELECT metrics.clicks
FROM hotel_performance_view
Kết quả của truy vấn sẽ có dạng như sau:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Nhận chỉ số lượt nhấp được phân đoạn
Cụm từ tìm kiếm ví dụ sau đây cho chế độ xem hiệu suất khách sạn sẽ nhận được lượt nhấp và phân đoạn kết quả theo Mã khách sạn.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
Lượt nhấp được phân đoạn theo partnerHotelID và do đó, hai hoặc nhiều đối tượng có thể được trả về cho cùng một hotelPerformanceView.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Nhận các chỉ số về nhóm quảng cáo
Ví dụ sau đây là truy vấn cho nhóm quảng cáo, nhận được số lượt hiển thị và số lượt nhấp trong 30 ngày qua, được phân đoạn theo ngày.
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
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
Phản hồi được lọc để chỉ có những chỉ số đáp ứng các điều kiện của mệnh đề WHERE. Trường ngày được điền sẵn ngày cuối cùng trong khoảng thời gian 30 ngày.
{
"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"
}
}
]
}
Nhận quảng cáo của nhóm quảng cáo đã bật
Cụm từ tìm kiếm ví dụ sau đây cho quảng cáo nhóm quảng cáo sẽ nhận được các nhóm quảng cáo sẽ phân phát. Để phân phát, mọi nhóm quảng cáo, quảng cáo trong nhóm quảng cáo và chiến dịch đều phải được bật.
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
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
{
"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"
}
}
}
]
}
Các chế độ xem hữu ích cho báo cáo Quảng cáo khách sạn
Trong các API trước đây để báo cáo Quảng cáo khách sạn, bạn có thể truy xuất một báo cáo cụ thể, chẳng hạn như báo cáo hiệu suất. Trong Google Ads API, loại dữ liệu này được biểu thị trong các tài nguyên *_view riêng biệt, chẳng hạn như hotel_performance_view và hotel_group_view. Phần này mô tả các tài nguyên *_view hữu ích cho báo cáo Quảng cáo khách sạn. Các truy vấn mẫu cũng được cung cấp.
Xin lưu ý rằng mỗi tài nguyên *_view đều có các trường tài nguyên, phân khúc và chỉ số cụ thể. Tham khảo tài liệu về tài nguyên *_view cụ thể trước khi tạo truy vấn.
Chế độ xem nhóm khách sạn
Chế độ xem nhóm khách sạn là một chế độ xem tiêu chí, vì vậy, chế độ này hữu ích khi truy xuất các chỉ số cho một loại tiêu chí cụ thể của một nhóm khách sạn.
Cụm từ tìm kiếm ví dụ sau đây cho chế độ xem nhóm khách sạn sẽ nhận được số lượt nhấp cho từng khách sạn trong một nhóm trang thông tin cho toàn bộ cây nhóm trang thông tin khách sạn, bao gồm cả nút gốc ("Tất cả khách sạn").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
Vì case_value không được xác định cho nút gốc ("Tất cả khách sạn"), nên rõ ràng hàng đầu tiên đại diện cho các chỉ số của nhóm trang thông tin "Tất cả khách sạn", trong khi hàng thứ hai đại diện cho các chỉ số của nhóm trang thông tin con đại diện cho "Khác".
{
"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"
}
},
]
}
Chế độ xem hiệu suất của khách sạn
Chế độ xem hiệu suất khách sạn rất hữu ích nếu bạn muốn truy xuất các chỉ số hiệu suất của một khách sạn bằng dữ liệu không thuộc nhóm khách sạn, ngay cả khi bạn có một phân mục dựa trên Mã khách sạn.
Cụm từ tìm kiếm ví dụ sau đây cho chế độ xem hiệu suất khách sạn sẽ nhận được lượt nhấp và phân đoạn kết quả theo Mã khách sạn.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
Lượt nhấp được phân đoạn theo partner_hotel_id và do đó, hai hoặc nhiều đối tượng có thể được trả về cho cùng một chế độ xem hiệu suất của khách sạn.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Chế độ xem đối tượng của nhóm quảng cáo
Chế độ xem đối tượng của nhóm quảng cáo rất hữu ích nếu bạn muốn truy xuất các chỉ số hiệu suất cho đối tượng được đính kèm ở cấp nhóm quảng cáo.
Xin lưu ý rằng đây là chế độ xem chung cho nhiều loại chiến dịch, không chỉ là chiến dịch khách sạn. Chế độ xem này cũng cung cấp khả năng phân đoạn kết quả theo hotel_date_selection_type. Bạn có thể dùng chế độ xem này để chỉ định xem người dùng đã chọn ngày của khách sạn hay đó là ngày mặc định cho cụm từ tìm kiếm do Google đặt. Nếu bạn phân đoạn theo hotel_date_selection_type, thì chỉ kết quả cho chiến dịch khách sạn mới được trả về.
Truy vấn sau đây trả về một hàng cho mỗi 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
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
{
"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"
}
}
]
}
Chế độ xem đối tượng của chiến dịch
Chế độ xem đối tượng của chiến dịch rất hữu ích nếu bạn muốn truy xuất các chỉ số hiệu suất cho đối tượng được đính kèm ở cấp chiến dịch.
Xin lưu ý rằng đây là chế độ xem chung cho nhiều loại chiến dịch, không chỉ là chiến dịch khách sạn. Chế độ xem này cũng cung cấp khả năng phân đoạn kết quả theo hotel_date_selection_type. Bạn có thể dùng chế độ xem này để chỉ định xem người dùng đã chọn ngày của khách sạn hay đó là ngày mặc định cho cụm từ tìm kiếm do Google đặt. Nếu bạn phân đoạn theo hotel_date_selection_type, thì chỉ kết quả cho chiến dịch khách sạn mới được trả về.
Truy vấn sau đây trả về một hàng cho mỗi 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
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
{
"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"
}
}
]
}
Các báo cáo hữu ích cho Quảng cáo khách sạn
Phần này cung cấp một số báo cáo hữu ích được thiết kế riêng cho quảng cáo Khách sạn.
Báo cáo hiệu suất
Các truy vấn này sử dụng Chế độ xem hiệu suất của khách sạn để lấy dữ liệu hiệu suất.
hotel_performance_view cho phép bạn sử dụng tài nguyên campaign để phân đoạn các chỉ số. Ví dụ: bạn có thể sử dụng trường campaign.id để nhận các chỉ số hiệu suất theo chiến dịch.
Hiệu suất
Cụm từ tìm kiếm mẫu:
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
Ví dụ về phản hồi JSON:
{
"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"
}
}
]
}
Hiệu suất theo loại lượt nhấp
Cụm từ tìm kiếm mẫu:
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
Ví dụ về phản hồi JSON:
{
"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"
}
}
]
}
Báo cáo hiệu suất giá phòng có điều kiện
Truy vấn sau đây sẽ nhận được các chỉ số hiệu suất được phân đoạn theo:
campaignhotel_center_idhotel_countryhotel_rate_rule_idhotel_rate_typedevicepartner_hotel_id
Hãy xem HotelRateType để biết nội dung mô tả về các loại.
Bạn có thể đưa nhiều phân khúc vào một truy vấn; tuy nhiên, số lượng hàng được trả về có thể tăng đáng kể khi có thêm phân khúc.
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
Kết quả của truy vấn sẽ có dạng như chuỗi JSON sau.
{
"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"
}
}
]
}
Báo cáo sức cạnh tranh về giá
Bạn có thể xem thông tin chi tiết về mức giá của mình so với mức giá của đối thủ cạnh tranh cho cùng một hành trình khách sạn.
Cụm từ tìm kiếm mẫu:
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
Ví dụ về phản hồi JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Báo cáo giá đặt trước trung bình
Bạn có thể nhận được dữ liệu cần thiết để tính giá trung bình đã đặt (all_conversions_value chia cho conversions) cho khách sạn.
Cụm từ tìm kiếm mẫu:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Ví dụ về phản hồi JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Báo cáo hiệu suất lượt chuyển đổi và chi phí
Cụm từ tìm kiếm sau đây cho biết hiệu quả tổng thể về lượt chuyển đổi và chi phí cho Quảng cáo khách sạn của bạn. Điều này rất hữu ích khi đánh giá hiệu quả tài chính và Lợi tức trên chi tiêu quảng cáo.
Cụm từ tìm kiếm mẫu:
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
Ví dụ về phản hồi JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "250.0",
"costMicros": "15000000",
"conversions": "2.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"date": "2026-03-24",
"partnerHotelId": "123"
}
}
]
}
Báo cáo đối tượng
Báo cáo đối tượng cho biết hiệu suất của hệ số giá thầu trên danh sách đối tượng của Google Ads. Để xem ví dụ về báo cáo đối tượng, hãy xem các truy vấn mẫu trong Chế độ xem đối tượng của nhóm quảng cáo và Chế độ xem đối tượng của chiến dịch.