Diese Seite wurde von der Cloud Translation API übersetzt.

Experiments: insert

Erstellen Sie einen neuen Test. Beispiel

Neben den Standardparametern unterstützt diese Methode die in der Parametertabelle aufgeführten Parameter.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
`accountId`	`string`	Die Konto-ID, für die der Test erstellt werden soll.
`profileId`	`string`	Die ID des Profils, für das der Test erstellt werden soll.
`webPropertyId`	`string`	Die Web-Property-ID, für die der Test erstellt werden soll.

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Umfang
`https://www.googleapis.com/auth/analytics`
`https://www.googleapis.com/auth/analytics.edit`

Anfragetext

Geben Sie im Anfragetext eine Ressource vom Typ management.experiment mit den folgenden Properties an:

Attributname	Wert	Beschreibung	Hinweise
Erforderliche Properties
`name`	`string`	Testname. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden. Dieses Feld ist beim Erstellen eines Tests erforderlich.	Bearbeitbar
`status`	`string`	Teststatus Mögliche Werte: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED" Tests können im Status „&AFT;“, „&BEDINGT_AUSFÜHREN“ oder „AUSFÜHREN“ erstellt werden. Dieses Feld ist beim Erstellen eines Tests erforderlich.	Bearbeitbar
`variations[].name`	`string`	Der Name der Variante. Dieses Feld ist beim Erstellen eines Tests erforderlich. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
Optionale Attribute
`description`	`string`	Hinweise zu diesem Test	Bearbeitbar
`editableInGaUi`	`boolean`	Bei Einstellung auf „true“ kann der Endnutzer den Test über die Google Analytics-Benutzeroberfläche bearbeiten.	Bearbeitbar
`equalWeighting`	`boolean`	Boolescher Wert, der angibt, ob der Traffic gleichmäßig auf alle Varianten verteilt werden soll. Wenn der Wert auf „False“ gesetzt ist, werden für Content-Tests die Standardeinstellungen verwendet, bei denen Zugriffe dynamisch auf Grundlage der Variantenleistung angepasst werden. Optional: Der Standardwert ist „False“. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
`minimumExperimentLengthInDays`	`integer`	Eine Ganzzahl in [3, 90]. Gibt die Mindestdauer des Tests an. Kann für einen laufenden Test geändert werden. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
`objectiveMetric`	`string`	Der Messwert, den der Test optimiert. Gültige Werte: "ga:goal(n)Abschlüsse Dieses Feld ist erforderlich, wenn der Status "RUNNING" ist und ServingFramework entweder „REDIRECT"“ oder "API" ist.	Bearbeitbar
`optimizationType`	`string`	Gibt an, ob „targetMetrics“ minimiert oder maximiert werden soll. Mögliche Werte: "MAX", "Minimum" Optional: Der Standardwert ist "MAX". Kann nicht ohne „targetMetrics“ angegeben werden. Kann nicht geändert werden, wenn der Status "RUNNING" oder "ENDED" lautet.	Bearbeitbar
`rewriteVariationUrlsAsOriginal`	`boolean`	Boolescher Wert, der angibt, ob Varianten-URLs kopiert werden, damit sie mit denen des Originals übereinstimmen. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
`servingFramework`	`string`	Das Framework zur Bereitstellung der Testvarianten und zur Bewertung der Ergebnisse. Eine der folgenden Möglichkeiten: WEITERLEITUNG: Google Analytics leitet den Traffic auf verschiedene Variantenseiten weiter, meldet die ausgewählte Variante und wertet die Ergebnisse aus. API: Google Analytics wählt die Variante aus und meldet sie, um die Ergebnisse auszuliefern. Der Aufrufer ist für die Auslieferung der ausgewählten Variante verantwortlich. EXTERN: Die Varianten werden extern ausgeliefert und die ausgewählte Variante wird an Google Analytics gemeldet. Der Aufrufer ist für die Auslieferung der ausgewählten Variante und die Auswertung der Ergebnisse verantwortlich.	Bearbeitbar
`trafficCoverage`	`double`	Eine Gleitkommazahl zwischen 0 und 1. Gibt den Anteil des Traffics an, der am Test teilnimmt. Kann für einen laufenden Test geändert werden. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
`variations[]`	`list`	Array von Varianten. Die erste Variante im Array ist das Original. Die Anzahl der Varianten darf sich nicht ändern, wenn der Test den Status „Wird ausgeführt“ hat. Es sind mindestens zwei Varianten erforderlich, bevor der Status auf AUSGEFÜHRT gesetzt werden kann.	Bearbeitbar
`variations[].status`	`string`	Der Status der Variante. Mögliche Werte: "ACTIVE", "INACTIVE" Inaktive Varianten werden nicht ausgeliefert. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar
`variations[].url`	`string`	Die URL der Variante. Dieses Feld kann für einen Test, dessen Status AUSGEFÜHRT oder BEENDET ist, nicht geändert werden.	Bearbeitbar
`winnerConfidenceLevel`	`double`	Eine Gleitkommazahl zwischen 0 und 1. Gibt das erforderliche Konfidenzniveau an, um einen Gewinner auszuwählen. Dieses Feld kann für einen Test mit dem Status ENDED nicht geändert werden.	Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine management.experiment-Ressource im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

/*
 * 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

Die PHP-Clientbibliothek wird verwendet.

/**
 * 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

Verwendet die Python-Clientbibliothek.

# 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

Verwendet die JavaScript-Clientbibliothek.

/*
 * 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. });
}