Richiede l'autorizzazione
Aggiornare un esperimento esistente. Vedi un esempio.
Oltre ai parametri standard, questo metodo supporta quelli elencati nella tabella dei parametri.
Richiesta
Richiesta HTTP
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
accountId |
string |
ID account dell'esperimento da aggiornare. |
experimentId |
string |
L'ID esperimento dell'esperimento da aggiornare. |
profileId |
string |
Visualizza l'ID (profilo) dell'esperimento da aggiornare. |
webPropertyId |
string |
ID proprietà web dell'esperimento da aggiornare. |
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
Corpo della richiesta
Nel corpo della richiesta, fornisci una risorsa management.experiment con le seguenti proprietà:
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
Proprietà obbligatorie | |||
id |
string |
ID esperimento. Obbligatorio per la patch e l'aggiornamento. Non consentita per la creazione. | |
name |
string |
Nome dell'esperimento. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. Questo campo è obbligatorio durante la creazione di un esperimento. | scrivibile |
status |
string |
Stato dell'esperimento. Valori possibili: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Gli esperimenti possono essere creati nello stato "BOZZA", "READY_TO_RUN" o "IN ESECUZIONE". Questo campo è obbligatorio durante la creazione di un esperimento. | scrivibile |
variations[].name |
string |
Il nome della variante. Questo campo è obbligatorio durante la creazione di un esperimento. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
Proprietà facoltative | |||
description |
string |
Note su questo esperimento. | scrivibile |
editableInGaUi |
boolean |
Se il valore è true, l'utente finale può modificare l'esperimento tramite l'interfaccia utente di Google Analytics. | scrivibile |
equalWeighting |
boolean |
Valore booleano che specifica se distribuire il traffico in modo uniforme tra tutte le varianti. Se il valore è False, gli esperimenti sui contenuti seguono il comportamento predefinito di aggiustamento del traffico in base al rendimento della variante. Facoltativo: il valore predefinito è False. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
minimumExperimentLengthInDays |
integer |
Un numero intero compreso tra [3, 90]. Specifica la durata minima dell'esperimento. Può essere modificato per un esperimento in esecuzione. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
objectiveMetric |
string |
La metrica ottimizzata dall'esperimento. Valori validi: "ga:goal(n)Completes", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". Questo campo è obbligatorio se lo stato è "RUNNING" e ServingFramework è uno di "REDIRECT" o "API". | scrivibile |
optimizationType |
string |
Indica se obiettivoMetric deve essere ridotto al minimo o massimizzato. Valori possibili: "MAXIMUM", "MAXIMUM". Facoltativo: il valore predefinito è "MAXIMUM". Non può essere specificato senza objectMetric. Non può essere modificato quando lo stato è "IN ESECUZIONE" o "ENDED". | scrivibile |
rewriteVariationUrlsAsOriginal |
boolean |
Valore booleano che specifica se gli URL delle varianti devono essere riscritti per corrispondere a quelli dell'originale. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
servingFramework |
string |
Il framework utilizzato per pubblicare le varianti dell'esperimento e valutare i risultati. Uno dei seguenti:
|
scrivibile |
trafficCoverage |
double |
Un numero in virgola mobile compreso tra 0 e 1. Specifica la frazione di traffico che partecipa all'esperimento. Può essere modificato per un esperimento in esecuzione. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
variations[] |
list |
Array di varianti. La prima variante dell'array è l'originale. Quando un esperimento è in stato IN ESECUZIONE, il numero di varianti può non cambiare. Sono necessarie almeno due varianti prima di poter impostare lo stato su IN ESECUZIONE. | scrivibile |
variations[].status |
string |
Stato della variante. Valori possibili: "ACTIVE", "INACTIVE". Le varianti INACTIVE non vengono pubblicate. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
variations[].url |
string |
L'URL della variante. Questo campo non può essere modificato per un esperimento il cui stato è IN ESECUZIONE o TERMINATO. | scrivibile |
winnerConfidenceLevel |
double |
Un numero in virgola mobile compreso tra 0 e 1. Specifica il livello di confidenza necessario per scegliere un vincitore. Questo campo non può essere modificato per un esperimento il cui stato è ENDED. | scrivibile |
Risposta
Se l'esito è positivo, questo metodo restituisce una management.experiment resource nel corpo della risposta.
Esempi
Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).
Java
Utilizza la libreria client Java.
/* * 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
Utilizza la libreria client PHP.
/** * 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
Utilizza la libreria client Python.
# 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
Utilizza la libreria client JavaScript.
/* * 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. }); }