ویدیو: سخنرانی گزارش تبلیغات هتل از کارگاه سال ۲۰۱۹ را ببینید
با استفاده از API گوگل ادز، میتوانید کوئریهایی را برای دریافت گزارشهای مورد نیاز خود از تبلیغات هتل طراحی کنید. سپس میتوانید این کوئریها را در برنامههای کلاینت خود بگنجانید.
پیشنیازها
- یاد بگیرید که گزارشدهی و پرسوجوها به طور کلی چگونه کار میکنند.
- یاد بگیرید که چگونه میتوان منابع مختلف را جستجو کرد.
سوالات متداول برای تبلیغات هتل
برای آشنایی با نحوه استفاده از API گوگل ادز برای گزارشدهی تبلیغات هتل، این نمونه سوالات را بررسی کنید.
دریافت معیارهای کلیک
کوئری مثال زیر تعداد کلیکها را از نمای عملکرد هتل برمیگرداند.
SELECT metrics.clicks
FROM hotel_performance_view
نتایج حاصل از پرس و جو چیزی شبیه به این خواهد بود:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
معیارهای کلیکهای بخشبندیشده را دریافت کنید
مثال زیر برای نمایش عملکرد هتل، کلیکها را دریافت کرده و نتایج را بر اساس شناسه هتل تقسیمبندی میکند.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود. کلیکها بر اساس partnerHotelID تقسیمبندی میشوند و بنابراین میتوان دو یا چند شیء را برای یک hotelPerformanceView یکسان برگرداند.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
دریافت معیارهای گروه تبلیغاتی
مثال زیر برای گروههای تبلیغاتی، تعداد نمایشها و کلیکها را در 30 روز گذشته، بر اساس تاریخ، دستهبندی میکند.
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
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود. پاسخ فقط برای معیارهایی که شرایط بند WHERE را برآورده میکنند، فیلتر میشود. فیلد تاریخ با آخرین تاریخ موجود در دوره 30 روزه پر میشود.
{
"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"
}
}
]
}
تبلیغات گروههای تبلیغاتی را فعال کنید
مثال زیر برای جستجوی تبلیغات گروههای تبلیغاتی، گروههای تبلیغاتی که قرار است نمایش داده شوند را نمایش میدهد. برای نمایش هر گروه تبلیغاتی، باید تبلیغ گروه تبلیغاتی، گروه تبلیغاتی و کمپین فعال باشند.
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
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود.
{
"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"
}
}
}
]
}
نماهای مفید برای گزارش تبلیغات هتل
در APIهای قبلی برای گزارشدهی تبلیغات هتل، میتوانستید یک گزارش خاص، مانند گزارش عملکرد ، را بازیابی کنید. در API تبلیغات گوگل، این نوع دادهها در منابع *_view جداگانهای مانند hotel_performance_view و hotel_group_view نمایش داده میشوند. این بخش منابع *_view را که برای گزارشدهی تبلیغات هتل مفید هستند، شرح میدهد. نمونههایی از پرسوجو نیز ارائه شده است.
توجه داشته باشید که هر منبع *_view فیلدها، بخشها و معیارهای منبع خاصی دارد. قبل از ایجاد پرسوجوی خود، مستندات مربوط به منبع *_view خاص را مطالعه کنید.
نمای گروهی هتل
نمای گروه هتل یک نمای معیار است، بنابراین برای بازیابی معیارها برای یک نوع معیار خاص از یک گروه هتل مفید است.
پرس و جوی مثال زیر برای نمایشهای گروه هتل، کلیکهای مربوط به هر هتل در یک گروه فهرستبندی را برای کل درخت گروه فهرست هتلها، از جمله گره ریشه ("همه هتلها") دریافت میکند.
SELECT
metrics.clicks,
ad_group_criterion.listing_group.case_value.hotel_id.value
FROM hotel_group_view
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود. با توجه به اینکه case_value برای گره ریشه ("همه هتلها") تعریف نشده است، واضح است که ردیف اول نشان دهنده معیارهای گروه فهرست "همه هتلها" است، در حالی که ردیف دوم نشان دهنده معیارهای گروه فهرست فرزند است که نشان دهنده "سایر" است.
{
"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"
}
},
]
}
نمای عملکرد هتل
نمای عملکرد هتل در صورتی مفید است که بخواهید معیارهای عملکرد یک هتل را با استفاده از دادههایی که از گروهبندی هتلها به دست نمیآیند، بازیابی کنید، حتی اگر بر اساس شناسه هتل، زیرمجموعهای داشته باشید.
مثال زیر برای نمایش عملکرد هتل، کلیکها را دریافت کرده و نتایج را بر اساس شناسه هتل تقسیمبندی میکند.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود. کلیکها بر اساس partner_hotel_id تقسیمبندی میشوند و بنابراین میتوان دو یا چند شیء را برای نمای عملکرد هتل یکسان برگرداند.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
},
...
]
}
نمای مخاطبان گروه تبلیغاتی
نمای مخاطبان گروه تبلیغاتی در صورتی مفید است که بخواهید معیارهای عملکرد مخاطبان متصل به سطح گروه تبلیغاتی را بازیابی کنید.
توجه داشته باشید که این یک نمای کلی برای انواع مختلف کمپینها است، نه فقط کمپینهای هتل. این نما همچنین امکان تقسیمبندی نتایج بر اساس hotel_date_selection_type را فراهم میکند، که میتواند برای مشخص کردن اینکه آیا تاریخ هتل توسط کاربر انتخاب شده است یا یک تاریخ پیشفرض برای جستجوی تعیین شده توسط گوگل بوده است، استفاده شود. اگر بر اساس hotel_date_selection_type تقسیمبندی کنید، فقط نتایج مربوط به کمپینهای هتل بازگردانده میشوند.
کوئری زیر به ازای هر 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
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود.
{
"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"
}
}
]
}
نمای مخاطبان کمپین
نمای مخاطبان کمپین در صورتی مفید است که بخواهید معیارهای عملکرد مخاطبان متصل به سطح کمپین را بازیابی کنید.
توجه داشته باشید که این یک نمای کلی برای انواع مختلف کمپینها است، نه فقط کمپینهای هتل. این نما همچنین امکان تقسیمبندی نتایج بر اساس hotel_date_selection_type را فراهم میکند، که میتواند برای مشخص کردن اینکه آیا تاریخ هتل توسط کاربر انتخاب شده است یا یک تاریخ پیشفرض برای جستجوی تعیین شده توسط گوگل بوده است، استفاده شود. اگر بر اساس hotel_date_selection_type تقسیمبندی کنید، فقط نتایج مربوط به کمپینهای هتل بازگردانده میشوند.
کوئری زیر به ازای هر 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
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود.
{
"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"
}
}
]
}
گزارشهای مفید برای تبلیغات هتل
این بخش چندین گزارش مفید را که مخصوص تبلیغات هتل طراحی شدهاند، ارائه میدهد.
گزارشهای عملکرد
این کوئریها از نمای عملکرد هتل برای دریافت دادههای عملکرد استفاده میکنند.
نمای hotel_performance_view به شما امکان میدهد از منبع campaign برای تقسیمبندی معیارها استفاده کنید. برای مثال، میتوانید از فیلد campaign.id برای دریافت معیارهای عملکرد بر اساس کمپین استفاده کنید.
عملکرد
نمونه سوال:
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
مثال پاسخ 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"
}
}
]
}
عملکرد با نوع کلیک
نمونه سوال:
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
مثال پاسخ 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"
}
}
]
}
گزارش عملکرد نرخهای مشروط
کوئری زیر معیارهای عملکرد را بر اساس موارد زیر تقسیمبندی میکند:
-
campaign -
hotel_center_id -
hotel_country -
hotel_rate_rule_id -
hotel_rate_type -
device -
partner_hotel_id
برای توضیح انواع هتلها به HotelRateType مراجعه کنید.
میتوان چندین بخش را در یک پرسوجو گنجاند؛ با این حال، تعداد ردیفهای برگردانده شده میتواند با بخشهای اضافی به طور قابل توجهی افزایش یابد.
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
نتایج حاصل از پرس و جو چیزی شبیه به رشته JSON زیر خواهد بود.
{
"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"
}
}
]
}
گزارش رقابتپذیری قیمت
میتوانید در مورد چگونگی مقایسه قیمتهای خود با قیمتهای رقبا در همان برنامههای سفر هتل، بینشهایی کسب کنید.
نمونه سوال:
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
مثال پاسخ JSON:
{
"results": [
{
"metrics": {
"hotelAverageLeadValueMicros": "96416341.829268292",
"hotelPriceDifferencePercentage": "-0.014627310872986811"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
گزارش میانگین قیمت رزرو شده
شما میتوانید دادههای مورد نیاز برای محاسبه میانگین قیمت رزرو شده ( all_conversions_value تقسیم بر conversions ) برای هتلها را دریافت کنید.
نمونه سوال:
SELECT
segments.hotel_center_id,
segments.partner_hotel_id,
segments.hotel_price_bucket,
metrics.all_conversions_value,
metrics.conversions
FROM hotel_performance_view
مثال پاسخ JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "123.5",
"conversions": "1"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
گزارش عملکرد تبدیل و هزینه
کوئری زیر نرخ تبدیل کلی و عملکرد هزینه را برای تبلیغات هتل شما دریافت میکند که برای ارزیابی عملکرد مالی و بازگشت سرمایه (ROAS) مفید است.
نمونه سوال:
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
مثال پاسخ JSON:
{
"results": [
{
"metrics": {
"allConversionsValue": "250.0",
"costMicros": "15000000",
"conversions": "2.0"
},
"hotelPerformanceView": {
"resourceName": "customers/123456789/hotelPerformanceView"
},
"segments": {
"date": "2026-03-24",
"partnerHotelId": "123"
}
}
]
}
گزارشهای مخاطبان
گزارشهای مخاطبان، عملکرد ضرایب پیشنهاد قیمت را در فهرست مخاطبان گوگل ادز نشان میدهند. برای مثالهایی از گزارشهای مخاطبان، به مثالهای موجود در نمای مخاطبان گروه تبلیغاتی و نمای مخاطبان کمپین مراجعه کنید.