Experiments: update

Yetkilendirme gerektirir

Mevcut bir denemeyi güncelleyin. Örneğe göz atın

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

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
accountId string Güncellenecek denemenin hesap kimliği.
experimentId string Güncellenecek denemenin deneme kimliği.
profileId string Güncellenecek denemenin Görünüm (Profil) kimliği.
webPropertyId string Güncellenecek denemenin 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
id string Deneme kimliği. Yama ve güncelleme için gereklidir. Oluşturmaya izin verilmiyor.
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 example updates an existing experiment with new variations.
Variations variationA = new Variations();
variationA.setName("Home Alpha");
variationA.setUrl("homeA.html");
Variations variationB = new Variations();
variationB.setName("Home Beta");
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 Update with the updated experiment.
  analytics.management().experiments().update("123456", "UA-123456-1",
      "7654321", "122333444455555", 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 updates 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 update method with the updated experiment.
  $analytics->management_experiments->update('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 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 updates an existing experiment with a new name,
# and new variations.
try:
  analytics.management().experiments().update(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      experimentId='ABCDEFG123456abcdefg',
      body={
          'name': 'Updated Test Title',
          'status': 'DRAFT',
          'variations': [
              {
                  'name': 'Checkout Page',
                  'url': 'checkout.html'
              },
              {
                  'name': 'Proposed Checkout Page',
                  'url': 'newCheckout.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 updates an existing experiment.
 */
function updateExperiment() {
  var request = gapi.client.analytics.management.experiments.update(
    {
      '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. });
}