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:adsenseAdsclicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". هذا الحقل مطلوب إذا كانت الحالة "RUNNING" (تشغيل) وكان widthFramework واحدًا من "إعادة توجيه" أو "واجهة برمجة التطبيقات". قابل للكتابة
optimizationType string ما إذا كان يجب تصغير سمة eventMetric أو تكبيرها. القيم المحتملة: "الحد الأقصى" و"الحد الأدنى". اختياري--يتم ضبط القيمة التلقائية على "الحد الأقصى". لا يمكن تحديده بدون functionMetric. لا يمكن التعديل عندما تكون الحالة "قيد التشغيل" أو "منتهية". قابل للكتابة
rewriteVariationUrlsAsOriginal boolean قيمة منطقية تحدّد ما إذا كانت تتم إعادة كتابة عناوين URL للصيغ المختلفة لتتطابق مع عناوين URL الأصلية. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". قابل للكتابة
servingFramework string الإطار المستخدم لعرض الأشكال المختلفة للتجربة وتقييم النتائج. واحد مما يلي:
  • إعادة التوجيه: يُعيد Google Analytics توجيه الزيارات إلى صفحات أشكال مختلفة، ويعمل على إعداد تقارير عن الشكل المختار وتقييم النتائج.
  • واجهة برمجة التطبيقات: تختار Google Analytics الصيغة وتُبلغ عنها وتعرضها وتُقيّم النتائج؛ ويكون المتصل مسؤولاً عن عرض الصيغة المحدّدة.
  • خارجي: سيتم عرض الصيغ خارجيًا والإبلاغ عن الشكل المختار إلى "إحصاءات Google". فإن المتصل مسؤول عن عرض الصيغة المحددة وتقييم النتائج.
قابل للكتابة
trafficCoverage double رقم نقطة عائمة بين 0 و1. لتحديد جزء الزيارات التي تشارك في التجربة. يمكن تغيير هذا الإعداد لتجربة قيد التنفيذ. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". قابل للكتابة
variations[] list مصفوفة من الاختلافات. الاختلاف الأول في الصفيفة هو الأصل. قد لا يتغير عدد الأشكال المختلفة بمجرد أن تكون التجربة في حالة التشغيل. يجب توفّر شكلين على الأقل قبل ضبط الحالة على "تشغيل". قابل للكتابة
variations[].status string حالة الصيغة. القيم المحتملة: "ACTIVE" و"INACTIVE". لا يتم عرض الصيغ غير النشطة. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". قابل للكتابة
variations[].url string تمثّل هذه السمة عنوان URL لصفحة الشكل. لا يمكن تغيير هذا الحقل لتجربة حالتها "قيد التشغيل" أو "منتهية". قابل للكتابة
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. });
}