نیاز به مجوز دارد
یک آزمایش موجود را بهروزرسانی کنید. یک نمونه ببینید .
علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.
درخواست
درخواست 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 با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
خواص مورد نیاز | |||
id | string | شناسه آزمایش برای پچ و آپدیت مورد نیاز است. برای ایجاد غیرمجاز است. | |
name | string | نام آزمایش این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. این فیلد هنگام ایجاد آزمایش ضروری است. | قابل نوشتن |
status | string | وضعیت آزمایش مقادیر ممکن: "DRAFT"، "READY_TO_RUN"، "RUNNING"، "ENDED". آزمایشها را میتوان در حالت «DRAFT»، «READY_TO_RUN» یا «RUNNING» ایجاد کرد. این فیلد هنگام ایجاد آزمایش ضروری است. | قابل نوشتن |
variations[]. name | string | نام تنوع. این فیلد هنگام ایجاد آزمایش ضروری است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
ویژگی های اختیاری | |||
description | string | نکاتی در مورد این آزمایش | قابل نوشتن |
editableInGaUi | boolean | اگر درست باشد، کاربر نهایی میتواند آزمایش را از طریق رابط کاربری Google Analytics ویرایش کند. | قابل نوشتن |
equalWeighting | boolean | Boolean مشخص می کند که آیا ترافیک به طور مساوی در همه تغییرات توزیع شود یا خیر. اگر مقدار False باشد، آزمایشهای محتوا از رفتار پیشفرض تنظیم ترافیک به صورت پویا بر اساس عملکرد تغییرات پیروی میکنند. اختیاری -- پیش فرض نادرست است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
minimumExperimentLengthInDays | integer | یک عدد صحیح در [3، 90]. حداقل طول آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
objectiveMetric | string | معیاری که آزمایش در حال بهینه سازی آن است. مقادیر معتبر: "ga:goal(n)Completions"، "ga:adsenseAdsClicks"، "ga:adsenseAdsViewed"، "ga:adsenseRevenue"، "ga:bounces"، "ga:pageviews"، "ga:sessionDuration"، " ga:transactions، "ga:transactionRevenue". اگر وضعیت "در حال اجرا" باشد و servingFramework یکی از "REDIRECT" یا "API" باشد، این فیلد ضروری است. | قابل نوشتن |
optimizationType | string | اینکه آیا ObjectMetric باید به حداقل برسد یا حداکثر. مقادیر ممکن: "MAXIMUM"، "MINIMUM". اختیاری - پیشفرض روی "MAXIMUM". بدون ObjectMetric قابل تعیین نیست. وقتی وضعیت "در حال اجرا" یا "پایان" است، نمی توان آن را تغییر داد. | قابل نوشتن |
rewriteVariationUrlsAsOriginal | boolean | بولی که مشخص می کند آیا URL های تغییرات برای مطابقت با URL های اصلی بازنویسی می شوند یا خیر. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
servingFramework | string | چارچوب مورد استفاده برای ارائه تغییرات آزمایش و ارزیابی نتایج. یکی از:
| قابل نوشتن |
trafficCoverage | double | یک عدد ممیز شناور بین 0 و 1. کسری از ترافیک شرکت کننده در آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
variations[] | list | آرایه ای از تغییرات. اولین تغییر در آرایه اصلی است. هنگامی که آزمایش در حالت RUNNING قرار گرفت، ممکن است تعداد تغییرات تغییر نکند. قبل از تنظیم وضعیت روی RUNNING، حداقل دو تغییر لازم است. | قابل نوشتن |
variations[]. status | string | وضعیت تغییرات مقادیر ممکن: "ACTIVE"، "INACTIVE". تغییرات غیرفعال ارائه نمی شود. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
variations[]. url | string | URL تنوع. این فیلد ممکن است برای آزمایشی که وضعیت آن در حال اجرا یا پایان است تغییر نکند. | قابل نوشتن |
winnerConfidenceLevel | double | یک عدد ممیز شناور بین 0 و 1. سطح اطمینان لازم برای انتخاب برنده را مشخص می کند. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع management.experiment را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * 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(); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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))
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * 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. }); }
نیاز به مجوز دارد
یک آزمایش موجود را بهروزرسانی کنید. یک نمونه ببینید .
علاوه بر پارامترهای استاندارد ، این روش از پارامترهای فهرست شده در جدول پارامترها پشتیبانی می کند.
درخواست
درخواست 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 با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
خواص مورد نیاز | |||
id | string | شناسه آزمایش برای پچ و آپدیت مورد نیاز است. برای ایجاد غیرمجاز است. | |
name | string | نام آزمایش این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. این فیلد هنگام ایجاد آزمایش ضروری است. | قابل نوشتن |
status | string | وضعیت آزمایش مقادیر ممکن: "DRAFT"، "READY_TO_RUN"، "RUNNING"، "ENDED". آزمایشها را میتوان در حالت «DRAFT»، «READY_TO_RUN» یا «RUNNING» ایجاد کرد. این فیلد هنگام ایجاد آزمایش ضروری است. | قابل نوشتن |
variations[]. name | string | نام تنوع. این فیلد هنگام ایجاد آزمایش ضروری است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
ویژگی های اختیاری | |||
description | string | نکاتی در مورد این آزمایش | قابل نوشتن |
editableInGaUi | boolean | اگر درست باشد، کاربر نهایی میتواند آزمایش را از طریق رابط کاربری Google Analytics ویرایش کند. | قابل نوشتن |
equalWeighting | boolean | Boolean مشخص می کند که آیا ترافیک به طور مساوی در همه تغییرات توزیع شود یا خیر. اگر مقدار False باشد، آزمایشهای محتوا از رفتار پیشفرض تنظیم ترافیک به صورت پویا بر اساس عملکرد تغییرات پیروی میکنند. اختیاری -- پیش فرض نادرست است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
minimumExperimentLengthInDays | integer | یک عدد صحیح در [3، 90]. حداقل طول آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
objectiveMetric | string | معیاری که آزمایش در حال بهینه سازی آن است. مقادیر معتبر: "ga:goal(n)Completions"، "ga:adsenseAdsClicks"، "ga:adsenseAdsViewed"، "ga:adsenseRevenue"، "ga:bounces"، "ga:pageviews"، "ga:sessionDuration"، " ga:transactions، "ga:transactionRevenue". اگر وضعیت "در حال اجرا" باشد و servingFramework یکی از "REDIRECT" یا "API" باشد، این فیلد ضروری است. | قابل نوشتن |
optimizationType | string | اینکه آیا ObjectMetric باید به حداقل برسد یا حداکثر. مقادیر ممکن: "MAXIMUM"، "MINIMUM". اختیاری - پیشفرض روی "MAXIMUM". بدون ObjectMetric قابل تعیین نیست. وقتی وضعیت "در حال اجرا" یا "پایان" است، نمی توان آن را تغییر داد. | قابل نوشتن |
rewriteVariationUrlsAsOriginal | boolean | بولی که مشخص می کند آیا URL های تغییرات برای مطابقت با URL های اصلی بازنویسی می شوند یا خیر. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
servingFramework | string | چارچوب مورد استفاده برای ارائه تغییرات آزمایش و ارزیابی نتایج. یکی از:
| قابل نوشتن |
trafficCoverage | double | یک عدد ممیز شناور بین 0 و 1. کسری از ترافیک شرکت کننده در آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
variations[] | list | آرایه ای از تغییرات. اولین تغییر در آرایه اصلی است. هنگامی که آزمایش در حالت RUNNING قرار گرفت، ممکن است تعداد تغییرات تغییر نکند. قبل از تنظیم وضعیت روی RUNNING، حداقل دو تغییر لازم است. | قابل نوشتن |
variations[]. status | string | وضعیت تغییرات مقادیر ممکن: "ACTIVE"، "INACTIVE". تغییرات غیرفعال ارائه نمی شود. ممکن است این فیلد برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
variations[]. url | string | URL تنوع. این فیلد ممکن است برای آزمایشی که وضعیت آن در حال اجرا یا پایان است تغییر نکند. | قابل نوشتن |
winnerConfidenceLevel | double | یک عدد ممیز شناور بین 0 و 1. سطح اطمینان لازم برای انتخاب برنده را مشخص می کند. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع management.experiment را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * 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(); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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))
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * 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. }); }