होटल के विज्ञापनों की रिपोर्ट

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"
      }
    }
  ]
}

खास किराये की परफ़ॉर्मेंस रिपोर्ट

इस क्वेरी से, परफ़ॉर्मेंस मेट्रिक को इनके हिसाब से सेगमेंट किया जाता है:

  • 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/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 की ऑडियंस सूचियों पर बिड मल्टीप्लायर की परफ़ॉर्मेंस का पता चलता है. ऑडियंस रिपोर्ट के उदाहरणों के लिए, विज्ञापन ग्रुप ऑडियंस व्यू और कैंपेन ऑडियंस व्यू में उदाहरण के तौर पर दी गई क्वेरी देखें.

पीछे जाएं
बोलियां एडजस्ट करें
आगे बढ़ें
Search Network में दिखने वाले विज्ञापनों के लिए यात्रा फ़ीड