Отчеты о рекламе гостиниц

С помощью 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"
      }
    }
  ]
}

Как получить объявления из включенной группы объявлений

В следующем примере запроса для объявлений из группы объявлений возвращаются группы объявлений, которые будут показываться. Чтобы объявления из группы показывались, должны быть включены объявление, группа объявлений и кампания.

Примечание. Если у ad_group нет ad_group_ad, его необходимо создать. Чтобы проверить, так ли это, удалите фильтр ad_group_ad.status = ENABLED.

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

Полезные представления для отчетов о рекламе гостиниц

В предыдущих API для отчетов о рекламе отелей можно было получить определенный отчет, например об эффективности. В Google Ads 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/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 в JSON REST), поэтому для одного и того же параметра 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"
      }
    }
  ]
}

Просмотр аудитории группы объявлений

Представление аудитории группы объявлений позволяет получать показатели эффективности для аудиторий, связанных на уровне группы объявлений.

Примечание. Это общий вид для различных типов кампаний, а не только для кампаний для гостиниц. В этом представлении также можно сегментировать результаты по параметру hotel_date_selection_type, который указывает, выбрал ли пользователь даты самостоятельно или использовал стандартные варианты, предложенные Google. Если вы сегментируете данные по 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/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"
      }
    }
  ]
}

Представление аудитории кампании

Представление аудитории кампании позволяет получать показатели эффективности для аудиторий, добавленных на уровне кампании.

Примечание. Это общий вид для различных типов кампаний, а не только для кампаний для гостиниц. В этом представлении также можно сегментировать результаты по параметру hotel_date_selection_type, который указывает, были ли даты проживания в гостинице выбраны пользователем или заданы Google по умолчанию. Если вы сегментируете данные по 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/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 для получения данных об эффективности.

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

Эффективность с разбивкой по типам кликов

Примечание. Если вы используете metrics.search_impression_share, то не сможете сегментировать данные по click_type.

Пример запроса:

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

Результаты запроса выглядят примерно так:

{
  "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 Рекламы. Примеры отчетов об аудиториях можно найти в примерах запросов в разделах Ad Group Audience View и Campaign Audience View.