Terima kasih telah melihat pratinjau dokumentasi platform tag Google yang baru. Situs ini berstatus beta versi publik. (Masukan)

Google Tag Manager + Firebase untuk Android

Developer dapat menggunakan antarmuka Google Tag Manager untuk menerapkan dan mengelola tag serta piksel pengukuran dalam aplikasi seluler mereka, tanpa harus membuat kembali dan mengirim ulang biner aplikasi ke marketplace aplikasi. Developer yang menggunakan Firebase Analytics dapat dengan mudah menambahkan Tag Manager untuk membantu mengelola dan melakukan perubahan pada penerapan, bahkan setelah aplikasi terkirim.

Developer dapat mencatat peristiwa penting ke dalam log, dan kemudian menentukan tag atau piksel pelacakan mana yang harus diaktifkan.

Prasyarat

Sebelum memulai:

Bagian berikut akan memandu Anda melakukan langkah-langkah untuk mengonfigurasi dan menggunakan Google Tag Manager di aplikasi Android.

1. Menambahkan Google Tag Manager ke project Anda

  1. Dalam file Gradle modul (biasanya app/build.gradle), tambahkan dependensi berikut di library Tag Manager:

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.1'
    }
    
  2. Login ke akun Tag Manager.

  3. Pilih penampung seluler.

  4. Klik Versi di menu navigasi atas.

  5. Klik Tindakan > Download di versi penampung yang dipilih.

    download penampung

  6. Buat folder app/src/main/assets/containers jika tidak ada. Salin penampung yang didownload ke folder.

2. Mencatat peristiwa dan variabel ke dalam log

Tag Manager menggunakan peristiwa, parameter, dan properti pengguna Firebase Analytics untuk memicu dan membuat tag yang telah Anda konfigurasikan di antarmuka web Google Tag Manager. Dalam hal ini, penerapan Firebase Analytics berfungsi sebagai lapisan data Anda.

Baca Dokumentasi Developer Firebase Analytics untuk mengetahui petunjuk tentang cara mencatat peristiwa ke dalam log dan menetapkan properti pengguna.

Mengonfigurasi variabel di Tag Manager

Untuk menangkap nilai parameter peristiwa dan properti pengguna Firebase untuk digunakan di Google Tag Manager, Anda dapat mengonfigurasi variabel di antarmuka Tag Manager.

Misalnya, jika Anda mencatat peristiwa kustom berikut ke dalam log di aplikasi Anda:

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

Anda dapat mengonfigurasi variabel Parameter Peristiwa baru di Tag Manager untuk mengambil nilai image_name dan full_text parameter:

  • Nama Variabel: Nama Image
  • Jenis Variabel: Parameter Peristiwa
  • Nama Kunci Parameter Peristiwa: image_name

dan:

  • Nama Variabel: Teks Lengkap
  • Jenis Variabel: Parameter Peristiwa
  • Nama Kunci Parameter Peristiwa: full_text

Demikian pula, jika Anda menetapkan properti pengguna berikut di aplikasi:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

Anda dapat mengonfigurasi variabel Properti Pengguna Firebase baru di Google Tag Manager untuk mengambil nilai favorite_food:

  • Nama Variabel: Makanan Favorit
  • Jenis Variabel: Properti Pengguna Firebase
  • Nama Kunci Parameter Peristiwa: favorite_food

Mengubah dan memblokir peristiwa Firebase Analytics

Tag Manager memungkinkan Anda mengubah dan memblokir peristiwa sebelum login ke Firebase Analytics. Mengubah peristiwa dapat membantu Anda—tanpa perlu update aplikasi—untuk menambahkan, menghapus, atau mengubah nilai parameter peristiwa atau menyesuaikan nama peristiwa. Peristiwa yang tidak diblokir akan dicatat ke dalam log di Firebase Analytics.

Firebase Analytics juga secara otomatis mencatat beberapa peristiwa dan properti pengguna ke dalam log; Anda tidak perlu menambahkan kode apa pun untuk mengaktifkannya. Peristiwa dan properti yang dikumpulkan secara otomatis ini dapat digunakan di Tag Manager, tetapi tidak dapat diblokir.

3. Mengaktifkan tag

Variabel nama peristiwa Firebase, variabel parameter peristiwa Firebase, dan variabel lainnya digunakan untuk menyiapkan pemicu. Kondisi pemicu dievaluasi setiap kali Anda mencatat peristiwa Firebase ke dalam log. Secara default, peristiwa Firebase Analytics diaktifkan secara otomatis. Anda dapat menambahkan tag Firebase Analytics di Tag Manager untuk memblokir peristiwa agar tidak dikirim ke Firebase Analytics.

4. Melihat pratinjau, men-debug, dan memublikasikan penampung

Sebelum memublikasikan versi penampung, Anda dapat melihat pratinjaunya untuk memastikan penampung berfungsi sebagaimana mestinya. Google Tag Manager memberi Anda kemampuan untuk melihat pratinjau versi penampung dengan membuat link dan kode QR di antarmuka web dan menggunakannya untuk membuka aplikasi Anda. Anda juga dapat mengaktifkan mode logging panjang untuk men-debug perilaku yang tidak terduga.

Melihat pratinjau penampung

Sebelum melihat pratinjau penampung, buat URL pratinjau di antarmuka web Google Tag Manager dengan memilih versi penampung yang ingin Anda lihat pratinjaunya, lalu memilih Pratinjau. Simpan URL pratinjau ini untuk mengetahui langkah-langkah berikutnya.

URL pratinjau tersedia di jendela pratinjau antarmuka web Tag Manager
Gambar 1: Mendapatkan URL pratinjau dari antarmuka web Tag Manager.

Untuk melihat pratinjau penampung (jika Anda menggunakan Android Studio, langsung ke langkah 3):

  1. Tambahkan aktivitas pratinjau ini ke file AndroidManifest Anda:

    <!--  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. Ubah baris ini untuk menyertakan nama paket aplikasi Anda:

    <data android:scheme="tagmanager.c.com.example.app"/>
    
  3. Di antarmuka web Google Tag Manager, buat link pratinjau:

    1. Login ke akun Tag Manager.
    2. Pilih penampung seluler.
    3. Klik Versi di menu navigasi atas.
    4. Klik Tindakan > Pratinjau di versi penampung yang ingin Anda lihat pratinjaunya.
    5. Masukkan nama paket aplikasi Anda.
    6. Klik Buat link memulai pratinjau.
  4. Hentikan aplikasi Anda dan gunakan link pratinjau atau Kode QR yang dibuat untuk meluncurkan aplikasi Anda.

  5. Anda dapat keluar dari mode pratinjau dengan mengklik link yang dibuat oleh opsi Buat link akhiri pratinjau di antarmuka web.

Men-debug penampung

Untuk memecahkan masalah penerapan penampung, aktifkan logging panjang:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

Memublikasikan penampung

Setelah melihat pratinjau penampung dan memverifikasi bahwa penampung tersebut berfungsi, Anda dapat memublikasikannya. Setelah memublikasikan penampung, konfigurasi tag Anda akan tersedia untuk pengguna aplikasi seluler.

Langkah berikutnya

Baca Konfigurasi lanjutan.