Отчеты о росте

Чтобы оценить причинно-следственное влияние рекламных кампаний на восприятие бренда, конверсии, ценность конверсий и поведение пользователей в органическом поиске, запросите ресурсы отчетов об измерении роста в Google Ads API:

  • Отчеты Brand Lift. Позволяют оценить, как просмотр рекламы влияет на восприятие бренда. Для этого используются различные типы показателей, полученных в результате опросов. Доступны в Google Ads API версии 25 и более поздних.
  • Отчеты о росте конверсий. Позволяют сравнивать количество дополнительных конверсий, их ценность, цену за дополнительную конверсию и дополнительную рентабельность инвестиций в рекламу с данными по контрольной группе, которой не показывалась реклама. Доступны в Google Ads API версии 25 и более поздних. Включают:
  • Отчеты об эффективности на основе поисковых запросов. Позволяют оценить рост количества поисковых запросов в Google Поиске и на YouTube, вызванный показом рекламы. Доступны в Google Ads API версии 26 и более поздних.

Информацию о стандартных отчетах об A/B-экспериментах для ресурсов experiment и campaign вы найдете в статье Отчеты об экспериментах.

Отчеты Brand Lift

Чтобы оценить, как ваши рекламные кампании влияют на восприятие бренда, в Google Ads API версии 25 и более поздних версиях отправьте запрос к специальным ресурсам для показателей Brand Lift.

Ресурсы и разбивка данных Brand Lift

Конфигурации, периоды и разбивки Brand Lift доступны в Google Ads API только для чтения (все поля имеют значение OUTPUT_ONLY). Настраивать их можно в интерфейсе Google Рекламы или с помощью представителя Google или специалиста по глобальным решениям для продуктов. Запрашивайте эти ресурсы, используя параметр customer_id аккаунта (управляющего или дочернего), которому принадлежит исследование.

Запросите ресурс LiftMeasurementFlight, чтобы получить расписание Brand Lift на уровне периода и метаданные коллекции опросов, включая статус периода (lift_measurement_flight.status, определяется перечислением LiftMeasurementFlightStatus со значениями ENABLED для активных периодов и STOPPED для периодов, остановленных вручную), диапазоны дат периода (lift_measurement_flight.start_date и lift_measurement_flight.end_date) в часовом поясе клиента и прогресс сбора ответов на целевой опрос (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, где 0 равно 0 %, а 1000000 – 100 %). Чтобы определить, выполняется ли период показа ENABLED или он уже завершен, сравните текущую дату в часовом поясе клиента с lift_measurement_flight.start_date и lift_measurement_flight.end_date, а также проверьте, достигло ли значение response_collection_ratio_micros значения 1000000.

Чтобы получить общие показатели Brand Lift на уровне исследования, запросите ресурс LiftMeasurementConfig. Чтобы проанализировать показатели Brand Lift по определенным параметрам, запросите следующие ресурсы разбивки:

Добавьте сегмент segments.brand_lift_measurement_type, чтобы разбить показатели Brand Lift по типу вопроса в опросе, который определяется перечислением BrandLiftMeasurementType (например, RECALL или AWARENESS). Если вы не добавите сегмент segments.brand_lift_measurement_type, API вернет показатели для одного автоматически выбранного типа измерения на сегмент. Добавьте сегмент segments.date, чтобы разбить показатели Brand Lift по датам (YYYY-MM-DD). Показатель metrics.cost_per_lifted_cookie возвращается в микроединицах валюты аккаунта, в котором проводится исследование.

В Google Ads API версии 27 и более поздних вы также можете выбрать поле lift_guidance (lift_guidance.outcome и lift_guidance.guidance_message, тип LiftGuidance) только для чтения (OUTPUT_ONLY) в предложении SELECT языка запросов Google Рекламы (GAQL) для lift_measurement_config и пяти ресурсов разбивки Brand Lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender и lift_measurement_video), чтобы получить статистическую интерпретацию на уровне строк. В lift_measurement_config поле lift_guidance заполняется, только если в запросе также выбраны или отфильтрованы показатели или сегменты роста (оно опускается в запросах конфигурации, содержащих только метаданные), а lift_guidance.guidance_message может содержать встроенные ссылки Markdown (например, [Learn more](https://support.google.com/...)). Вы не можете фильтровать или сортировать подполя lift_guidance в предложениях WHERE или ORDER BY. Описания значений LiftOutcomeEnum.LiftOutcome, возвращаемых в lift_guidance.outcome, приведены в статье Как интерпретировать результаты Brand Lift.

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

Отчеты Brand Lift ограничены по времени (требуется задержка в 24–48 часов после начала исследования) и по количеству ответов для каждого типа измерений (segments.brand_lift_measurement_type), чтобы обеспечить статистическую значимость и соблюдение порогов конфиденциальности.

  • Доля положительных ответов (metrics.brand_lift_baseline_positive_response_rate* и metrics.brand_lift_exposed_positive_response_rate*): не менее 50 ответов на опрос в соответствующей группе (экспериментальной или контрольной).
  • Строгий порог положительного роста (исследование в целом по LiftMeasurementConfig или независимый сегмент). Статистически положительный рост (p_value <= 0.50) при наличии не менее 2000 ответов в целом и 860 ответов на группу.
  • Менее строгий порог положительного роста для сегмента (для ресурса разбивки, когда общее исследование соответствует строгому порогу с положительным ростом): статистически положительный рост (p_value <= 0.50) при наличии не менее 500 ответов в целом и 200 ответов на группу.
  • Пороговое значение для завершения исследования без положительного роста (NO_SIGNIFICANT_LIFT по сравнению с NOT_ENOUGH_DATA). Если статистически значимый положительный рост не обнаружен,то для каждого показателя должно быть получено не менее 4100 ответов.

Запросы к LiftMeasurementConfig и пяти ресурсам разбивки Brand Lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign и LiftMeasurementVideo) возвращают пустой ответ (results: []), а не ошибку в следующих случаях:

  • Запрошенный параметр customer_id не находится в белом списке или не владеет исследованием.
  • Фильтры по дате WHERE не соответствуют датам выполнения (lift_measurement_flight.start_date и lift_measurement_flight.end_date).
  • Исследование или определенный сегмент (демографическая группа, устройство, кампания или видео) не соответствует требованиям к задержке отчетов (24–48 часов) и количеству ответов на опрос, даже если LiftMeasurementConfig возвращает общие результаты исследования.

Чтобы устранить неполадки с пустыми ответами, выполните следующие действия:

  1. Выполните запрос lift_measurement_flight, чтобы проверить, что lift_measurement_flight.status = 'ENABLED'. Убедитесь, что фильтры дат WHERE находятся в диапазоне между lift_measurement_flight.start_date и lift_measurement_flight.end_date, и проверьте ход выполнения опроса в lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (где 1000000 равно 100 %).
  2. Прежде чем запрашивать ресурсы с разбивкой по параметрам, отправьте запрос LiftMeasurementConfig, чтобы узнать, получены ли в рамках исследования показатели Brand Lift, которые можно включить в отчет.

Как интерпретировать результаты Brand Lift

В Google Ads API версии 27 и более поздних поле lift_guidance.outcome возвращает значение LiftOutcomeEnum.LiftOutcome, которое классифицирует статистическое состояние каждой возвращенной строки, а также человекочитаемые рекомендации по исправлению в lift_guidance.guidance_message:

  • Результаты текущего исследования (когда lift_measurement_flight.status – это ENABLED, а текущая дата в часовом поясе клиента – это lift_measurement_flight.end_date или более ранняя дата, при этом lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros меньше 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: исследование проводится, и уже наблюдается положительный рост.
    • STUDY_IN_PROGRESS_NO_LIFT_YET – исследование продолжается, начальный объем данных достаточен, статистически значимый рост пока не обнаружен.
    • STUDY_IN_PROGRESS_COLLECTING_DATA – исследование выполняется, и в настоящее время собираются ответы на опросы, необходимые для достижения пороговых значений статистической отчетности.
  • Результаты завершенного исследования (когда прошло lift_measurement_flight.end_date или lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros достигло 1000000):
    • POSITIVE_LIFT_DETECTED – в завершенном исследовании или сегменте обнаружен статистически значимый положительный рост.
    • NO_SIGNIFICANT_LIFT – завершенное исследование или сегмент соответствуют пороговым значениям статистической точности (всего не менее 4100 ответов на показатель), и статистически значимого положительного роста не обнаружено.
    • NOT_ENOUGH_DATA – в завершенном исследовании или сегменте не достигнуто пороговое значение ответов, необходимое для статистической значимости (не менее 2000 ответов в целом и 860 ответов на группу для положительного роста в исследовании в целом, 500 ответов в целом и 200 ответов на группу для положительного роста в сегменте, если в исследовании в целом наблюдается положительный рост, или 4100 ответов в целом на показатель, если положительный рост не обнаружен).

При интерпретации результатов Brand Lift следуйте приведенным ниже рекомендациям.

  • Текущие и завершенные периоды (STUDY_IN_PROGRESS_*). Пока период исследования ENABLED не завершен (не прошло lift_measurement_flight.end_date и response_collection_ratio_micros не достигло 1000000), ответы на опросы и моделирование с поправкой на систематическую погрешность ещё не стабилизировались. Показатели, полученные в ходе кампании, следует считать предварительными. Не приостанавливайте кампании и не сокращайте бюджеты до их завершения.
  • Положительный Brand Lift (POSITIVE_LIFT_DETECTED). Если обнаружен положительный Brand Lift, запросите ресурсы разбивки по параметрам (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign и LiftMeasurementVideo), чтобы определить наиболее эффективные когорты аудитории ("яркие пятна") и оценить резонанс креативов по всей воронке бренда.
  • Недостаточно данных или нет значительного роста (NOT_ENOUGH_DATA или NO_SIGNIFICANT_LIFT). Если количество ответов на опрос недостаточно (менее 4100 ответов на показатель без положительного роста или меньше строгих пороговых значений 2000/860 или мягких пороговых значений 500/200 для положительного роста) или в сегменте не обнаружен статистически значимый рост, не считайте это неудачей кампании и не исключайте аудитории на основе недостаточности выборки в одном сегменте. Проверьте общие показатели исследования на вкладке LiftMeasurementConfig, запросите другие значения segments.brand_lift_measurement_type (например, RECALL или AWARENESS в верхней части воронки) и проверьте оставшиеся параметры разбивки.

Примеры запросов Brand Lift

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

Запрос сведений о рейсе

Чтобы получить метаданные о периоде исследования Brand Lift, например его статус, тип отслеживания, запланированные даты и ход сбора данных, отправьте запрос к ресурсу LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста (lift_measurement_config.lift_measurement_config_id).

Запрос статистики

Чтобы получить показатели Brand Lift, запросите ресурс LiftMeasurementConfig или соответствующий ресурс разбивки. Например, следующий запрос извлекает показатели Brand Lift, сегментированные по кампаниям и типам показателей Brand Lift, из ресурса LiftMeasurementCampaign:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.

Отчеты о росте конверсий

В Google Ads API версии 25 и более поздних версиях отчеты Conversion Lift позволяют оценить дополнительное влияние вашей рекламы на конверсии и ценность конверсии. В ходе исследования Conversion Lift сравнивается поведение пользователей, которые могли видеть вашу рекламу (экспериментальная группа), и тех, кто не мог (контрольная группа).

Конфигурации, периоды и ссылки на эксперименты для роста конверсий доступны в Google Ads API только для чтения (все поля имеют значение OUTPUT_ONLY). Их можно настроить в интерфейсе Google Рекламы или с помощью представителя Google или GPS. Запросите ресурс lift_measurement_config, используя параметр customer_id аккаунта, которому принадлежит исследование. Управляющий аккаунт может напрямую запрашивать данные исследований Conversion Lift в нескольких аккаунтах, которыми он владеет. Запрашивать исследования, принадлежащие дочернему аккаунту, с помощью параметра customer_id дочернего аккаунта (при необходимости с аутентификацией через заголовок login-customer-id).

Отчеты Conversion Lift поддерживают два рабочих процесса, которые используют одинаковые обнаружение исследований и периодов, диапазоны дат для совокупных данных и области действия-конверсии:

  • Отчеты Conversion Lift. Позволяют оценить общую инкрементальность, цену за дополнительную конверсию (iCPA) и дополнительную рентабельность инвестиций в рекламу (iROAS) для выбранных или всех действий-конверсий из кампаний, которые отслеживаются в исследовании.
  • Отчеты об A/B-тестировании и Conversion Lift. Позволяют оценить инкрементальность для каждой группы и байесовские показатели победителя между двумя конкурирующими группами эксперимента (контрольной и экспериментальной), а также общую инкрементальность исследования.

Чтобы составить корректные запросы к ресурсу lift_measurement_config, используйте конструктор запросов Google Рекламы.

В Google Ads API версии 27 и более поздних вы можете выбрать поле lift_measurement_config.lift_guidance (lift_guidance.outcome и lift_guidance.guidance_message, тип LiftGuidance) только для чтения (OUTPUT_ONLY) в предложении SELECT GAQL для lift_measurement_config, чтобы получать статистическую интерпретацию на уровне строк для отдельных запросов Conversion Lift и A/B + Conversion Lift. В lift_measurement_config поле lift_guidance заполняется, только если в запросе также выбраны или отфильтрованы показатели или сегменты Lift (оно опускается в запросах конфигурации, предназначенных только для метаданных), а lift_guidance.guidance_message может содержать встроенные ссылки Markdown (например, [Learn more](https://support.google.com/...)). Вы не можете фильтровать или сортировать подполя lift_guidance в предложениях WHERE или ORDER BY. Поле lift_guidance.outcome возвращает одно из следующих значений LiftOutcomeEnum.LiftOutcome:

  • Результаты текущего исследования (когда lift_measurement_flight.status – это ENABLED, а текущая дата в часовом поясе клиента – это lift_measurement_flight.end_date или более ранняя дата):
    • STUDY_IN_PROGRESS_WITH_LIFT: исследование проводится, и уже наблюдается положительный рост.
    • STUDY_IN_PROGRESS_NO_LIFT_YET – исследование продолжается, начальный объем данных достаточен, статистически значимый рост пока не обнаружен.
    • STUDY_IN_PROGRESS_COLLECTING_DATA – исследование выполняется, идет сбор данных о конверсиях для достижения пороговых значений статистической отчетности.
  • Результаты завершенного исследования (когда прошло lift_measurement_flight.end_date):
    • POSITIVE_LIFT_DETECTED – в завершенном исследовании, группе эксперимента или сегменте обнаружен статистически значимый положительный рост.
    • AB_WINNER_WITH_LIFT – A/B-тестирование и исследование Conversion Lift завершены, определена группа эксперимента-победитель, и рост конверсий по сравнению с контрольной группой статистически значим.
    • AB_WINNER_PARITY_VS_CONTROL: завершено исследование A/B + Conversion Lift, в котором одна из групп эксперимента показала лучшие результаты, чем другая, но такие же, как контрольная группа.
    • NO_SIGNIFICANT_LIFT – завершенное исследование, группа эксперимента или сегмент достигли пороговых значений статистической точности, и статистически значимого положительного роста не обнаружено.
    • NOT_ENOUGH_DATA: в завершенном исследовании, группе эксперимента или сегменте не набралось достаточно конверсий, чтобы достичь пороговых значений статистической точности.

Как посмотреть конфигурации и периоды исследования

Чтобы создать отчет об исследовании Conversion Lift, сначала узнайте конфигурацию исследования и его расписание:

  1. Получите конфигурацию исследования. Запросите ресурс LiftMeasurementConfig, чтобы получить название исследования, долю контрольной группы (lift_measurement_config.conversion_lift_holdback_ratio_micros), отслеживаемые действия-конверсии (lift_measurement_config.conversion_actions) и, если вы используете Google Ads API версии 26 или более поздней, активно связанные кампании (lift_measurement_config.campaigns). Значение поля conversion_lift_holdback_ratio_micros выражается в микроединицах, где 1,000,000 равно 100 % (например, 300000 соответствует контрольной группе в 30 %). Если вы не знаете CONFIG_ID исследования, опустите условие WHERE, чтобы получить список всех конфигураций исследований в аккаунте.
  2. Получите периоды наблюдения за рейсами. Запросите ресурс LiftMeasurementFlight, чтобы найти запланированные даты рейсов (lift_measurement_flight.start_date и lift_measurement_flight.end_date) в часовом поясе клиента. Поскольку один ресурс LiftMeasurementConfig может группировать периоды исследований Brand Lift (SURVEY), Conversion Lift (CONVERSION) и Search Lift (SEARCH), добавьте поле lift_measurement_flight.lift_type в условие SELECT и отфильтруйте по lift_measurement_flight.lift_type = 'CONVERSION' в условии WHERE. Поля lift_measurement_flight.start_date и lift_measurement_flight.end_date можно сортировать в условиях ORDER BY, но нельзя фильтровать в условиях WHERE.

Следующий запрос позволяет получить конфигурацию исследования (в Google Ads API версии 25 опустите поле lift_measurement_config.campaigns, так как оно поддерживается только в версии 26 и более поздних):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста (lift_measurement_config.lift_measurement_config_id).

Следующий запрос позволяет получить расписание показов Conversion Lift для исследования:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста (lift_measurement_config.lift_measurement_config_id).

В Google Ads API версии 26 и более поздних вы также можете узнать конфигурацию измерения роста, связанную с кампанией, непосредственно из ресурса campaign, запросив поле campaign.lift_measurement_config. Запрос этого поля позволяет избежать необходимости отдельно сопоставлять данные ресурса LiftMeasurementConfig:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

Замените следующее:

  • CAMPAIGN_ID – целочисленный идентификатор кампании (campaign.id).

Поле campaign.lift_measurement_config возвращает название ресурса в формате customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Если кампания участвовала в нескольких исследованиях роста, в этом поле указывается последняя связанная конфигурация (активная или неактивная). В поле lift_measurement_config.campaigns указываются только активно связанные кампании.

Запрос диапазонов дат для сводных данных

Результаты исследования Conversion Lift представлены в виде ежедневных сводок, начиная с даты начала периода показа рекламы.

  • Сегмент segments.conversion_lift_start_date остается привязанным к дате начала периода показа (lift_measurement_flight.start_date).
  • Сегмент segments.conversion_lift_end_date ежедневно увеличивается до даты окончания кампании (lift_measurement_flight.end_date).

Поля segments.conversion_lift_start_date и segments.conversion_lift_end_date – это поля INT64, отформатированные как восьмизначные целые числа без кавычек и дефисов в формате YYYYMMDD (например, 20260501). Поля lift_measurement_flight.start_date и lift_measurement_flight.end_date возвращают строки даты в формате ISO 8601 YYYY-MM-DD (например, 2026-05-01). В отличие от запросов Brand Lift и эффективности на основе поисковых запросов, сегмент segments.date несовместим со всеми показателями и сегментами роста конверсий. Если выбрать сегмент segments.date вместе с сегментами Conversion Lift (например, segments.conversion_lift_start_date) в условии SELECT, будет возвращена ошибка QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, а если объединить segments.date с показателями Conversion Lift – ошибка QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

Последний вычисленный снимок может отставать от даты окончания активного периода показа, пока обрабатываются данные. Чтобы определить, какой из оцененных снимков является самым новым, всегда запрашивайте ресурс lift_measurement_config для доступных пар (segments.conversion_lift_start_date, segments.conversion_lift_end_date), упорядоченных по segments.conversion_lift_end_date DESC.

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

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.

Фильтровать по области действия-конверсии

Conversion Lift оценивает инкрементальность в двух областях, определяемых сегментом segments.conversion_lift_included_conversion_action_types:

  • SELECTED – действия-конверсии, выбранные при настройке исследования, или все основные действия-конверсии, если собственные действия-конверсии не были указаны.
  • ALL – все действия-конверсии из кампаний, которые оцениваются в исследовании.

Если вы запрашиваете ресурс lift_measurement_config для показателей Conversion Lift без фильтрации по сегменту segments.conversion_lift_included_conversion_action_types, API возвращает две строки на фрагмент: одну для ALL и одну для SELECTED. В GAQL любое поле сегмента, не связанное с датой (и любое поле сегмента даты снимка Conversion Lift), отфильтрованное в условии WHERE, также должно быть указано в условии SELECT. В противном случае API возвращает ошибку QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Если вы фильтруете по segments.conversion_lift_included_conversion_action_types = 'SELECTED' в условии WHERE, включите этот сегмент в условие SELECT.

Отдельные отчеты о росте конверсий

Отдельные исследования Conversion Lift позволяют оценить дополнительный эффект от рекламы по сравнению с контрольной группой, не видевшей рекламу, без разделения кампаний на конкурирующие экспериментальные группы.

Conversion Lift и iCPA

В отчетах Conversion Lift приводятся точечные оценки и 90-процентные односторонние доверительные границы (*_p90_lower_bound и *_p90_upper_bound, которые вместе образуют 80-процентный двусторонний доверительный интервал), а также p-значения (p_value <= 0.10 соответствует 90-процентной односторонней статистической значимости):

API не возвращает показатели Conversion Lift в следующих случаях:

  • Окно снимка меньше четырех дней.
  • Количество зарегистрированных конверсий без масштабирования меньше минимального порога точности (менее 65 зарегистрированных базовых конверсий в контрольной группе или менее 150 зарегистрированных конверсий в экспериментальной группе, оцененных до масштабирования metrics.conversion_lift_baseline_conversions).
  • Измеренный рост не является положительным (metrics.incremental_conversions_p_value > 0.5 для показателей конверсий или metrics.incremental_conversion_value_p_value > 0.5 для показателей ценности конверсий).
  • В Google Ads API версии 27 и более поздних версиях показатели iROAS (metrics.incremental_conversion_value_per_cost*) и показатели выигрыша по ценности конверсии (metrics.incremental_conversion_value_winner_score и metrics.incremental_conversion_value_per_cost_winner_score) запрашиваются в исследовании, в котором в качестве основного показателя было настроено количество конверсий, а не ценность конверсии. Показатели ценности конверсии, не связанные с расходами (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* и metrics.relative_conversion_value_lift*), по-прежнему заполняются в исследованиях, где основным показателем является количество конверсий, если можно создать отчет о росте ценности конверсий.
  • Несколько строк или исследований агрегируются, поскольку вы не указали поля lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date или segments.conversion_lift_included_conversion_action_types в предложении SELECT.

При интерпретации результатов исследования роста конверсий учитывайте следующие рекомендации:

  • Текущие и завершенные периоды (STUDY_IN_PROGRESS_*). Пока период исследования ENABLED не завершен (текущая дата в часовом поясе клиента – lift_measurement_flight.end_date или ранее), моделирование конверсий в контрольной и экспериментальной группах и атрибуция отложенных конверсий ещё не стабилизировались. Показатели, полученные в ходе кампании, следует считать предварительными. Не приостанавливайте кампании и не сокращайте бюджеты до их завершения.
  • Positive lift (POSITIVE_LIFT_DETECTED): Отчетность по показателю Conversion Lift и триггер lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' доступны, если измеренный рост положительный (p_value <= 0.50, что соответствует достоверности не менее 50 % с положительной точечной оценкой, а p_value <= 0.10 указывает на одностороннюю статистическую значимость 90 %, где *_p90_lower_bound >= 0) и достигнуты минимальные пороговые значения точности (не менее четырех дней сбора данных, не менее 65 немасштабированных базовых конверсий и не менее 150 немасштабированных конверсий в экспериментальной группе). Если рост положительный, запросите разбивку по параметрам (демографические данные, устройство, страна, категория конверсии или действие-конверсия), чтобы определить наиболее эффективные когорты.
  • Недостаточно данных или нет значительного роста (NOT_ENOUGH_DATA или NO_SIGNIFICANT_LIFT). Если объем данных недостаточен (менее 65 немасштабированных базовых конверсий или менее 150 немасштабированных конверсий в экспериментальной группе) или в сегменте не обнаружен статистически значимый рост, не считайте это неудачей кампании и не исключайте аудитории на основе недостаточности выборки в одном сегменте. Проверьте общие показатели исследования и запрос segments.conversion_lift_included_conversion_action_types = 'ALL' (если в SELECTED не наблюдается рост) или оставшиеся разбивки по параметрам, чтобы узнать, был ли положительный рост изолирован в другом месте.

Следующий запрос позволяет получить общую инкрементальность конверсий, доверительные границы и цену за дополнительную конверсию:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Как узнать рост ценности конверсий и дополнительную рентабельность инвестиций в рекламу

Чтобы оценить дополнительный доход, полученный благодаря расходам на рекламу, запросите показатели ценности конверсий и показатель metrics.incremental_conversion_value_per_cost. Показатели ценности конверсий, не связанные с расходами (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* и metrics.relative_conversion_value_lift*), заполняются, если в исследовании есть рост ценности конверсий, который можно включить в отчет, независимо от того, является ли основным показателем исследования количество конверсий или их ценность. В Google Ads API версии 27 и более поздних версиях показатели iROAS (metrics.incremental_conversion_value_per_cost*), а также metrics.incremental_conversion_value_winner_score и metrics.incremental_conversion_value_per_cost_winner_score возвращаются, только если при настройке исследования в качестве основного показателя была выбрана ценность конверсии. В исследованиях, где основным показателем является количество конверсий, они не возвращаются.

Следующий запрос позволяет получить данные о дополнительной ценности конверсий, доверительных границах и дополнительной рентабельности инвестиций в рекламу:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Сегментирование результатов по параметру

Сегментируйте показатели дополнительных конверсий по категории конверсии, действию-конверсии, демографическим данным, устройству или географическому местоположению. При запросе ресурса lift_measurement_config выбирайте только совместимые комбинации сегментов:

  • Сегменты по категории конверсии и действию-конверсии. Вы можете выбрать сегменты segments.conversion_lift_conversion_category, segments.conversion_action и segments.conversion_action_name по отдельности, объединить их друг с другом или с одним демографическим параметром, параметром устройства или страны. При запросе сегмента segments.experiment_arm совместим только сегмент segments.conversion_lift_conversion_category.
  • Сегменты по демографическим данным, устройствам и географическим данным. Параметры segments.age_range, segments.gender, segments.device и страна (segments.country с segments.country_localized_name) несовместимы друг с другом и с сегментом segments.experiment_arm. В одном запросе можно использовать не более одного из этих четырех параметров.

Если в пункте SELECT выбрать несовместимые сегменты, запрос не пройдет проверку и будет возвращена ошибка QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Чтобы проверить комбинации сегментов в интерактивном режиме, используйте конструктор запросов Google Рекламы.

Оценивайте показатели экономической эффективности (metrics.cost_per_incremental_conversion* и metrics.incremental_conversion_value_per_cost*) только в строках с общими данными исследования или строках segments.experiment_arm. В Google Ads API версий 25 и 26 схема позволяет выбирать шесть показателей соотношения расходов (metrics.cost_per_incremental_conversion, metrics.cost_per_incremental_conversion_p90_lower_bound, metrics.cost_per_incremental_conversion_p90_upper_bound, metrics.incremental_conversion_value_per_cost, metrics.incremental_conversion_value_per_cost_p90_lower_bound и metrics.incremental_conversion_value_per_cost_p90_upper_bound) с восемью сегментами, не относящимися к вариантам (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country и segments.country_localized_name). Начиная с Google Ads API версии 27, выбор любого из этих шести показателей соотношения расходов с любым из этих восьми сегментов, не относящихся к вариантам, приводит к сбою проверки запроса и возвращает ошибку QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Показатели ценности конверсий, не связанные с расходами (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* и metrics.relative_conversion_value_lift*), по-прежнему поддерживаются в сегментах по категории конверсии, действию-конверсии, демографическим данным, устройству и стране, если можно получить данные о росте ценности конверсий (независимо от того, является ли основным показателем исследования количество конверсий или их ценность).

Чтобы оценить рост по категориям конверсий, заданным в перечислении ConversionActionCategory (например, PURCHASE, SIGNUP или SUBMIT_LEAD_FORM), сегментируйте результаты по сегменту segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Сегмент segments.conversion_action возвращает название ресурса действия-конверсии в формате customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Выберите сегмент segments.conversion_action_name в ресурсе lift_measurement_config, чтобы получить человекочитаемые названия действий-конверсий без отдельного запроса к ресурсу conversion_action. Следующий запрос сегментирует показатели Conversion Lift по действию-конверсии, названию действия-конверсии и категории конверсии:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

В следующем запросе показатели Conversion Lift сегментируются по сегменту segments.device. Чтобы получить разбивку по демографическим данным (при необходимости в сочетании с сегментами по категории конверсии или действию-конверсии), замените сегмент segments.age_range или segments.gender в отдельных запросах:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Чтобы посмотреть результаты по географическим регионам, добавьте сегменты segments.country и segments.country_localized_name (при необходимости в сочетании с сегментами категорий конверсий или действий-конверсий). Сегмент segments.country возвращает глобальное название ресурса константы области геотаргетинга в формате geoTargetConstants/CRITERION_ID (например, geoTargetConstants/2840 для США).

В следующем запросе показатели Conversion Lift сегментируются по названию ресурса критерия страны и локализованному названию страны:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Отчеты об A/B-тестировании и росте конверсий

В Google Ads API версии 25 и более поздних версиях исследования A/B-тестирования и Conversion Lift сочетают эксперимент с двумя группами (сравнение контрольной и экспериментальной стратегий) с измерением контрольной группы в Google Ads API, чтобы оценить инкрементальность в каждой группе и рассчитать байесовские оценки победителей. В отличие от прямых отчетов об экспериментах на основе ресурса experiment, в которых сравниваются нескорректированные показатели трафика для разных групп, запросы к ресурсу lift_measurement_config с сегментом segments.experiment_arm позволяют оценить прирост для каждой группы по сравнению с контрольной группой, не видевшей рекламу.

Как найти эксперименты и группы

Исследование A/B + Conversion Lift связывает ресурс LiftMeasurementConfig с ресурсом experiment с двумя группами через поле experiment.lift_measurement_config, доступное только для чтения (OUTPUT_ONLY).

Чтобы найти связанный эксперимент и его группы в одном запросе, запросите ресурс ExperimentArm с атрибутированными полями experiment и отфильтруйте по полю experiment.lift_measurement_config. В ответе будет указан статус управления каждой группы (experiment_arm.control), разделение трафика (experiment_arm.traffic_split), связанные кампании (experiment_arm.campaigns) и название ресурса. Используйте возвращенное значение experiment_arm.resource_name (в формате customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID), чтобы отфильтровать сегмент segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

Замените следующее:

  • CUSTOMER_ID – 10-значный идентификатор клиента, которому принадлежит исследование (без дефисов).
  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.

Если вы начинаете с известного EXPERIMENT_ID (или хотите получить список всех экспериментов с ростом в аккаунте), выполните тот же запрос experiment_arm, отфильтрованный по WHERE experiment.experiment_id = EXPERIMENT_ID (или WHERE experiment.lift_measurement_config IS NOT NULL).

Запрос инкрементальности и показателей победителя для каждой группы

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

Следующие показатели байесовской оценки победителя позволяют определить вероятность (от 0.0 до 1.0, в сумме 1.0 для обеих групп, если в обеих группах есть положительный рост, который можно отразить в отчете) того, что определенная группа лучше:

  • metrics.incremental_conversions_winner_score – вероятность того, что эта группа является победителем по дополнительным конверсиям, нормализованная по разделению трафика группы (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score – вероятность того, что эта группа является победителем по дополнительной ценности конверсий, нормализованная по разделению трафика между группами (experiment_arm.traffic_split). В Google Ads API версии 27 и более поздних заполняется, только если основным показателем исследования является ценность конверсии, и опускается (остается незаданным) в исследованиях, где основным показателем является количество конверсий.
  • metrics.cost_per_incremental_conversion_winner_score – вероятность того, что эта группа объявлений является победителем по цене за дополнительную конверсию (самая низкая цена за дополнительную конверсию), нормализованная по расходам.
  • metrics.incremental_conversion_value_per_cost_winner_score – вероятность того, что эта группа является победителем по дополнительной ценности конверсий на стоимость (самая высокая дополнительная рентабельность инвестиций в рекламу), нормализованная по расходам. В Google Ads API версии 27 и более поздних версиях заполняется, только если основным показателем исследования является ценность конверсии, и опускается (остается незаданным) в исследованиях, где основным показателем является количество конверсий.

Следующий запрос возвращает инкрементальность и байесовские оценки победителя для обеих групп:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Чтобы отфильтровать данные по одной группе, добавьте AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' в условие WHERE, где EXPERIMENT_ID – идентификатор эксперимента, а ARM_ID – идентификатор группы, возвращенный в поле experiment_arm.resource_name. Сегмент segments.experiment_arm поддерживает фильтрацию в условиях WHERE (=, !=, IN, NOT IN), но вы не можете сортировать его в условии ORDER BY.

Как интерпретировать результаты A/B-тестирования и исследования Conversion Lift

В рамках исследования A/B-тестирования и Conversion Lift одновременно проверяются две гипотезы: превосходство одной группы над другой (metrics.*_winner_score) и причинно-следственный рост по сравнению с контрольной группой, не видевшей рекламу (metrics.incremental_* и *_p_value). Пока период исследования ENABLED ещё не завершен (STUDY_IN_PROGRESS_*, когда текущая дата в часовом поясе клиента совпадает с lift_measurement_flight.end_date или предшествует ей), сравнение групп и моделирование конверсий в контрольной группе ещё не стабилизировались. Показатели, полученные в ходе эксперимента, следует считать предварительными. Не продвигайте группу эксперимента и не перераспределяйте бюджеты до его завершения.

В завершенных исследованиях группа эксперимента считается победителем, если она соответствует минимальным пороговым значениям точности (не менее четырех дней сбора данных, 65 немасштабированных базовых конверсий и 150 немасштабированных конверсий в экспериментальной группе), имеет 0 <= p_value <= 0.50 и достигает байесовской оценки победителя выше 0.55 (> 0.55) по основному показателю исследования. В результате такой оценки по двум гипотезам определяются два разных состояния победителя (они также отражены в lift_guidance.outcome в Google Ads API версии 27 и более поздних):

  • Явный победитель с причинно-следственным ростом (AB_WINNER_WITH_LIFT). Победившая группа превосходит конкурирующую группу по показателям (winner_score > 0.55) и генерирует статистически значимые дополнительные конверсии или ценность конверсий по сравнению с контрольной группой. Продвигайте или масштабируйте стратегию победившей группы и запрашивайте разбивку по параметрам, чтобы проанализировать наиболее эффективные когорты.
  • Победитель в прямом сравнении наравне с контрольной группой (AB_WINNER_PARITY_VS_CONTROL). Победившая группа превосходит конкурирующую группу в прямом сравнении (winner_score > 0.55), но ни одна из них не дает статистически значимого дополнительного роста по сравнению с контрольной группой, не видевшей рекламу, на запрашиваемом уровне. Прежде чем увеличивать расходы на победившую группу, запросите данные о конверсиях ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') и разбивку segments.conversion_lift_conversion_category, чтобы проверить, не был ли положительный рост изолирован в другом месте.

Результат POSITIVE_LIFT_DETECTED применяется к запросам A/B-тестирования и Conversion Lift на следующих уровнях детализации:

  • Строки исследования с комбинированной группой (OVERALL) (запросы без segments.experiment_arm). Исследование показало положительный рост по сравнению с контрольной группой (p_value <= 0.50), и ни одна из групп не достигла показателя победителя в прямом сравнении, превышающего 0.55.
  • Строки для каждой группы (segments.experiment_arm). Если одна группа побеждает (winner_score > 0.55) и обе группы достигают положительного роста по сравнению с контрольной группой, строка победившей группы возвращает AB_WINNER_WITH_LIFT, а строка проигравшей группы – POSITIVE_LIFT_DETECTED.
  • Строки среза "Категория конверсии" (segments.conversion_lift_conversion_category). В строках с положительным ростом всегда возвращается POSITIVE_LIFT_DETECTED, поскольку оценки победителей не рассчитываются для отдельных категорий конверсий.

Если для сегмента возвращается значение NOT_ENOUGH_DATA или NO_SIGNIFICANT_LIFT, не приостанавливайте варианты и не исключайте аудитории на основе недостаточного размера выборки в одном сегменте. Проверьте общие показатели исследования и ALL конверсий (segments.conversion_lift_included_conversion_action_types = 'ALL').

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

Если вы не укажете сегмент segments.experiment_arm в запросе к ресурсу lift_measurement_config, API вернет инкрементальность на уровне исследования, агрегированную по обеим группам. В запросах с комбинированными вариантами опустите четыре показателя metrics.*_winner_score, которые применяются только к конкурирующим вариантам и опускаются (остаются незаданными) в строках с комбинированными вариантами без segments.experiment_arm. Используйте запросы на уровне исследования в разделах Запрос роста конверсий и iCPA и Запрос роста ценности конверсий и iROAS.

Если вы сегментируете результаты A/B-тестирования и Conversion Lift по сегменту segments.experiment_arm, то API поддерживает только сегмент segments.conversion_lift_conversion_category в качестве дополнительного параметра разбивки. Поскольку расходы группы не связаны с отдельными категориями конверсий, при включении сегмента segments.conversion_lift_conversion_category оценивайте показатели роста конверсий и их ценности (не учитывая цену за дополнительную конверсию и дополнительную рентабельность инвестиций в рекламу, которые не проходят проверку запроса с ошибкой QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE в Google Ads API версии 27 и более поздних). Сегменты segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name и segments.date несовместимы с сегментом segments.experiment_arm и показателями metrics.*_winner_score. Если выбрать любой из этих несовместимых сегментов вместе с segments.experiment_arm, возвращается ошибка QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (и ошибка QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE, если в запросе также выбран любой показатель metrics.*_winner_score).

Чтобы получить результаты для нескольких конфигураций исследований в одном запросе, используйте оператор IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Замените следующее:

  • CONFIG_ID_1 – целочисленный идентификатор первой конфигурации измерения роста.
  • CONFIG_ID_2 – целочисленный идентификатор второй конфигурации измерения роста.
  • START_DATE – дата начала периода, за который создается снимок, в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260501).
  • END_DATE – дата окончания снимка в виде восьмизначного целого числа YYYYMMDD без кавычек (например, 20260515).

Точное совпадение дат (= START_DATE и = END_DATE) возвращает строки только для исследований, у которых совпадает окно статистики. При запросе исследований с разными датами начала или последними оцененными датами снимков используйте операторы диапазона (>= и <=) или не указывайте фильтры дат в условии WHERE, но сохраните сегменты segments.conversion_lift_start_date и segments.conversion_lift_end_date в условии SELECT.

Отчеты об эффективности на основе поисковых запросов

Чтобы узнать, насколько увеличилось количество поисковых запросов в результате ваших рекламных кампаний, в Google Ads API версии 26 и более поздних версиях можно запрашивать ресурсы отчетов об эффективности на основе поисковых запросов. Search Lift позволяет оценить разницу в поисковом поведении пользователей, которые видели вашу рекламу, и пользователей из контрольной группы, которые ее не видели.

Ресурсы и сегментация для Search Lift

Чтобы получить подробные сведения о наборах ключевых слов, настроенных для исследований эффективности на основе поисковых запросов, отправьте запрос к ресурсу SearchLiftKeywordBundle. Ресурс SearchLiftKeywordBundle в Google Ads API доступен только для чтения (все поля имеют статус OUTPUT_ONLY). Наборы ключевых слов настраиваются в интерфейсе Google Рекламы, представителем Google или контактным лицом GPS. Поля, которые можно запрашивать в GAQL: resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) и status (SearchLiftKeywordBundleStatus). Повторяющееся поле keywords нельзя выбрать в запросах GAQL.

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

В Google Ads API версии 27 и более поздних вы также можете выбрать поле lift_measurement_config.lift_guidance (lift_guidance.outcome и lift_guidance.guidance_message, тип LiftGuidance) только для чтения (OUTPUT_ONLY) в пункте SELECT GAQL в lift_measurement_config при запросе показателей или сегментов Search Lift (segments.search_lift_keyword_bundle или segments.search_property). В lift_measurement_config lift_guidance опускается в запросах конфигурации только для метаданных, а lift_guidance.guidance_message может содержать встроенные ссылки Markdown (например, [Learn more](https://support.google.com/...)). Для Search Lift lift_guidance.outcome возвращает STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (достоверность не менее 70 %, p_value <= 0.30), NO_SIGNIFICANT_LIFT или NOT_ENOUGH_DATA (оценивается по пороговым значениям не менее 1 000 000 показов в целом или 100 000 показов в сегменте, не менее 75 наблюдаемых поисковых запросов и не менее 17 из 20 сегментов файлов cookie, где один недостаточно эффективный пакет ключевых слов приводит к тому, что в общих результатах исследования сообщается NOT_ENOUGH_DATA).

Анализ эффективности Search Lift по следующим параметрам:

  • segments.search_lift_keyword_bundle Сегментирование по названию ресурса пакета ключевых слов. Совместим с сегментами segments.search_property, segments.date и сегментами на основе демографических данных (segments.device, segments.age_range и segments.gender). В каждом пакете ключевых слов указывается полная стоимость кампании и количество показов, а ключевые слова могут принадлежать нескольким пакетам. Не суммируйте показатели metrics.search_lift_cost_micros, metrics.search_lift_impressions и Search Lift по наборам ключевых слов.
  • segments.search_property – сегментирование по ресурсу, в котором выполнялся поиск. Определяется перечислением SearchLiftSearchProperty (например, GOOGLE_SEARCH или YOUTUBE). Сегмент segments.search_property совместим только с сегментами segments.search_lift_keyword_bundle и segments.date. Если объединить segments.search_property с сегментами на основе демографических данных (segments.device, segments.age_range или segments.gender), запрос не пройдет проверку. Поскольку segments.search_property разделяет данные по местам, где выполнялся последующий органический поиск, а не по местам показа объявлений, в строках, сегментированных по segments.search_property, повторяются неразделенные данные о расходах и показах на уровне кампании в Google Ads API версии 26. Начиная с версии 27 Google Ads API все восемь показателей расходов и показов (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* и metrics.normalized_incremental_searches_per_impression*) несовместимы с segments.search_property, и при проверке запроса возникает ошибка QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Демографические сегменты и сегменты по дате: segments.device, segments.age_range, segments.gender и segments.date.

Показатели эффективности на основе поисковых запросов

Ресурс LiftMeasurementConfig предоставляет метрики Search Lift для оценки изменений в поисковом поведении.

  • metrics.relative_search_lift – разница в количестве поисковых запросов между экспериментальной и контрольной группами, выраженная как доля поисковых запросов в контрольной группе.
  • metrics.relative_search_lift_p90_lower_bound и metrics.relative_search_lift_p90_upper_bound – односторонние доверительные границы 90 % (которые вместе образуют двусторонний доверительный интервал 80 %) для относительного роста эффективности на основе поисковых запросов.
  • metrics.incremental_searches_p_value – p-значение для дополнительных поисковых запросов, представляющее собой статистическую вероятность того, что наблюдаемый рост количества поисковых запросов произошел случайно.
  • metrics.search_lift_cost_micros – общая стоимость (в микроединицах) показов объявлений, выполненных для этого сегмента оценки Search Lift. Несовместимо с segments.search_property в Google Ads API версии 27 и более поздних.
  • metrics.search_lift_impressions – общее количество показов объявлений, выполненных в рамках этого сегмента исследования Search Lift. Несовместимо с segments.search_property в Google Ads API версии 27 и более поздних.

Если рост статистически положителен, в отчетах приводятся следующие нормализованные дополнительные показатели, а также соответствующие им односторонние доверительные границы 90 % (*_p90_lower_bound и *_p90_upper_bound):

Примеры запросов для исследования эффективности на основе поисковых запросов

В приведенных ниже запросах GAQL показано, как получить пакеты ключевых слов и показатели эффективности для Search Lift.

Запрос набора ключевых слов

Чтобы получить наборы ключевых слов, настроенные для измерения Search Lift, запросите ресурс search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

Запрос показателей

Значения search_lift_keyword_bundle.resource_name, полученные в запросе пакета ключевых слов, соответствуют значениям, возвращенным в сегменте segments.search_lift_keyword_bundle в следующем запросе. Чтобы узнать CONFIG_ID, связанные кампании и расписание показов для исследования, следуйте инструкциям в статье Как узнать конфигурации и показы исследований в ресурсах lift_measurement_config и lift_measurement_flight (отфильтровав показы по lift_measurement_flight.lift_type = 'SEARCH').

Следующий запрос позволяет получить показатели Search Lift с сегментированием по набору ключевых слов и поисковому ресурсу (при выборе metrics.search_lift_cost_micros или metrics.search_lift_impressions опустите segments.search_property):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Замените следующее:

  • CONFIG_ID – целочисленный идентификатор конфигурации измерения роста.