يجب تقديم تفويض
عدِّل تجربة حالية. تدعم هذه الطريقة دلالات التصحيح. اطّلِع على مثال.
بالإضافة إلى المَعلمات العادية، تتيح هذه الطريقة المَعلمات الواردة في جدول المَعلمات.
الطلب
طلب 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، وفقًا لقواعد دلالات التصحيح، بالسمات التالية:
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
الخصائص المطلوبة | |||
id |
string |
رقم تعريف التجربة. مطلوب للتصحيح والتحديث. غير مسموح للإنشاء. | |
الخصائص الاختيارية | |||
description |
string |
ملاحظات حول هذه التجربة | قابل للكتابة |
editableInGaUi |
boolean |
وفي حال ضبطها على "صحيح"، سيتمكّن المستخدم النهائي من تعديل التجربة من خلال واجهة مستخدِم "إحصاءات Google". | قابل للكتابة |
equalWeighting |
boolean |
قيمة منطقية لتحديد ما إذا كان سيتم توزيع الزيارات بالتساوي على جميع الصيغ. إذا كانت القيمة "خطأ"، تتّبع تجارب المحتوى السلوك التلقائي لضبط عدد الزيارات ديناميكيًا استنادًا إلى أداء الصيغة. اختياري -- القيمة التلقائية هي "خطأ". لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". | قابل للكتابة |
minimumExperimentLengthInDays |
integer |
رقم صحيح في [3، 90]. تحدّد الحد الأدنى لمدة التجربة. يمكن تغيير هذا الإعداد لتجربة قيد التنفيذ. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". | قابل للكتابة |
name |
string |
اسم التجربة. لا يمكن تغيير هذا الحقل في تجربة حالتها "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 |
الإطار المستخدم لعرض الأشكال المختلفة للتجربة وتقييم النتائج. واحد مما يلي:
|
قابل للكتابة |
status |
string |
حالة التجربة القيم المحتملة: "DRAFT" و"READY_TO_RUN" و"RUNNING" و"ENDED". يمكن إنشاء التجارب بالحالة "مسودة" أو "READY_TO_RUN" أو "RUNNING". هذا الحقل مطلوب عند إنشاء تجربة. | قابل للكتابة |
trafficCoverage |
double |
رقم نقطة عائمة بين 0 و1. لتحديد جزء الزيارات التي تشارك في التجربة. يمكن تغيير هذا الإعداد لتجربة قيد التنفيذ. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". | قابل للكتابة |
variations[] |
list |
مصفوفة من الاختلافات. الاختلاف الأول في الصفيفة هو الأصل. قد لا يتغير عدد الأشكال المختلفة بمجرد أن تكون التجربة في حالة التشغيل. يجب توفّر شكلين على الأقل قبل ضبط الحالة على "تشغيل". | قابل للكتابة |
variations[].name |
string |
اسم الصيغة المختلفة. هذا الحقل مطلوب عند إنشاء تجربة. لا يمكن تغيير هذا الحقل في تجربة حالتها "ENDED". | قابل للكتابة |
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 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()); }
PHP
لاستخدام مكتبة برامج PHP.
/** * 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(); }
Python
تستخدم مكتبة برامج Python.
# 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))
JavaScript
تستخدم مكتبة عميل JavaScript.
/* * 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. }); }