Experiments: insert

अनुमति देना ज़रूरी है

एक नया प्रयोग बनाएं. एक उदाहरण देखें.

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

अनुरोध करें

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

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments

पैरामीटर

पैरामीटर का नाम	वैल्यू	जानकारी
पाथ पैरामीटर
accountId	string	वह खाता आईडी जिसके लिए प्रयोग बनाना है.
profileId	string	प्रयोग बनाने के लिए, व्यू (प्रोफ़ाइल) आईडी देखें.
webPropertyId	string	प्रयोग के लिए वेब प्रॉपर्टी आईडी.

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम किसी एक दायरे की अनुमति ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

अनुमति देने का
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

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

अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ एक मैनेजमेंट.प्रयोग संसाधन उपलब्ध कराएं:

प्रॉपर्टी का नाम	वैल्यू	जानकारी	नोट
ज़रूरी प्रॉपर्टी
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&quot&quot&quot&quot&quot&yourm&&&quot&quot अगर फ़ील्ड में स्टेटस है, जबकि &RUNNING" और सर्व करने का फ़्रेमवर्क एक है "API" है, तो यह फ़ील्ड ज़रूरी है.	लिखा जा सकता है
optimizationType	string	मकसद मेट्रिक को छोटा करना चाहिए या बढ़ाया जाना चाहिए. संभावित मान: "Max", "minimum". वैकल्पिक--defaults "Max". इसे मकसद के बिना नहीं बताया जा सकता. जब स्थिति "RUNNING" या "ENDED" होने पर बदली नहीं जा सकती.	लिखा जा सकता है
rewriteVariationUrlsAsOriginal	boolean	बूलियन, जिससे यह तय होता है कि यूआरएल के मूल वर्शन से मिलते-जुलते यूआरएल फिर से लिखे गए हैं या नहीं. इस फ़ील्ड को उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति ENDED है.	लिखा जा सकता है
servingFramework	string	प्रयोग के अलग-अलग वैरिएंट दिखाने और नतीजों का आकलन करने के लिए इस्तेमाल किया जाने वाला फ़्रेमवर्क. इनमें से एक: रीडायरेक्ट: Google Analytics ट्रैफ़िक को अलग-अलग वर्शन वाले पेजों पर रीडायरेक्ट करता है, चुने गए वैरिएशन की रिपोर्ट करता है, और नतीजों का मूल्यांकन करता है. API: Google Analytics, नतीजों को दिखाने और उनका आकलन करने के लिए, वैरिएशन चुनता है और उसकी रिपोर्ट करता है. कॉल करने वाला व्यक्ति, चुने गए वैरिएशन को दिखाने के लिए ज़िम्मेदार होता है. बाहरी: वैरिएशन को बाहरी तौर पर दिखाया जाएगा और चुने गए वैरिएशन Google Analytics को रिपोर्ट किए जाएंगे. कॉल करने वाले व्यक्ति की ज़िम्मेदारी होती है कि वह चुने गए वैरिएशन को पूरा करे और नतीजों की जांच करे.	लिखा जा सकता है
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 request creates a new Experiment.
 */

// Construct the body of the request.
Experiment body = new Experiment();
body.setName("Landing Page Experiment");
body.setStatus("DRAFT");

// Construct the first variation.
Variations variationA = new Variations();
variationA.setName("Variation A");
variationA.setUrl("index.html");

// Construct the second variation.
Variations variationB = new Variations();
variationB.setName("Variation B");
variationB.setUrl("indexB.html");

// Set the variations.
body.setVariations(Arrays.asList(variationA, variationB));

try {
  analytics.management().experiments().insert("123456", "UA-123456-1",
      "7654321", 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 creates a new experiment.
 */

// Construct the body of the request.
$experiment = new Google_Service_Analytics_Experiment();
$experiment->setName('Landing Page Experiment');
$experiment->setStatus('DRAFT');

// 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');

// Set the variations.
$experiment->setVariations(array($variationA, $variationB));

try {
  $analytics->management_experiments->insert('123456', 'UA-123456-1',
      '7654321', $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.

# Example #1:
# Creates a new DRAFT experiment with two variations.
try:
  experiments = analytics.management().experiments().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='98765432',
      body={
          'name': 'Landing Page Test',
          'status': 'DRAFT',
          'variations': [
              {
                  'name': 'Variation A',
                  'url': 'index.html'
              },
              {
                  'name': 'Variation B',
                  '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 creates a new Experiment.
 */
function insertExperiment() {
  var request = gapi.client.analytics.management.experiments.insert(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      '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. });
}