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	รหัสเว็บพร็อพเพอร์ตี้ของการทดสอบที่จะอัปเดต

การให้สิทธิ์

คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

เนื้อหาของคำขอ

ในเนื้อหาคำขอ ให้ระบุส่วนที่เกี่ยวข้องของ management.experiment resource ตามกฎของอรรถศาสตร์แพตช์ โดยมีพร็อพเพอร์ตี้ต่อไปนี้

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	Notes
พร็อพเพอร์ตี้ที่จำเป็น
id	string	รหัสการทดสอบ จำเป็นสำหรับแพตช์และการอัปเดต ไม่อนุญาตให้สร้าง
พร็อพเพอร์ตี้ที่ไม่บังคับ
description	string	หมายเหตุเกี่ยวกับการทดสอบนี้	เขียนได้
editableInGaUi	boolean	หากเป็นจริง ผู้ใช้ปลายทางจะแก้ไขการทดสอบผ่านอินเทอร์เฟซผู้ใช้ Google Analytics ได้	เขียนได้
equalWeighting	boolean	บูลีนที่ระบุว่าจะกระจายการเข้าชมในทุกรูปแบบอย่างเท่าเทียมกันหรือไม่ หากค่าเป็น "เท็จ" การทดสอบเนื้อหาจะใช้พฤติกรรมเริ่มต้นของการปรับการเข้าชมแบบไดนามิกตามประสิทธิภาพของรูปแบบต่างๆ ไม่บังคับ -- ค่าเริ่มต้นคือ "เท็จ" ไม่สามารถเปลี่ยนแปลงฟิลด์นี้ได้สำหรับการทดสอบที่มีสถานะ "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" ต้องระบุข้อมูลในช่องนี้หากสถานะเป็น "RUNING" และกรอบการแสดงผลเป็น "REDIRECT" หรือ "API"	เขียนได้
optimizationType	string	ควรย่อหรือขยายวัตถุประสงค์เมตริกให้สูงสุดหรือไม่ ค่าที่เป็นไปได้: "MAXIMUM", "MINIMUM" ไม่บังคับ -- ค่าเริ่มต้นคือ "MAXIMUM" ระบุไม่ได้หากไม่มีobjectMetric แก้ไขไม่ได้เมื่อสถานะเป็น "กำลังทำงาน" หรือ "สิ้นสุด"	เขียนได้
rewriteVariationUrlsAsOriginal	boolean	บูลีนที่ระบุว่ามีการเขียน URL รูปแบบใหม่เพื่อให้ตรงกับ URL ต้นฉบับหรือไม่ ไม่สามารถเปลี่ยนแปลงฟิลด์นี้ได้สำหรับการทดสอบที่มีสถานะ "ENDED"	เขียนได้
servingFramework	string	เฟรมเวิร์กที่ใช้แสดงรูปแบบต่างๆ ของการทดสอบและประเมินผลลัพธ์ ข้อใดข้อหนึ่ง: เปลี่ยนเส้นทาง: Google Analytics จะเปลี่ยนเส้นทางการเข้าชมไปยังหน้ารูปแบบต่างๆ รายงานหน้ารูปแบบใหม่ที่เลือก และประเมินผลลัพธ์ API: Google Analytics เลือกและรายงานรูปแบบเพื่อแสดงและประเมินผลลัพธ์ ผู้โทรจะเป็นผู้รับผิดชอบในการแสดงรูปแบบที่เลือกไว้ ภายนอก: รูปแบบจะแสดงภายนอกและในรูปแบบที่เลือกจะถูกรายงานไปยัง Google Analytics ผู้โทรมีหน้าที่รับผิดชอบต่อการแสดงรูปแบบที่เลือกไว้และประเมินผลลัพธ์	เขียนได้
status	string	สถานะการทดสอบ ค่าที่เป็นไปได้ ได้แก่ "DRAFT", "READY_TO_RUN", "RUNning", "ENDED" คุณสามารถสร้างการทดสอบได้ในสถานะ "DRAFT", "READY_TO_RUN" หรือ "RUNning" ต้องระบุข้อมูลในช่องนี้เมื่อสร้างการทดสอบ	เขียนได้
trafficCoverage	double	จำนวนทศนิยมระหว่าง 0 ถึง 1 ระบุเศษส่วนของการเข้าชมที่เข้าร่วมในการทดสอบ เปลี่ยนแปลงสำหรับการทดสอบที่ดำเนินอยู่ได้ ไม่สามารถเปลี่ยนแปลงฟิลด์นี้ได้สำหรับการทดสอบที่มีสถานะ "ENDED"	เขียนได้
variations[]	list	อาร์เรย์ของรูปแบบ รูปแบบแรกในอาร์เรย์คือรูปแบบเดิม จำนวนรูปแบบจะไม่เปลี่ยนแปลงเมื่อการทดสอบอยู่ในสถานะ "ทำงาน" ต้องมีอย่างน้อย 2 รูปแบบก่อนจึงจะตั้งสถานะเป็น "ทำงาน" ได้	เขียนได้
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. });
}