Geçersiz kılınabilir yapılandırma parametreleri

Geçersiz kılınabilir yapılandırma parametreleri, rapor düzenleyicilerin değişiklik yapmasına izin verme seçeneği sağlar bir veri kaynağındaki varsayılan değerlere ulaşabilirsiniz. Yapılandırma parametrelerini geçersiz kılınabilir olarak tanımlamak, Daha esnek bir veri kaynağı sunar ve kullanıcılara, kullanıcılar tarafından yapılandırılabilen rapor şablonları.

Örneğin, hava durumu verileri sağlayan bir bağlayıcının izleyicilerin bir yerel ayardan hava durumu raporu istemesini sağlayan parametre biraz daha farklı olacaktır.

Bu dokümanda, geçersiz kılınabilir parametrelerin nasıl tanımlandığı ve ve parametre değerlerinin rapor kullanıcıları tarafından nasıl değiştirilebileceği. Öğrenmek için Looker Studio'da parametrelerin nasıl kullanıldığı hakkında daha fazla bilgi Veri kaynağı parametreleri.

Roller

Belgede atıfta bulunulan kullanıcı rolleri:

Rol	Tanım
Bağlayıcı geliştiricisi	Topluluk bağlayıcısı oluşturan bir kullanıcı.
Veri kaynağı sahibi	Bir veri kaynağı oluşturan ve bu kaynağa sahip olan kullanıcı.
Rapor düzenleyici	Rapor için düzenleme modu erişimine sahip kullanıcı.
Rapor görüntüleyici	Rapor için görüntüleme modu erişimine sahip kullanıcı.

Geçersiz kılınabilir parametreleri tanımlama

Bağlayıcı geliştiricisi, yapılandırma parametrelerini getConfig() fonksiyonu topluluk bağlayıcısıdır. Bir yapılandırma parametresini bağlayıcının geçersiz kılınabileceği şekilde tanımlamak için setAllowOverride(true) araması yapar.

Not: Parametreler, BigQuery özel sorgusunun parçası olarak da tanımlanabilir.

Şu örnekte geçersiz kılınabilecek 2 parametre tanımlanmaktadır: zipcode ve units ve geçersiz kılınamayan 1 parametre: days-to-forcecast.

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

Not: allowOverride için varsayılan değer false. E-posta teslim etmek istemiyorsanız bir parametre için geçersiz kılmayı etkinleştirirseniz bu çağrıyı setAllowOverride().

Bir parametrenin geçersiz kılınabilir olarak tanımlanmasının yapılmaması gereken durumlar

Google Analytics 4'te Bağlayıcıların, Veri Kaynakları'nın ve Raporların birbirleriyle olan ilişkilerini öğrenmek için Looker Studio'nun verilerinize nasıl bağlandığını öğrenin başlıklı makaleyi inceleyin.

Aşağıdaki durumlarda, bir parametreyi geçersiz kılınabilir olarak tanımlamaktan kaçının:

1. Bir parametrenin değeri şemayı etkilediğinde.
   • Bir kullanıcı bir parametre değerini ve yeni verilerin şemasını değiştirirse herhangi bir rapor, veri kaynağında tanımlı olandan farklıysa eksik alanlar nedeniyle bozulabilir.
2. Bir parametre değerinin hassas verileri kontrol edip etmediği. Ör. Hesap seçimi.
   • Bir parametreyi geçersiz kılmak istiyorsanız bu parametreyi geçersiz kılınabilir olarak tanımlamayın. Hassas verileri yanlışlıkla görüntüleme veya paylaşma.

Rapor kullanıcıları için parametreleri etkinleştirme

Veri kaynağı sahipleri hangi geçersiz kılınabilir parametrelerin kullanılmasına izin verileceğini kontrol eder rapor düzenleyiciler tarafından değiştirilmiştir. Benzer şekilde, rapor düzenleyicileri hangi raporların parametreler rapor görüntüleyenler tarafından değiştirilebilir.

Rapor düzenleyicilerin parametre değerlerini değiştirmesine izin ver

Veri kaynağı sahibi, raporlar. Bu, veri kaynağı oluşturulurken veya düzenlenirken yapılandırılır ve yalnızca ilk olarak Bağlayıcı tarafından geçersiz kılınabilir olarak tanımlanır geliştiricisi. Etkinleştirilirse rapor düzenleyiciler şunları yapabilir: Bir rapordaki parametreleri değiştirin.

Aşağıdaki örnekte, bir bağlayıcının geçersiz kılınabilir olarak tanımlanmış 2 parametresi vardır: zipcode ve units. Veri kaynağı sahibi yalnızca zipcode için izin verdi: raporlarda değiştirildi. Raporda, rapor düzenleyici üzerinde değişiklik yapma seçeneği bulunur. zipcode parametre değeri.

Rapor görüntüleyicilerin parametre değerlerini değiştirmesine izin ver

Rapor düzenleyiciler, rapor görüntüleyenler tarafından hangi parametrelerin değiştirilebileceğini kontrol eder. Parametre değerleri, herhangi bir görüntüleyen tarafından rapor URL'si aracılığıyla değiştirilebilir seçeceğiz.

Not: Rapor düzenleyicinin, parametrelerin değiştirilmesine izin verme konusundaki kontrolü veri kaynağı sahibinin izin verdiği parametrelerle sınırlıdır.

Örneğin, geçersiz kılınabilir olarak tanımlanmış 2 parametresi olan bir bağlayıcıyı düşünün: zipcode ve units (şekil 1). Veri kaynağı sahibi izin verdiyse zipcode değerinin raporlarda değiştirilmesi (şekil 2), rapor düzenleyicileri yalnızca zipcode ürününün rapor görüntüleyenler tarafından değiştirilmesine izin verilebilir. Rapor düzenleyici, units parametresinin ayarlanmasına izin verecek şekilde erişime veya görünürlüğe sahip olmaz rapor görüntüleyenler tarafından değiştirildi.

Şekil 1: Bağlayıcı yapılandırması.

Şekil 2: Parametreleri yönetme.

ziyaret edin.

Uyarı: Rapor görüntüleyenler tarafından kontrol edilen tüm verilere erişebilecek. parametreleridir. Hassas verileri yanlışlıkla paylaşmamak için inceleyip onaylayın veri kaynağı ve veri kaynağı kimlik bilgilerinin yapılandırıldığından değerini doğru şekilde tanımlar. Bir parametre, hassas verilere erişmek için izleyicinin kimlik bilgilerini kullanabilirsiniz. raporu görüntüleyenlerin yalnızca kendi verilerini görebildiğinden emin olun.

URL parametreleri

Rapor görüntüleyicilerin parametre değerlerini rapor URL'si aracılığıyla düzenlemesine izin vermek için:

1. Raporu düzenleyin.
2. Kaynak -> Rapor URL parametrelerini yönetin.
3. URL'lere izin vermek için Rapor URL'sinde değiştirilmesine izin ver rapor URL'sinde parametre değerlerinin değiştirilmesine izin vermeme. Değişiklikler otomatik olarak kaydedilir.
4. Sağ üstteki Kapat'ı tıklayın.

Parametre değerlerini değiştirme

Rapor düzenleyiciler, rapor özellikleri panelini kullanarak parametre değerlerini değiştirebilir rapor görüntüleyenler ise parametre değerlerini rapor URL'si üzerinden değiştirebilir.

Rapor özellikleri paneli

Rapor düzenleyicinin parametre değerlerini nasıl ayarlayabileceğini öğrenmek için Bir rapordaki parametreleri değiştirin.

Rapor URL'si parametreleri

Örneğin, rapor URL'sinde değiştirilmesine izin verildiyse değerler görünüm modunda rapor URL'sine eklenen URL kodlamalı bir JSON nesnesi aracılığıyla ayarlanır.

URL yapılandırması oluşturmak için:

1. Parametre adlarını toplama

   1. Raporu düzenleyin.
   2. Kaynak -> Rapor URL parametrelerini yönetin.
   3. Rapor üzerinden ayarlamak istediğiniz parametrelerin adını not edin. URL'yi tıklayın.

   Örneğin, aşağıdaki şekilde parametre adı ds0.zipcode'dir.

   

2. Parametre nesnesini oluşturma

   Parametreler bir JSON nesnesi aracılığıyla tanımlanır. Parametre değerlerinin anahtarları parametre adlarıdır.

   {
     "parameterName": parameterValue
   }
   

   Parametre değer türleri şunlardır: STRING, NUMBER veya BOOLEAN. Örneğin, birden çok değeri kabul eden parametrelerde (ör. Çoklu seçim açılır listeleri) bir değer dizisidir.

   Örneğin, parametre adı ds0.zipcode ise posta kodu şu şekilde ayarlanır: 94094, JSON aşağıdaki gibidir:

   {
     "ds0.zipcode": "94094"
   }
   

3. URL Parametre nesnesini kodlama

   Parametre nesnesini oluşturduktan sonra, JSON.stringify() kullanarak dizeye dönüştürüp URL olarak kodlamak için [encodeURIComponent] öğesini kullanın.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Bu işlem, aşağıdaki kodlanmış dizeyle sonuçlanır:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Rapor URL'sini oluşturma

   URL kodlamalı parametre nesnesini aldıktan sonra bunu rapor görünümüne ekleyin params sorgu parametresini kullanan URL.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   REPORT_ID ve PAGE_ID yerine kullandığınız, kullanabilirsiniz.

5. URL'yi kullanın

   Rapor URL'si, JSON parametrelerinde tanımlanan parametreleri geçersiz kılar Parametre devralma işlemine göre nesne.

Parametre nesnesi örneği

Aşağıdaki parametre nesnesinde, birden fazla parametrenin nasıl ayarlanacağı gösterilmektedir. Aynı zamanda , farklı giriş türleri için parametre değerlerinin ayarlanmasını gösterir.

• ds0.includeToday, onay kutusuyla oluşturulmuş bir giriştir
• ds0.units, tek seçimli giriştir
• ds1.countries, çoklu seçimli bir giriştir
• ds1.labelName bir metin girişidir.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Parametre devralma

Bir parametre için kullanılan değer, parametresinin değeridir. Daha yüksek önceliğe sahip konumlarda ayarlanan parametreler geçersiz kılınır Daha düşük öncelikli konumlarda ayarlanmış parametreler. Öncelik sırası ( en düşükten en yükseğe) şu şekildedir:

1. Veri kaynağı (varsayılan)
2. Rapor URL'si
3. Veri kaynağını izleyen rapor özellikleri paneli parametre devralma kuralları.