Autorisation requise
Créez un test. Voir un exemple.
Outre les paramètres standards, cette méthode accepte les paramètres répertoriés dans le tableau des paramètres.
Requête
Requête HTTP
POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de chemin d'accès | ||
accountId |
string |
ID du compte pour lequel créer le test. |
profileId |
string |
ID de la vue (profil) pour lequel créer le test. |
webPropertyId |
string |
ID de la propriété Web pour laquelle créer le test. |
L'autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
Champ d'application |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
Corps de la requête
Dans le corps de la requête, indiquez une ressource "management.experiment" avec les propriétés suivantes:
Nom de propriété | Valeur | Description | Notes |
---|---|---|---|
Propriétés obligatoires | |||
name |
string |
Nom du test. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". Ce champ est obligatoire lorsque vous créez un test. | accessible en écriture |
status |
string |
État du test. Valeurs possibles: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Les tests peuvent être créés à l'état "BROUILLON", "READY_TO_RUN" ou "RUNNING". Ce champ est obligatoire lorsque vous créez un test. | accessible en écriture |
variations[].name |
string |
Nom de la variante. Ce champ est obligatoire lorsque vous créez un test. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
Propriétés facultatives | |||
description |
string |
Remarques sur ce test. | accessible en écriture |
editableInGaUi |
boolean |
Si la valeur est "true", l'utilisateur final pourra modifier le test via l'interface utilisateur Google Analytics. | accessible en écriture |
equalWeighting |
boolean |
Booléen spécifiant si le trafic doit être réparti de manière uniforme entre toutes les variantes. Si la valeur est "False", les tests de page de contenu suivent le comportement par défaut qui consiste à ajuster le trafic de manière dynamique en fonction des performances des variantes. Facultatif : la valeur par défaut est "False". Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
minimumExperimentLengthInDays |
integer |
Nombre entier compris entre [3, 90]. Indique la durée minimale du test. Peut être modifié pour un test en cours d'exécution. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
objectiveMetric |
string |
Métrique optimisée par le test. Valeurs correctes: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". Ce champ est obligatoire si l'état est "RUNNING" (En cours d'exécution) et que "servingFramework" est défini sur "REDIRECT" ou "API". | accessible en écriture |
optimizationType |
string |
Indique si l'élément "objectMetric" doit être minimisé ou maximisé. Valeurs possibles: "MAXIMUM", "minimum". Facultatif : la valeur par défaut est "MAXIMUM". Ne peut pas être spécifié sans objectifMetric. Ce paramètre ne peut pas être modifié lorsque l'état est "RUNNING" (En cours d'exécution) ou "ENDED" (ENDÉ). | accessible en écriture |
rewriteVariationUrlsAsOriginal |
boolean |
Booléen indiquant si les URL des variantes sont réécrites pour correspondre à celles de l'URL d'origine. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
servingFramework |
string |
Structure utilisée pour diffuser les variantes du test et évaluer les résultats. Choix possible:
|
accessible en écriture |
trafficCoverage |
double |
Nombre à virgule flottante compris entre 0 et 1. Indique la part du trafic qui participe au test. Peut être modifié pour un test en cours d'exécution. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
variations[] |
list |
Tableau de variantes. La première variante du tableau est la variante d'origine. Le nombre de variantes ne peut pas changer lorsqu'un test est "EN COURS D'EXÉCUTION". Il faut au moins deux variantes pour que l'état puisse être défini sur "RUNNING" (En cours d'exécution). | accessible en écriture |
variations[].status |
string |
État de la variante. Valeurs possibles: "ACTIVE", "INACTIVE". Les variantes INACTIVE ne sont pas diffusées. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
variations[].url |
string |
URL de la variante. Vous ne pouvez pas modifier ce champ si l'état d'un test est EN COURS D'EXÉCUTION ou TERMINÉ. | accessible en écriture |
winnerConfidenceLevel |
double |
Nombre à virgule flottante compris entre 0 et 1. Indique le niveau de confiance nécessaire pour choisir une combinaison gagnante. Vous ne pouvez pas modifier ce champ si l'état d'un test est "ENDED". | accessible en écriture |
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource "management.experiment" dans le corps de la réponse.
Exemples
Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).
Java
Utilise la bibliothèque cliente 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
Utilise la bibliothèque cliente 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
Utilise la bibliothèque cliente Python
# 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
Utilise la bibliothèque cliente 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. }); }