Thanks for previewing Google's new tag platform documentation! This site is in public beta. (Feedback)

Android İçin Google Etiket Yöneticisi

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Geliştirici olarak, uygulama ikili kodlarını yeniden oluşturup uygulama pazarlarına yeniden göndermenize gerek 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 gönderildikten sonra bile, uygulamanın yönetilmesine ve değiştirilmesine yardımcı olmak için Etiket Yöneticisi'ni kolayca ekleyebilirler.

Geliştiriciler önemli etkinlikleri günlüğe kaydedebilir ve daha sonra hangi etiketlerin veya piksellerin tetikleneceğine karar verebilirler.

Ön koşullar

Başlamadan önce:

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 ekleyin

  1. Modül Gradle dosyanıza (genellikle app/build.gradle) aşağıdaki bağımlıyı Etiket Yöneticisi kitaplığına ekleyin:

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.2'
    }
    
  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. Seçilen kapsayıcı sürümünde İşlemler &İndir'i tıklayın.

    kapsayıcı indir

  6. Mevcut değilse app/src/main/assets/containers klasörünü 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 için 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 kullanılacak 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 bulunan 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 Etiket Yöneticisi'nde image_name ve full_text parameter değerlerini yakalamak için yeni Etkinlik Parametresi değişkenlerini aşağıdaki şekilde 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 de ayarlayabilirsiniz:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Daha sonra, Google Etiket Yöneticisi'nde favorite_food değerini yakalamak için yeni bir Firebase User Property değişkeni yapılandırabilirsiniz:

  • Değişken Adı: Favori Yemek
  • 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. Etkinlikte değişiklik yapmak, etkinlik parametrelerinin değerini eklemenize, kaldırmanıza veya değiştirmenize veya 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. Otomatik olarak toplanan etkinlikleri ve özellikleri herhangi bir kod eklemenize gerek kalmadan Etiket Yöneticisi'nde kullanabilirsiniz. Ancak bu kullanıcıyı engelleyemezsiniz.

3. Etkinlik gönderme

Tetikleyicileri 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 günlüğe her kaydettiğinizde tetikleyici koşulları değerlendirilir. Firebase için Google Analytics etkinlikleri varsayılan olarak otomatik şekilde tetiklenir. Etkinliklerin Google Analytics'e gönderilmesini engellemek için Etiket Yöneticisi'nde bir Firebase için Google Analytics etiketi ekleyebilirsiniz.

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 önizleme yapmak istersiniz. Google Etiket Yöneticisi, web arayüzünde bağlantılar ve QR kodları oluşturup uygulamanızı açmak için bunları kullanarak kapsayıcınızın sürümlerini önizleme olanağı sunar. Beklenmeyen davranışlarda hata ayıklamak için ayrıntılı bir günlük kaydı modu da etkinleştirebilirsiniz.

Kapsayıcı önizlemesi

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

Önizleme URL'leri, Etiket Yöneticisi web arayüzünün önizleme penceresinde bulunur
Şekil 1: Etiket Yöneticisi web arayüzünden bir önizleme URL'si alın.

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 & Önizleme'yi tıklayın.
    5. Uygulamanızın paket adını girin.
    6. Önizleme başlat bağlantısı oluştur'u tıklayın.
  4. Uygulamanızı durdurup oluşturulan önizleme bağlantısını veya QR Kodunu kullanarak uygulamanızı başlatın.

  5. Web arayüzünde Son önizleme bağlantısı oluştur seçeneği tarafından 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ınla

Kapsayıcınızı önizledikten ve ç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.