Cette page n’est pas encore traduite : la version anglaise est affichée.

Analytics

Tout ce qui doit être compté plus tard plutôt que vu tout de suite. Déclarez un événement de télémétrie typé, émettez-le, et il rejoint ceux de la plateforme : un niveau terminé, une étape d’entonnoir, un événement économique, la durée d’une session, un abandon pendant le tutoriel. Ce module émet ; il ne lit, n’agrège et n’expédie rien lui-même. La destination d’un lot relève du routeur, dans Extensibility.

Quand l’utiliser

• Quelque chose doit être compté plus tard : une étape d’entonnoir (funnel), un niveau terminé, un événement économique, la durée d’une session.
• La comparaison doit tenir d’un build à l’autre : un type porte une version de schéma, si bien qu’un entonnoir vieux d’un an ne mélange pas en silence deux sens d’un même champ.
• Le volume est élevé, et une ligne perdue est acceptable si vous l’avez dit : la télémétrie est le seul endroit du contrat où une perte déclarée est légitime.
• Inutile si quelqu’un doit réagir. Un événement de télémétrie n’a aucun abonné ; un fait que d’autres doivent entendre est un événement de jeu.

Qui fait quoi

En bref

[Event("boss_defeated")]
public class BossDefeated
{
    public string BossId = "";
    public int PartySize;
    public float FightSeconds;
}

PlayServ.Analytics.Emit(new BossDefeated { BossId = "hydra", PartySize = 4, FightSeconds = 212f });

@Event('boss_defeated')
export class BossDefeated {
  bossId = '';
  partySize = 0;
  fightSeconds = 0;
}

PlayServ.analytics.emit(new BossDefeated({ bossId: 'hydra', partySize: 4, fightSeconds: 212 }));

@event("boss_defeated")
class BossDefeated:
    boss_id: str = ""
    party_size: int = 0
    fight_seconds: float = 0.0

playserv.analytics.emit(BossDefeated(boss_id="hydra", party_size=4, fight_seconds=212.0))

USTRUCT(PSEvent = (Name = "boss_defeated"))
struct FBossDefeated
{
    GENERATED_BODY()

    UPROPERTY() FString BossId;
    UPROPERTY() int32   PartySize;
    UPROPERTY() float   FightSeconds;
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

// the declared type becomes a generated member under the Emit node
Client->Analytics->Emit->BossDefeated({ TEXT("hydra"), /*PartySize*/ 4, /*FightSeconds*/ 212.f });
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

[Event("boss_defeated")]
public class BossDefeated
{
    public string BossId = "";
    public int PartySize;
    public float FightSeconds;
}

PlayServ.Analytics.Emit(new BossDefeated { BossId = "hydra", PartySize = 4, FightSeconds = 212f });

La définition fait partie du schéma : ce qui arrive porte donc des champs nommés et typés, pas un blob JSON. Elle est déclarée comme un type à part entière, et non comme un événement de jeu muni d’un indicateur.

Le modèle

Ce que déclare un type d’événement de télémétrie.

Ce qui vaut pour tout événement de télémétrie.

Erreurs

• Un type non déclaré, ou un champ qui ne correspond pas au schéma du type, donne un refus de validation ; ni l’un ni l’autre n’est une surprise à l’exécution, puisqu’un type arrive dans la console d’administration à partir de sa déclaration.
• Un événement trop volumineux est un refus de validation ; les champs ne sont jamais tronqués en silence.
• La fréquence dépassée répond dans la catégorie rate limit, avec l’instant avant lequel réessayer ne sert à rien.
• Un rejet par échantillonnage n’est pas une erreur, pas plus qu’une perte admise. L’appel a été exécuté et le rejet est un comportement déclaré ; signaler l’un ou l’autre comme un échec rendrait le comportement déclaré impossible à distinguer d’une panne.
• Un lot est traité en entier ou élément par élément, et le choix est déclaré : jamais « selon ce qui s’est passé ».

Limites

Les chiffres arriveront avec le chapitre sur les limites de la plateforme ; ce qui se passe à chaque plafond est déjà fixé.

• La fréquence d’événements par acteur : un refus pour limite de débit, avec un délai. Un dépassement n’entraîne jamais de rejet silencieux : c’est soit ce refus, soit un rejet par échantillonnage déclaré.
• La taille d’un événement : un refus de validation, jamais des champs tronqués en silence.
• La taille d’un lot : rejeté avant l’envoi plutôt qu’appliqué en partie.
• Les types déclarés par projet : une nouvelle déclaration est rejetée au déploiement, pas à l’exécution.
• Les champs d’un type : de même, au déploiement.
• La durée de rétention : au-delà de la durée déclarée, l’événement n’est plus disponible.