Эта страница переведена с помощью Cloud Translation API.

Отчеты

Видео : Посмотрите доклад о составлении отчетов по рекламе в отелях с семинара 2019 года.

С помощью API Google Ads вы можете создавать запросы для получения необходимых отчетов по рекламе отелей. Затем вы можете интегрировать эти запросы в свои клиентские приложения.

Предварительные требования

Узнайте, как в целом работают отчеты и запросы .
Узнайте, как можно запрашивать информацию о различных ресурсах .

Основные поисковые запросы для рекламы отелей

Ознакомьтесь с этими примерами запросов, чтобы ознакомиться с использованием API Google Ads для создания отчетов по рекламе отелей.

Получите показатели кликов.

Приведенный ниже пример запроса возвращает количество кликов из представления показателей работы отеля.

SELECT metrics.clicks
FROM hotel_performance_view

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

{
  "results": [
    {
      "metrics": {
        "clicks": "78090"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      }
    }
  ],
  "totalResultsCount": "1",
  "fieldMask": "metrics.clicks"
}

Получите сегментированные показатели кликов.

Следующий пример запроса для просмотра показателей эффективности отелей обрабатывает клики и сегментирует результаты по идентификатору отеля.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Результаты запроса будут выглядеть примерно так: JSON-строка. Клики сегментируются по partnerHotelID , поэтому для одного и того же hotelPerformanceView может быть возвращено два или более объекта.

{
  "results": [
    {
      "metrics": {
        "clicks": "7055"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1111"
      }
    },
    {
      "metrics": {
        "clicks": "3047"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/1234567890/hotelPerformanceView"
      },
      "segments": {
        "partnerHotelId": "1112"
      }
    },
    ...
  ]
}

Получение метрик для групп объявлений

Приведенный ниже пример запроса для групп объявлений позволяет получить данные о показах и кликах за последние 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 . Поле даты заполняется последней датой, входящей в 30-дневный период.

{
  "results": [
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/123456789/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/123456789/campaigns/23456789",
        "name": "test campaign",
        "status": "ENABLED"
      },
      "adGroup": {
        "resourceName": "customers/123456789/adGroups/111111111111",
        "id": "106121857411",
        "name": "test adgroup",
        "status": "ENABLED"
      },
      "adGroupAd": {
        "resourceName": "customers/123456789/adGroupAds/111111111111~33333333333",
        "status": "ENABLED",
        "ad": {
          "resourceName": "customers/123456789/ads/77777777777"
        }
      }
    }
  ]
}

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

В предыдущих версиях API для создания отчетов по рекламе отелей можно было получить конкретный отчет, например, отчет о производительности . В API Google Ads такие данные представлены в отдельных ресурсах *_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/22222222222~111111111111"
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111111"
      }
    },
    {
      "metrics": {
        "clicks": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111112"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111112"
      }
    },
    {
      "metrics": {
        "clicks": "3"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111113"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111111"
              }
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111113"
      }
    },
    {
      "metrics": {
        "clicks": "2"
      },
      "adGroupCriterion": {
        "resourceName": "customers/1234567890/adGroupCriteria/22222222222~111111111114"
        "listingGroup": {
          "caseValue": {
            "hotelId": {
              "value": "11111111111111112"
              }
            }
          }
        }
      },
      "hotelGroupView": {
        "resourceName": "customers/1234567890/hotelGroupViews/22222222222~111111111114"
      }
    },
  ]
}

Обзор показателей работы отеля

Функция просмотра показателей эффективности отеля полезна, если вы хотите получить метрики эффективности отеля, используя данные, не относящиеся к группе отелей, даже если у вас есть подразделение, основанное на идентификаторе отеля.

SELECT
  segments.partner_hotel_id,
  metrics.clicks
FROM hotel_performance_view

Результаты запроса будут выглядеть примерно так: JSON-строка. Клики сегментируются по partner_hotel_id , поэтому для одного и того же представления показателей отеля может быть возвращено два или более объектов.

{
  "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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "adGroupCriterion": {
        "resourceName": "customers/123456789/adGroupCriteria/23456789~789456",
        "userList": {
          "userList": "customers/123456789/userLists/456789"
        }
      },
      "adGroupAudienceView": {
        "resourceName": "customers/8005193609/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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "0",
        "conversions": "0",
        "costMicros": "0",
        "impressions": "3",
        "allConversionsValue": "0"
      },
      "campaignCriterion": {
        "resourceName": "customers/123456789/campaignCriteria/23456789~789456",
        "userList": {
          "userList": "customers/123456789/userLists/456789"
        }
      },
      "campaignAudienceView": {
        "resourceName": "customers/8005193609/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/123456789/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/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "3",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "MONDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/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/123456789/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/123456789/campaigns/23456789"
    },
      "metrics": {
        "clicks": "0",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "DESKTOP",
        "hotelBookingWindowDays": "0",
        "hotelCenterId": "1234",
        "hotelCheckInDayOfWeek": "TUESDAY",
        "hotelDateSelectionType": "USER_SELECTED",
        "hotelLengthOfStay": "4",
        "partnerHotelId": "123",
        "clickType": "HOTEL_PRICE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1",
        "allConversionsValue": "0.0"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/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/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "1",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "24",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.17073170731707318"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/hotelPerformanceView"
      },
      "segments": {
        "device": "TABLET",
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelRateRuleId": "desktop",
        "hotelRateType": "PUBLIC_RATE"
      }
    },
    {
      "campaign": {
        "resourceName": "customers/123456789/campaigns/23456789",
        "id": "23456789"
      },
      "metrics": {
        "clicks": "107",
        "conversions": "0.0",
        "costMicros": "0",
        "impressions": "1668",
        "searchAbsoluteTopImpressionShare": "0.0999",
        "searchTopImpressionShare": "0.3581201665675193"
      },
      "hotelPerformanceView": {
        "resourceName": "customers/123456789/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/123456789/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/123456789/hotelPerformanceView"
      },
      "segments": {
        "hotelCenterId": "1234",
        "partnerHotelId": "123",
        "hotelPriceBucket": "LOWEST_TIED"
      }
    }
  ]
}

Отчет о показателях конверсии и затрат

Следующий запрос позволяет получить общую конверсию и эффективность затрат для вашей рекламы отелей, что полезно для оценки финансовых показателей и рентабельности инвестиций (ROAS).

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

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/123456789/hotelPerformanceView"
      },
      "segments": {
        "date": "2026-03-24",
        "partnerHotelId": "123"
      }
    }
  ]
}

Отчеты об аудитории

Отчеты по аудитории показывают эффективность множителей ставок в списках аудиторий Google Ads. Примеры отчетов по аудитории см. в примерах запросов в разделах «Просмотр аудитории группы объявлений» и «Просмотр аудитории кампании» .

Скорректировать ставки

Ленты путешествий для поисковых объявлений

Отчеты Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Предварительные требования

Основные поисковые запросы для рекламы отелей

Получите показатели кликов.

Получите сегментированные показатели кликов.

Получение метрик для групп объявлений

Включите объявления в группах объявлений

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

Вид от группы отелей

Обзор показателей работы отеля

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

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

Полезные отчеты для рекламы отелей

Отчеты о результатах деятельности

Производительность

Производительность при нажатии кнопки

Отчет о результатах применения условных ставок

Отчет о ценовой конкурентоспособности

Отчет о средней цене бронирования

Отчет о показателях конверсии и затрат

Отчеты об аудитории

Отчеты