Experiments: patch

Wymaga autoryzacji

Zaktualizuj istniejący eksperyment. Ta metoda obsługuje semantykę poprawki. Zobacz przykład

Oprócz parametrów standardowych metoda ta obsługuje parametry wymienione w tabeli parametrów.

Prośba

Żądanie HTTP

PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId

Parametry

Nazwa parametru	Wartość	Opis
Parametry ścieżki
`accountId`	`string`	Identyfikator konta eksperymentu do zaktualizowania.
`experimentId`	`string`	Identyfikator eksperymentu do zaktualizowania.
`profileId`	`string`	Identyfikator widoku danych (profil) eksperymentu do zaktualizowania.
`webPropertyId`	`string`	Identyfikator usługi internetowej eksperymentu do zaktualizowania.

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 odpowiednie części zasobu management.experiment (zgodnie z regułami semantyki poprawki), z następującymi właściwościami:

nazwa usługi,	Wartość	Opis	Uwagi
Właściwości wymagane
`id`	`string`	Identyfikator eksperymentu. Wymagane do zainstalowania poprawki i aktualizacji. Nie można tworzyć.
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
`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
`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: PRZEKIEROWANIE: Google Analytics przekierowuje ruch na różne strony z odmianami, zgłasza wybraną odmianę i ocenia wyniki. Interfejs API: Google Analytics wybiera i zgłasza odmianę do wyświetlenia i ocenia wyniki. Za wyświetlanie wybranej odmiany odpowiada element wywołujący. ZEWNĘTRZNE: odmiany będą wyświetlane zewnętrznie, a wybrana odmiana zostanie zgłoszona do Google Analytics. Element wywołujący odpowiada za wyświetlanie wybranej odmiany i ocenianie wyników.	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
`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[].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
`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 example patches an existing experiment with new variations.
Variations variationA = new Variations();
variationA.setName("Home A");
variationA.setUrl("homeA.html");
Variations variationB = new Variations();
variationB.setName("Home B");
variationB.setUrl("homeB.html");
List<Variations> variations = Arrays.asList(variationA, variationB);

try {
  // First get an existing Experiment.
  Experiment body = analytics.management().experiments().get("123456",
      "UA-123456-1", "7654321", "122333444455555").execute();

  // Set the new variations.
  body.setVariations(variations);

  // Call Patch with the updated experiment.
  analytics.management().experiments().patch("123456", "UA-123456-1",
      "7654321", "12233344455555", 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 patches an existing experiment.
 */

// 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');

try {
  // Get an existing Experiment.
  $experiment = $analytics->management_experiments->get('123456',
      'UA-123456-1', '7654321', '122333444455555');

  // Set the new variations.
  $experiment->setVariations(array($variationA, $variationB));

  // Call the patch method with the updated experiment.
  $analytics->management_experiments->patch('123456', 'UA-123456-1',
      '7654321', '122333444455555', $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.

# This request patches an existing experiment with a new name,
# and new variations.
try:
  analytics.management().experiments().patch(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      experimentId='ABCDEFG123456abcdefg',
      body={
          'name': 'Landing Page Test April',
          'variations': [
              {
                  'name': 'First Variation',
                  'url': 'index.html'
              },
              {
                  'name': 'Proposed Change',
                  '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 patches an existing experiment.
 */
function patchExperiment() {
  var request = gapi.client.analytics.management.experiments.patch(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      'experimentId': '122333444455555',
      '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. });
}