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