स्टैंडर्ड Universal Analytics (UA) प्रॉपर्टी ने 1 जुलाई, 2023 से डेटा प्रोसेस करना बंद कर दिया है. UA 360 प्रॉपर्टी, 1 जुलाई, 2024 से डेटा को प्रोसेस करना बंद कर देंगी. साथ ही, Google Analytics 4 पर माइग्रेट करने की वजह से, UA 360 की कुछ सुविधाएं इससे पहले ही बंद हो जाएंगी. GA4 प्रॉपर्टी का प्रावधान और उसे मैनेज करने के लिए, Admin API का इस्तेमाल करें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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`

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

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

प्रॉपर्टी का नाम	वैल्यू	ब्यौरा	ज़रूरी जानकारी
ज़रूरी प्रॉपर्टी
`name`	`string`	एक्सपेरिमेंट का नाम. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है.	लिखा जा सकता है
`status`	`string`	एक्सपेरिमेंट की स्थिति. संभावित वैल्यू: "Draft", "READY_TO_RUN", "RUNNING", "ENDED". प्रयोगों को "ड्राफ़्ट", "READY_TO_RUN" या "RUNNING" स्थिति में बनाया जा सकता है. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है.	लिखा जा सकता है
`variations[].name`	`string`	भिन्नरूप का नाम. प्रयोग बनाते समय यह फ़ील्ड ज़रूरी है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है.	लिखा जा सकता है
वैकल्पिक प्रॉपर्टी
`description`	`string`	इस प्रयोग के बारे में नोट.	लिखा जा सकता है
`editableInGaUi`	`boolean`	अगर सही है, तो असली उपयोगकर्ता Google Analytics यूज़र इंटरफ़ेस के ज़रिए प्रयोग में बदलाव कर सकेगा.	लिखा जा सकता है
`equalWeighting`	`boolean`	बूलियन यह तय करता है कि ट्रैफ़िक को सभी वैरिएशन में बराबर बांटना है या नहीं. अगर वैल्यू गलत है, तो कॉन्टेंट एक्सपेरिमेंट, वैरिएशन की परफ़ॉर्मेंस के आधार पर ट्रैफ़िक में डाइनैमिक तौर पर बदलाव करने का डिफ़ॉल्ट तरीका अपनाते हैं. ज़रूरी नहीं -- डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है.	लिखा जा सकता है
`minimumExperimentLengthInDays`	`integer`	[3, 90] में एक पूर्णांक संख्या. एक्सपेरिमेंट की कम से कम अवधि बताती है. किसी मौजूदा एक्सपेरिमेंट के लिए, इसे बदला जा सकता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है.	लिखा जा सकता है
`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`	एक्सपेरिमेंट के वैरिएशन और नतीजों का आकलन करने के लिए इस्तेमाल किया जाने वाला फ़्रेमवर्क. इनमें से एक: रीडायरेक्ट: Google Analytics ट्रैफ़िक को अलग-अलग विविधता पेज पर रीडायरेक्ट करता है, चुनी गई विविधता की रिपोर्ट करता है और परिणामों का मूल्यांकन करता है. API: Google Analytics, नतीजे दिखाने और उनका आकलन करने के लिए, वर्शन चुनता है और उसकी रिपोर्ट करता है. चुनी गई वैरिएशन दिखाने के लिए कॉलर की ज़िम्मेदारी है. बाहरी: वैरिएशन बाहरी पेश किए जाएंगे और चुने गए वैरिएशन Google Analytics को रिपोर्ट किए जाएंगे. चुने गए वैरिएशन को दिखाने और नतीजों का आकलन करने की ज़िम्मेदारी कॉलर की है.	लिखा जा सकता है
`trafficCoverage`	`double`	0 और 1 के बीच का कोई फ़्लोटिंग-पॉइंट नंबर. प्रयोग में शामिल होने वाले ट्रैफ़िक के हिस्से के बारे में बताता है. किसी मौजूदा एक्सपेरिमेंट के लिए, इसे बदला जा सकता है. यह फ़ील्ड उस प्रयोग के लिए नहीं बदला जा सकता जिसकी स्थिति खत्म हो गई है.	लिखा जा सकता है
`variations[]`	`list`	वैरिएशन की कैटगरी. कलेक्शन में पहला वैरिएशन ओरिजनल होता है. किसी प्रयोग के दौड़ने की स्थिति में होने पर, शायद वैरिएशन की संख्या न बदल पाए. स्टेटस को RUNNING पर सेट करने के लिए, कम से कम दो वैरिएशन ज़रूरी हैं.	लिखा जा सकता है
`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 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. });
}