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

Google Tag Manager untuk iOS

Developer dapat menggunakan antarmuka 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 Google Analytics for Firebase dapat dengan mudah menambahkan Tag Manager untuk membantu mengelola dan melakukan perubahan pada penerapan, bahkan setelah aplikasi dikirim.

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 iOS.

1. Menambahkan Tag Manager ke project Anda

  1. Tambahkan paket Tag Manager:

    CocoaPods

    Untuk menambahkan Tag Manager melalui CocoaPods:

    1. Di terminal, jalankan perintah berikut:

      $ sudo gem install cocoapods
      
    2. Ubah ke direktori project Anda.

    3. Jalankan perintah berikut untuk membuat file bernama Podfile:

      $ pod init
      
    4. Di Podfile, tambahkan kode berikut:

      pod 'GoogleTagManager', '~> 6.0'
      
    5. Jalankan perintah berikut untuk mendownload dan menginstal dependensi Tag Manager ke project Anda:

      $ pod install
      

    Swift Package Manager

    Untuk menambahkan Tag Manager melalui Swift Package Manager:

    1. Jika bermigrasi dari project berbasis CocoaPods, jalankan pod deintegrate untuk menghapus CocoaPods dari project Xcode Anda. File .xcworkspace yang dihasilkan CocoaPods dapat dihapus dengan aman setelahnya. Jika Anda menambahkan Firebase ke project untuk pertama kalinya, Anda dapat mengabaikan langkah ini.
    2. Di Xcode 12, instal library Tag Manager dengan membuka File > Tag Manager Packages > Add Package Dependency…
    3. Pada perintah yang muncul, masukkan repositori GitHub Tag Manager:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. Pilih versi Tag Manager yang ingin Anda gunakan. Untuk project baru, sebaiknya gunakan Tag Manager versi terbaru.

    5. Tambahkan -ObjC ke Other Linker Flags di Build Settings project Anda.

  2. Buat penampung iOS jika akun Tag Manager Anda belum memilikinya:

    1. Login ke akun Tag Manager Anda.
    2. Klik ADMIN di menu navigasi atas.
    3. Di kolom PENAMPUNG, klik menu drop-down, lalu pilih BUAT PENAMPUNG.
    4. Masukkan nama penampung.
    5. Pilih penampung iOS.
    6. Pilih Firebase (iOS) SDK.
    7. Klik BUAT.
  3. Mendownload penampung Anda:

    1. Login ke akun Tag Manager Anda.
    2. Pilih penampung iOS Anda.
    3. Klik Versi di menu navigasi atas.
    4. Klik Tindakan > Download di versi penampung yang dipilih.

  4. Tambahkan penampung yang didownload ke project Anda:

    1. Salin file yang didownload ke dalam folder bernama container di root project XCode (biasanya PROJECT_ROOT/container/GTM-XXXXXX.json).
    2. Buka Xcode.
    3. Dari menu File, pilih Add files to...
    4. Pilih folder container.
    5. Klik Options, lalu pastikan Create folder references dipilih.
    6. Klik Finish.

2. Mencatat peristiwa dan variabel

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

Baca dokumentasi developer 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 Tag Manager, Anda dapat mengonfigurasi variabel di antarmuka Tag Manager.

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

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

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

  • Nama Variabel: Nama Gambar
  • 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:

Analytics.setUserProperty(food, forName: "favorite_food")

Anda dapat mengonfigurasi variabel Properti Pengguna Firebase baru di 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 Analytics

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

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 Analytics akan otomatis diaktifkan. Anda dapat menambahkan tag Analytics di Tag Manager untuk memblokir peristiwa agar tidak dikirim ke Analytics.

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

Sebelum memublikasikan versi penampung, Anda dapat melihat pratinjaunya untuk memastikan penampung berfungsi sebagaimana mestinya. Tag Manager memungkinkan Anda melihat pratinjau versi penampung dengan membuat link dan kode QR di antarmuka web Tag Manager dan menggunakannya untuk membuka aplikasi.

Melihat pratinjau penampung

Untuk melihat pratinjau penampung, buat URL pratinjau di antarmuka web Tag Manager:

  1. Login ke akun Tag Manager Anda.
  2. Pilih penampung seluler.
  3. Klik Versi di menu navigasi atas.
  4. Klik Tindakan > Pratinjau di versi penampung yang ingin Anda pratinjau.
  5. Masukkan nama paket aplikasi Anda.
  6. Klik Buat link memulai pratinjau.

    URL pratinjau tersedia di jendela pratinjau antarmuka web Tag Manager

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

    Simpan URL pratinjau ini untuk langkah-langkah berikutnya.

Untuk mengaktifkan pratinjau penampung, Anda harus menentukan skema URL pratinjau Tag Manager dalam daftar properti project Anda. Di bagian Jenis URL file daftar properti aplikasi Anda, daftarkan ID URL dan skema URL berikut:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
Daftarkan skema URL pratinjau Tag Manager dalam file daftar properti aplikasi Anda.
Gambar 2: Tambahkan skema URL pratinjau Tag Manager ke file daftar properti aplikasi Anda.

Hentikan aplikasi Anda dan buka URL pratinjau di emulator atau perangkat fisik untuk melihat pratinjau penampung draf di aplikasi Anda.

Men-debug penampung

Saat Anda menjalankan aplikasi dalam simulator atau dalam mode pratinjau, Tag Manager secara otomatis mengubah logging menjadi panjang.

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.

Baca Konfigurasi lanjutan.