Experiments: update

يجب تقديم تفويض.

تعديل تجربة حالية اطّلِع على مثال.

وبالإضافة إلى المَعلمات العادية، تتيح هذه الطريقة استخدام المَعلمات المدرَجة في جدول المَعلمات.

الطلب

طلب HTTP

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 يحتوي على السمات التالية:

اسم الموقع	القيمة	الوصف	Notes
الخصائص المطلوبة
`id`	`string`	رقم تعريف التجربة. مطلوب للتصحيح والتحديث. غير مسموح بالإنشاء.
`name`	`string`	اسم التجربة. لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED. هذا الحقل مطلوب عند إنشاء تجربة.	قابل للكتابة
`status`	`string`	حالة التجربة القيم المحتملة: "DRAFT"، "READY_TO_RUN"، "RUNNING"، "ENDED" يمكن إنشاء التجارب بالحالة "مسودّة" أو "READY_TO_RUN" أو "RUNNING". هذا الحقل مطلوب عند إنشاء تجربة.	قابل للكتابة
`variations[].name`	`string`	اسم الشكل المختلف. هذا الحقل مطلوب عند إنشاء تجربة. لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
السمات الاختيارية
`description`	`string`	ملاحظات حول هذه التجربة	قابل للكتابة
`editableInGaUi`	`boolean`	في حال اختيار القيمة "صحيح"، سيتمكّن المستخدم النهائي من تعديل التجربة من خلال واجهة مستخدِم "إحصاءات Google".	قابل للكتابة
`equalWeighting`	`boolean`	يحدد هذا المنطقي ما إذا كان سيتم توزيع الزيارات بالتساوي على جميع صفحات الأشكال. وإذا كانت القيمة "خطأ"، تتّبع تجارب المحتوى السلوك التلقائي لضبط عدد الزيارات ديناميكيًا استنادًا إلى أداء الصيغة. اختياري -- يتم ضبط القيمة التلقائية على "خطأ". لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
`minimumExperimentLengthInDays`	`integer`	رقم صحيح في [3، 90]. تحدد هذه السمة الحد الأدنى لمدة التجربة. يمكن تغييرها لتجربة قيد التنفيذ. لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
`objectiveMetric`	`string`	المقياس الذي تعمل التجربة على تحسينه. القيم الصالحة: "ga:goal(n)completes", "ga:adsenseAdsAds", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". هذا الحقل مطلوب إذا كانت الحالة هي "RUNNING" وكانت viewFramework واحدة من "REDIRECT" أو "API".	قابل للكتابة
`optimizationType`	`string`	ما إذا كان يجب تصغير مقياس الهدف أو تكبيره. القيم المحتملة: "الحد الأقصى", "الحد الأقصى". اختياري-القيمة التلقائية هي "الحد الأقصى". لا يمكن أن تكون محدّدة بدون eventMetric. لا يمكن التعديل عندما تكون الحالة "RUNNING" أو "ENDED" (ENDED).	قابل للكتابة
`rewriteVariationUrlsAsOriginal`	`boolean`	قيمة منطقية تحدّد ما إذا كانت ستتم إعادة كتابة عناوين URL للصيغ المختلفة لتتطابق مع عناوين URL الأصلية لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
`servingFramework`	`string`	إطار العمل المستخدَم لعرض صيغ التجربة وتقييم النتائج. أحد الخيارات التالية: إعادة التوجيه: يُعيد Google Analytics توجيه الزيارات إلى صفحات أشكال مختلفة، ويعمل على إعداد تقارير عن الشكل المختار وتقييم النتائج. واجهة برمجة التطبيقات: تختار "إحصاءات Google" الصيغة وتُبلغ عنها لعرض النتائج وتقييمها؛ ويكون المتصل مسؤولاً عن عرض الشكل المحدّد. EXTERNAL: سيتم عرض الصيغ خارجيًا وسيتم إرسال تقارير عن الشكل المختار إلى "إحصاءات Google". ويكون المتصل مسؤولًا عن عرض الشكل المحدد وتقييم النتائج.	قابل للكتابة
`trafficCoverage`	`double`	رقم النقطة العائمة بين 0 و1. لتحديد جزء الزيارات التي تشارك في التجربة. يمكن تغييرها لتجربة قيد التنفيذ. لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
`variations[]`	`list`	مصفوفة من الأشكال المختلفة. الاختلاف الأول في الصفيف هو الأصل. قد لا يتغير عدد الأشكال المختلفة بعد دخول التجربة في حالة التشغيل. يجب إدخال شكلين على الأقل قبل ضبط الحالة على RUNNING.	قابل للكتابة
`variations[].status`	`string`	حالة الصيغة المختلفة. القيم المحتملة: "ACTIVE", "INACTIVE". ولا يتم عرض الصيغ غير النشطة. لا يمكن تغيير هذا الحقل لتجربة حالتها ENDED.	قابل للكتابة
`variations[].url`	`string`	تمثّل هذه السمة عنوان URL لصفحة الشكل. لا يمكن تغيير هذا الحقل لتجربة حالتها "قيد التشغيل" أو "ENDED".	قابل للكتابة
`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. });
}