Experiments: patch

অনুমোদন প্রয়োজন

একটি বিদ্যমান পরীক্ষা আপডেট করুন। এই পদ্ধতি প্যাচ শব্দার্থবিদ্যা সমর্থন করে. একটি উদাহরণ দেখুন ।

স্ট্যান্ডার্ড প্যারামিটারগুলি ছাড়াও, এই পদ্ধতিটি প্যারামিটার টেবিলে তালিকাভুক্ত পরামিতিগুলিকে সমর্থন করে।

অনুরোধ

HTTP অনুরোধ

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 বুলিয়ান সব বৈচিত্র জুড়ে সমানভাবে ট্র্যাফিক বিতরণ করতে হবে কিনা তা নির্দিষ্ট করে৷ মানটি মিথ্যা হলে, বিষয়বস্তু পরীক্ষাগুলি পরিবর্তনের কার্যকারিতার উপর ভিত্তি করে গতিশীলভাবে ট্র্যাফিক সামঞ্জস্য করার ডিফল্ট আচরণ অনুসরণ করে। ঐচ্ছিক -- ডিফল্ট থেকে False. এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
minimumExperimentLengthInDays integer [৩, ৯০] একটি পূর্ণসংখ্যা। পরীক্ষার ন্যূনতম দৈর্ঘ্য নির্দিষ্ট করে। চলমান পরীক্ষার জন্য পরিবর্তন করা যেতে পারে। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
name string পরীক্ষার নাম। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ একটি পরীক্ষা তৈরি করার সময় এই ক্ষেত্রটি প্রয়োজন৷ লিখনযোগ্য
objectiveMetric string পরীক্ষাটি অপ্টিমাইজ করছে এমন মেট্রিক। বৈধ মান: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", " ga:লেনদেন", "ga:transactionRevenue"। স্ট্যাটাস "চলমান" হলে এবং সার্ভিং ফ্রেমওয়ার্ক "REDIRECT" বা "API" এর মধ্যে একটি হলে এই ক্ষেত্রটি প্রয়োজন৷ লিখনযোগ্য
optimizationType string অবজেক্টিভমেট্রিক মিনিমাইজ বা ম্যাক্সিমাইজ করা উচিত কিনা। সম্ভাব্য মান: "সর্বোচ্চ", "মিনিমাম"। ঐচ্ছিক--ডিফল্ট "MAXIMUM"। উদ্দেশ্যমেট্রিক ছাড়া নির্দিষ্ট করা যাবে না। স্ট্যাটাস "চলমান" বা "শেষ" হলে পরিবর্তন করা যাবে না। লিখনযোগ্য
rewriteVariationUrlsAsOriginal boolean বুলিয়ান নির্দিষ্ট করে যে ভিন্নতা ইউআরএলগুলি মূলের সাথে মেলে কিনা তা আবার লেখা হয়েছে। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
servingFramework string পরীক্ষার বৈচিত্র পরিবেশন করতে এবং ফলাফলের মূল্যায়ন করার জন্য ব্যবহৃত কাঠামো। অন্যতম:
  • পুনঃনির্দেশ: গুগল অ্যানালিটিক্স ট্রাফিককে বিভিন্ন বৈচিত্র্য পৃষ্ঠায় পুনঃনির্দেশ করে, নির্বাচিত বৈচিত্রের প্রতিবেদন করে এবং ফলাফলের মূল্যায়ন করে।
  • এপিআই: গুগল অ্যানালিটিক্স ফলাফল পরিবেশন ও মূল্যায়ন করার জন্য বৈচিত্র নির্বাচন করে এবং প্রতিবেদন করে; কলার নির্বাচিত বৈচিত্র পরিবেশনের জন্য দায়ী।
  • বাহ্যিক: বৈচিত্রগুলি বাহ্যিকভাবে পরিবেশন করা হবে এবং নির্বাচিত বৈচিত্রগুলি Google Analytics-এ রিপোর্ট করা হবে৷ কলকারী নির্বাচিত বৈচিত্র পরিবেশন এবং ফলাফল মূল্যায়নের জন্য দায়ী।
 লিখনযোগ্য
status string পরীক্ষার স্থিতি। সম্ভাব্য মান: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED"। পরীক্ষাগুলি "DRAFT", "READY_TO_RUN" বা "RUNNING" অবস্থায় তৈরি করা যেতে পারে৷ একটি পরীক্ষা তৈরি করার সময় এই ক্ষেত্রটি প্রয়োজন৷ লিখনযোগ্য
trafficCoverage double 0 এবং 1 এর মধ্যে একটি ফ্লোটিং-পয়েন্ট সংখ্যা। পরীক্ষায় অংশগ্রহণকারী ট্রাফিকের ভগ্নাংশ নির্দিষ্ট করে। চলমান পরীক্ষার জন্য পরিবর্তন করা যেতে পারে। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
variations[] list বৈচিত্র্যের অ্যারে। অ্যারের প্রথম বৈচিত্রটি আসল। একবার পরীক্ষা চলমান অবস্থায় থাকলে পরিবর্তনের সংখ্যা পরিবর্তন নাও হতে পারে। RUNNING-এ স্ট্যাটাস সেট করার আগে অন্তত দুটি ভিন্নতা প্রয়োজন। লিখনযোগ্য
variations[]. name string প্রকরণের নাম। একটি পরীক্ষা তৈরি করার সময় এই ক্ষেত্রটি প্রয়োজন৷ এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
variations[]. status string প্রকরণের অবস্থা। সম্ভাব্য মান: "সক্রিয়", "নিষ্ক্রিয়"। নিষ্ক্রিয় বৈচিত্র পরিবেশিত হয় না. এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য
variations[]. url string পরিবর্তনের URL। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি চলমান বা শেষ। লিখনযোগ্য
winnerConfidenceLevel double 0 এবং 1 এর মধ্যে একটি ফ্লোটিং-পয়েন্ট সংখ্যা। একজন বিজয়ী নির্বাচন করার জন্য প্রয়োজনীয় আত্মবিশ্বাসের স্তর নির্দিষ্ট করে। এই ক্ষেত্রটি একটি পরীক্ষার জন্য পরিবর্তন করা যাবে না যার স্থিতি শেষ হয়েছে৷ লিখনযোগ্য

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি management.experiment সম্পদ প্রদান করে।

উদাহরণ

দ্রষ্টব্য: এই পদ্ধতির জন্য উপলব্ধ কোড উদাহরণগুলি সমস্ত সমর্থিত প্রোগ্রামিং ভাষার প্রতিনিধিত্ব করে না (সমর্থিত ভাষার তালিকার জন্য ক্লায়েন্ট লাইব্রেরি পৃষ্ঠা দেখুন)।

জাভা

জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

/*
 * 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());
}

পিএইচপি

পিএইচপি ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

/**
 * 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();
}

পাইথন

পাইথন ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

# 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))

জাভাস্ক্রিপ্ট

জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

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