ZEPETO Analytics

12min

ZEPETO Analytics adalah paket yang membuat API statistik mudah digunakan.
Saat ini, Google Analytics tersedia.
👍 Spesifikasi Google Analytics v4 didukung
﻿
LANGKAH 1 : Instal
Window → Package Manager → Silakan instal ZEPETO.World Package versi 1.21.14 terlebih dahulu.
Setelah itu, instal paket ZEPETO Analytics.
﻿
﻿
LANGKAH 2 : Membuat Aliran Data Google Analytics
📘 Google Analytics
https://analytics.google.com/﻿
Setelah Anda membuat akun Google Analytics Anda, Anda harus membuat aliran data untuk digunakan di World. (Rata-rata, dibutuhkan 1 hari untuk mengaktifkan akun awal.)
Disarankan agar Anda membuat dan mengelola satu aliran data per WorldId.
ZEPETO Analytics mengirim data menggunakan httpService, jadi pastikan untuk memilih platform 'web'.
﻿
﻿
Silakan tulis WorldId di tempat Anda menulis URL.
﻿
﻿
Ketika pembuatan aliran data selesai, Anda dapat memverifikasi ID Pengukuran.
﻿
﻿
Untuk menghasilkan nilai Kunci API, Anda harus memasukkan menu rahasia Protokol Pengukuran.
﻿
﻿
Setelah menekan tombol Buat di sebelah kanan, lengkapi entri Nama Panggilan untuk menghasilkan Nilai Rahasia.
﻿
﻿
Silakan salin nilai ID Pengukuran dan Nilai Rahasia untuk proses selanjutnya.
﻿
LANGKAH 3 : Cara Menggunakan
Di jendela Hierarki, klik tab ZEPETO → Zepeto Analytics.
﻿
﻿
Sebuah objek bernama Zepeto Analytics secara otomatis dibuat sebagai berikut:
ZepetoAnalyticsComponent adalah komponen yang bertanggung jawab untuk mengirim statistik dalam sebuah Scene.
Di jendela Inspector, Anda dapat memasukkan pengaturan yang diperlukan untuk mengirim statistik.
ZepetoAnalytics
﻿
﻿
Silakan pilih Google Analytics sebagai Tipe Analitik dan masukkan kunci Api dan id Pengukuran.
﻿
﻿
Ketika Anda memainkan Scene dengan komponen ZEPETO Analytics yang ditambahkan, nilai waktu tinggal kumulatif secara otomatis terakumulasi di Google Analytics.
Anda dapat melihat nilai waktu keterlibatan dari menu Laporan > Ikhtisar Realtime. (Item laporan yang tidak termasuk tab Realtime memerlukan waktu tertentu untuk tercermin.)
Jika scene diubah dan komponen dihapus, statistik tidak akan dikirim. Jadi jika Anda ingin menyimpannya, harap proses sebagai Jangan Hancurkan.
❗️ Peringatan
Jika Anda memeriksa mode debug selama pengujian editor, data tidak akan dikirim ke dasbor.
Ketika Anda ingin menumpuk data, pastikan bahwa mode debug dimatikan.
﻿
﻿
Menambahkan Acara Kustom
Anda dapat mengumpulkan statistik berdasarkan acara kustom.
Di bawah ini adalah contoh kode yang mengirimkan acara kustom ke dasbor Google Analytics ketika Anda menekan tombol.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { AnalyticsType, ZepetoAnalyticsComponent } from 'ZEPETO.Analytics';
import { Button } from 'UnityEngine.UI';

export default class CustomEvent extends ZepetoScriptBehaviour {

    public zepetoAnalytics: ZepetoAnalyticsComponent;
    public myButton: Button;

    Start() {
        this.myButton.onClick.AddListener(() => {

            // Ketika tombol diklik, acara acak dikirim ke Google Analytics
            const ga = this.zepetoAnalytics.Analytics(AnalyticsType.GoogleAnalytics);

            interface CustomEvent {
                param_01 : string;
                param_02 : number;
            }

            const _event : CustomEvent = {
                param_01 : "param_string_val_01",
                param_02 : 3,
            }
            ga.LogEvent<CustomEvent>("custom_sub_param", _event);
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { AnalyticsType, ZepetoAnalyticsComponent } from 'ZEPETO.Analytics';
import { Button } from 'UnityEngine.UI';

export default class CustomEvent extends ZepetoScriptBehaviour {

    public zepetoAnalytics: ZepetoAnalyticsComponent;
    public myButton: Button;

    Start() {
        this.myButton.onClick.AddListener(() => {

            // Ketika tombol diklik, acara acak dikirim ke Google Analytics
            const ga = this.zepetoAnalytics.Analytics(AnalyticsType.GoogleAnalytics);

            interface CustomEvent {
                param_01 : string;
                param_02 : number;
            }

            const _event : CustomEvent = {
                param_01 : "param_string_val_01",
                param_02 : 3,
            }
            ga.LogEvent<CustomEvent>("custom_sub_param", _event);
        });
    }
}
﻿
﻿
Pastikan untuk menghubungkan komponen Zepeto Analytics setelah menulis skrip.
Tangkapan layar di bawah ini adalah contoh komponen yang dikonfigurasi untuk membuat skrip contoh berfungsi.
﻿
﻿
Dari menu Laporan > Ikhtisar waktu nyata, Anda dapat melihat bahwa nilai untuk acara kustom ditumpuk secara waktu nyata.
﻿
﻿
Aktifkan Mode Debug
Google Analytics memvalidasi Payload Body untuk CustomEvent yang Anda kirim. (Jika tidak valid, tidak akan dikirim)
Memeriksa mode debug memudahkan untuk melihat hasil validasi untuk Payload yang Anda kirim di jendela konsol.
❗️ Peringatan
Jika Anda memeriksa mode debug selama pengujian editor, data tidak akan dikirim ke dasbor.
Ketika Anda ingin menumpuk data, pastikan bahwa mode debug dimatikan.
﻿
﻿
Jika Anda membuat acara kustom yang tidak sesuai dengan spesifikasi Google Anda, validasi akan gagal dalam mode debug.
﻿
﻿
Untuk informasi tentang Spesifikasi Google dan Mode Debug, silakan kunjungi:
📘  Untuk informasi tentang Spesifikasi Google dan Mode Debug, silakan kunjungi:
Untuk informasi tentang Spesifikasi Google dan Mode Debug, silakan kunjungi:
﻿
Google Analytics
﻿https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?hl=en&client_type=gtag﻿
Alat Pengembang Google Analytics
﻿https://ga-dev-tools.web.app/ga4/event-builder/﻿
﻿
API ZepetoBaseAnalytics
Fungsi
Deskripsi
LogEvent
Memungkinkan Anda untuk mengirim acara kustom ke dasbor Google Analytics yang terhubung.

Mendukung parameter tunggal (string, angka, boolean) dan Payload generik.

Untuk Payload dalam format generik, hanya formulir yang diizinkan oleh Google Analytics yang dapat ditransfer.

﻿https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag

SetAnalyticsCollectionEnabled
Mengaktifkan/mematikan fungsi transmisi Acara dari Komponen Analitik ZEPETO. Dapat digunakan untuk kontrol dinamis.

Secara default, Komponen Analitik menjadi True ketika Diaktifkan, dan False ketika Dinonaktifkan.

(Waktu tinggal dasar secara otomatis dicatat dari saat Komponen Analitik ZEPETO diaktifkan.)
SendDuration
Untuk nama Acara tertentu, Anda dapat mentransfer waktu tinggal dalam milidetik (ms).

Dapat digunakan untuk mencatat Waktu Keterlibatan secara manual untuk acara tertentu. (Independen dari waktu tinggal yang diukur secara otomatis.)

ex) Digunakan untuk mencatat secara manual 'Saya berada di area tertentu selama 3 detik (3000 ms)'
SetUserProperty
Untuk acara yang Anda kirim, Anda dapat menambahkan properti Pengguna Kustom.
https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?hl=en&client_type=gtag

SetUserID
Untuk Acara yang Anda kirim, Anda dapat mengatur UserID untuk Google Analytics agar dapat dibedakan. Data selanjutnya dikumpulkan secara terpisah di bagian Pengguna dari dasbor Google Analytics.
﻿https://support.google.com/analytics/answer/9213390

Secara default, setiap pengguna secara otomatis dikumpulkan dengan memetakan ke unit Sesi (GA4) dalam unit UserId ZEPETO.
﻿

Fungsi	Deskripsi
LogEvent	Memungkinkan Anda untuk mengirim acara kustom ke dasbor Google Analytics yang terhubung. Mendukung parameter tunggal (string, angka, boolean) dan Payload generik. Untuk Payload dalam format generik, hanya formulir yang diizinkan oleh Google Analytics yang dapat ditransfer. https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag
SetAnalyticsCollectionEnabled	Mengaktifkan/mematikan fungsi transmisi Acara dari Komponen Analitik ZEPETO. Dapat digunakan untuk kontrol dinamis. Secara default, Komponen Analitik menjadi True ketika Diaktifkan, dan False ketika Dinonaktifkan. (Waktu tinggal dasar secara otomatis dicatat dari saat Komponen Analitik ZEPETO diaktifkan.)
SendDuration	Untuk nama Acara tertentu, Anda dapat mentransfer waktu tinggal dalam milidetik (ms). Dapat digunakan untuk mencatat Waktu Keterlibatan secara manual untuk acara tertentu. (Independen dari waktu tinggal yang diukur secara otomatis.) ex) Digunakan untuk mencatat secara manual 'Saya berada di area tertentu selama 3 detik (3000 ms)'
SetUserProperty	Untuk acara yang Anda kirim, Anda dapat menambahkan properti Pengguna Kustom. https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?hl=en&client_type=gtag
SetUserID	Untuk Acara yang Anda kirim, Anda dapat mengatur UserID untuk Google Analytics agar dapat dibedakan. Data selanjutnya dikumpulkan secara terpisah di bagian Pengguna dari dasbor Google Analytics. https://support.google.com/analytics/answer/9213390 Secara default, setiap pengguna secara otomatis dikumpulkan dengan memetakan ke unit Sesi (GA4) dalam unit UserId ZEPETO.

Diperbarui 11 Oct 2024

Apakah halaman ini membantu Anda?

SEBELUMNYA

Mata Uang Dunia

BERIKUTNYA

Membangun paket dengan CLI