Отчеты

ondemand_video Видео: ознакомьтесь с докладом о рекламе отелей на семинаре 2019 года

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

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

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

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

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

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

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

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 Рекламы такого рода данные представлены в отдельных ресурсах *_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"
      }
    },
  ]
}

Отель Performance View

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

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

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

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

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

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

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

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

Отчет о сверке отелей

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