किसी मौजूदा प्रयोग को अपडेट करें. एक उदाहरण देखें.
यह तरीका स्टैंडर्ड पैरामीटर के अलावा, पैरामीटर टेबल में दिए गए पैरामीटर के साथ भी काम करता है.
अनुरोध करें
एचटीटीपी अनुरोध
PUT https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments/experimentId
पैरामीटर
पैरामीटर का नाम | वैल्यू | जानकारी |
---|---|---|
पाथ पैरामीटर | ||
accountId |
string |
अपडेट करने के लिए, प्रयोग का खाता आईडी. |
experimentId |
string |
परफ़ॉर्मेंस की जांच को अपडेट करने के लिए, प्रयोग का आईडी. |
profileId |
string |
अपडेट किए जाने वाले प्रयोग का (प्रोफ़ाइल) आईडी देखें. |
webPropertyId |
string |
प्रयोग के लिए वेब प्रॉपर्टी आईडी को अपडेट करें. |
अनुमति देना
इस अनुरोध के लिए, इनमें से कम से कम किसी एक दायरे की अनुमति ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
अनुमति देने का |
---|
https://www.googleapis.com/auth/analytics |
https://www.googleapis.com/auth/analytics.edit |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ एक मैनेजमेंट.प्रयोग संसाधन उपलब्ध कराएं:
प्रॉपर्टी का नाम | वैल्यू | जानकारी | नोट |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
id |
string |
प्रयोग आईडी. पैच और अपडेट के लिए ज़रूरी है. बनाने की अनुमति नहीं है. | |
name |
string |
प्रयोग का नाम. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी होता है. | लिखा जा सकता है |
status |
string |
प्रयोग स्थिति. संभावित मान: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". प्रयोग को "ड्राफ़्ट", "READY_TO_RUN" या "RUNNING" स्थिति में बनाया जा सकता है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी होता है. | लिखा जा सकता है |
variations[].name |
string |
वैरिएशन का नाम. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी होता है. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
ज़रूरी नहीं | |||
description |
string |
इस प्रयोग के बारे में नोट. | लिखा जा सकता है |
editableInGaUi |
boolean |
अगर सही है, तो असली उपयोगकर्ता, Google Analytics यूज़र इंटरफ़ेस के ज़रिए प्रयोग में बदलाव कर पाएगा. | लिखा जा सकता है |
equalWeighting |
boolean |
बूलियन, जिससे तय होता है कि ट्रैफ़िक को सभी वैरिएशन में बराबर बांटना है या नहीं. अगर वैल्यू गलत है, तो कॉन्टेंट एक्सपेरिमेंट अलग-अलग परफ़ॉर्मेंस के आधार पर डाइनैमिक तौर पर ट्रैफ़िक में बदलाव करने के डिफ़ॉल्ट व्यवहार को फ़ॉलो करता है. वैकल्पिक -- डिफ़ॉल्ट रूप से गलत. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
minimumExperimentLengthInDays |
integer |
[3, 90] में कोई पूर्णांक संख्या. इससे प्रयोग की कम से कम अवधि की जानकारी मिलती है. चल रहे प्रयोग के लिए बदला जा सकता है. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
objectiveMetric |
string |
वह मेट्रिक जिसे प्रयोग को ऑप्टिमाइज़ करना है. मान्य वैल्यू: "ga:GOAL(n)कम्प्लीट", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:बाउंसs"""""&yourm&&"" अगर फ़ील्ड में स्टेटस है, जबकि &RUNNING" और सर्व करने का फ़्रेमवर्क एक है "API" है, तो यह फ़ील्ड ज़रूरी है. | लिखा जा सकता है |
optimizationType |
string |
मकसद मेट्रिक को छोटा करना चाहिए या बढ़ाया जाना चाहिए. संभावित मान: "Max", "minimum". वैकल्पिक--defaults "Max". इसे मकसद के बिना नहीं बताया जा सकता. जब स्थिति "RUNNING" या "ENDED" होने पर बदली नहीं जा सकती. | लिखा जा सकता है |
rewriteVariationUrlsAsOriginal |
boolean |
बूलियन, जिससे यह तय होता है कि यूआरएल के मूल वर्शन से मिलते-जुलते यूआरएल फिर से लिखे गए हैं या नहीं. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
servingFramework |
string |
प्रयोग के अलग-अलग वैरिएंट दिखाने और नतीजों का आकलन करने के लिए इस्तेमाल किया जाने वाला फ़्रेमवर्क. इनमें से एक:
|
लिखा जा सकता है |
trafficCoverage |
double |
0 और 1 के बीच का फ़्लोटिंग-पॉइंट नंबर. इससे प्रयोग में हिस्सा लेने वाले ट्रैफ़िक के हिस्से का पता चलता है. चल रहे प्रयोग के लिए बदला जा सकता है. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
variations[] |
list |
वैरिएशन की कैटगरी. श्रेणी का पहला वैरिएशन मूल वर्शन होता है. किसी प्रयोग के रनिंग स्टेटस में होने पर, वैरिएशन की संख्या नहीं बदल सकती. स्थिति को रनिंग पर सेट करने से पहले, कम से कम दो वैरिएशन जोड़ना ज़रूरी है. | लिखा जा सकता है |
variations[].status |
string |
वैरिएशन की स्थिति. संभावित वैल्यू: "ACTIVE", "INACTIVE". इस्तेमाल न होने वाले वैरिएशन नहीं दिखाए जाते. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
variations[].url |
string |
वैरिएशन का यूआरएल. इस फ़ील्ड को किसी ऐसे प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति चालू हो या खत्म हो चुकी हो. | लिखा जा सकता है |
winnerConfidenceLevel |
double |
0 और 1 के बीच का फ़्लोटिंग-पॉइंट नंबर. विजेता चुनने के लिए ज़रूरी कॉन्फ़िडेंस लेवल बताती है. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. | लिखा जा सकता है |
जवाब
कामयाब होने पर, यह तरीका रिस्पॉन्स के तौर पर मैनेज.प्रयोग संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ // This example updates an existing experiment with new variations. Variations variationA = new Variations(); variationA.setName("Home Alpha"); variationA.setUrl("homeA.html"); Variations variationB = new Variations(); variationB.setName("Home Beta"); variationB.setUrl("homeB.html"); List<Variations> variations = Arrays.asList(variationA, variationB); try { // First get an existing Experiment. Experiment body = analytics.management().experiments().get("123456", "UA-123456-1", "7654321", "122333444455555").execute(); // Set the new variations. body.setVariations(variations); // Call Update with the updated experiment. analytics.management().experiments().update("123456", "UA-123456-1", "7654321", "122333444455555", body).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ /** * This request updates an existing experiment. */ // Construct the first variation. $variationA = new Google_Service_Analytics_ExperimentVariations(); $variationA->setName('VariationA'); $variationA->setUrl('index.html'); // Construct the second variation. $variationB = new Google_Service_Analytics_ExperimentVariations(); $variationB->setName('VariationB'); $variationB->setUrl('indexB.html'); try { // Get an existing Experiment. $experiment = $analytics->management_experiments->get('123456', 'UA-123456-1', '7654321', '122333444455555'); // Set the new variations. $experiment->setVariations(array($variationA, $variationB)); // Call the update method with the updated experiment. $analytics->management_experiments->update('123456', 'UA-123456-1', '7654321', '122333444455555', $experiment); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
# Note: This code assumes you have an authorized Analytics service object. # See the Experiments Developer Guide for details. # This request updates an existing experiment with a new name, # and new variations. try: analytics.management().experiments().update( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', experimentId='ABCDEFG123456abcdefg', body={ 'name': 'Updated Test Title', 'status': 'DRAFT', 'variations': [ { 'name': 'Checkout Page', 'url': 'checkout.html' }, { 'name': 'Proposed Checkout Page', 'url': 'newCheckout.html' } ] } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason))
JavaScript
JavaScript क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Experiments Developer Guide for details. */ /* * This request updates an existing experiment. */ function updateExperiment() { var request = gapi.client.analytics.management.experiments.update( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'profileId': '7654321', 'experimentId': '122333444455555', 'resource': { 'name': 'Landing Page Test', 'status': 'DRAFT', 'variations': [ { 'name': 'VariationA', 'url': 'index.html' }, { 'name': 'VariationB', 'url': 'indexB.html' } ] } }); request.execute(function (response) { // Handle the response. }); }