| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="analytics_v3.html">Google Analytics API</a> . <a href="analytics_v3.management.html">management</a> . <a href="analytics_v3.management.experiments.html">experiments</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="#delete">delete(accountId, webPropertyId, profileId, experimentId)</a></code></p> |
| 79 | <p class="firstline">Delete an experiment.</p> |
| 80 | <p class="toc_element"> |
| 81 | <code><a href="#get">get(accountId, webPropertyId, profileId, experimentId)</a></code></p> |
| 82 | <p class="firstline">Returns an experiment to which the user has access.</p> |
| 83 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 84 | <code><a href="#insert">insert(accountId, webPropertyId, profileId, body=None)</a></code></p> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 85 | <p class="firstline">Create a new experiment.</p> |
| 86 | <p class="toc_element"> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 87 | <code><a href="#list">list(accountId, webPropertyId, profileId, max_results=None, start_index=None)</a></code></p> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 88 | <p class="firstline">Lists experiments to which the user has access.</p> |
| 89 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 90 | <code><a href="#patch">patch(accountId, webPropertyId, profileId, experimentId, body=None)</a></code></p> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 91 | <p class="firstline">Update an existing experiment. This method supports patch semantics.</p> |
| 92 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 93 | <code><a href="#update">update(accountId, webPropertyId, profileId, experimentId, body=None)</a></code></p> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 94 | <p class="firstline">Update an existing experiment.</p> |
| 95 | <h3>Method Details</h3> |
| 96 | <div class="method"> |
| 97 | <code class="details" id="delete">delete(accountId, webPropertyId, profileId, experimentId)</code> |
| 98 | <pre>Delete an experiment. |
| 99 | |
| 100 | Args: |
| 101 | accountId: string, Account ID to which the experiment belongs (required) |
| 102 | webPropertyId: string, Web property ID to which the experiment belongs (required) |
| 103 | profileId: string, View (Profile) ID to which the experiment belongs (required) |
| 104 | experimentId: string, ID of the experiment to delete (required) |
| 105 | </pre> |
| 106 | </div> |
| 107 | |
| 108 | <div class="method"> |
| 109 | <code class="details" id="get">get(accountId, webPropertyId, profileId, experimentId)</code> |
| 110 | <pre>Returns an experiment to which the user has access. |
| 111 | |
| 112 | Args: |
| 113 | accountId: string, Account ID to retrieve the experiment for. (required) |
| 114 | webPropertyId: string, Web property ID to retrieve the experiment for. (required) |
| 115 | profileId: string, View (Profile) ID to retrieve the experiment for. (required) |
| 116 | experimentId: string, Experiment ID to retrieve the experiment for. (required) |
| 117 | |
| 118 | Returns: |
| 119 | An object of the form: |
| 120 | |
| 121 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 122 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 123 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 124 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 125 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 126 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 127 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 128 | "endTime": "A String", # 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. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 129 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 130 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 131 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 132 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 133 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 134 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 135 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 136 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 137 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 138 | "reasonExperimentEnded": "A String", # 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. |
| 139 | "trafficCoverage": 3.14, # 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. |
| 140 | "startTime": "A String", # 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. |
| 141 | "optimizationType": "A String", # 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". |
| 142 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 143 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 144 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 145 | "minimumExperimentLengthInDays": 42, # 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. |
| 146 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 147 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 148 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 149 | "variations": [ # 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. |
| 150 | { |
| 151 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 152 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 153 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 154 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 155 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 156 | }, |
| 157 | ], |
| 158 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 159 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 160 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 161 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 162 | "winnerConfidenceLevel": 3.14, # 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. |
| 163 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 164 | }</pre> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 165 | </div> |
| 166 | |
| 167 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 168 | <code class="details" id="insert">insert(accountId, webPropertyId, profileId, body=None)</code> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 169 | <pre>Create a new experiment. |
| 170 | |
| 171 | Args: |
| 172 | accountId: string, Account ID to create the experiment for. (required) |
| 173 | webPropertyId: string, Web property ID to create the experiment for. (required) |
| 174 | profileId: string, View (Profile) ID to create the experiment for. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 175 | body: object, The request body. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 176 | The object takes the form of: |
| 177 | |
| 178 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 179 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 180 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 181 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 182 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 183 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 184 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 185 | "endTime": "A String", # 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. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 186 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 187 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 188 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 189 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 190 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 191 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 192 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 193 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 194 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 195 | "reasonExperimentEnded": "A String", # 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. |
| 196 | "trafficCoverage": 3.14, # 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. |
| 197 | "startTime": "A String", # 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. |
| 198 | "optimizationType": "A String", # 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". |
| 199 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 200 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 201 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 202 | "minimumExperimentLengthInDays": 42, # 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. |
| 203 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 204 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 205 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 206 | "variations": [ # 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. |
| 207 | { |
| 208 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 209 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 210 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 211 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 212 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 213 | }, |
| 214 | ], |
| 215 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 216 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 217 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 218 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 219 | "winnerConfidenceLevel": 3.14, # 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. |
| 220 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 221 | } |
| 222 | |
| 223 | |
| 224 | Returns: |
| 225 | An object of the form: |
| 226 | |
| 227 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 228 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 229 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 230 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 231 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 232 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 233 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 234 | "endTime": "A String", # 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. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 235 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 236 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 237 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 238 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 239 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 240 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 241 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 242 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 243 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 244 | "reasonExperimentEnded": "A String", # 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. |
| 245 | "trafficCoverage": 3.14, # 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. |
| 246 | "startTime": "A String", # 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. |
| 247 | "optimizationType": "A String", # 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". |
| 248 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 249 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 250 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 251 | "minimumExperimentLengthInDays": 42, # 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. |
| 252 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 253 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 254 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 255 | "variations": [ # 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. |
| 256 | { |
| 257 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 258 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 259 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 260 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 261 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 262 | }, |
| 263 | ], |
| 264 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 265 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 266 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 267 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 268 | "winnerConfidenceLevel": 3.14, # 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. |
| 269 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 270 | }</pre> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 271 | </div> |
| 272 | |
| 273 | <div class="method"> |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 274 | <code class="details" id="list">list(accountId, webPropertyId, profileId, max_results=None, start_index=None)</code> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 275 | <pre>Lists experiments to which the user has access. |
| 276 | |
| 277 | Args: |
| 278 | accountId: string, Account ID to retrieve experiments for. (required) |
| 279 | webPropertyId: string, Web property ID to retrieve experiments for. (required) |
| 280 | profileId: string, View (Profile) ID to retrieve experiments for. (required) |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 281 | max_results: integer, The maximum number of experiments to include in this response. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 282 | start_index: integer, An index of the first experiment to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 283 | |
| 284 | Returns: |
| 285 | An object of the form: |
| 286 | |
| 287 | { # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 288 | "username": "A String", # Email ID of the authenticated user |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 289 | "totalResults": 42, # The total number of results for the query, regardless of the number of resources in the result. |
| 290 | "items": [ # A list of experiments. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 291 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 292 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 293 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 294 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 295 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 296 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 297 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 298 | "endTime": "A String", # 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. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 299 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 300 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 301 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 302 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 303 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 304 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 305 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 306 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 307 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 308 | "reasonExperimentEnded": "A String", # 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. |
| 309 | "trafficCoverage": 3.14, # 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. |
| 310 | "startTime": "A String", # 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. |
| 311 | "optimizationType": "A String", # 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". |
| 312 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 313 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 314 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 315 | "minimumExperimentLengthInDays": 42, # 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. |
| 316 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 317 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 318 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 319 | "variations": [ # 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. |
| 320 | { |
| 321 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 322 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 323 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 324 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 325 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 326 | }, |
| 327 | ], |
| 328 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 329 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 330 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 331 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 332 | "winnerConfidenceLevel": 3.14, # 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. |
| 333 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 334 | }, |
| 335 | ], |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 336 | "kind": "analytics#experiments", # Collection type. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 337 | "itemsPerPage": 42, # 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. |
| 338 | "startIndex": 42, # The starting index of the resources, which is 1 by default or otherwise specified by the start-index query parameter. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 339 | "nextLink": "A String", # Link to next page for this experiment collection. |
| 340 | "previousLink": "A String", # Link to previous page for this experiment collection. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 341 | }</pre> |
| 342 | </div> |
| 343 | |
| 344 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 345 | <code class="details" id="patch">patch(accountId, webPropertyId, profileId, experimentId, body=None)</code> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 346 | <pre>Update an existing experiment. This method supports patch semantics. |
| 347 | |
| 348 | Args: |
| 349 | accountId: string, Account ID of the experiment to update. (required) |
| 350 | webPropertyId: string, Web property ID of the experiment to update. (required) |
| 351 | profileId: string, View (Profile) ID of the experiment to update. (required) |
| 352 | experimentId: string, Experiment ID of the experiment to update. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 353 | body: object, The request body. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 354 | The object takes the form of: |
| 355 | |
| 356 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 357 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 358 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 359 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 360 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 361 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 362 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 363 | "endTime": "A String", # 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. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 364 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 365 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 366 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 367 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 368 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 369 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 370 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 371 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 372 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 373 | "reasonExperimentEnded": "A String", # 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. |
| 374 | "trafficCoverage": 3.14, # 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. |
| 375 | "startTime": "A String", # 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. |
| 376 | "optimizationType": "A String", # 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". |
| 377 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 378 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 379 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 380 | "minimumExperimentLengthInDays": 42, # 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. |
| 381 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 382 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 383 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 384 | "variations": [ # 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. |
| 385 | { |
| 386 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 387 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 388 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 389 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 390 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 391 | }, |
| 392 | ], |
| 393 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 394 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 395 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 396 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 397 | "winnerConfidenceLevel": 3.14, # 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. |
| 398 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 399 | } |
| 400 | |
| 401 | |
| 402 | Returns: |
| 403 | An object of the form: |
| 404 | |
| 405 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 406 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 407 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 408 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 409 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 410 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 411 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 412 | "endTime": "A String", # 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. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 413 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 414 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 415 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 416 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 417 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 418 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 419 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 420 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 421 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 422 | "reasonExperimentEnded": "A String", # 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. |
| 423 | "trafficCoverage": 3.14, # 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. |
| 424 | "startTime": "A String", # 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. |
| 425 | "optimizationType": "A String", # 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". |
| 426 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 427 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 428 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 429 | "minimumExperimentLengthInDays": 42, # 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. |
| 430 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 431 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 432 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 433 | "variations": [ # 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. |
| 434 | { |
| 435 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 436 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 437 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 438 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 439 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 440 | }, |
| 441 | ], |
| 442 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 443 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 444 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 445 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 446 | "winnerConfidenceLevel": 3.14, # 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. |
| 447 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 448 | }</pre> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 449 | </div> |
| 450 | |
| 451 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 452 | <code class="details" id="update">update(accountId, webPropertyId, profileId, experimentId, body=None)</code> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 453 | <pre>Update an existing experiment. |
| 454 | |
| 455 | Args: |
| 456 | accountId: string, Account ID of the experiment to update. (required) |
| 457 | webPropertyId: string, Web property ID of the experiment to update. (required) |
| 458 | profileId: string, View (Profile) ID of the experiment to update. (required) |
| 459 | experimentId: string, Experiment ID of the experiment to update. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 460 | body: object, The request body. |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 461 | The object takes the form of: |
| 462 | |
| 463 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 464 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 465 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 466 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 467 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 468 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 469 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 470 | "endTime": "A String", # 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. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 471 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 472 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 473 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 474 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 475 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 476 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 477 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 478 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 479 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 480 | "reasonExperimentEnded": "A String", # 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. |
| 481 | "trafficCoverage": 3.14, # 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. |
| 482 | "startTime": "A String", # 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. |
| 483 | "optimizationType": "A String", # 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". |
| 484 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 485 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 486 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 487 | "minimumExperimentLengthInDays": 42, # 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. |
| 488 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 489 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 490 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 491 | "variations": [ # 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. |
| 492 | { |
| 493 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 494 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 495 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 496 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 497 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 498 | }, |
| 499 | ], |
| 500 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 501 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 502 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 503 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 504 | "winnerConfidenceLevel": 3.14, # 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. |
| 505 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 506 | } |
| 507 | |
| 508 | |
| 509 | Returns: |
| 510 | An object of the form: |
| 511 | |
| 512 | { # JSON template for Analytics experiment resource. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 513 | "parentLink": { # Parent link for an experiment. Points to the view (profile) to which this experiment belongs. |
| 514 | "type": "analytics#profile", # Value is "analytics#profile". This field is read-only. |
| 515 | "href": "A String", # Link to the view (profile) to which this experiment belongs. This field is read-only. |
| 516 | }, |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 517 | "updated": "A String", # Time the experiment was last modified. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 518 | "equalWeighting": True or False, # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 519 | "endTime": "A String", # 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. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 520 | "servingFramework": "A String", # The framework used to serve the experiment variations and evaluate the results. One of: |
| 521 | # - REDIRECT: Google Analytics redirects traffic to different variation pages, reports the chosen variation and evaluates the results. |
| 522 | # - API: Google Analytics chooses and reports the variation to serve and evaluates the results; the caller is responsible for serving the selected variation. |
| 523 | # - 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 524 | "selfLink": "A String", # Link for this experiment. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 525 | "status": "A String", # 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. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 526 | "objectiveMetric": "A String", # 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". |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 527 | "accountId": "A String", # Account ID to which this experiment belongs. This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 528 | "kind": "analytics#experiment", # Resource type for an Analytics experiment. This field is read-only. |
| 529 | "reasonExperimentEnded": "A String", # 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. |
| 530 | "trafficCoverage": 3.14, # 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. |
| 531 | "startTime": "A String", # 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. |
| 532 | "optimizationType": "A String", # 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". |
| 533 | "editableInGaUi": True or False, # If true, the end user will be able to edit the experiment via the Google Analytics user interface. |
| 534 | "created": "A String", # Time the experiment was created. This field is read-only. |
| 535 | "name": "A String", # Experiment name. This field may not be changed for an experiment whose status is ENDED. This field is required when creating an experiment. |
| 536 | "minimumExperimentLengthInDays": 42, # 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. |
| 537 | "rewriteVariationUrlsAsOriginal": True or False, # 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. |
| 538 | "profileId": "A String", # View (Profile) ID to which this experiment belongs. This field is read-only. |
| 539 | "id": "A String", # Experiment ID. Required for patch and update. Disallowed for create. |
| 540 | "variations": [ # 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. |
| 541 | { |
| 542 | "status": "A String", # Status of the variation. Possible values: "ACTIVE", "INACTIVE". INACTIVE variations are not served. This field may not be changed for an experiment whose status is ENDED. |
| 543 | "name": "A String", # The name of the variation. This field is required when creating an experiment. This field may not be changed for an experiment whose status is ENDED. |
| 544 | "url": "A String", # The URL of the variation. This field may not be changed for an experiment whose status is RUNNING or ENDED. |
| 545 | "weight": 3.14, # Weight that this variation should receive. Only present if the experiment is running. This field is read-only. |
| 546 | "won": True or False, # True if the experiment has ended and this variation performed (statistically) significantly better than the original. This field is read-only. |
| 547 | }, |
| 548 | ], |
| 549 | "winnerFound": True or False, # Boolean specifying whether a winner has been found for this experiment. This field is read-only. |
| 550 | "description": "A String", # Notes about this experiment. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 551 | "snippet": "A String", # The snippet of code to include on the control page(s). This field is read-only. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame^] | 552 | "internalWebPropertyId": "A String", # Internal ID for the web property to which this experiment belongs. This field is read-only. |
| 553 | "winnerConfidenceLevel": 3.14, # 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. |
| 554 | "webPropertyId": "A String", # Web property ID to which this experiment belongs. The web property ID is of the form UA-XXXXX-YY. This field is read-only. |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 555 | }</pre> |
| John Asmuth | 614db98 | 2014-04-24 15:46:26 -0400 | [diff] [blame] | 556 | </div> |
| 557 | |
| 558 | </body></html> |