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

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 संसाधनों के बारे में बताया गया है. ये संसाधन, Hotel Ads की रिपोर्ट के लिए काम के होते हैं. साथ ही, इसमें क्वेरी के उदाहरण भी दिए गए हैं.

होटल ग्रुप व्यू

होटल ग्रुप व्यू, एक मानदंड व्यू है. इसलिए, यह होटल ग्रुप के किसी खास मानदंड टाइप के लिए मेट्रिक पाने में मददगार होता है.

होटल ग्रुप के व्यू के लिए यहां दी गई उदाहरण क्वेरी में, होटल लिस्टिंग ग्रुप के पूरे ट्री के लिए, हर होटल को क्लिक मिलते हैं. इसमें रूट नोड ("सभी होटल") भी शामिल है.

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 में दिखने वाले विज्ञापनों के लिए यात्रा फ़ीड