Experiments: update

इसके लिए, अनुमति लेना ज़रूरी है

किसी मौजूदा एक्सपेरिमेंट को अपडेट करें. उदाहरण देखें.

स्टैंडर्ड पैरामीटर के अलावा, यह तरीका पैरामीटर टेबल में दिए गए पैरामीटर के साथ काम करता है.

अनुरोध

एचटीटीपी अनुरोध

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

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ management.experiment संसाधन के तौर पर शामिल करें:

प्रॉपर्टी का नाम वैल्यू ब्यौरा ज़रूरी जानकारी
ज़रूरी प्रॉपर्टी
id string एक्सपेरिमेंट आईडी. पैच और अपडेट के लिए ज़रूरी है. बनाने की अनुमति नहीं है.
name string एक्सपेरिमेंट का नाम. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है. लिखने योग्य
status string एक्सपेरिमेंट की स्थिति. संभावित वैल्यू: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". प्रयोगों को "DRAFT", "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)completes", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". यह फ़ील्ड तब ज़रूरी है, जब स्टेटस "RUNNING" है और serviceFramework एक "रीडायरेक्ट" या "एपीआई" में से एक है. लिखने योग्य
optimizationType string मकसद मेट्रिक को छोटा किया जाना चाहिए या बड़ा किया जाना चाहिए. संभावित वैल्यू: "NUMBER", "MINIMUM". वैकल्पिक--डिफ़ॉल्ट रूप से " max". मकसद मेट्रिक के बिना इसे तय नहीं किया जा सकता. स्थिति "RUNNING" या "ENDED" होने पर, इसे बदला नहीं जा सकता. लिखने योग्य
rewriteVariationUrlsAsOriginal boolean बूलियन यह बताता है कि अलग-अलग वर्शन के यूआरएल को मूल यूआरएल से मिलान करने के लिए फिर से लिखा गया है या नहीं. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. लिखने योग्य
servingFramework string एक्सपेरिमेंट के वैरिएशन और नतीजों का आकलन करने के लिए इस्तेमाल किया जाने वाला फ़्रेमवर्क. इनमें से एक:
  • रीडायरेक्ट: Google Analytics ट्रैफ़िक को अलग-अलग विविधता पेजों पर रीडायरेक्ट करता है, चुनी गई वैरिएशन की रिपोर्ट करता है और नतीजों का आकलन करता है.
  • API: Google Analytics, नतीजों को दिखाने और उनका आकलन करने के लिए, वैरिएशन चुनता है और उनकी रिपोर्ट करता है. चुने गए वैरिएशन को दिखाने की ज़िम्मेदारी कॉलर की होती है.
  • बाहरी: वैरिएशन बाहर से दिखाए जाएंगे और चुने गए वैरिएशन Google Analytics को रिपोर्ट किए जाएंगे. चुने गए वैरिएशन को दिखाने और नतीजों का आकलन करने की ज़िम्मेदारी कॉलर की है.
लिखने योग्य
trafficCoverage double 0 और 1 के बीच का फ़्लोटिंग-पॉइंट नंबर. प्रयोग में हिस्सा लेने वाले ट्रैफ़िक के अंश को दिखाता है. चल रहे किसी प्रयोग के लिए, इसे बदला जा सकता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. लिखने योग्य
variations[] list वैरिएशन की कलेक्शन. कलेक्शन में मौजूद पहला वैरिएशन ओरिजनल होता है. किसी प्रयोग के रनिंग की स्थिति में होने पर, हो सकता है कि वैरिएशन की संख्या न बदल पाए. स्टेटस को RUNNING पर सेट करने से पहले, कम से कम दो वैरिएशन ज़रूरी हैं. लिखने योग्य
variations[].status string वैरिएशन की स्थिति. संभावित वैल्यू: "चालू है", "बंद है". इस्तेमाल न होने वाले वैरिएशन नहीं दिए गए हैं. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. लिखने योग्य
variations[].url string वैरिएशन का यूआरएल. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति चल रही है या खत्म हो गई है. लिखने योग्य
winnerConfidenceLevel double 0 और 1 के बीच का फ़्लोटिंग-पॉइंट नंबर. विजेता चुनने के लिए ज़रूरी कॉन्फ़िडेंस लेवल बताता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है. लिखने योग्य

जवाब

कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में management.experiment संसाधन को दिखाता है.

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

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. });
}