Android için Google Etiket Yöneticisi

Geliştirici olarak, uygulama ikili programlarını yeniden derleyip uygulama pazar yerlerine tekrar göndermek zorunda kalmadan mobil uygulamalarınızda ölçüm etiketleri ve pikselleri uygulamak ve yönetmek için Google Etiket Yöneticisi'ni kullanabilirsiniz. Firebase için Google Analytics SDK'sı ile çalışan geliştiriciler, uygulama yayınlandıktan sonra bile uygulamayı yönetmeye ve uygulamada değişiklik yapmaya yardımcı olması için Etiket Yöneticisi'ni kolayca ekleyebilir.

Geliştiriciler önemli etkinlikleri kaydedebilir ve hangi etiketlerin veya piksellerin tetikleneceğine daha sonra karar verebilir.

Ön koşullar

Başlamadan önce:

• Firebase konsolunda uygulamanızı Firebase projenize ekleyin.
• Firebase projenizde Google Analytics'i etkinleştirme ve Firebase için Google Analytics SDK'sını uygulamanıza ekleme dahil olmak üzere uygulamanız için Google Analytics'i ayarlayın.
• Etiket Yöneticisi hesabı oluşturun.
• Bir Google Etiket Yöneticisi kapsayıcısı yapılandırın.

Aşağıdaki bölümlerde, Android uygulamanızda Google Etiket Yöneticisi'ni yapılandırma ve kullanma adımları açıklanmaktadır.

1. Projenize Google Etiket Yöneticisi'ni ekleme

1. Modülünüzün Gradle dosyasına (genellikle app/build.gradle) Etiket Yöneticisi kitaplığı için aşağıdaki bağımlılığı ekleyin:

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. Etiket Yöneticisi hesabınızda oturum açın.

3. Bir mobil kapsayıcı seçin.

4. Üst gezinme çubuğunda Sürümler'i tıklayın.

5. Kullanmak istediğiniz kapsayıcı sürümünü tıklayın.

6. İndir'i tıklayın.

7. app/src/main/assets/containers klasörü yoksa oluşturun. İndirilen kapsayıcıyı klasöre kopyalayın.

2. Günlük etkinlikleri ve değişkenler

Etiket Yöneticisi, Google Etiket Yöneticisi'nde yapılandırdığınız etiketleri tetiklemek ve oluşturmak için Firebase için Google Analytics SDK'sı tarafından kaydedilen etkinlikleri, parametreleri ve kullanıcı özelliklerini kullanır.

Etkinlikleri günlüğe kaydetme ve kullanıcı özelliklerini ayarlama ile ilgili talimatlar için Firebase geliştirici belgelerini okuyun.

Etiket Yöneticisi'nde değişkenleri yapılandırma

Etkinlik parametrelerinin ve kullanıcı özelliklerinin değerini Google Etiket Yöneticisi'nde kullanmak üzere yakalamak için Etiket Yöneticisi arayüzünde değişkenleri yapılandırabilirsiniz.

Örneğin, uygulamanızda aşağıdaki özel etkinliği günlüğe kaydedebilirsiniz:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Ardından, image_name ve full_text parameter değerlerini yakalamak için Etiket Yöneticisi'nde yeni etkinlik parametresi değişkenlerini aşağıdaki gibi yapılandırabilirsiniz:

• Değişken Adı: Resim Adı
• Değişken Türü: Etkinlik Parametresi
• Etkinlik parametresi anahtar adı: image_name

ve:

• Değişken Adı: Tam Metin
• Değişken Türü: Etkinlik Parametresi
• Etkinlik parametresi anahtar adı: full_text

Benzer şekilde, uygulamanızda aşağıdaki kullanıcı özelliğini ayarlayabilirsiniz:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Ardından, favorite_food değerini yakalamak için Google Etiket Yöneticisi'nde yeni bir Firebase Kullanıcı Özelliği değişkeni yapılandırabilirsiniz:

• Değişken Adı: En Sevilen Yemek
• Değişken Türü: Firebase Kullanıcı Özelliği
• Etkinlik parametresi anahtar adı: favorite_food

Etkinlikleri değiştirme ve engelleme

Etiket Yöneticisi, etkinlikleri Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilmeden önce değiştirmenize ve engellemenize olanak tanır. Etkinlikleri değiştirerek uygulama güncellemesi yapmadan etkinlik parametrelerinin değerlerini ekleyebilir, kaldırabilir veya değiştirebilir ya da etkinlik adlarını düzenleyebilirsiniz. Engellenmeyen etkinlikler, Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilir.

Firebase için Google Analytics SDK'sı, bazı etkinlikleri ve kullanıcı özelliklerini de otomatik olarak günlüğe kaydeder. Etiket Yöneticisi'nde otomatik olarak toplanan etkinlikleri ve özellikleri kod eklemenize gerek kalmadan kullanabilirsiniz. Ancak bu kişileri engelleyemezsiniz.

3. Etkinlik gönderme

Firebase etkinlik adı değişkenleri, Firebase etkinlik parametresi değişkenleri ve diğer değişkenler tetikleyicileri ayarlamak için kullanılır. Bir Firebase etkinliği kaydettiğinizde tetikleme koşulları değerlendirilir. Varsayılan olarak, Firebase için Google Analytics etkinlikleri otomatik olarak tetiklenir. Etkinliklerin Google Analytics'e gönderilmesini engellemek için Etiket Yöneticisi'ne Firebase için Google Analytics etiketi ekleyebilirsiniz.

4. Kapsayıcınızı önizleme, kapsayıcıda hata ayıklama ve kapsayıcıyı 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 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.

Kapsayıcıyı önizleme

Bir kapsayıcıyı önizlemeden önce, Google Etiket Yöneticisi web arayüzünde önizlemek istediğiniz kapsayıcı sürümünü ve ardından Önizle'yi seçerek bir önizleme URL'si oluşturun. Bu önizleme URL'sini sonraki adımlar için kaydedin.

Şekil 1: Etiket Yöneticisi web arayüzünden önizleme URL'si alma

Kapsayıcınızı önizlemek için (Android Studio kullanıyorsanız 3. adıma geçin):

1. Bu önizleme etkinliğini AndroidManifest dosyanıza ekleyin:

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. Bu satırı, uygulamanızın paket adını içerecek şekilde değiştirin:

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. Google Etiket Yöneticisi web arayüzünde bir önizleme bağlantısı oluşturun:

   1. Etiket Yöneticisi hesabınızda oturum açın.
   2. Bir mobil kapsayıcı seçin.
   3. Üst gezinme çubuğunda Sürümler'i tıklayın.
   4. Önizlemek istediğiniz kapsayıcı sürümünde İşlemler > Önizle'yi tıklayın.
   5. Uygulamanızın paket adını girin.
   6. Önizleme bağlantısı oluştur'u tıklayın.

4. Uygulamanızı durdurun ve uygulamanızı başlatmak için oluşturulan önizleme bağlantısını veya QR kodunu kullanın.

5. Web arayüzündeki Önizlemeyi sonlandırma bağlantısı oluştur seçeneğiyle oluşturulan bir bağlantıyı tıklayarak önizleme modundan çıkabilirsiniz.

Hata ayıklama kapsayıcısı

Kapsayıcı uygulamanızla ilgili sorunları gidermek için ayrıntılı günlük kaydını etkinleştirin:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Kapsayıcıyı yayınlama

Kapsayıcınızı önizleyip çalıştığını doğruladıktan sonra yayınlayabilirsiniz. Kapsayıcınızı yayınladıktan sonra etiket yapılandırmalarınız mobil uygulama kullanıcıları tarafından kullanılabilir hale gelir.

Not: Mobil kapsayıcılar için, bir kapsayıcı ilk kez indirilene kadar ilk etiket yapılandırmalarını ayarlamak üzere varsayılan bir kapsayıcı kullanılır. Uygulama internete bağlanıp bir kapsayıcı indirdikten sonra varsayılan kapsayıcıyı bir daha kullanmaz. Uygulamalar, genellikle 12 saatte bir olmak üzere düzenli olarak kapsayıcı güncellemelerini kontrol eder.

Sonraki adımlar

Gelişmiş yapılandırma başlıklı makaleyi inceleyin.