अनुमति की ज़रूरत है
मौजूदा एक्सपेरिमेंट को अपडेट करें. यह तरीका पैच सिमैंटिक के साथ काम करता है. उदाहरण देखें.
स्टैंडर्ड पैरामीटर के अलावा, यह तरीका पैरामीटर टेबल में दिए गए पैरामीटर के साथ काम करता है.
अनुरोध
एचटीटीपी अनुरोध
PATCH 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 |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी की मदद से, पैच सिमैंटिक के नियमों के मुताबिक, management.experiment संसाधन के काम के हिस्से दें:
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | ज़रूरी जानकारी |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
id |
string |
एक्सपेरिमेंट आईडी. पैच और अपडेट के लिए ज़रूरी है. बनाने की अनुमति नहीं है. | |
वैकल्पिक प्रॉपर्टी | |||
description |
string |
इस प्रयोग के बारे में नोट. | लिखा जा सकता है |
editableInGaUi |
boolean |
अगर सही है, तो असली उपयोगकर्ता Google Analytics यूज़र इंटरफ़ेस के ज़रिए प्रयोग में बदलाव कर सकेगा. | लिखा जा सकता है |
equalWeighting |
boolean |
बूलियन यह तय करता है कि ट्रैफ़िक को सभी वैरिएशन में बराबर बांटना है या नहीं. अगर वैल्यू गलत है, तो कॉन्टेंट एक्सपेरिमेंट, वैरिएशन की परफ़ॉर्मेंस के आधार पर ट्रैफ़िक में डाइनैमिक तौर पर बदलाव करने का डिफ़ॉल्ट तरीका अपनाते हैं. ज़रूरी नहीं -- डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
minimumExperimentLengthInDays |
integer |
[3, 90] में एक पूर्णांक संख्या. एक्सपेरिमेंट की कम से कम अवधि बताती है. किसी मौजूदा एक्सपेरिमेंट के लिए, इसे बदला जा सकता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
name |
string |
एक्सपेरिमेंट का नाम. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है. | लिखा जा सकता है |
objectiveMetric |
string |
वह मेट्रिक जिसे प्रयोग ऑप्टिमाइज़ कर रहा है. मान्य वैल्यू: "ga:goal(n)completes", "ga:adsenseAdsClick", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". अगर स्टेटस "RUNNING" है और होस्टिंग फ़्रेमवर्क "रीडायरेक्ट" या "एपीआई" में से एक है, तो इस फ़ील्ड को भरना ज़रूरी है. | लिखा जा सकता है |
optimizationType |
string |
मकसद मेट्रिक को छोटा करना है या बड़ा करना है. संभावित वैल्यू: "लागत", "कम से कम". ज़रूरी नहीं--यह वैल्यू डिफ़ॉल्ट रूप से " MAX" पर सेट होती है. मकसद मेट्रिक के बिना तय नहीं किया जा सकता. स्थिति "चल रहा है" या "ENDED" होने पर, इसे बदला नहीं जा सकता. | लिखा जा सकता है |
rewriteVariationUrlsAsOriginal |
boolean |
बूलियन यह तय करता है कि क्या अलग-अलग वर्शन के यूआरएल को फिर से मूल यूआरएल से मैच कराने के लिए लिखा गया है या नहीं. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
servingFramework |
string |
एक्सपेरिमेंट के वैरिएशन और नतीजों का आकलन करने के लिए इस्तेमाल किया जाने वाला फ़्रेमवर्क. इनमें से एक:
|
लिखा जा सकता है |
status |
string |
एक्सपेरिमेंट की स्थिति. संभावित वैल्यू: "Draft", "READY_TO_RUN", "RUNNING", "ENDED". प्रयोगों को "ड्राफ़्ट", "READY_TO_RUN" या "RUNNING" स्थिति में बनाया जा सकता है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है. | लिखा जा सकता है |
trafficCoverage |
double |
0 और 1 के बीच का कोई फ़्लोटिंग-पॉइंट नंबर. प्रयोग में शामिल होने वाले ट्रैफ़िक के हिस्से के बारे में बताता है. किसी मौजूदा एक्सपेरिमेंट के लिए, इसे बदला जा सकता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
variations[] |
list |
वैरिएशन की कैटगरी. कलेक्शन में पहला वैरिएशन ओरिजनल होता है. किसी प्रयोग के दौड़ने की स्थिति में होने पर, शायद वैरिएशन की संख्या न बदल पाए. स्टेटस को RUNNING पर सेट करने के लिए, कम से कम दो वैरिएशन ज़रूरी हैं. | लिखा जा सकता है |
variations[].name |
string |
भिन्नरूप का नाम. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
variations[].status |
string |
वैरिएशन की स्थिति. संभावित वैल्यू: "चालू है", "बंद है". प्रयोग में नहीं वैरिएशन पेश नहीं किए गए हैं. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
variations[].url |
string |
वैरिएशन का यूआरएल. जिस प्रयोग की स्थिति RUNNING या ENDED है उसके लिए, शायद यह फ़ील्ड न बदला जाए. | लिखा जा सकता है |
winnerConfidenceLevel |
double |
0 और 1 के बीच का कोई फ़्लोटिंग-पॉइंट नंबर. विजेता को चुनने के लिए ज़रूरी कॉन्फ़िडेंस लेवल बताता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. | लिखा जा सकता है |
जवाब
अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में यह तरीका management.experiment संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
/* * Note: This code assumes you have an authorized Analytics service object. * See the Experiments Developer Guide for details. */ // This example patches an existing experiment with new variations. Variations variationA = new Variations(); variationA.setName("Home A"); variationA.setUrl("homeA.html"); Variations variationB = new Variations(); variationB.setName("Home B"); 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 Patch with the updated experiment. analytics.management().experiments().patch("123456", "UA-123456-1", "7654321", "12233344455555", 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 patches 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 patch method with the updated experiment. $analytics->management_experiments->patch('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 patches an existing experiment with a new name, # and new variations. try: analytics.management().experiments().patch( accountId='123456', webPropertyId='UA-123456-1', profileId='7654321', experimentId='ABCDEFG123456abcdefg', body={ 'name': 'Landing Page Test April', 'variations': [ { 'name': 'First Variation', 'url': 'index.html' }, { 'name': 'Proposed Change', '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
JavaScript क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Experiments Developer Guide for details. */ /* * This request patches an existing experiment. */ function patchExperiment() { var request = gapi.client.analytics.management.experiments.patch( { '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. }); }