ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را در 1 ژوئیه 2023 متوقف کردند . دارایی‌های UA 360 پردازش داده‌ها را در تاریخ 1 ژوئیه 2024 متوقف خواهند کرد و برخی از ویژگی‌های UA 360 قبل از آن منسوخ خواهند شد ، زیرا ما به Google Analytics 4 منتقل می‌شویم . از Admin API برای تهیه و مدیریت ویژگی های GA4 استفاده کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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`	Boolean مشخص می کند که آیا ترافیک به طور مساوی در همه تغییرات توزیع شود یا خیر. اگر مقدار False باشد، آزمایش‌های محتوا از رفتار پیش‌فرض تنظیم ترافیک به صورت پویا بر اساس عملکرد تغییرات پیروی می‌کنند. اختیاری -- پیش فرض نادرست است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند.	قابل نوشتن
`minimumExperimentLengthInDays`	`integer`	یک عدد صحیح در [3، 90]. حداقل طول آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند.	قابل نوشتن
`name`	`string`	نام آزمایش این فیلد ممکن است برای آزمایشی که وضعیت آن 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`	چارچوب مورد استفاده برای ارائه تغییرات آزمایش و ارزیابی نتایج. یکی از: REDIRECT: Google Analytics ترافیک را به صفحات تغییرات مختلف هدایت می کند، تغییرات انتخابی را گزارش می دهد و نتایج را ارزیابی می کند. API: Google Analytics تغییری را برای ارائه انتخاب و گزارش می‌کند و نتایج را ارزیابی می‌کند. تماس گیرنده مسئول ارائه تنوع انتخاب شده است. EXTERNAL: تغییرات به صورت خارجی ارائه می شود و تغییر انتخاب شده به Google Analytics گزارش می شود. تماس گیرنده مسئول ارائه تنوع انتخاب شده و ارزیابی نتایج است.	قابل نوشتن
`status`	`string`	وضعیت آزمایش مقادیر ممکن: "DRAFT"، "READY_TO_RUN"، "RUNNING"، "ENDED". آزمایش‌ها را می‌توان در حالت «DRAFT»، «READY_TO_RUN» یا «RUNNING» ایجاد کرد. این فیلد هنگام ایجاد آزمایش ضروری است.	قابل نوشتن
`trafficCoverage`	`double`	یک عدد ممیز شناور بین 0 و 1. کسری از ترافیک شرکت کننده در آزمایش را مشخص می کند. می توان برای یک آزمایش در حال اجرا تغییر داد. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند.	قابل نوشتن
`variations[]`	`list`	آرایه ای از تغییرات. اولین تغییر در آرایه اصلی است. هنگامی که آزمایش در حالت RUNNING قرار گرفت، ممکن است تعداد تغییرات تغییر نکند. قبل از تنظیم وضعیت روی RUNNING، حداقل دو تغییر لازم است.	قابل نوشتن
`variations[]. name`	`string`	نام تنوع. این فیلد هنگام ایجاد آزمایش ضروری است. این فیلد ممکن است برای آزمایشی که وضعیت آن ENDED است تغییر نکند.	قابل نوشتن
`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 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();
}

پایتون

از کتابخانه کلاینت پایتون استفاده می کند.

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