Experiment

Эксперимент с рекламой Google, позволяющий пользователям экспериментировать с изменениями в нескольких кампаниях, сравнивать эффективность и применять эффективные изменения.

JSON-представление
{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string
}
Поля
resourceName

string

Неизменный. Имя ресурса эксперимента. Имена ресурсов эксперимента имеют вид:

customers/{customerId}/experiments/{experimentId}

name

string

Необходимый. Название эксперимента. Он должен иметь минимальную длину 1 и максимальную длину 1024. Он должен быть уникальным для клиента.

description

string

Описание эксперимента. Он должен иметь минимальную длину 1 и максимальную длину 2048.

suffix

string

Для экспериментов, управляемых системой, рекламодатель должен предоставить суффикс во время создания, на этапе настройки, прежде чем переходить к этапу «Инициировано». Суффикс будет добавлен к названиям проектных и экспериментальных кампаний, чтобы имя представляло собой базовое название кампании + суффикс.

type

enum ( ExperimentType )

Необходимый. Продукт/функция, использующая этот эксперимент.

status

enum ( ExperimentStatus )

Статус этого эксперимента, выбранный рекламодателем.

goals[]

object ( MetricGoal )

Цели этого эксперимента.

promoteStatus

enum ( AsyncActionStatus )

Только вывод. Статус процесса продвижения эксперимента.

experimentId

string ( int64 format)

Только вывод. Идентификатор эксперимента. Только чтение.

startDate

string

Дата начала эксперимента. По умолчанию эксперимент начинается сейчас или в дату начала кампании, в зависимости от того, что наступит позднее. Если это поле задано, то эксперимент начнется в начале указанной даты в часовом поясе заказчика.

Формат: ГГГГ-ММ-ДД. Пример: 14.03.2019.

endDate

string

Дата окончания эксперимента. По умолчанию эксперимент заканчивается в дату окончания кампании. Если это поле задано, то эксперимент завершается в конце указанной даты в часовом поясе клиента.

Формат: ГГГГ-ММ-ДД. Пример: 18 апреля 2019 г.

longRunningOperation

string

Только вывод. Имя ресурса длительной операции, которое можно использовать для опроса завершения расписания эксперимента или продвижения. Возвращается самая последняя длительная операция.

Тип эксперимента

Тип эксперимента.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
DISPLAY_AND_VIDEO_360 Это эксперимент DISPLAY_AND_VIDEO_360.
AD_VARIATION Это эксперимент по вариациям рекламы.
YOUTUBE_CUSTOM Специальный эксперимент, состоящий из видеокампаний.
DISPLAY_CUSTOM Специальный эксперимент, состоящий из медийных кампаний.
SEARCH_CUSTOM Пользовательский эксперимент, состоящий из поисковых кампаний.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Эксперимент, в котором сравниваются стратегии назначения ставок для медийных кампаний.
SEARCH_AUTOMATED_BIDDING_STRATEGY Эксперимент, сравнивающий стратегии назначения ставок для поисковых кампаний».
SHOPPING_AUTOMATED_BIDDING_STRATEGY Эксперимент, в котором сравниваются стратегии назначения ставок для торговых кампаний.
SMART_MATCHING УСТАРЕЛО. Умный эксперимент по сопоставлению с поисковыми кампаниями.
HOTEL_CUSTOM Специальный эксперимент с кампаниями для отелей.

Статус эксперимента

Статус эксперимента.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
ENABLED Эксперимент включен.
REMOVED Эксперимент удален.
HALTED Эксперимент остановлен. Этот статус можно установить из статуса ВКЛЮЧЕНО через API.
PROMOTED Эксперимент будет выведен из статуса экспериментального.
SETUP Исходное состояние эксперимента.
INITIATED Кампании эксперимента ожидают реализации. Этот статус можно установить из статуса SETUP через API.
GRADUATED Эксперимент окончен.

МетрикаЦель

Метрическая цель для эксперимента.

JSON-представление
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Поля
metric

enum ( ExperimentMetric )

Метрика цели. Например, клики, показы, стоимость, конверсии и т. д.

direction

enum ( ExperimentMetricDirection )

Метрическое направление цели. Например, увеличение, уменьшение, отсутствие изменений.

ЭкспериментМетрика

Тип метрики эксперимента.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
CLICKS Цель эксперимента — клики.
IMPRESSIONS Цель эксперимента – впечатления.
COST Цель эксперимента – стоимость.
CONVERSIONS_PER_INTERACTION_RATE Цель эксперимента — коэффициент конверсии.
COST_PER_CONVERSION Цель эксперимента — цена за конверсию.
CONVERSIONS_VALUE_PER_COST Целью эксперимента является соотношение ценности конверсии к затратам.
AVERAGE_CPC Целью эксперимента является средняя цена за клик.
CTR Цель эксперимента — ctr.
INCREMENTAL_CONVERSIONS Цель эксперимента — дополнительные конверсии.
COMPLETED_VIDEO_VIEWS Цель эксперимента — полные просмотры видео.
CUSTOM_ALGORITHMS Цель эксперимента — кастомные алгоритмы.
CONVERSIONS Цель эксперимента — конверсии.
CONVERSION_VALUE Цель эксперимента — ценность конверсии.

ЭкспериментМетричноеНаправление

Тип метрики эксперимента, направление.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
NO_CHANGE Цель эксперимента — не изменить метрику.
INCREASE Цель эксперимента — создать метрику.
DECREASE Цель эксперимента – уменьшить показатель.
NO_CHANGE_OR_INCREASE Цель эксперимента — либо не менять, либо увеличить метрику.
NO_CHANGE_OR_DECREASE Цель эксперимента — либо не менять, либо уменьшить метрику.

Асинкционатстатус

Статус асинхронного действия эксперимента.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN В этой версии значение неизвестно.
NOT_STARTED Действие не началось.
IN_PROGRESS Действие продолжается.
COMPLETED Действие завершилось успешно.
FAILED Действие не удалось.
COMPLETED_WITH_WARNING Действие завершилось успешно с предупреждениями.