Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу Google Ads в Discord на сервере Google Advertising and Measurement Community .

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

Отчеты

Видео: Посмотрите доклад об отчётности Hotel Ads с семинара 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 для получения данных о производительности.

Представление 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"
      }
    }
  ]
}

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

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

Отчет о сверке гостиничных номеров

Отчёт о сверке бронирования отелей содержит информацию о конверсиях из бронирований отелей для сверки с данными рекламодателя. Вы можете загрузить данные с помощью массовых загрузок, чтобы сообщить Google, какие бронирования были отменены или завершены. Основные столбцы в этом отчёте следующие:

Столбец пользовательского интерфейса	Столбец API	Объяснение
Стоимость бронирования	`metrics.value_per_conversions_by_conversion_date`	Значение конверсии, указанное тегом
Дата конвертации	`segments.date`	Дата бронирования
Ставка комиссии	`metrics.hotel_commission_rate_micros`	Процент стоимости бронирования, который вы предлагаете за показ рекламы
Стоимость комиссии	Если `status == RECONCILED` или `CANCELED` , то это значение можно рассчитать как `metrics.hotel_commission_rate_micros * hotel_reconciliation.reconciled_value_micros` . Во всех остальных случаях это значение можно получить из столбца `metrics.hotel_expected_commission_cost` или рассчитать как `metrics.hotel_commission_rate_micros * metrics.value_per_conversions_by_conversion_date`	Сумма, которую вы должны заплатить или уже заплатили за проживание гостя

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

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

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

Предпосылки

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

Получите метрики кликов

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

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

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

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

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

Просмотр эффективности отеля

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

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

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

Отчеты об эффективности

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

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

Отчет об эффективности условных ставок

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

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

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

Отчет о сверке гостиничных номеров

Отчеты