گزارش‌های «آگهی هتل»

با 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"
}

دریافت معیارهای گروه آگهی

نمونه پُرسمان زیر برای گروه‌های آگهی، ظهورها و کلیک‌ها را در ۳۰ روز گذشته، بخش‌بندی‌شده براساس تاریخ، دریافت می‌کند.

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 انتخاب شده است، پُرسمان یک ردیف در روز در بازه ۳۰ روزه برمی‌گرداند.

{
  "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 (partnerHotelId در REST JSON) بخش‌بندی می‌شوند، بنابراین دو یا چند شیء می‌توانند برای 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 نشان می‌دهد. برای نمونه‌های گزارش‌های مخاطب، پُرسمان‌های نمونه را در نمای مخاطب گروه آگهی و نمای مخاطب پویش ببینید.

قبلی
اصلاح قیمت پیشنهادی
بعدی
فیدهای سفر برای «آگهی‌های جستجوها»