Pemberian tag sisi server untuk aplikasi seluler

Anda dapat mengonfigurasi aplikasi seluler menggunakan Google Analytics for Firebase SDK agar berfungsi dengan pemberian tag sisi server di Google Tag Manager.

Pemberian tag sisi server memungkinkan Anda melakukan staging, menyamarkan, dan menambah data sebelum mengirimnya ke produk tujuan seperti Google Analytics. Pelajari Pemberian tag sisi server lebih lanjut.

Untuk menyiapkan pemberian tag sisi server untuk aplikasi seluler:

1. Menyiapkan aplikasi untuk pemberian tag sisi server
2. Mengonfigurasi penampung server untuk mendukung traffic seluler
3. Mengaktifkan pemberian tag sisi server di properti GA4 Anda

Prasyarat

• Anda perlu menyertakan Google Analytics for Firebase SDK di aplikasi dan menghubungkannya ke properti Google Analytics 4. Pelajari Google Analytics for Firebase SDK lebih lanjut.
• Anda memerlukan akun Google Tag Manager dan penampung server. Jika Anda belum memilikinya, buat akun dan penampung Tag Manager baru.
• Anda perlu menyiapkan server pemberian tag.

Langkah 1: Siapkan aplikasi untuk pemberian tag sisi server

iOS

1. Aktifkan fitur upload pemberian tag sisi server dan siapkan skema URL kustom untuk mode debug pemberian tag sisi server dalam file Info.plist. Ganti BUNDLE_ID pada kode berikut dengan ID paket aplikasi.

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. Untuk mengaktifkan mode debug atau pratinjau, tambahkan panggilan ke Analytics.handleOpen(_:) dalam metode siklus proses untuk meneruskan URL peluncuran.

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   Untuk aplikasi yang tidak menggunakan SwiftUI atau UIScene, Anda tidak perlu melakukan tindakan apa pun. SDK menerima URL peluncuran dari ApplicationDidFinishLaunchingNotification.

Android

1. Instal rilis terbaru Google Analytics for Firebase SDK.

2. Aktifkan sGTM dengan menambahkan kode berikut ke file AndroidManifest.xml aplikasi.

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

Langkah 2: Konfigurasikan penampung server Anda untuk mendukung traffic seluler

Bagian berikut mengasumsikan bahwa Anda sudah memiliki deployment pemberian tag sisi server dan memahami konsepnya. Jika Anda baru mengenal pemberian tag sisi server, Anda dapat mengikuti kursus dasar-dasar pemberian tag sisi server.

Menyiapkan klien Google Analytics: GA4 (Aplikasi)

Klien adalah jenis resource Tag Manager yang mencegat jenis permintaan masuk tertentu dan menghasilkan peristiwa yang dapat diteruskan ke tujuan, seperti Google Analytics 4. Dalam hal ini, permintaan HTTP adalah peristiwa Google Analytics 4, sehingga Anda perlu mengonfigurasi klien Google Analytics: GA4 (Aplikasi) bawaan. Anda hanya memerlukan satu klien GA4 per sumber data seperti GA SDK dan situs. Pelajari lebih lanjut Cara kerja klien.

1. Di penampung server, buka Klien, lalu klik Baru.

2. Klik Konfigurasi Klien, lalu pilih Google Analytics: GA4 (Aplikasi).

   

3. Masukkan nama untuk klien Anda, lalu klik Simpan.

Mengonfigurasi tag Google Analytics: GA4

Untuk mengirim data ke Google Analytics, Anda harus membuat tag Google Analytics: GA4 di penampung server. Klien mengurai permintaan HTTP yang masuk menjadi objek data peristiwa. Tag akan mengambil objek data peristiwa ini, memetakannya ke format yang benar, lalu mengirimnya ke Google Analytics 4.

1. Di penampung server, buka Tag, lalu klik Baru.

2. Klik Konfigurasi Tag, lalu pilih Google Analytics: GA4.

   

Secara default, tag akan mewarisi semua kolom dan parameter yang relevan dari objek data peristiwa yang dibuat oleh klien:

• Jika permintaan Google Analytics 4 yang masuk melewati klien Google Analytics: GA4 (Aplikasi), tag tersebut akan mewarisi ID Aplikasi dan parameter peristiwa.
• Jika permintaan Google Analytics 4 yang masuk melewati klien Google Analytics: GA4 (Web), tag tersebut akan mewarisi ID Pengukuran dan parameter peristiwa.

Tips: Anda dapat menggunakan transformasi secara opsional untuk menyertakan, mengecualikan, atau mengubah output parameter peristiwa dari klien Anda sebelum ditampilkan ke tag. Dengan transformasi, Anda dapat mengamankan informasi sensitif dan memiliki kontrol terperinci atas parameter peristiwa yang tersedia untuk diproses lebih lanjut.

Menyiapkan pemicu untuk traffic seluler

Kemudian, Anda harus menetapkan kapan tag GA4 harus diaktifkan. Klien Google Analytics: GA4 (Aplikasi) mengurai permintaan masuk menjadi objek data peristiwa, dan tag akan mewarisi nilainya. Oleh karena itu, Anda biasanya ingin tag diaktifkan setiap kali klien GA4 mengklaim permintaan.

Untuk menyiapkan pemicu:

1. Di setelan tag, klik Pemicuan.
2. Untuk membuat pemicu baru, klik ikon + di sudut kanan atas.
3. Klik Konfigurasi Pemicu untuk memilih jenis pemicu.

4. Pilih Kustom atau Peristiwa Kustom dari daftar.

   • Jenis Pemicu kustom, secara default, mengaktifkan tag saat peristiwa apa pun dibuat oleh klien sisi server.
   • Jenis pemicu Peristiwa Kustom dapat digunakan untuk mengaktifkan tag pada nama peristiwa tertentu atau peristiwa yang cocok dengan pola ekspresi reguler.

5. Untuk mengaktifkan daftar kondisi aktivasi untuk pemicu ini, seperti untuk diaktifkan hanya pada data peristiwa seluler atau web, pilih Beberapa Peristiwa.

   1. Anda akan melihat Nama Peristiwa yang dipilih sebelumnya. Klik pemilih tersebut, lalu pilih Pilih Variabel Bawaan dari daftar.
   2. Untuk otomatis menampilkan nama klien yang membuat peristiwa, pilih Nama Klien.

   3. Gunakan nama klien yang Anda konfigurasikan sebelumnya untuk menetapkan kondisinya. Pemicu Anda akan terlihat seperti ini:

      

      Catatan: Nama klien adalah nama yang Anda tentukan di langkah sebelumnya. Jenis klien adalah Google Analytics: GA4 (Aplikasi). Variabel Nama Klien menampilkan nama, bukan jenis klien.

6. Simpan pemicu dan masukkan nama deskriptif. Misalnya, Anda dapat menggunakan "Semua Peristiwa Aplikasi GA4".

7. Sekarang Anda akan kembali ke setelan tag dengan pemicu baru yang telah dibuat. Simpan tag dan masukkan nama deskriptif, misalnya "GA4". Tag Anda akan terlihat seperti ini:

   

Tips: Untuk menghapus peristiwa tertentu agar tidak dikirim, Anda dapat memilih untuk menggunakan pemicu kustom dengan logika kondisional berdasarkan nama peristiwa (atau beberapa variabel lainnya) atau menambahkan pengecualian pemicu. Pelajari lebih lanjut cara Mengaktifkan pemicu dan pengecualian pemicu.

Melihat pratinjau penampung

Anda dapat menggunakan Google Tag Manager untuk melihat pratinjau dan men-debug penampung server sebelum memublikasikan perubahan. Perhatikan bahwa pratinjau tidak akan berfungsi hingga Anda mengaktifkan pemberian tag sisi server di properti GA4.

Agar permintaan aplikasi memicu konfigurasi pratinjau, Anda harus:

1. Pilih Pratinjau saat berada di penampung server Google Tag Manager.
2. Klik ikon Tindakan Lainnya ⋮ di kanan atas, lalu pilih Kirim permintaan dari aplikasi.

3. Masukkan ID aplikasi Anda, lalu klik Buat Kode QR.

   

4. Pindai kode QR dengan aplikasi kamera ponsel Anda. Lanjutkan berinteraksi dengan aplikasi seperti biasa untuk menghasilkan peristiwa pratinjau.

5. Klik OK untuk menutup dialog.

Memublikasikan penampung

Setelah memverifikasi perubahan, publikasikan penampung agar perubahan tersebut berlaku untuk semua traffic. Pelajari lebih lanjut Penerbitan, versi, dan persetujuan.

Langkah 3: Aktifkan pemberian tag sisi server di properti GA4 Anda

1. Di properti Google Analytics 4, buka Admin.
2. Buka Aliran data.

3. Pilih konfigurasi aliran data aplikasi Anda dari tab iOS atau Android.

   

4. Klik Konfigurasikan setelan SDK, lalu Konfigurasikan Tag Manager sisi server.

   

5. Agar SDK dapat mengirim data pengukuran ke URL penampung server:

   1. Alihkan tombol Kirim data ke penampung Tag Manager sisi server.
   2. Salin URL penampung server. Anda dapat menemukannya di Google Tag Manager dengan membuka Admin > Setelan Penampung > URL penampung server.

   3. Pilih persentase traffic yang ingin Anda arahkan ke penampung server. Anda dapat memilih opsi di bawah 100% untuk memvalidasi penyiapan dan konfigurasi server sebelum menggunakan pemberian tag sisi server untuk semua traffic.

      Catatan: Gunakan opsi Khusus perangkat debug untuk mengaktifkan hanya aplikasi yang dibuka menggunakan Mode pratinjau untuk mengirim data ke server Anda.

   

6. Klik Simpan. SDK akan mengambil URL penampung server yang diperbarui dan mengarahkan data pengukuran ke URL tersebut.

Batasan umum

• Untuk aplikasi Android:

  • Untuk menghindari potensi kerentanan keamanan yang melibatkan penampung server dan layanan Google Play, peristiwa akan melalui server proxy stateless di antara SDK dan penampung server Anda. Proxy ini akan memvalidasi sumber dan endpoint permintaan, tetapi tidak akan memeriksa atau menyimpan data apa pun tentang peristiwa. Sesuai dengan cara GA4 mengumpulkan data dari perangkat yang berbasis di Uni Eropa, proxy akan berada di Uni Eropa untuk traffic yang berbasis di Uni Eropa.
  • Pembelian dalam aplikasi yang dicatat secara otomatis bergantung pada integrasi dengan backend Google Play dan tidak akan dikirim ke penampung server.
  • Peristiwa app_remove tidak akan dilaporkan di Android.

• Menghubungkan aliran data aplikasi di Google Analytics ke akun Google Ads masih diperlukan untuk memastikan bahwa data dan konversi SDK Anda diimpor ke Google Ads. Pemberian tag sisi server tidak menawarkan integrasi bawaan antara SDK dan Google Ads.

API

Anda dapat menggunakan Tag Manager REST API untuk mengakses data konfigurasi Tag Manager. Untuk informasi selengkapnya tentang API:

• Lihat Panduan Developer untuk mempelajari cara menggunakan API.
• Tinjau Referensi Tag Manager API untuk memahami resource Tag Manager dan operasi yang tersedia.