Video: Xem bài nói chuyện về báo cáo Quảng cáo khách sạn tại hội thảo năm 2019
Thông qua API Google Ads, bạn có thể thiết kế các truy vấn để nhận được các 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 các ứng dụng khách của mình.
Điều kiện tiên quyết
- Tìm hiểu cách báo cáo và truy vấn hoạt động nói chung.
- Tìm hiểu cách truy vấn các tài nguyên khác nhau.
Cụm từ tìm kiếm cơ bản cho Quảng cáo khách sạn
Hãy xem các truy vấn mẫu sau để làm quen với cách sử dụng API Google Ads cho khách sạn Báo cáo quảng cáo.
Xem chỉ số về lượt nhấp
Truy vấn mẫu sau trả về số lượt nhấp từ khách sạn chế độ xem hiệu suất.
SELECT metrics.clicks
FROM hotel_performance_view
Kết quả của truy vấn sẽ trông giống như sau:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Nhận chỉ số về lượt nhấp được phân đoạn
Cụm từ tìm kiếm mẫu sau đây về lượt xem hiệu suất của khách sạn nhận được lượt nhấp và phân khúc 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.
Các lượt nhấp được phân đoạn theo partnerHotelID
nên có thể có hai hoặc nhiều đối tượng
đượ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"
}
},
...
]
}
Lấy chỉ số nhóm quảng cáo
Truy vấn mẫu sau cho nhóm quảng cáo nhận được lần hiển thị và lần nhấp qua 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 chỉ được lọc ra các chỉ số đáp ứng mệnh đề WHERE
. Trường ngày được điền theo ngày gần đây nhất trong phạm vi 30 ngày
6 tháng.
{
"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"
}
}
]
}
Bật quảng cáo trong nhóm quảng cáo
Cụm từ tìm kiếm mẫu sau cho quảng cáo trong nhóm quảng cáo sẽ lấy nhóm quảng cáo sẽ phân phát. Để một nhóm quảng cáo bất kỳ được phân phát, quảng cáo của nhóm quảng cáo, nhóm quảng cáo và chiến dịch phải đều đượ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"
}
}
}
]
}
Chế độ xem hữu ích cho báo cáo Quảng cáo khách sạn
Trong các API dùng để báo cáo Quảng cáo khách sạn trước đây, 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 API Google Ads, 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
rất 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.
Lưu ý rằng mỗi tài nguyên *_view
đều có các trường tài nguyên, phân đoạn và
chỉ số. Hãy tham khảo tài liệu về tài nguyên *_view
cụ thể trước khi
tạo truy vấn của bạn.
Chế độ xem nhóm khách sạn
Chế độ xem nhóm khách sạn là một tiêu chí chế độ xem. Vì vậy, rất 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 mẫu sau đây về lượt xem nhóm khách sạn nhận được lượt nhấp cho từng khách sạn trong 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 xác định cho nút gốc ("Tất cả khách sạn"), nên
rõ ràng rằng hàng đầu tiên đại diện cho các chỉ số cho "Tất cả khách sạn" trang thông tin
trong khi hàng thứ hai hiển thị các chỉ số cho 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 sẽ hữu ích nếu bạn muốn truy xuất chỉ số hiệu suất cho một khách sạn bằng cách sử dụng dữ liệu không phù hợp từ một 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 mẫu sau đây về lượt xem hiệu suất của khách sạn nhận được lượt nhấp và phân khúc 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.
Các lượt nhấp được phân đoạn theo partner_hotel_id
nên có thể có 2 hoặc nhiều đối tượng
đượ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 nhóm quảng cáo
Chế độ xem đối tượng nhóm quảng cáo rất hữu ích nếu bạn muốn truy xuất chỉ số hiệu suất cho các đối tượng được đính kèm tại nhóm quảng cáo cấp độ.
Xin lưu ý rằng đây là chế độ xem chung cho các loại chiến dịch, không chỉ chiến dịch khách sạn
. Chế độ xem này cũng cho phép phân đoạn kết quả theo
hotel_date_selection_type
, có thể dùng để chỉ định ngày khách sạn
đã được người dùng chọn hoặc là ngày mặc định cho tìm kiếm do Google đặt. Nếu
bạn phân đoạn theo hotel_date_selection_type
, thì chỉ có kết quả cho chiến dịch khách sạn là
bị trả lại.
Truy vấn sau 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"
}
}
]
}
Lượt 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 chỉ số hiệu suất cho các đối tượng được đính kèm ở chiến dịch cấp độ.
Xin lưu ý rằng đây là chế độ xem chung cho các loại chiến dịch, không chỉ chiến dịch khách sạn
. Chế độ xem này cũng cho phép phân đoạn kết quả theo
hotel_date_selection_type
, có thể dùng để chỉ định ngày khách sạn
đã được người dùng chọn hoặc là ngày mặc định cho tìm kiếm do Google đặt. Nếu
bạn phân đoạn theo hotel_date_selection_type
, thì chỉ có kết quả cho chiến dịch khách sạn là
bị trả lại.
Truy vấn sau 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"
}
}
]
}
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 dành riêng cho khách sạn quảng cáo.
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 để nhận dữ liệu về hiệu suất.
hotel_performance_view
cho phép bạn sử dụng tài nguyên campaign
để phân đoạn
chỉ số. Ví dụ: bạn có thể sử dụng trường campaign.id
để theo dõi 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 với 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 được phân đoạn các chỉ số hiệu suất theo:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Hãy truy cập vào HotelRateType
để biết
phần mô tả về các loại.
Có thể đưa nhiều phân đoạn vào một truy vấn; tuy nhiên, số lượt truy cập được trả về có thể tăng đáng kể với các phân đoạn bổ sung.
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ể nhận được thông tin chi tiết về mức giá của mình so với giá của đối thủ cạnh tranh giá trên hành trình khách sạn giống nhau.
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ể lấy dữ liệu cần thiết để tính giá trung bình đã đặt trước
(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 đố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 đối tượng của Google Ads danh sách. Để xem ví dụ về báo cáo đối tượng, hãy xem truy vấn mẫu trong mục Nhóm quảng cáo Chế độ xem đối tượng và Đối tượng chiến dịch Chế độ xem.
Báo cáo đối chiếu khách sạn
Báo cáo đối chiếu khách sạn chứa thông tin về lượt chuyển đổi từ các lượt đặt phòng khách sạn để điều chỉnh với nhà quảng cáo bản ghi. Bạn có thể tải dữ liệu lên thông qua tính năng tải lên hàng loạt để cho Google biết lượt đặt trước đã bị huỷ hoặc đã hoàn tất. Các cột chính trong báo cáo này có dạng như sau:
Cột giao diện người dùng | Cột API | Giải thích |
---|---|---|
Giá trị của lượt đặt phòng | metrics.value_per_conversions_by_conversion_date |
Giá trị chuyển đổi theo báo cáo của thẻ |
Ngày chuyển đổi | segments.date |
Ngày đặt phòng |
Tỷ lệ phí hoa hồng | metrics.hotel_commission_rate_micros |
Tỷ lệ phần trăm giá trị của lượt đặt phòng mà bạn đặt giá thầu cho một lượt hiển thị quảng cáo |
Phí hoa hồng |
Nếu |
Số tiền mà bạn dự kiến sẽ trả hoặc đã thanh toán cho lượt lưu trú của khách |