Video: Lihat pembahasan pelaporan Iklan Hotel dari workshop 2019
Dengan Google Ads API, Anda dapat mendesain kueri untuk mendapatkan laporan Iklan Hotel yang Anda butuhkan. Anda kemudian dapat menggabungkan kueri ini ke dalam aplikasi klien.
Prasyarat
- Pelajari cara kerja pelaporan dan kueri secara umum.
- Pelajari cara membuat kueri dari berbagai resource.
Kueri dasar untuk Iklan Hotel
Lihat contoh kueri ini untuk memahami penggunaan Google Ads API untuk pelaporan Iklan Hotel.
Mendapatkan metrik klik
Contoh kueri berikut menampilkan jumlah klik dari tampilan performa hotel.
SELECT metrics.clicks
FROM hotel_performance_view
Hasil kueri akan terlihat seperti ini:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
Mendapatkan metrik klik yang tersegmentasi
Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan mengelompokkan hasil menurut ID Hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Hasil kueri akan terlihat seperti string JSON berikut.
Klik disegmentasikan berdasarkan partnerHotelID
, sehingga dua objek atau lebih dapat ditampilkan untuk hotelPerformanceView yang sama.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Dapatkan metrik grup iklan
Contoh kueri untuk grup iklan berikut mendapatkan tayangan dan klik selama 30 hari terakhir, yang disegmentasikan menurut tanggal.
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
Hasil kueri akan terlihat seperti string JSON berikut.
Respons difilter hanya untuk metrik yang memenuhi kondisi klausa
WHERE
. Kolom tanggal diisi dengan tanggal terakhir yang disertakan dalam periode
30 hari.
{
"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"
}
}
]
}
Dapatkan iklan grup iklan yang diaktifkan
Contoh kueri untuk iklan grup iklan berikut mendapatkan grup iklan yang akan ditayangkan. Agar grup iklan ditayangkan, iklan grup iklan, grup iklan, dan kampanye harus diaktifkan.
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
Hasil kueri akan terlihat seperti string JSON berikut.
{
"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"
}
}
}
]
}
Tampilan yang berguna untuk pelaporan Iklan Hotel
Dalam API sebelumnya untuk pelaporan Iklan Hotel, Anda dapat mengambil laporan tertentu, seperti laporan performa. Di Google Ads API, jenis data ini direpresentasikan dalam resource *_view
terpisah, seperti hotel_performance_view
dan hotel_group_view
. Bagian ini menjelaskan referensi *_view
yang berguna untuk pelaporan Iklan Hotel. Contoh kueri juga disediakan.
Perhatikan bahwa setiap resource *_view
memiliki kolom resource, segmen, dan metrik tertentu. Lihat dokumentasi untuk resource *_view
tertentu sebelum
membuat kueri.
Tampilan Grup Hotel
Tampilan Grup Hotel adalah tampilan kriteria, sehingga berguna untuk mengambil metrik untuk jenis kriteria tertentu grup hotel.
Contoh kueri untuk tampilan grup hotel berikut mendapatkan klik untuk setiap hotel dalam grup listingan untuk seluruh hierarki grup listingan hotel, termasuk node root ("Semua hotel").
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
Hasil kueri akan terlihat seperti string JSON berikut.
Mengingat bahwa case_value
tidak ditentukan untuk node root ("Semua hotel"), terlihat bahwa baris pertama mewakili metrik untuk grup listingan
"Semua hotel", sedangkan baris kedua mewakili metrik untuk grup listingan turunan
yang mewakili "Lainnya".
{
"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"
}
},
]
}
Tampilan Performa Hotel
Tampilan Performa Hotel berguna jika Anda ingin mengambil metrik performa untuk hotel menggunakan data yang tidak berasal dari pengelompokan hotel, meskipun Anda memiliki subdivisi berdasarkan ID Hotel.
Contoh kueri untuk tampilan performa hotel berikut mendapatkan klik dan mengelompokkan hasil menurut ID Hotel.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
Hasil kueri akan terlihat seperti string JSON berikut.
Klik disegmentasikan berdasarkan partner_hotel_id
, sehingga dua objek atau lebih dapat ditampilkan untuk tampilan performa hotel yang sama.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
Tampilan Audiens Grup Iklan
Tampilan Audiens Grup Iklan berguna jika Anda ingin mengambil metrik performa untuk audiens yang disertakan di tingkat grup iklan.
Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye Hotel. Tampilan ini juga menyediakan kemampuan untuk menyegmentasikan hasil menurut hotel_date_selection_type
, yang dapat digunakan untuk menentukan apakah tanggal hotel dipilih oleh pengguna atau merupakan tanggal default untuk penelusuran yang disetel oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type
, hanya hasil untuk kampanye Hotel yang akan ditampilkan.
Kueri berikut menampilkan satu baris per
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
Hasil kueri akan terlihat seperti string JSON berikut.
{
"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"
}
}
]
}
Tampilan Audiens Kampanye
Tampilan Audiens Kampanye berguna jika Anda ingin mengambil metrik performa untuk audiens yang disertakan di tingkat kampanye.
Perhatikan bahwa ini adalah tampilan umum untuk berbagai jenis kampanye, bukan hanya kampanye Hotel. Tampilan ini juga menyediakan kemampuan untuk menyegmentasikan hasil menurut hotel_date_selection_type
, yang dapat digunakan untuk menentukan apakah tanggal hotel dipilih oleh pengguna atau merupakan tanggal default untuk penelusuran yang disetel oleh Google. Jika Anda menyegmentasikan menurut hotel_date_selection_type
, hanya hasil untuk kampanye Hotel yang akan ditampilkan.
Kueri berikut menampilkan satu baris per
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
Hasil kueri akan terlihat seperti string JSON berikut.
{
"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"
}
}
]
}
Laporan yang berguna untuk Iklan Hotel
Bagian ini memberikan beberapa laporan bermanfaat yang dirancang khusus untuk iklan Hotel.
Laporan performa
Kueri ini memanfaatkan Tampilan Performa Hotel untuk mendapatkan data performa.
hotel_performance_view
memungkinkan Anda menggunakan resource campaign
untuk menyegmentasikan
metrik. Misalnya, Anda dapat menggunakan kolom campaign.id
untuk mendapatkan metrik performa menurut kampanye.
Performa
Contoh kueri:
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
Contoh respons 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"
}
}
]
}
Performa dengan jenis klik
Contoh kueri:
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
Contoh respons 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"
}
}
]
}
Laporan performa tarif bersyarat
Kueri berikut mendapatkan metrik performa yang disegmentasikan berdasarkan:
campaign
hotel_center_id
hotel_country
hotel_rate_rule_id
hotel_rate_type
device
partner_hotel_id
Lihat HotelRateType
untuk
deskripsi jenis.
Beberapa segmen dapat disertakan dalam kueri, tetapi jumlah baris yang ditampilkan dapat meningkat secara signifikan dengan segmen tambahan.
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
Hasil kueri akan terlihat seperti string JSON berikut.
{
"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"
}
}
]
}
Laporan persaingan harga
Anda bisa mendapatkan insight tentang perbandingan harga Anda dengan harga pesaing pada itinerari hotel yang sama.
Contoh kueri:
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
Contoh respons JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Laporan harga pemesanan rata-rata
Anda bisa mendapatkan data yang diperlukan untuk menghitung harga pemesanan rata-rata (all_conversions_value
dibagi dengan conversions
) untuk hotel.
Contoh kueri:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
Contoh respons JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
Laporan audiens
Laporan audiens menampilkan performa pengganda bid di daftar audiens Google Ads. Untuk contoh laporan audiens, lihat contoh kueri di Tampilan Audiens Grup Iklan dan Tampilan Audiens Kampanye.
Laporan Rekonsiliasi Hotel
Laporan Rekonsiliasi Hotel berisi informasi konversi dari pemesanan Hotel untuk direkonsiliasi dengan data pengiklan. Anda dapat mengupload data melalui upload massal untuk memberi tahu Google pemesanan yang dibatalkan atau diselesaikan. Kolom utama dalam laporan ini adalah sebagai berikut:
Kolom UI | Kolom API | Penjelasan |
---|---|---|
Nilai pemesanan | metrics.value_per_conversions_by_conversion_date |
Nilai konversi seperti yang dilaporkan oleh tag |
Tanggal konversi | segments.date |
Tanggal pemesanan |
Tarif komisi | metrics.hotel_commission_rate_micros |
Persentase nilai pemesanan yang Anda ajukan bid untuk tayangan iklan |
Biaya komisi |
Jika |
Jumlah yang diperkirakan akan Anda bayar atau telah dibayar untuk masa inap tamu |