Giriş
Google Etiket Yöneticisi, geliştiricilerin uygulama ikili programlarını yeniden derleyip uygulama pazar yerlerine tekrar göndermesine gerek kalmadan Google Etiket Yöneticisi arayüzünü kullanarak mobil uygulamalarındaki yapılandırma değerlerini değiştirmesine olanak tanır.
Bu, uygulamanızda gelecekte değiştirmeniz gerekebilecek yapılandırma değerlerini veya işaretleri yönetmek için kullanışlıdır. Örneğin:
- Çeşitli kullanıcı arayüzü ayarları ve görüntüleme dizeleri
- Uygulamanızda yayınlanan reklamların boyutları, konumları veya türleri
- Çeşitli oyun ayarları
Yapılandırma değerleri, kurallar kullanılarak çalışma zamanında da değerlendirilebilir. Bu sayede, aşağıdaki gibi dinamik yapılandırmalar etkinleştirilebilir:
- Reklam banner'ı boyutunu belirlemek için ekran boyutunu kullanma
- Kullanıcı arayüzü öğelerini yapılandırmak için dil ve konum kullanma
Google Etiket Yöneticisi, uygulamalarda izleme etiketlerinin ve piksellerinin dinamik olarak uygulanmasını da sağlar. Geliştiriciler, önemli etkinlikleri bir veri katmanına aktarabilir ve daha sonra hangi izleme etiketlerinin veya piksellerinin tetikleneceğine karar verebilir.
Başlamadan Önce
Bu başlangıç kılavuzuna başlamadan önce aşağıdaki adımları tamamlayın:
- Android SDK'sını yükleyin.
- Google Play Hizmetleri SDK'sını indirin.
- Google Etiket Yöneticisi hesabı oluşturun.
- Google Etiket Yöneticisi kapsayıcısı yapılandırma
Bu adımları tamamladıktan sonra, bu kılavuzun geri kalanında Google Etiket Yöneticisi'ni Android uygulamanızda nasıl yapılandıracağınız ve kullanacağınız açıklanmaktadır.
Başlarken
Bu başlangıç kılavuzunu inceledikten sonra şunları nasıl yapacağınızı öğreneceksiniz:
- Google Etiket Yöneticisi'ni projenize ekleme
- Uygulamanızda Etiket Yöneticisi'ni başlatma
- Etiket Yöneticisi kapsayıcısından yapılandırma değerlerini alma
- Değerleri ve etkinlikleri
dataLayeriçine aktarma - Kapsayıcınızı önizleme, hata ayıklama ve yayınlama
Bu kılavuzda, Google Play Hizmetleri SDK'sı ile birlikte sunulan Cute Animals örnek uygulamasından kod snippet'leri kullanılmıştır.
Bu projenin tam kaynağına <android-sdk-directory>/extras/google/google_play_services/tagmanager/cuteanimals adresinden ulaşabilirsiniz.
1. Google Etiket Yöneticisi'ni projenize ekleme
Google Etiket Yöneticisi'ni projenize eklemek için:
- Google Play Hizmetleri SDK'sını ayarlama.
- Android Studio dışında bir IDE kullanıyorsanız
AndroidManifest.xmldosyasına aşağıdaki izinleri ekleyin:<!-- For TagManager SDK --> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
InstallReferrerReceiver'ın kampanya verilerini ayarlamak için Google Analytics alıcısını çağırmasını sağlamak üzereAndroidManifest.xmldosyasına aşağıdakileri ekleyin:<!-- Used for install referrer tracking--> <service android:name="com.google.android.gms.tagmanager.InstallReferrerService" /> <receiver android:name="com.google.android.gms.tagmanager.InstallReferrerReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
2. Projenize varsayılan kapsayıcı dosyası ekleme
Google Etiket Yöneticisi, uygulamanızın ilk çalıştırılışında varsayılan bir kapsayıcı kullanır. Uygulama, ağ üzerinden yeni bir kapsayıcı alabildiği anda varsayılan kapsayıcı kullanılmayı bırakır.
Varsayılan kapsayıcı ikili programını indirip uygulamanıza eklemek için:
- Google Etiket Yöneticisi web arayüzünde oturum açın.
- İndirmek istediğiniz kapsayıcının Sürüm'ünü seçin.
- Kapsayıcı ikili programını almak için İndir düğmesini tıklayın.
- İndirilen kapsayıcı ikili program dosyasını projenize ham kaynak olarak ekleyin.
<project-root>/res/altındakirawalt klasörü yoksa oluşturun.- Gerekirse kapsayıcı ikili program dosyasını yeniden adlandırın. Yalnızca küçük harf, rakam ve alt çizgilerden oluşur.
- Kapsayıcı ikili program dosyasını
<project-root>/res/rawklasörüne kopyalayın.
İkili program dosyasının kullanılması önerilse de kapsayıcınızda kural veya etiket yoksa bunun yerine basit bir JSON dosyası kullanmayı tercih edebilirsiniz.
3. Google Etiket Yöneticisi başlatılıyor
Uygulamanızda Google Etiket Yöneticisi'ni başlatmak için:
TagManagersingleton'ını alın:TagManager tagManager = TagManager.getInstance(this);
- Bir kapsayıcı yükleme isteğinde bulunmak için
TagManagertekilini kullanın. Bu sırada bir Google Etiket Yöneticisi kapsayıcı kimliği ve varsayılan kapsayıcı dosyanızı belirtin. Kapsayıcı kimliği büyük harfle yazılmalı ve Google Etiket Yöneticisi web arayüzündeki kapsayıcı kimliğiyle tam olarak eşleşmelidir.loadContainerPreferNonDefault()çağrısı engellenmez ve birPendingResultdöndürür:PendingResult<ContainerHolder> pending = tagManager.loadContainerPreferNonDefault(CONTAINER_ID, R.raw.defaultcontainer_binary);
- Yükleme tamamlandıktan veya zaman aşımına uğradıktan sonra
ContainerHolderöğesini döndürmek içinResultCallbackkullanın:// The onResult method will be called as soon as one of the following happens: // 1. a saved container is loaded // 2. if there is no saved container, a network container is loaded // 3. the 2-second timeout occurs pending.setResultCallback(new ResultCallback<ContainerHolder>() { @Override public void onResult(ContainerHolder containerHolder) { ContainerHolderSingleton.setContainerHolder(containerHolder); Container container = containerHolder.getContainer(); if (!containerHolder.getStatus().isSuccess()) { Log.e("CuteAnimals", "failure loading container"); displayErrorToUser(R.string.load_error); return; } ContainerLoadedCallback.registerCallbacksForContainer(container); containerHolder.setContainerAvailableListener(new ContainerLoadedCallback()); startMainActivity(); } }, TIMEOUT_FOR_CONTAINER_OPEN_MILLISECONDS, TimeUnit.MILLISECONDS);
ContainerHolder Singleton oluşturma
Uygulamanızın her çalıştırılışında yalnızca bir
ContainerHolderörneği bulundurmanız gerekir. Bu nedenle, yukarıdaki örnekteContainerHolderörneğine erişimi yönetmek için birContainerHolderSingletonyardımcı sınıfı kullanılmıştır.ContainerHolderSingletonsınıfı şu şekilde görünür:package com.google.android.tagmanager.examples.cuteanimals; import com.google.android.gms.tagmanager.ContainerHolder; /** * Singleton to hold the GTM Container (since it should be only created once * per run of the app). */ public class ContainerHolderSingleton { private static ContainerHolder containerHolder; /** * Utility class; don't instantiate. */ private ContainerHolderSingleton() { } public static ContainerHolder getContainerHolder() { return containerHolder; } public static void setContainerHolder(ContainerHolder c) { containerHolder = c; } }
4. Kapsayıcıdan Yapılandırma Değerlerini Alma
Kapsayıcı yüklendikten sonra Container.get<type>() yöntemlerinden herhangi birini kullanarak yapılandırma değerlerini alabilirsiniz. Yapılandırma değerleri, Google Etiket Yöneticisi'nin değer toplama değişkenleri kullanılarak tanımlanır. Örneğin, aşağıdaki yöntem, bir kullanıcı arayüzü öğesinde kullanmaya karar verdiğimiz en son rengi alır ve tam sayı olarak döndürür:
/** * Returns an integer representing a color. */ private int getColor(String key) { return colorFromColorName(containerHolder.getContainer().getString(key)); }
Bu kod, kapsayıcıdan renk adını almak için iki işlem gerçekleştirir:
ContainerHolder.getContainer()yöntemini kullanarakContainerHolderüzerindenContaineralır.- Renk değerini, Google Etiket Yöneticisi web arayüzünde anahtarı ve değeri tanımladığınız
Container.getString(key)kullanarak alır.
5. Etkinlikleri ve değerleri dataLayer'a aktarma
Google Etiket Yöneticisi, uygulamanızın diğer bölümlerinde okunabilen veya Google Etiket Yöneticisi web arayüzünde yapılandırdığınız etiketleri tetiklemek için kullanılabilen, uygulamanızla ilgili bilgileri aktarabileceğiniz bir dataLayer da sağlar.
Değerleri dataLayer'a aktarma
dataLayer, uygulamanızın diğer bölümlerinde kullanmak isteyebileceğiniz anahtar/değer çiftlerini veya Google Etiket Yöneticisi etiketlerine giriş olarak kullanabileceğiniz bir kalıcılık katmanı sağlar.
dataLayer öğesine bir değer göndermek için şu kalıbı kullanın:
DataLayersingleton'ını alın:DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
DataLayer.push()kullanarak etkinliği gönderin:// Put the image_name into the data layer for future use. TagManager.getInstance(this).getDataLayer().push(IMAGE_NAME_KEY, imageName);
dataLayer öğesinden değer almak için DataLayer.get(key) kullanın.
Etkinlikleri dataLayer'a aktarma
Etkinlikleri dataLayer'e aktarmak, uygulama kodunuzu bu etkinliklere yanıt olarak tetiklemek isteyebileceğiniz etiketlerden ayırmanıza olanak tanır.
Örneğin, Google Analytics ekran görüntüleme izleme çağrılarını uygulamanıza sabit kodlamak yerine, ekran etkinliklerini dataLayer içine aktarabilir ve izleme etiketlerinizi Google Etiket Yöneticisi web arayüzü üzerinden tanımlayabilirsiniz. Bu sayede, uygulama kodunuzu güncellemeden bu etiketi değiştirme veya ekran etkinliklerine yanıt veren ek etiketler ekleme esnekliğine sahip olursunuz.
dataLayer'e bir etkinlik göndermek için şu kalıbı kullanın:
DataLayersingleton'ını alın:DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
DataLayer.pushEvent()kullanarak etkinliği gönderin:dataLayer.pushEvent("openScreen", DataLayer.mapOf("screenName", screenName));DataLayer.mapOf(), etkinlik gönderilirkendataLayeröğesini güncelleyecek anahtar/değer çiftlerinin haritasını kolayca oluşturmak için kullanabileceğiniz bir yardımcı yöntemdir.
6. Önizleme, Hata Ayıklama ve Yayınlama
Kapsayıcınızın bir sürümünü yayınlamadan önce, amaçlandığı gibi çalıştığından emin olmak için önizlemek istersiniz. Google Etiket Yöneticisi, web arayüzünde bağlantılar ve QR kodları oluşturup bunları kullanarak uygulamanızı açarak kapsayıcınızın önizleme sürümlerini önizlemenize olanak tanır. Beklenmeyen davranışlarda hata ayıklamak için ayrıntılı günlük kaydı modunu da etkinleştirebilirsiniz.
Önizleniyor
Kapsayıcınızın bir sürümünü önizlemek için aşağıdaki adımları uygulayın:
- Bu önizleme
ActivityöğesiniAndroidManifestdosyanıza ekleme:<!-- Add preview activity. --> <activity android:name="com.google.android.gms.tagmanager.PreviewActivity" android:label="@string/app_name" android:noHistory="true"> <!-- optional, removes the previewActivity from the activity stack. --> <intent-filter> <data android:scheme="tagmanager.c.com.google.android.tagmanager.examples.cuteanimals" /> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE"/> </intent-filter> </activity>
Bu satırı, uygulamanızın paket adını içerecek şekilde değiştirdiğinizden emin olun:
<data android:scheme="tagmanager.c.com.google.android.tagmanager.examples.cuteanimals" />
- Google Etiket Yöneticisi web arayüzünde önizleme bağlantısı oluşturma
- Google Etiket Yöneticisi'nde oturum açma
- Önizlenecek kapsayıcı sürümünü seçin.
- Önizleme düğmesini tıklayın
- Uygulamanızın paket adını girin ve Önizleme başlatma bağlantısı oluştur'u tıklayın.
- Uygulamanızı başlatmak için oluşturulan bağlantıyı veya QR kodunu kullanın.
- Web arayüzündeki Önizlemeyi sonlandırma bağlantısı oluştur seçeneğiyle oluşturulan bir bağlantıyı takip ederek önizleme modundan çıkabilirsiniz.
Hata ayıklama
Kapsayıcı uygulamanızla ilgili sorunları gidermeniz gerekiyorsa TagManager.setVerboseLoggingEnabled(true) yöntemini çağırarak ayrıntılı günlük kaydını etkinleştirin:
// Modify the log level of the logger to print out not only // warning and error messages, but also verbose, debug, info messages. tagManager.setVerboseLoggingEnabled(true);
Yayınlama
Kapsayıcınızı önizledikten ve beklendiği gibi çalıştığını doğruladıktan sonra kapsayıcınızı yayınlayabilirsiniz. Kapsayıcı yapılandırma değerleriniz, etiketleriniz ve etkinlikleriniz, kapsayıcıları bir sonraki yenilemede kullanıcılar için etkin hale gelir. Kapsayıcıları yenileme hakkında daha fazla bilgi edinin.
Gelişmiş Yapılandırma
Aşağıdaki bölümlerde, Google Etiket Yöneticisi uygulamanızı daha fazla özelleştirmek için kullanmak isteyeceğiniz gelişmiş yapılandırma seçenekleri açıklanmaktadır.
Kapsayıcıyı yenileme
Varsayılan olarak, kapsayıcınız 12 saatte bir yenilenmeye uygun hale gelir. Kapsayıcıyı manuel olarak yenilemek için ContainerHolder.refresh() kullanın:
ContainerHolderSingleton.getContainerHolder().refresh();
Bu, hemen sonuç vermeyecek eşzamansız bir çağrıdır. Ağ trafiğini azaltmak için refresh() yalnızca 15 dakikada bir çağrılabilir. Aksi takdirde işlem yapılmaz.