Wymaga autoryzacji
Utwórz nowy eksperyment. Zobacz przykład
Oprócz parametrów standardowych metoda ta obsługuje parametry wymienione w tabeli parametrów.
Prośba
Żądanie HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry ścieżki | ||
accountId |
string |
Identyfikator konta, na którym chcesz utworzyć eksperyment. |
profileId |
string |
Identyfikator widoku danych (profilu), dla którego chcesz utworzyć eksperyment. |
webPropertyId |
string |
Identyfikator usługi internetowej, dla której chcesz utworzyć eksperyment. |
Upoważnienie
To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).
Zakres |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
Treść żądania
W treści żądania podaj zasób management.experiment z tymi właściwościami:
nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
Właściwości wymagane | |||
name |
string |
Nazwa eksperymentu. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. To pole jest wymagane podczas tworzenia eksperymentu. | z możliwością zapisu |
status |
string |
Stan eksperymentu. Możliwe wartości: „DRAFT”, „READY_TO_RUN”, „RUNNING”, „ENDED”. Eksperymenty można tworzyć w stanie „WERSJA ROBOCZA”, „READY_TO_RUN” lub „URUCHOMIONA”. To pole jest wymagane podczas tworzenia eksperymentu. | z możliwością zapisu |
variations[].name |
string |
Nazwa odmiany. To pole jest wymagane podczas tworzenia eksperymentu. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
Właściwości opcjonalne | |||
description |
string |
Uwagi na temat tego eksperymentu. | z możliwością zapisu |
editableInGaUi |
boolean |
Jeśli ma wartość prawda, użytkownik może edytować eksperyment w interfejsie Google Analytics. | z możliwością zapisu |
equalWeighting |
boolean |
Wartość logiczna określająca, czy ruch ma być równomiernie rozłożony na wszystkie odmiany. Jeśli wartość to Fałsz, eksperymenty z treścią stron korzystają z domyślnego działania polegającego na dynamicznym dostosowywaniu ruchu na podstawie skuteczności odmian. Opcjonalny – domyślnie przyjmuje wartość Fałsz. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
minimumExperimentLengthInDays |
integer |
Liczba całkowita z zakresu [3, 90]. Określa minimalną długość eksperymentu. Można ją zmienić w trwającym eksperymencie. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
objectiveMetric |
string |
Dane, które są optymalizowane przez eksperyment. Prawidłowe wartości: „ga:goal(n)completions”, „ga:adsenseAdsKliknięcia”, „ga:adsenseAdsViewed”, „ga:adsenseRevenue”, „ga:bouncy”, „ga:pageviews”, „ga:sessionDuration”, „ga:transactions”, „ga:transactionRevenue”. To pole jest wymagane, jeśli stan to „URUCHOMIONA”, a interfejs ServiceFramework ma wartość „PRZEKIEROWANIE” lub „Interfejs API”. | z możliwością zapisu |
optimizationType |
string |
Określa, czy parametr goalMetric ma być zminimalizowany czy zmaksymalizowany. Możliwe wartości: „MAXIMUM”, „MIN”. Opcjonalna – wartość domyślna to „MAXIMUM”. Nie można określić bez celuMetric. Nie można zmienić, gdy stan to „URUCHOMIONA” lub „ZAKOŃCZONA”. | z możliwością zapisu |
rewriteVariationUrlsAsOriginal |
boolean |
Wartość logiczna określająca, czy adresy URL odmian są przepisywane tak, aby odpowiadały adresom oryginału. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
servingFramework |
string |
Platforma służąca do wyświetlania odmian eksperymentu i oceny wyników. Jedna z tych możliwości:
|
z możliwością zapisu |
trafficCoverage |
double |
Liczba zmiennoprzecinkowa z zakresu od 0 do 1. Określa, jaka część ruchu uczestniczy w eksperymencie. Można ją zmienić w trwającym eksperymencie. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
variations[] |
list |
Tablica odmian. Pierwsza odmiana tablicy jest oryginałem. Liczba odmian nie może się zmienić po rozpoczęciu eksperymentu. Do ustawienia stanu URUCHOMIONEGO wymagane są co najmniej dwie odmiany. | z możliwością zapisu |
variations[].status |
string |
Stan odmiany. Możliwe wartości: „ACTIVE”, „INACTIVE”. Odmiany INACTIVE nie są wyświetlane. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
variations[].url |
string |
Adres URL odmiany. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to URUCHOMIONO lub KONIEC. | z możliwością zapisu |
winnerConfidenceLevel |
double |
Liczba zmiennoprzecinkowa z zakresu od 0 do 1. Określa poziom pewności niezbędny do wyboru zwycięzcy. Tego pola nie można zmienić w przypadku eksperymentu, którego stan to ENDED. | z możliwością zapisu |
Odpowiedź
Jeśli operacja się uda, metoda zwróci zasób management.experiment w treści odpowiedzi.
Przykłady
Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.
Java
Używa biblioteki klienta 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
Wykorzystuje bibliotekę klienta 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
Używa biblioteki klienta Pythona.
# 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
Używa biblioteki klienta 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. }); }