Google Ads API की मदद से, होटल विज्ञापनों की रिपोर्ट पाने के लिए क्वेरी डिज़ाइन की जा सकती हैं. इसके बाद, इन क्वेरी को अपने क्लाइंट ऐप्लिकेशन में शामिल किया जा सकता है.
ज़रूरी शर्तें
- रिपोर्टिंग और क्वेरी के काम करने के तरीके के बारे में जानें.
- जानें कि अलग-अलग संसाधनों के लिए क्वेरी कैसे की जा सकती हैं.
होटल विज्ञापनों के लिए बुनियादी क्वेरी
होटल विज्ञापनों की रिपोर्ट के लिए Google Ads API का इस्तेमाल करने के बारे में जानने के लिए, क्वेरी के ये उदाहरण देखें.
क्लिक की मेट्रिक पाना
क्वेरी के इस उदाहरण से, होटल की परफ़ॉर्मेंस व्यू से मिले क्लिक की संख्या का पता चलता है.
SELECT metrics.clicks
FROM hotel_performance_view
क्वेरी के नतीजे, JSON के इस जवाब की तरह दिखते हैं:
{
"results": [
{
"metrics": {
"clicks": "78090"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
}
}
],
"totalResultsCount": "1",
"fieldMask": "metrics.clicks"
}
विज्ञापन ग्रुप की मेट्रिक पाना
विज्ञापन ग्रुप के लिए क्वेरी के इस उदाहरण से, पिछले 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 क्लॉज़ की शर्तों को पूरा करती हैं. segments.date चुने जाने की वजह से, क्वेरी 30 दिनों की अवधि के लिए हर दिन की एक लाइन दिखाती है.
{
"results": [
{
"campaign": {
"resourceName": "customers/1234567890/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/1234567890/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/1234567890/campaigns/23456789",
"name": "test campaign",
"status": "ENABLED"
},
"adGroup": {
"resourceName": "customers/1234567890/adGroups/11111111",
"id": "11111111",
"name": "test adgroup",
"status": "ENABLED"
},
"adGroupAd": {
"resourceName": "customers/1234567890/adGroupAds/11111111~33333333",
"status": "ENABLED",
"ad": {
"resourceName": "customers/1234567890/ads/77777777"
}
}
}
]
}
होटल विज्ञापनों की रिपोर्ट के लिए काम के व्यू
होटल विज्ञापनों की रिपोर्ट के लिए, पहले के एपीआई में परफ़ॉर्मेंस रिपोर्ट जैसी कोई खास रिपोर्ट वापस पाई जा सकती थी. Google Ads API में, इस तरह का डेटा अलग-अलग *_view संसाधनों में दिखाया जाता है. जैसे, hotel_performance_view और hotel_group_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/2222222~1111111"
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/2222222~1111111"
}
},
{
"metrics": {
"clicks": "0"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/2222222~1111112",
"listingGroup": {
"caseValue": {
"hotelId": {}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/2222222~1111112"
}
},
{
"metrics": {
"clicks": "3"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/2222222~1111113",
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111111"
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/2222222~1111113"
}
},
{
"metrics": {
"clicks": "2"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/2222222~1111114",
"listingGroup": {
"caseValue": {
"hotelId": {
"value": "11111111111111112"
}
}
}
},
"hotelGroupView": {
"resourceName": "customers/1234567890/hotelGroupViews/2222222~1111114"
}
}
]
}
होटल परफ़ॉर्मेंस व्यू
होटल परफ़ॉर्मेंस व्यू तब काम का होता है, जब आपको किसी होटल की परफ़ॉर्मेंस मेट्रिक, ऐसे डेटा का इस्तेमाल करके वापस पानी हो जो होटल ग्रुपिंग से नहीं आता. भले ही, आपके पास होटल आईडी के आधार पर सबडिविज़न हो.
होटल परफ़ॉर्मेंस व्यू के लिए क्वेरी के इस उदाहरण से, क्लिक की संख्या का पता चलता है. साथ ही, नतीजों को होटल आईडी के हिसाब से सेगमेंट किया जाता है.
SELECT
segments.partner_hotel_id,
metrics.clicks
FROM hotel_performance_view
क्वेरी के नतीजे, JSON के इस जवाब की तरह दिखते हैं. क्लिक को partner_hotel_id (REST JSON में partnerHotelId) के हिसाब से सेगमेंट किया जाता है. इसलिए, एक ही hotel_performance_view के लिए दो या उससे ज़्यादा ऑब्जेक्ट वापस किए जा सकते हैं.
{
"results": [
{
"metrics": {
"clicks": "7055"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1111"
}
},
{
"metrics": {
"clicks": "3047"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"partnerHotelId": "1112"
}
}
]
}
विज्ञापन ग्रुप की ऑडियंस का व्यू
विज्ञापन ग्रुप की ऑडियंस का व्यू तब काम का होता है, जब आपको विज्ञापन ग्रुप के लेवल पर जोड़ी गई ऑडियंस के लिए परफ़ॉर्मेंस मेट्रिक वापस पानी हों.
इस क्वेरी से, हर 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/1234567890/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"adGroupCriterion": {
"resourceName": "customers/1234567890/adGroupCriteria/23456789~789456",
"userList": {
"userList": "customers/1234567890/userLists/456789"
}
},
"adGroupAudienceView": {
"resourceName":
"customers/1234567890/adGroupAudienceViews/23456789~789456"
},
"segments": {
"device": "TABLET",
"hotelDateSelectionType": "USER_SELECTED"
}
}
]
}
कैंपेन की ऑडियंस का व्यू
कैंपेन ऑडियंस व्यू तब काम का होता है, जब आपको कैंपेन के लेवल पर जोड़ी गई ऑडियंस के लिए परफ़ॉर्मेंस मेट्रिक वापस पानी हों.
इस क्वेरी से, हर 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/1234567890/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0",
"costMicros": "0",
"impressions": "3",
"allConversionsValue": "0"
},
"campaignCriterion": {
"resourceName": "customers/1234567890/campaignCriteria/23456789~789456",
"userList": {
"userList": "customers/1234567890/userLists/456789"
}
},
"campaignAudienceView": {
"resourceName":
"customers/1234567890/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/1234567890/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/1234567890/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "3",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "MONDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123"
}
},
{
"campaign": {
"resourceName": "customers/1234567890/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/1234567890/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/1234567890/campaigns/23456789"
},
"metrics": {
"clicks": "0",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "123",
"clickType": "HOTEL_PRICE"
}
},
{
"campaign": {
"resourceName": "customers/1234567890/campaigns/23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1",
"allConversionsValue": "0.0"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"device": "DESKTOP",
"hotelBookingWindowDays": "0",
"hotelCenterId": "1234",
"hotelCheckInDayOfWeek": "TUESDAY",
"hotelDateSelectionType": "USER_SELECTED",
"hotelLengthOfStay": "4",
"partnerHotelId": "12345",
"clickType": "HOTEL_PRICE"
}
}
]
}
खास किराये की परफ़ॉर्मेंस रिपोर्ट
इस क्वेरी से, परफ़ॉर्मेंस मेट्रिक मिलती हैं. इन्हें इनके हिसाब से सेगमेंट किया जाता है:
campaignhotel_center_idhotel_countryhotel_rate_rule_idhotel_rate_typedevicepartner_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/1234567890/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "1",
"conversions": "0.0",
"costMicros": "0",
"impressions": "24",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.17073170731707318"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/hotelPerformanceView"
},
"segments": {
"device": "TABLET",
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelRateRuleId": "desktop",
"hotelRateType": "PUBLIC_RATE"
}
},
{
"campaign": {
"resourceName": "customers/1234567890/campaigns/23456789",
"id": "23456789"
},
"metrics": {
"clicks": "107",
"conversions": "0.0",
"costMicros": "0",
"impressions": "1668",
"searchAbsoluteTopImpressionShare": "0.0999",
"searchTopImpressionShare": "0.3581201665675193"
},
"hotelPerformanceView": {
"resourceName": "customers/1234567890/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/1234567890/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/1234567890/hotelPerformanceView"
},
"segments": {
"hotelCenterId": "1234",
"partnerHotelId": "123",
"hotelPriceBucket": "LOWEST_TIED"
}
}
]
}
कन्वर्ज़न और लागत की परफ़ॉर्मेंस रिपोर्ट
इस क्वेरी से, होटल विज्ञापनों के लिए कन्वर्ज़न और लागत की कुल परफ़ॉर्मेंस का पता चलता है. यह वित्तीय परफ़ॉर्मेंस और आरओएएस का आकलन करने में मददगार होती है.
क्वेरी का उदाहरण:
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/1234567890/hotelPerformanceView"
},
"segments": {
"date": "2026-03-24",
"partnerHotelId": "123"
}
}
]
}
ऑडियंस रिपोर्ट
ऑडियंस रिपोर्ट से, Google Ads की ऑडियंस सूचियों पर बिड मल्टीप्लायर की परफ़ॉर्मेंस का पता चलता है. ऑडियंस रिपोर्ट के उदाहरण देखने के लिए, विज्ञापन ग्रुप की ऑडियंस का व्यू और कैंपेन की ऑडियंस का व्यू में क्वेरी के उदाहरण देखें.