Geliştirici olarak, ölçüm etiketlerini ve piksellerini mobil uygulamalarınızda yeniden oluşturup uygulama pazarlarına yeniden göndermek zorunda kalmadan Google Etiket Yöneticisi'ni kullanabilirsiniz. Firebase için Google Analytics SDK'sı ile çalışan geliştiriciler, uygulama gönderildikten sonra bile uygulamayı yönetmeye ve değişiklik yapmaya yardımcı olması için Etiket Yöneticisi'ni kolayca ekleyebilir.
Geliştiriciler önemli etkinlikleri günlüğe 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ştirmek ve uygulamanıza Firebase için Google Analytics SDK'sını eklemek dahil olmak üzere uygulamanız için Google Analytics'i ayarlayın.
- Bir 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ında yol gösterilmektedir.
1. Google Etiket Yöneticisi'ni projenize ekleme
Gradle modülü dosyanızda (genellikle
app/build.gradle
), Etiket Yöneticisi kitaplığına aşağıdaki bağımlılığı ekleyin:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.0.4' }
Etiket Yöneticisi hesabınızda oturum açın.
Bir mobil kapsayıcı seçin.
Üst gezinme çubuğunda Sürümler'i tıklayın.
Kullanmak istediğiniz kapsayıcı sürümünü tıklayın.
İndir'i tıklayın.
app/src/main/assets/containers
klasörü yoksa oluşturun. İndirilen kapsayıcıyı klasöre kopyalayın.
2. Etkinlikleri ve değişkenleri günlüğe kaydetme
Etiket Yöneticisi, Google Etiket Yöneticisi'nde yapılandırdığınız etiketleri tetiklemek ve oluşturmak üzere Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilen etkinlikleri, parametreleri ve kullanıcı özelliklerini kullanır.
Etkinlikleri günlüğe kaydetme ve kullanıcı özelliklerini ayarlama talimatları için Firebase geliştirici belgelerini okuyun.
Etiket Yöneticisi'nde değişkenleri yapılandırma
Google Etiket Yöneticisi'nde kullanmak üzere etkinlik parametrelerinin ve kullanıcı özelliklerinin değerini 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ı Mülkü değişkeni yapılandırabilirsiniz:
- Değişken Adı: Favori Yiyecek
- Değişken Türü: Firebase Kullanıcı Mülkü
- Etkinlik Parametresi Anahtar Adı:
favorite_food
Etkinlikleri değiştirme ve engelleme
Etiket Yöneticisi, Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilmeden önce etkinlikleri değiştirmenize ve engellemenize olanak tanır. Etkinlikleri düzenlemek, etkinlik parametrelerinin değerlerini eklemenize, kaldırmanıza veya değiştirmenize ya da uygulama güncellemeleri olmadan etkinlik adlarını düzenlemenize yardımcı olabilir. 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. Herhangi bir kod eklemeniz gerekmeden Etiket Yöneticisi'nde otomatik olarak toplanan etkinlik ve mülkleri kullanabilirsiniz. Ancak bu kişileri engelleyemezsiniz.
3. Etkinlikleri gönder
Tetikleyici ayarlamak için Firebase etkinlik adı değişkenleri, Firebase etkinlik parametresi değişkenleri ve diğer değişkenler kullanılır. Bir Firebase etkinliğini 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 amacıyla Etiket Yöneticisi'ne bir Firebase için Google Analytics etiketi eklenebilir.
4. Kapsayıcınızı önizleme, hata ayıklama ve yayınlama
Kapsayıcınızın bir sürümünü yayınlamadan önce, istediğiniz gibi çalıştığından emin olmak için bu sürümü önizlemeniz gerekir. Google Etiket Yöneticisi, web arayüzünde bağlantılar ve QR kodları oluşturarak ve bunları uygulamanızı açmak için kullanarak, kapsayıcınızın sürümlerini önizlemenize olanak tanır. Beklenmedik davranışlarda hata ayıklamak için ayrıntılı günlük kaydı modunu da etkinleştirebilirsiniz.
Kapsayıcıyı önizle
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 önizleme URL'si oluşturun. Sonraki adımlar için bu önizleme URL'sini kaydedin.
Kapsayıcınızı önizlemek için (Android Studio kullanıyorsanız 3. adıma geçin):
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>
Bu satırı, uygulamanızın paket adını içerecek şekilde değiştirin:
<data android:scheme="tagmanager.c.com.example.app"/>
Google Etiket Yöneticisi web arayüzünde, bir önizleme bağlantısı oluşturun:
- Etiket Yöneticisi hesabınızda oturum açın.
- Bir mobil kapsayıcı seçin.
- Üst gezinme çubuğunda Sürümler'i tıklayın.
- Önizlemek istediğiniz kapsayıcı sürümünde İşlemler > Önizle'yi tıklayın.
- Uygulamanızın paket adını girin.
- Önizlemeyi başlatma bağlantısı oluştur'u tıklayın.
Uygulamanızı durdurun ve oluşturmak için oluşturulan önizleme bağlantısını veya QR kodunu kullanın.
Web arayüzündeki Önizleme sonu bağlantısı oluştur seçeneği ile oluşturulan bir bağlantıyı tıklayarak önizleme modundan çıkabilirsiniz.
Hata ayıklama kapsayıcısı
Container 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ınla
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ına sunulur.
Sonraki adımlar
Gelişmiş yapılandırma başlıklı makaleyi inceleyin.