Требуется авторизация
Создайте новый эксперимент. См. пример .
Помимо стандартных параметров , этот метод поддерживает параметры, перечисленные в таблице параметров.
Запрос
HTTP-запрос
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
Параметры
Имя параметра | Ценить | Описание |
---|---|---|
Параметры пути | ||
accountId | string | Идентификатор аккаунта, для которого нужно создать эксперимент. |
profileId | string | Идентификатор представления (профиля), для которого необходимо создать эксперимент. |
webPropertyId | string | Идентификатор веб-ресурса, для которого нужно создать эксперимент. |
Авторизация
Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).
Объем |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
Тело запроса
В теле запроса укажите ресурс Management.experiment со следующими свойствами:
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
Обязательные свойства | |||
name | string | Название эксперимента. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. Это поле обязательно для заполнения при создании эксперимента. | записываемый |
status | string | Статус эксперимента. Возможные значения: «ЧЕРНОВИК», «READY_TO_RUN», «RUNNING», «ENDED». Эксперименты можно создавать в состоянии «ЧЕРНОВИК», «READY_TO_RUN» или «RUNNING». Это поле обязательно для заполнения при создании эксперимента. | записываемый |
variations[]. name | string | Название вариации. Это поле обязательно для заполнения при создании эксперимента. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
Дополнительные свойства | |||
description | string | Заметки об этом эксперименте. | записываемый |
editableInGaUi | boolean | Если это правда, конечный пользователь сможет редактировать эксперимент через пользовательский интерфейс Google Analytics. | записываемый |
equalWeighting | boolean | Логическое значение, указывающее, следует ли распределять трафик равномерно по всем вариантам. Если значение равно False, эксперименты с контентом следуют стандартному поведению, заключающемуся в динамической корректировке трафика на основе вариаций эффективности. Необязательно – по умолчанию установлено значение False. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
minimumExperimentLengthInDays | integer | Целое число в [3, 90]. Указывает минимальную продолжительность эксперимента. Можно изменить для текущего эксперимента. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
objectiveMetric | string | Метрика, которую оптимизирует эксперимент. Допустимые значения: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", " ga:transactions", "ga:transactionRevenue". Это поле является обязательным, если статус «РАБОТАЕТ», а для «Серверфреймворк» — «ПЕРЕДИРЕКТ» или «API». | записываемый |
optimizationType | string | Следует ли минимизировать или максимизировать ObjectMetric. Возможные значения: «МАКСИМАЛЬНЫЙ», «МИНИМУМ». Необязательно — по умолчанию «МАКСИМАЛЬНЫЙ». Невозможно указать без ObjectMetric. Невозможно изменить, если статус «РАБОТАЕТ» или «ЗАВЕРШЕН». | записываемый |
rewriteVariationUrlsAsOriginal | boolean | Логическое значение, указывающее, перезаписываются ли URL-адреса вариантов в соответствии с оригиналом. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
servingFramework | string | Структура, используемая для обслуживания вариантов эксперимента и оценки результатов. Один из:
| записываемый |
trafficCoverage | double | Число с плавающей запятой от 0 до 1. Указывает долю трафика, участвующую в эксперименте. Можно изменить для текущего эксперимента. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
variations[] | list | Массив вариаций. Первая вариация массива является исходной. Количество вариантов не может меняться, когда эксперимент находится в состоянии ВЫПОЛНЯЕТСЯ. Прежде чем статус можно будет установить на «РАБОТАЕТ», требуются как минимум два изменения. | записываемый |
variations[]. status | string | Статус вариации. Возможные значения: «АКТИВНО», «НЕАКТИВНО». НЕАКТИВНЫЕ варианты не обслуживаются. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
variations[]. url | string | URL-адрес варианта. Это поле нельзя изменить для эксперимента со статусом ВЫПОЛНЯЕТСЯ или ЗАВЕРШЕНО. | записываемый |
winnerConfidenceLevel | double | Число с плавающей запятой от 0 до 1. Определяет необходимый уровень уверенности для выбора победителя. Это поле нельзя изменить для эксперимента со статусом ЗАВЕРШЕНО. | записываемый |
Ответ
В случае успеха этот метод возвращает ресурс Management.experiment в теле ответа.
Примеры
Примечание. Примеры кода, доступные для этого метода, не представляют все поддерживаемые языки программирования (список поддерживаемых языков см. на странице клиентских библиотек ).
Джава
Использует клиентскую библиотеку Java .
/* * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ /* * This request creates a new Experiment. */ // Construct the body of the request. Experiment body = new Experiment(); body.setName("Landing Page Experiment"); body.setStatus("DRAFT"); // Construct the first variation. Variations variationA = new Variations(); variationA.setName("Variation A"); variationA.setUrl("index.html"); // Construct the second variation. Variations variationB = new Variations(); variationB.setName("Variation B"); variationB.setUrl("indexB.html"); // Set the variations. body.setVariations(Arrays.asList(variationA, variationB)); try { analytics.management().experiments().insert("123456", "UA-123456-1", "7654321", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
Использует клиентскую библиотеку PHP .
/** * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ /** * This request creates a new experiment. */ // Construct the body of the request. $experiment = new Google_Service_Analytics_Experiment(); $experiment->setName('Landing Page Experiment'); $experiment->setStatus('DRAFT'); // Construct the first variation. $variationA = new Google_Service_Analytics_ExperimentVariations(); $variationA->setName('VariationA'); $variationA->setUrl('index.html'); // Construct the second variation. $variationB = new Google_Service_Analytics_ExperimentVariations(); $variationB->setName('VariationB'); $variationB->setUrl('indexB.html'); // Set the variations. $experiment->setVariations(array($variationA, $variationB)); try { $analytics->management_experiments->insert('123456', 'UA-123456-1', '7654321', $experiment); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
Питон
Использует клиентскую библиотеку Python .
# Note: This code assumes you have an authorized Analytics service object. # See the Experiments Developer Guide for details. # Example #1: # Creates a new DRAFT experiment with two variations. try: experiments = analytics.management().experiments().insert( accountId='123456', webPropertyId='UA-123456-1', profileId='98765432', body={ 'name': 'Landing Page Test', 'status': 'DRAFT', 'variations': [ { 'name': 'Variation A', 'url': 'index.html' }, { 'name': 'Variation B', 'url': 'indexB.html' } ] } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason))
JavaScript
Использует клиентскую библиотеку JavaScript .
/* * Note: This code assumes you have an authorized Analytics client object. * See the Experiments Developer Guide for details. */ /* * This request creates a new Experiment. */ function insertExperiment() { var request = gapi.client.analytics.management.experiments.insert( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'profileId': '7654321', 'resource': { 'name': 'Landing Page Test', 'status': 'DRAFT', 'variations': [ { 'name': 'VariationA', 'url': 'index.html' }, { 'name': 'VariationB', 'url': 'indexB.html' } ] } }); request.execute(function (response) { // Handle the response. }); }