ZEPETO Analytics

12min

ZEPETO Analytics est un package qui rend les API statistiques faciles à utiliser.
Actuellement, Google Analytics est disponible.
👍 La spécification de Google Analytics v4 est prise en charge
﻿
ÉTAPE 1 : Installer
Fenêtre → Gestionnaire de packages → Veuillez d'abord installer la version 1.21.14 du package ZEPETO.World.
Après cela, installez le package ZEPETO Analytics.
﻿
﻿
ÉTAPE 2 : Création de flux de données Google Analytics
📘 Google Analytics
https://analytics.google.com/﻿
Après avoir créé votre compte Google Analytics, vous devez créer un flux de données à utiliser dans le Monde. (En moyenne, il faut 1 jour pour activer le compte initial.)
Il est recommandé de créer et de gérer un flux de données par WorldId.
ZEPETO Analytics envoie des données en utilisant httpService, donc veuillez vous assurer de sélectionner la plateforme 'web'.
﻿
﻿
Veuillez écrire le WorldId là où vous écrivez l'URL.
﻿
﻿
Lorsque la création du flux de données est terminée, vous pouvez vérifier l'ID de mesure.
﻿
﻿
Pour générer des valeurs de clé API, vous devez entrer dans le menu des secrets de l'API du protocole de mesure.
﻿
﻿
Après avoir appuyé sur le bouton Créer à droite, complétez l'entrée du surnom pour générer la valeur secrète.
﻿
﻿
Veuillez copier les valeurs de l'ID de mesure et de la valeur secrète pour le processus suivant.
﻿
ÉTAPE 3 : Comment utiliser
Dans la fenêtre Hiérarchie, cliquez sur l'onglet ZEPETO → Zepeto Analytics.
﻿
﻿
Un objet appelé Zepeto Analytics est automatiquement créé comme suit :
ZepetoAnalyticsComponent est le composant responsable de l'envoi des statistiques dans une scène.
Dans la fenêtre Inspecteur, vous pouvez entrer les paramètres nécessaires pour envoyer des statistiques.
ZepetoAnalytics
﻿
﻿
Veuillez sélectionner Google Analytics comme type d'analyse et entrer la clé API et l'identifiant de mesure.
﻿
﻿
Lorsque vous jouez la scène avec le composant ZEPETO Analytics ajouté, les valeurs de temps de résidence cumulatif sont automatiquement accumulées dans Google Analytics.
Vous pouvez voir la valeur du temps d'engagement dans le menu Rapports > Vue d'ensemble en temps réel. (Les éléments de rapport, à l'exception de l'onglet en temps réel, prennent un certain temps à être reflétés.)
Si la scène est changée et que le composant est supprimé, les statistiques ne seront pas envoyées. Donc, si vous souhaitez le conserver, veuillez traiter comme Ne pas détruire.
❗️ Attention
Si vous activez le mode débogage pendant le test de l'éditeur, les données ne seront pas envoyées au tableau de bord.
Lorsque vous souhaitez empiler des données, assurez-vous que le mode débogage est désactivé.
﻿
﻿
Ajout d'un événement personnalisé
Vous pouvez empiler des statistiques basées sur des événements personnalisés.
Voici un exemple de code qui envoie un événement personnalisé au tableau de bord Google Analytics lorsque vous appuyez sur un bouton.
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(() => {

            // Lorsque le bouton est cliqué, un événement aléatoire est envoyé à 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(() => {

            // Lorsque le bouton est cliqué, un événement aléatoire est envoyé à 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);
        });
    }
}
﻿
﻿
Assurez-vous de connecter les composants Zepeto Analytics après avoir écrit le script.
La capture d'écran ci-dessous est un exemple d'un composant configuré pour faire fonctionner le script d'exemple.
﻿
﻿
Dans le menu Rapports > Vue d'ensemble en temps réel, vous pouvez voir que les valeurs des événements personnalisés sont empilées en temps réel.
﻿
﻿
Activer le mode débogage
Google Analytics valide le corps de la charge utile pour l'événement personnalisé que vous envoyez. (S'il n'est pas valide, il ne sera pas envoyé)
Vérifier le mode débogage facilite la visualisation des résultats de validation pour la charge utile que vous envoyez dans la fenêtre de console.
❗️ Attention
Si vous activez le mode débogage pendant le test de l'éditeur, les données ne seront pas envoyées au tableau de bord.
Lorsque vous souhaitez empiler des données, assurez-vous que le mode débogage est désactivé.
﻿
﻿
Si vous créez un événement personnalisé qui ne correspond pas à votre spécification Google, la validation échouera en mode débogage.
﻿
﻿
Pour des informations sur les spécifications Google et le mode débogage, veuillez visiter :
📘  Pour des informations sur les spécifications Google et le mode débogage, veuillez visiter :
Pour des informations sur les spécifications Google et le mode débogage, veuillez visiter :
﻿
Google Analytics
﻿https://developers.google.com/analytics/devguides/collection/protocol/ga4/sending-events?hl=fr&client_type=gtag﻿
Outils de développement Google Analytics
﻿https://ga-dev-tools.web.app/ga4/event-builder/﻿
﻿
API ZepetoBaseAnalytics
Fonctions
Description
LogEvent
Vous permet d'envoyer des événements personnalisés au tableau de bord Google Analytics lié.

Prend en charge des paramètres uniques (chaîne, nombre, booléen) et un Payload générique.

Pour le Payload au format générique, seuls les formulaires autorisés par Google Analytics peuvent être transférés.

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

SetAnalyticsCollectionEnabled
Active/désactive la fonction de transmission des événements du composant ZEPETO Analytics. Peut être utilisé pour un contrôle dynamique.

Par défaut, le composant Analytics devient Vrai lorsqu'il est activé, et Faux lorsqu'il est désactivé.

(Le temps de résidence de base est automatiquement enregistré à partir du moment où le composant ZEPETO Analytics est activé.)
SendDuration
Pour un nom d'événement particulier, vous pouvez transférer le temps de résidence en millisecondes (ms).

Peut être utilisé pour enregistrer manuellement le temps d'engagement pour un événement spécifique. (Indépendant du temps de résidence mesuré automatiquement.)

ex) Utilisé pour enregistrer manuellement 'J'étais dans une zone spécifique pendant 3 secondes (3000 ms)'
SetUserProperty
Pour l'événement que vous envoyez, vous pouvez ajouter une propriété utilisateur personnalisée.
https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?hl=en&client_type=gtag

SetUserID
Pour l'événement que vous envoyez, vous pouvez définir l'UserID pour Google Analytics afin de faire la distinction. Les données suivantes sont collectées séparément dans la section Utilisateur du tableau de bord Google Analytics.
﻿https://support.google.com/analytics/answer/9213390

Par défaut, chaque utilisateur est automatiquement collecté en étant mappé aux unités de session (GA4) dans les unités UserId de ZEPETO.
﻿

Fonctions	Description
LogEvent	Vous permet d'envoyer des événements personnalisés au tableau de bord Google Analytics lié. Prend en charge des paramètres uniques (chaîne, nombre, booléen) et un Payload générique. Pour le Payload au format générique, seuls les formulaires autorisés par Google Analytics peuvent être transférés. https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events?client_type=gtag
SetAnalyticsCollectionEnabled	Active/désactive la fonction de transmission des événements du composant ZEPETO Analytics. Peut être utilisé pour un contrôle dynamique. Par défaut, le composant Analytics devient Vrai lorsqu'il est activé, et Faux lorsqu'il est désactivé. (Le temps de résidence de base est automatiquement enregistré à partir du moment où le composant ZEPETO Analytics est activé.)
SendDuration	Pour un nom d'événement particulier, vous pouvez transférer le temps de résidence en millisecondes (ms). Peut être utilisé pour enregistrer manuellement le temps d'engagement pour un événement spécifique. (Indépendant du temps de résidence mesuré automatiquement.) ex) Utilisé pour enregistrer manuellement 'J'étais dans une zone spécifique pendant 3 secondes (3000 ms)'
SetUserProperty	Pour l'événement que vous envoyez, vous pouvez ajouter une propriété utilisateur personnalisée. https://developers.google.com/analytics/devguides/collection/protocol/ga4/user-properties?hl=en&client_type=gtag
SetUserID	Pour l'événement que vous envoyez, vous pouvez définir l'UserID pour Google Analytics afin de faire la distinction. Les données suivantes sont collectées séparément dans la section Utilisateur du tableau de bord Google Analytics. https://support.google.com/analytics/answer/9213390 Par défaut, chaque utilisateur est automatiquement collecté en étant mappé aux unités de session (GA4) dans les unités UserId de ZEPETO.

Mis à jour 10 Oct 2024

Cette page vous a-t-elle aidée?

Monnaie mondiale

Créer des paquets avec CLI