Vorhandenen Test aktualisieren Beispiel ansehen
Bei dieser Methode werden zusätzlich zu den Standardparametern die in der Parametertabelle aufgeführten Parameter unterstützt.
Anfragen
HTTP-Anfrage
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
accountId |
string |
Konto-ID des zu aktualisierenden Tests. |
experimentId |
string |
Test-ID des zu aktualisierenden Tests. |
profileId |
string |
ID der Datenansicht (Profil) des zu aktualisierenden Tests. |
webPropertyId |
string |
Web-Property-ID des zu aktualisierenden Tests. |
Autorisierung
Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).
Bereich |
---|
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 Attributen an:
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
Erforderliche Eigenschaften | |||
id |
string |
Test-ID. Erforderlich für Patches und Updates. Nicht für Erstellung zulässig. | |
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 „ENTWURF“, „READY_TO_RUN“ oder „WIRD AUSGEFÜHRT“ 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 „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 Variationen verteilt werden soll. Wenn der Wert „Falsch“ ist, wird für Content-Tests die Standardfunktionsweise verwendet, bei der Zugriffe dynamisch basierend auf 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)Finishs“, „ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". Dieses Feld ist erforderlich, wenn der Status "RUNNING" lautet und für "asingFramework" entweder "REDIRECT" oder "API" angegeben ist. | Bearbeitbar |
optimizationType |
string |
Gibt an, ob „objectMetric“ minimiert oder maximiert werden soll. Mögliche Werte: "MAXIMUM", "MIND". Optional: Der Standardwert ist „MAXIMUM“. Kann nicht ohne „objectMetric“ angegeben werden. Kann nicht geändert werden, wenn der Status „WIRD AUSGEFÜHRT“ oder „BEENDET“ ist. | Bearbeitbar |
rewriteVariationUrlsAsOriginal |
boolean |
Boolescher Wert, der angibt, ob URL-Varianten so umgeschrieben werden, dass 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, mit dem die Testvarianten bereitgestellt und die Ergebnisse ausgewertet werden. Eine der folgenden Optionen:
|
Bearbeitbar |
trafficCoverage |
double |
Eine Gleitkommazahl zwischen 0 und 1. Gibt den Anteil der Zugriffe 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 mit Variationen. Die erste Variante im Array ist das Original. Die Anzahl der Varianten ändert sich möglicherweise nicht mehr, wenn ein Test den Status WIRD AUSGEFÜHRT hat. Es sind mindestens zwei Varianten erforderlich, bevor der Status auf „WIRD AUSGEFÜHRT“ gesetzt werden kann. | Bearbeitbar |
variations[].status |
string |
Status der Variante. Mögliche Werte: "ACTIVE", "INACTIVE". INAKTIV 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 mit dem Status WIRD AUSGEFÜHRT oder BEENDET nicht geändert werden. | Bearbeitbar |
winnerConfidenceLevel |
double |
Eine Gleitkommazahl zwischen 0 und 1. Gibt das Konfidenzniveau an, das zur Auswahl eines Testsiegers erforderlich ist. 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 Ressource vom Typ „management.experiment“ 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 example updates an existing experiment with new variations. Variations variationA = new Variations(); variationA.setName("Home Alpha"); variationA.setUrl("homeA.html"); Variations variationB = new Variations(); variationB.setName("Home Beta"); 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 Update with the updated experiment. analytics.management().experiments().update("123456", "UA-123456-1", "7654321", "122333444455555", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
Verwendet die PHP-Clientbibliothek.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ /** * This request updates 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 update method with the updated experiment. $analytics->management_experiments->update('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
Verwendet die Python-Clientbibliothek.
# Note: This code assumes you have an authorized Analytics service object. # See the Experiments Developer Guide for details. # This request updates an existing experiment with a new name, # and new variations. try: analytics.management().experiments().update( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', experimentId='ABCDEFG123456abcdefg', body={ 'name': 'Updated Test Title', 'status': 'DRAFT', 'variations': [ { 'name': 'Checkout Page', 'url': 'checkout.html' }, { 'name': 'Proposed Checkout Page', 'url': 'newCheckout.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
Es wird die JavaScript-Clientbibliothek verwendet.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Experiments Developer Guide for details. */ /* * This request updates an existing experiment. */ function updateExperiment() { var request = gapi.client.analytics.management.experiments.update( { '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. }); }