Experiments: insert

Memerlukan otorisasi

Buat eksperimen baru. Lihat contoh.

Selain parameter standar, metode ini mendukung parameter yang tercantum dalam tabel parameter.

Permintaan

Permintaan HTTP

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

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
accountId string ID Akun untuk membuat eksperimen.
profileId string ID Tampilan (Profil) yang akan digunakan untuk membuat eksperimen.
webPropertyId string ID properti web tempat eksperimen dibuat.

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.edit

Isi permintaan

Dalam isi permintaan, sediakan resource management.experiment dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti yang Diperlukan
name string Nama eksperimen. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. Kolom ini wajib diisi saat membuat eksperimen. dapat ditulis
status string Status eksperimen. Nilai yang mungkin: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Eksperimen dapat dibuat di status "DRAFT", "READY_TO_RUN" atau "RUNNING". Kolom ini wajib diisi saat membuat eksperimen. dapat ditulis
variations[].name string Nama variasi. Kolom ini wajib diisi saat membuat eksperimen. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
Properti Opsional
description string Catatan tentang eksperimen ini. dapat ditulis
editableInGaUi boolean Jika benar, pengguna akhir akan dapat mengedit eksperimen melalui antarmuka pengguna Google Analytics. dapat ditulis
equalWeighting boolean Boolean yang menentukan apakah akan mendistribusikan traffic secara merata di seluruh variasi. Jika nilainya Salah, eksperimen konten mengikuti perilaku default penyesuaian traffic secara dinamis berdasarkan performa variasi. Opsional -- setelan defaultnya adalah Salah. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
minimumExperimentLengthInDays integer Angka bilangan bulat dalam [3, 90]. Menentukan durasi minimum eksperimen. Dapat diubah untuk eksperimen yang sedang berjalan. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
objectiveMetric string Metrik yang dioptimalkan eksperimen. Nilai yang valid: "ga:goal(n)Completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:transactionDurasi"ga:gade&ga Kolom ini wajib diisi jika statusnya adalah "RUNNING" dan servingFramework adalah salah satu dari "REDIRECT" atau "API". dapat ditulis
optimizationType string Apakah objectMetric harus diperkecil atau dimaksimalkan. Nilai yang mungkin: "MAXIMUM", "minimum". Opsional--default-nya adalah "MAXIMUM". Tidak dapat ditentukan tanpa destinationMetric. Tidak dapat diubah jika statusnya adalah "JALANKAN" atau "ENDED". dapat ditulis
rewriteVariationUrlsAsOriginal boolean Boolean yang menentukan apakah variasi URL ditulis ulang agar cocok dengan URL asli. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
servingFramework string Framework yang digunakan untuk menayangkan variasi eksperimen dan mengevaluasi hasilnya. Salah satu dari:
  • REDIRECT: Google Analytics mengalihkan traffic ke halaman variasi yang berbeda, melaporkan variasi yang dipilih, dan mengevaluasi hasilnya.
  • API: Google Analytics memilih dan melaporkan variasi untuk menayangkan dan mengevaluasi hasil; pemanggil bertanggung jawab untuk menayangkan variasi yang dipilih.
  • EKSTERNAL: Variasi akan ditayangkan secara eksternal dan variasi yang dipilih dilaporkan ke Google Analytics. Pemanggil bertanggung jawab untuk menayangkan variasi yang dipilih dan mengevaluasi hasilnya.
dapat ditulis
trafficCoverage double Angka floating-point antara 0 dan 1. Menentukan bagian traffic yang berpartisipasi dalam eksperimen. Dapat diubah untuk eksperimen yang sedang berjalan. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
variations[] list Array variasi. Variasi pertama dalam larik adalah asli. Jumlah variasi tidak dapat berubah setelah eksperimen berstatus RUNNING. Minimal dua variasi diperlukan sebelum status ditetapkan ke RUNNING. dapat ditulis
variations[].status string Status variasi. Nilai yang mungkin: "ACTIVE", "INACTIVE". Variasi TIDAK AKTIF tidak ditayangkan. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis
variations[].url string URL variasi. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya RUNNING atau ENDED. dapat ditulis
winnerConfidenceLevel double Angka floating-point antara 0 dan 1. Menentukan tingkat keyakinan yang diperlukan untuk memilih pemenang. Kolom ini tidak dapat diubah untuk eksperimen yang statusnya ENDED. dapat ditulis

Tanggapan

Jika berhasil, metode ini menampilkan resource management.experiment di isi respons.

Contoh

Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).

Java

Menggunakan library klien 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());
}

PHP

Menggunakan library klien 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

Menggunakan library klien 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

Menggunakan library klien 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. });
}