/management/accounts/{accountId}/webproperties/{webPropertyId}/profiles/{profileId}/experiments

GET

management

Lists experiments to which the user has access.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://analytics.googleapis.com/analytics/v3/management/accounts//webproperties//profiles//experiments'

Response Example

{
  "items": [
    {
      "accountId": "string",
      "created": "2019-08-24T14:15:22Z",
      "description": "string",
      "editableInGaUi": true,
      "endTime": "2019-08-24T14:15:22Z",
      "equalWeighting": true,
      "id": "string",
      "internalWebPropertyId": "string",
      "kind": "analytics#experiment",
      "minimumExperimentLengthInDays": 0,
      "name": "string",
      "objectiveMetric": "string",
      "optimizationType": "string",
      "parentLink": {
        "href": "string",
        "type": "analytics#profile"
      },
      "profileId": "string",
      "reasonExperimentEnded": "string",
      "rewriteVariationUrlsAsOriginal": true,
      "selfLink": "string",
      "servingFramework": "string",
      "snippet": "string",
      "startTime": "2019-08-24T14:15:22Z",
      "status": "string",
      "trafficCoverage": 0,
      "updated": "2019-08-24T14:15:22Z",
      "variations": [
        {
          "name": "string",
          "status": "string",
          "url": "string",
          "weight": 0,
          "won": true
        }
      ],
      "webPropertyId": "string",
      "winnerConfidenceLevel": 0,
      "winnerFound": true
    }
  ],
  "itemsPerPage": 0,
  "kind": "analytics#experiments",
  "nextLink": "string",
  "previousLink": "string",
  "startIndex": 0,
  "totalResults": 0,
  "username": "string"
}

Request

Path Params

accountId

string

required

Account ID to retrieve experiments for.

webPropertyId

string

required

Web property ID to retrieve experiments for.

profileId

string

required

View (Profile) ID to retrieve experiments for.

Query Params

max-results

integer

optional

The maximum number of experiments to include in this response.

start-index

integer

optional

An index of the first experiment to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.

Responses

🟢200Successful response

application/json

Body

An experiment collection lists Analytics experiments to which the user has access. Each view (profile) can have a set of experiments. Each resource in the Experiment collection corresponds to a single Analytics experiment.

items

array[object (Experiment) {28}]

optional

A list of experiments.

accountId

string

optional

Account ID to which this experiment belongs. This field is read-only.

created

string <date-time>

optional

Time the experiment was created. This field is read-only.

description

string

optional

Notes about this experiment.

editableInGaUi

boolean

optional

If true, the end user will be able to edit the experiment via the Google Analytics user interface.

endTime

string <date-time>

optional

The ending time of the experiment (the time the status changed from RUNNING to ENDED). This field is present only if the experiment has ended. This field is read-only.

equalWeighting

boolean

optional

Boolean specifying whether to distribute traffic evenly across all variations. If the value is False, content experiments follows the default behavior of adjusting traffic dynamically based on variation performance. Optional -- defaults to False. This field may not be changed for an experiment whose status is ENDED.

string

optional

Experiment ID. Required for patch and update. Disallowed for create.

internalWebPropertyId

string

optional

Internal ID for the web property to which this experiment belongs. This field is read-only.

kind

string

optional

Resource type for an Analytics experiment. This field is read-only.

Default:

analytics#experiment

minimumExperimentLengthInDays

integer <int32>

optional

An integer number in [3, 90]. Specifies the minimum length of the experiment. Can be changed for a running experiment. This field may not be changed for an experiments whose status is ENDED.

name

string

optional

Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment.

objectiveMetric

string

optional

The metric that the experiment is optimizing. Valid values: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". This field is required if status is "RUNNING" and servingFramework is one of "REDIRECT" or "API".

optimizationType

string

optional

Whether the objectiveMetric should be minimized or maximized. Possible values: "MAXIMUM", "MINIMUM". Optional--defaults to "MAXIMUM". Cannot be specified without objectiveMetric. Cannot be modified when status is "RUNNING" or "ENDED".

parentLink

object

optional

Parent link for an experiment. Points to the view (profile) to which this experiment belongs.

profileId

string

optional

View (Profile) ID to which this experiment belongs. This field is read-only.

reasonExperimentEnded

string

optional

Why the experiment ended. Possible values: "STOPPED_BY_USER", "WINNER_FOUND", "EXPERIMENT_EXPIRED", "ENDED_WITH_NO_WINNER", "GOAL_OBJECTIVE_CHANGED". "ENDED_WITH_NO_WINNER" means that the experiment didn't expire but no winner was projected to be found. If the experiment status is changed via the API to ENDED this field is set to STOPPED_BY_USER. This field is read-only.

rewriteVariationUrlsAsOriginal

boolean

optional

Boolean specifying whether variations URLS are rewritten to match those of the original. This field may not be changed for an experiments whose status is ENDED.

selfLink

string

optional

Link for this experiment. This field is read-only.

servingFramework

string

optional

The framework used to serve the experiment variations and evaluate the results. One of:

REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results.

API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation.

EXTERNAL: The variations will be served externally and the chosen variation reported to Google Analytics. The caller is responsible for serving the selected variation and evaluating the results.

snippet

string

optional

The snippet of code to include on the control page(s). This field is read-only.

startTime

string <date-time>

optional

The starting time of the experiment (the time the status changed from READY_TO_RUN to RUNNING). This field is present only if the experiment has started. This field is read-only.

status

string

optional

Experiment status. Possible values: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Experiments can be created in the "DRAFT", "READY_TO_RUN" or "RUNNING" state. This field is required when creating an experiment.

trafficCoverage

number <double>

optional

A floating-point number in (0, 1]. Specifies the fraction of the traffic that participates in the experiment. Can be changed for a running experiment. This field may not be changed for an experiments whose status is ENDED.

updated

string <date-time>

optional

Time the experiment was last modified. This field is read-only.

variations

array [object {5}]

optional

Array of variations. The first variation in the array is the original. The number of variations may not change once an experiment is in the RUNNING state. At least two variations are required before status can be set to RUNNING.

webPropertyId

string

optional

Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only.

winnerConfidenceLevel

number <double>

optional

A floating-point number in (0, 1). Specifies the necessary confidence level to choose a winner. This field may not be changed for an experiments whose status is ENDED.

winnerFound

boolean

optional

Boolean specifying whether a winner has been found for this experiment. This field is read-only.

itemsPerPage

integer <int32>

optional

The maximum number of resources the response can contain, regardless of the actual number of resources returned. Its value ranges from 1 to 1000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.

kind

string

optional

Collection type.

Default:

analytics#experiments

nextLink

string

optional

Link to next page for this experiment collection.

previousLink

string

optional

Link to previous page for this experiment collection.

startIndex

integer <int32>

optional

The starting index of the resources, which is 1 by default or otherwise specified by the start-index query parameter.

totalResults

integer <int32>

optional

The total number of results for the query, regardless of the number of resources in the result.

username

string

optional

Email ID of the authenticated user

Modified at 2023-08-15 05:39:07

/management/accounts/{accountId}/webproperties/{webPropertyId}/profiles/{profileId}/entityUserLinks/{linkId}

/management/accounts/{accountId}/webproperties/{webPropertyId}/profiles/{profileId}/experiments