Yerleşik değişkenlerin karşılayamadığı belirli gereksinimlere uyacak şekilde, Google Etiket Yöneticisi'nde kullanıcı tanımlı özel mobil değişkenler oluşturun.
Yeni bir kullanıcı tanımlı değişken oluşturmak için:
- Düzenlemek istediğiniz Etiket Yöneticisi kapsayıcısını açın.
- Sol gezinme panelindeki Çalışma Alanı sekmesinde Değişkenler'i tıklayın.
- Kullanıcı Tanımlı Değişkenler bölümünde Yeni'yi tıklayın.
- Değişken Yapılandırması'nı tıklayın ve istediğiniz değişken türünü seçin.
- Seçilen değişken türü için seçenekleri tamamlayın.
- Değişkene ad verin. Değişkenin işlevini tanımlayan bir adlandırma düzeni kullanın (örneğin: "Veri Katmanı Değişkeni - Ürün Adı").
- Kaydet'i tıklayın.
Etiket Yöneticisi, mobil uygulamalar için bu kullanıcı tanımlı değişken türlerini destekler:
Firebase
Etkinlik Adı
Uygulamanızda aşağıdaki kod çalıştırıldığında, değer "eventNameXYZ" olarak ayarlanır:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Etkinlik Parametresi
Değer, sağlanan anahtar için Google Analytics (Firebase) etkinlik parametresi değeri olarak ayarlanır.
Firebase Kullanıcı Özelliği
Değer, sağlanan anahtar için Google Analytics (Firebase) kullanıcı özelliği değerine ayarlanır.
Yardımcı Programlar
Reklamvereni İzleme Etkin
Android'de bu değişken, reklam izleme etkinse "true" (doğru), ilgi alanına dayalı reklamlar kullanıcı tarafından devre dışı bırakılmışsa "false" (yanlış) döndürür. Android Geliştirici Merkezi'nden daha fazla bilgi edinin. Sürüm 4'ten önceki SDK sürümleri her zaman "yanlış" döndürür. Değer, iOS 6 ve sonraki sürümler için advertisingTrackingEnabled mülküne ayarlanır. Diğerleri içinse true (doğru) olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Sabit
Değer, belirttiğiniz dize olarak ayarlanır.
Arama Tablosu
Değer, arama tablosundaki talimatlara göre ayarlanır. Arama tablosunda iki sütun vardır (Daha sonra verilerin nasıl kullanıldığını göstermek için tablo boştur):
| [belirli değişken] şuna eşitse | [bu değişken] değerini şu yap |
|---|
Arama Tablosu, değeri başka bir değişkenin değerine göre farklılık gösteren bir değişken oluşturmanızı sağlar. Uygulamanız uygun değerin (ör. dönüşüm izleme kimliği) Uygulama Sürüm Kodu'na veya uygulamanın başka bir özelliğine eşlenebileceği şekilde ayarlanmışsa bunu kullanmak faydalıdır. Bu örnekte, Dönüşüm Kimliği adlı bir değişken oluşturulmaktadır. Uygulama Sürüm Kodu 1.0 ise değer "12345" olarak ayarlanır; Uygulama Sürüm Kodu 1.1 ise değer "34567" olarak ayarlanır. Arama tablosundaki satırların sayısına ilişkin bir sınırlama yoktur. Alanlar büyük/küçük harfe duyarlıdır.
| {{Uygulama Sürümü Kodu}} şuna eşitse | {{Dönüşüm Kimliği}} değerini şu yap |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
Rastgele Sayı
Değer, 0 ile 2147483647 arasında rastgele bir sayı olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Kapsayıcı Verileri
Kapsayıcı Kimliği
Değer, kapsayıcının herkese açık kimliğidir (örneğin, GTM-ABC42). Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Kapsayıcı Sürümü Numarası
Kapsayıcı önizleme modundayken, bu değişkenin değeri kapsayıcının önizleme sürümü numarasıdır. Aksi durumda, bu değişkenin değeri kapsayıcının yayındaki sürüm numarasıdır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Uygulama
Uygulama Kimliği
Değer, paket adı (Android) veya uygulama kimliği (iOS) olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Uygulama Adı
Değer, uygulamanın adı olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Uygulama Sürüm Kodu
Değer, o anda çalışan uygulamanın sürümü olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Reklamcılık Kimliği
Android için değer, Reklam Kimliği olarak ayarlanır. Sürüm 4'ten önceki SDK sürümleri her zaman boş bir dize döndürür. Değer, iOS 6 ve üstü sürümler için reklam tanımlayıcısı (IDFA) olarak ayarlanır. Aksi durumda, değer boş dize olarak ayarlanır.
SDK Sürümü
Değer, uygulamanın yüklü olduğu işletim sisteminin SDK sürümü olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Cihaz
Cihaz Adı
Değer, çalışmakta olan uygulamanın cihaz adı olarak ayarlanır (örneğin, "Samsung Android", "Pixel 2"). Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Dil
Değer, kullanıcı tarafından belirlenen cihaz dili tercihini temsil eden iki harfli dil kodu olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
İşletim Sistemi Sürümü
Değer, uygulamanın yüklü olduğu işletim sisteminin sürümü olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Platform
Değer, o anda çalışan uygulamanın platformu (örneğin, "Android", "iOS") olarak ayarlanır. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Ekran Çözünürlüğü
Değer, o anda çalışan uygulamanın yüklü olduğu cihazın ekran çözünürlüğü olarak ayarlanır. Biçim, "genişlik x yükseklik" (örneğin, "1920 x 1080") şeklindedir. Çoğu durumda, eşdeğer yerleşik değişkeni kullanmalısınız.
Diğer
İşlev çağrısı
Değer, önceden kayıtlı bir işleve yapılan çağrının döndürdüğü değer olarak ayarlanır. Daha fazla bilgi edinmek için SDK belgelerine (Android veya iOS) göz atın.
Değer Koleksiyonu (yalnızca eski kapsayıcılar)
Bu değişken, JSON biçiminde ifade edilen bir anahtar-değer çifti kümesi içerir. Değer Koleksiyonu, uygulamanız için yapılandırma değerleri belirlemek amacıyla kullanılır. Örneğin, araba yarışı oyunu uygulaması için Değer Koleksiyonu türünde "Uygulama ayarları" adlı bir değişkeni aşağıdaki değerlerle oluşturabilirsiniz:
{
"fuel-burn-rate": 20
}
Mobil uygulamanız, anahtarı sağlayarak değişkendeki bir değeri alabilir. Örneğin:
public class MainActivity {
// Genel kapsayıcı kimliğinizi ekleyin.
private static final String CONTAINER_ID = "XXX-YYY";
// Kapsayıcı yapılandırma değer anahtarları,
// daha sonra değerleri almak için kullanılır.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// onCreate kodunuzun geri kalanı.
}
}
/*
* Bir Google Etiket Yöneticisi kapsayıcısını kullanarak oyun yapılandırma
* değerlerini güncelleyen yöntem.
*/
public void updateConfigurationFromContainer(Container container) {
// Kapsayıcı referansını alın.
Container container = mFutureContainer.get();
// Kapsayıcı yapılandırma değer anahtarlarını kullanarak
// oyun ayarlarını güncelleyin.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
Değer Koleksiyonu türündeki bir değişkenin ilişkilendirilmiş tetikleyicileri vardır. Uygulamanızın tüm örnekleri ve sürümleri için geçerli olan yapılandırma değerleri için, etkinleştirici tetikleyiciyi önceden tanımlı Her Zaman değerine ayarlayın. Değer Koleksiyonu değişkeninin nasıl kullanılacağına ilişkin ayrıntılar için geliştirici belgelerini (Android veya iOS) inceleyin.