Experiments: insert

Yetkilendirme gerektirir

Yeni bir deneme oluşturun. Örneğe göz atın

Bu yöntem, standart parametrelere ek olarak parametreler tablosunda listelenen parametreleri destekler.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
accountId string Denemenin oluşturulacağı hesap kimliği.
profileId string Denemenin oluşturulacağı Görünüm (Profil) kimliği.
webPropertyId string Denemenin oluşturulacağı web mülkü kimliği.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gereklidir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

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

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir management.deneme kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu mülkler
name string Deneme adı. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. Deneme oluştururken bu alan gereklidir. yazılabilir
status string Deneme durumu. Olası değerler: "DRAFT", "READY_TO_RUN", "RUNNING", "ENDED". Denemeler "DRAFT", "READY_TO_RUN" veya "RUNNING" durumunda oluşturulabilir. Deneme oluştururken bu alan gereklidir. yazılabilir
variations[].name string Varyasyonun adı. Deneme oluştururken bu alan gereklidir. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
İsteğe Bağlı Özellikler
description string Bu denemeyle ilgili notlar. yazılabilir
editableInGaUi boolean Politika true (doğru) ise son kullanıcı, denemeyi Google Analytics kullanıcı arayüzü üzerinden düzenleyebilir. yazılabilir
equalWeighting boolean Trafiğin tüm varyasyonlara eşit bir şekilde dağıtılıp dağıtılmayacağını belirten boole değeri. Değer Yanlış ise içerik denemelerinde, varsayılan davranış olan trafik, varyasyon performansına göre dinamik olarak ayarlanır. İsteğe bağlı -- varsayılan olarak False değerine ayarlanır. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
minimumExperimentLengthInDays integer [3, 90] içinde bir tam sayı. Denemenin minimum uzunluğunu belirtir. Çalışan bir deneme için değiştirilebilir. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
objectiveMetric string Denemenin optimize ettiği metrik. Geçerli değerler: "ga:target(n)completions", "ga:adsenseAdsClicks", "ga:adsenseAdsViewed", "ga:adsenseRevenue", "ga:bounces", "ga:pageviews", "ga:sessionDuration", "ga:transactions", "ga:transactionRevenue". Durum "RUNNING" ise veservingFramework "REDIRECT" veya "API" değerlerinden biriyse bu alan gereklidir. yazılabilir
optimizationType string TargetMetric'in küçültülmesi mi yoksa en üst düzeye çıkarılması mı gerektiği. Olası değerler: "MAKSİMUM", "MİNİMUM". İsteğe bağlı--varsayılan olarak "MAKSİMUM" değerine ayarlanır. destinationMetric olmadan belirtilemez. Durum "ÇALIŞIYOR" veya "SONA ERDİ" olduğunda değiştirilemez. yazılabilir
rewriteVariationUrlsAsOriginal boolean Varyasyon URL'lerinin orijinalin URL'leriyle eşleşecek şekilde yeniden yazılıp yazılmayacağını belirten boole değeri. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
servingFramework string Deneme varyasyonlarını sunmak ve sonuçları değerlendirmek için kullanılan çerçeve. Şunlardan biri:
  • YÖNLENDİRME: Google Analytics, trafiği farklı varyasyon sayfalarına yönlendirir, seçilen varyasyonu raporlar ve sonuçları değerlendirir.
  • API: Google Analytics, sunmak için varyasyonu seçer ve raporlar, sonuçları değerlendirir; çağrıyı yapan kişi seçilen varyasyonu sunmaktan sorumludur.
  • HARİCİ: Varyasyonlar harici olarak sunulur ve seçilen varyasyon Google Analytics'e bildirilir. Arayan, seçilen varyasyonu sunmaktan ve sonuçları değerlendirmekten sorumludur.
yazılabilir
trafficCoverage double 0 ile 1 arasında bir kayan nokta cinsinden sayı. Denemeye katılan trafik oranını belirtir. Çalışan bir deneme için değiştirilebilir. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
variations[] list Varyasyon dizisi. Dizideki ilk varyasyon orijinaldir. Bir deneme ÇALIŞIYOR durumuna geçtikten sonra varyasyon sayısı değişmeyebilir. Durumun ÇALIŞIYOR olarak ayarlanabilmesi için en az iki varyasyon gerekir. yazılabilir
variations[].status string Varyasyonun durumu. Olası değerler: "ACTIVE", "INACTIVE". ETKİN OLMAYAN varyasyonlar sunulmaz. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir
variations[].url string Varyasyonun URL'si. Bu alan, durumu ÇALIŞIYOR veya SONA ERİYOR bir deneme için değiştirilemez. yazılabilir
winnerConfidenceLevel double 0 ile 1 arasında bir kayan nokta cinsinden sayı. Kazananı seçmek için gerekli güven düzeyini belirtir. Bu alan, durumu SONLANDIRILDI olan bir deneme için değiştirilemez. yazılabilir

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir management.deneme kaynağı döndürür.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığı'nı kullanmalıdır.

/*
 * 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

PHP istemci kitaplığını kullanır.

/**
 * 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

Python istemci kitaplığı'nı kullanır.

# 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

JavaScript istemci kitaplığını kullanır.

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