Android 4 sürümü (Eski) - Başlangıç

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:

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:

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:

  1. Google Play Hizmetleri SDK'sını ayarlama.
  2. Android Studio dışında bir IDE kullanıyorsanız AndroidManifest.xml dosyası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" />
  3. InstallReferrerReceiver'ın kampanya verilerini ayarlamak için Google Analytics alıcısını çağırmasını sağlamak üzere AndroidManifest.xml dosyası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:

  1. Google Etiket Yöneticisi web arayüzünde oturum açın.
  2. İndirmek istediğiniz kapsayıcının Sürüm'ünü seçin.
  3. Kapsayıcı ikili programını almak için İndir düğmesini tıklayın.
  4. İndirilen kapsayıcı ikili program dosyasını projenize ham kaynak olarak ekleyin.
    1. <project-root>/res/ altındaki raw alt klasörü yoksa oluşturun.
    2. Gerekirse kapsayıcı ikili program dosyasını yeniden adlandırın. Yalnızca küçük harf, rakam ve alt çizgilerden oluşur.
    3. Kapsayıcı ikili program dosyasını <project-root>/res/raw klasö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:

  1. TagManager singleton'ını alın:
    TagManager tagManager = TagManager.getInstance(this);
  2. Bir kapsayıcı yükleme isteğinde bulunmak için TagManager tekilini 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 bir PendingResult döndürür:
    PendingResult<ContainerHolder> pending =
            tagManager.loadContainerPreferNonDefault(CONTAINER_ID,
            R.raw.defaultcontainer_binary);
  3. Yükleme tamamlandıktan veya zaman aşımına uğradıktan sonra ContainerHolder öğesini döndürmek için ResultCallback kullanı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 örnekte ContainerHolder örneğine erişimi yönetmek için bir ContainerHolderSingleton yardımcı sınıfı kullanılmıştır. ContainerHolderSingleton sı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:

  1. ContainerHolder.getContainer() yöntemini kullanarak ContainerHolder üzerinden Container alır.
  2. 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:

  1. DataLayer singleton'ını alın:
    DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
  2. 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:

  1. DataLayer singleton'ını alın:
    DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
  2. DataLayer.pushEvent() kullanarak etkinliği gönderin:
    dataLayer.pushEvent("openScreen", DataLayer.mapOf("screenName", screenName));

    DataLayer.mapOf(), etkinlik gönderilirken dataLayer öğ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:

  1. Bu önizleme Activity öğesini AndroidManifest dosyanı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" />
  2. Google Etiket Yöneticisi web arayüzünde önizleme bağlantısı oluşturma
    1. Google Etiket Yöneticisi'nde oturum açma
    2. Önizlenecek kapsayıcı sürümünü seçin.
    3. Önizleme düğmesini tıklayın
    4. Uygulamanızın paket adını girin ve Önizleme başlatma bağlantısı oluştur'u tıklayın.
  3. Uygulamanızı başlatmak için oluşturulan bağlantıyı veya QR kodunu kullanın.
  4. 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.