Experiments: insert

Cần có uỷ quyền

Tạo thử nghiệm mới. Xem ví dụ.

Ngoài các thông số chuẩn, phương thức này còn hỗ trợ các thông số được liệt kê trong bảng thông số.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/experiments

Tham số

Tên thông số	Giá trị	Nội dung mô tả
Tham số đường dẫn
accountId	string	Mã tài khoản để tạo thử nghiệm.
profileId	string	Mã chế độ xem (Hồ sơ) để tạo thử nghiệm.
webPropertyId	string	Mã tài sản web để tạo thử nghiệm.

Ủy quyền

Yêu cầu này cần được uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

Nội dung yêu cầu

Trong nội dung yêu cầu, hãy cung cấp tài nguyênmanagement.experiment với các thuộc tính sau:

Tên tài sản	Giá trị	Nội dung mô tả	Ghi chú
Thuộc tính bắt buộc
name	string	Tên thử nghiệm. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC. Trường này là bắt buộc khi tạo thử nghiệm.	có thể ghi
status	string	Trạng thái thử nghiệm. Giá trị có thể là: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Bạn có thể tạo thử nghiệm ở trạng thái "DRAFT", "READY_TO_RUN" hoặc "RUNNING". Trường này là bắt buộc khi tạo thử nghiệm.	có thể ghi
variations[].name	string	Tên của biến thể. Trường này là bắt buộc khi tạo thử nghiệm. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
Thuộc tính không bắt buộc
description	string	Ghi chú về thử nghiệm này.	có thể ghi
editableInGaUi	boolean	Nếu đúng, người dùng cuối sẽ có thể chỉnh sửa thử nghiệm thông qua giao diện người dùng Google Analytics.	có thể ghi
equalWeighting	boolean	Boolean chỉ định xem có phân phối lưu lượng truy cập đồng đều cho tất cả biến thể hay không. Nếu giá trị là False, thử nghiệm nội dung sẽ tuân theo hành vi mặc định của việc điều chỉnh lưu lượng truy cập một cách linh động dựa trên hiệu suất của biến thể. Không bắt buộc – mặc định là False. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
minimumExperimentLengthInDays	integer	Một số nguyên trong [3, 90]. Chỉ định thời lượng tối thiểu của thử nghiệm. Có thể thay đổi cho một thử nghiệm đang chạy. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
objectiveMetric	string	Chỉ số mà thử nghiệm đang tối ưu hoá. Giá trị hợp lệ: "ga:mục tiêu(n) Trường này là bắt buộc nếu trạng thái là "RUNNING" và servingFramework là một trong những trạng thái "REDIRECT" hoặc "API".	có thể ghi
optimizationType	string	Liệu nên giảm thiểu hay tối đa chỉ số mục tiêu. Giá trị có thể là: "MAXIMUM", "TỐI THIỂU". Không bắt buộc--mặc định là "MAXIMUM". Không thể chỉ định nếu không có itemsMetric. Không thể sửa đổi khi trạng thái là "ĐANG CHẠY" hoặc "ĐÃ KẾT THÚC".	có thể ghi
rewriteVariationUrlsAsOriginal	boolean	Boolean chỉ định liệu URL biến thể có được viết lại để khớp với URL của biến thể gốc hay không. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
servingFramework	string	Khung này dùng để phân phát các biến thể thử nghiệm và đánh giá kết quả. Một trong các độ phân giải: CHUYỂN HƯỚNG: Google Analytics chuyển hướng lưu lượng truy cập đến các trang biến thể khác nhau, báo cáo biến thể đã chọn và đánh giá kết quả. API: Google Analytics chọn và báo cáo biến thể để phân phát và đánh giá kết quả; phương thức gọi chịu trách nhiệm phân phát biến thể đã chọn. BÊN NGOÀI: Các biến thể sẽ được phân phát bên ngoài và biến thể đã chọn được báo cáo cho Google Analytics. Phương thức gọi chịu trách nhiệm phân phối biến thể đã chọn và đánh giá kết quả.	có thể ghi
trafficCoverage	double	Số thực dấu phẩy động từ 0 đến 1. Chỉ định tỷ lệ lưu lượng truy cập tham gia vào thử nghiệm. Có thể thay đổi cho một thử nghiệm đang chạy. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
variations[]	list	Mảng biến thể. Biến thể đầu tiên trong mảng là biến thể gốc. Số lượng biến thể có thể không thay đổi khi thử nghiệm ở trạng thái ĐANG CHẠY. Cần có ít nhất hai biến thể trước khi có thể đặt trạng thái thành ĐANG CHẠY.	có thể ghi
variations[].status	string	Trạng thái của biến thể. Giá trị có thể là: "ACTIVE", "INACTIVE". Các biến thể KHÔNG HOẠT ĐỘNG không được phân phát. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi
variations[].url	string	URL của biến thể. Bạn không thể thay đổi trường này cho một thử nghiệm có trạng thái ĐANG HOẠT ĐỘNG hoặc ĐÃ KẾT THÚC.	có thể ghi
winnerConfidenceLevel	double	Số thực dấu phẩy động từ 0 đến 1. Chỉ định mức độ tin cậy cần thiết để chọn thử nghiệm chiến thắng. Không thể thay đổi trường này cho một thử nghiệm có trạng thái là ĐÃ KẾT THÚC.	có thể ghi

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên manager.experiment trong nội dung phản hồi.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Sử dụng thư viện ứng dụng Java.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Experiments Developer Guide for details.
 */

/*
 *  This request creates a new Experiment.
 */

// Construct the body of the request.
Experiment body = new Experiment();
body.setName("Landing Page Experiment");
body.setStatus("DRAFT");

// Construct the first variation.
Variations variationA = new Variations();
variationA.setName("Variation A");
variationA.setUrl("index.html");

// Construct the second variation.
Variations variationB = new Variations();
variationB.setName("Variation B");
variationB.setUrl("indexB.html");

// Set the variations.
body.setVariations(Arrays.asList(variationA, variationB));

try {
  analytics.management().experiments().insert("123456", "UA-123456-1",
      "7654321", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

1.199

Sử dụng thư viện ứng dụng PHP.

/**
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Experiments Developer Guide for details.
 */

/**
 * This request creates a new experiment.
 */

// Construct the body of the request.
$experiment = new Google_Service_Analytics_Experiment();
$experiment->setName('Landing Page Experiment');
$experiment->setStatus('DRAFT');

// 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');

// Set the variations.
$experiment->setVariations(array($variationA, $variationB));

try {
  $analytics->management_experiments->insert('123456', 'UA-123456-1',
      '7654321', $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

Sử dụng thư viện ứng dụng Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the Experiments Developer Guide for details.

# Example #1:
# Creates a new DRAFT experiment with two variations.
try:
  experiments = analytics.management().experiments().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='98765432',
      body={
          'name': 'Landing Page Test',
          'status': 'DRAFT',
          'variations': [
              {
                  'name': 'Variation A',
                  'url': 'index.html'
              },
              {
                  'name': 'Variation B',
                  '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

Sử dụng thư viện ứng dụng JavaScript.

/*
 * Note: This code assumes you have an authorized Analytics client object.
 * See the Experiments Developer Guide for details.
 */

/*
 * This request creates a new Experiment.
 */
function insertExperiment() {
  var request = gapi.client.analytics.management.experiments.insert(
    {
      'accountId': '123456',
      'webPropertyId': 'UA-123456-1',
      'profileId': '7654321',
      '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. });
}