Skip to main content
Les clés de télémétrie (Telemetry Keys) vous permettent d’utiliser les puissantes capacités d’analytique de PlayFab en ingérant des événements de télémétrie personnalisés directement à partir de votre client de jeu. Vous pouvez maintenant utiliser l’API WriteTelemetryEvents pour simplifier l’authentification de votre client auprès de PlayFab lors de l’envoi de télémétrie. Une clé de télémétrie est un identifiant qui peut être utilisé à la place du jeton d’entité normalement requis pour appeler les API d’entité PlayFab. Cela signifie que vous pouvez utiliser les capacités d’ingestion de télémétrie de PlayFab même si aucun joueur n’est connecté. De plus, contrairement aux clés secrètes de titre, les clés de télémétrie n’accordent pas l’accès aux API d’administration; elles ne peuvent être utilisées que pour envoyer de la télémétrie. Vous pouvez partager en toute sécurité les clés de télémétrie directement avec vos clients de jeu.

​
Utiliser les clés de télémétrie

Vous pouvez gérer les clés configurées pour votre titre à partir de l’onglet Telemetry Keys de la section Data dans GameManager. Une fois que vous avez créé une clé, vous pouvez l’utiliser à partir de votre client de jeu lors de l’appel de WriteTelemetryEvents en l’incluant au moyen de l’en-tête HTTP X-TelemetryKey :
L’appelant doit fournir soit une clé de télémétrie, SOIT un jeton d’entité. Si les deux sont fournis, la clé de télémétrie sera ignorée, et la requête sera traitée comme si aucune clé n’avait été fournie.

​
Limitations

Les restrictions suivantes s’appliquent lors de l’utilisation des clés de télémétrie :
  • Un titre peut configurer jusqu’à cinq clés de télémétrie.
  • Les clés de télémétrie ne peuvent être utilisées que pour envoyer des événements de télémétrie au moyen de l’API WriteTelemetryEvents. Elles ne peuvent pas être utilisées pour envoyer des événements PlayStream au moyen de l’API WriteEvents.
  • Les titres dont la rétention Insights est réglée à plus de 30 jours ne peuvent pas configurer de clés de télémétrie pour le moment.

​
Spécifier des entités pour les événements

Les événements PlayFab indiquent le sujet de l’événement au moyen de leur propriété Entity. Lorsque vous envoyez de la télémétrie à l’aide de l’authentification par jeton d’entité, ce champ est automatiquement rempli avec les informations sur l’entité connectée. Cependant, lorsque vous utilisez une clé de télémétrie, aucune entité n’est connectée. Les événements de télémétrie envoyés à l’aide d’une clé de télémétrie ne sont donc pas autorisés à spécifier des entités intégrées PlayFab comme sujet. Lorsque vous utilisez des clés de télémétrie, vous pourriez tout de même vouloir associer vos événements de télémétrie à un sujet, par exemple un identificateur de joueur personnalisé utilisé dans votre jeu. Pour ce faire, vous pouvez spécifier une entité externe lors de la formation des événements dans votre client. Les entités externes sont simplement des entités que vous spécifiez avec type réglé à external. Elles ne font pas officiellement partie du système d’entités de PlayFab. Elles ne sont utilisées dans ce contexte que pour fournir un mécanisme pratique permettant d’associer des événements de télémétrie à des identificateurs de sujet pertinents dans votre système. Pour spécifier une entité externe comme sujet lors de la formation de l’événement dans votre code, vous devez :
  1. Régler le champ Entity.type de l’événement à external (sensible à la casse).
  2. Régler le champ Entity.id de l’événement à votre identificateur de sujet personnalisé, d’une longueur maximale de 64 caractères.
Voici un exemple qui montre comment envoyer un événement qui spécifie une entité externe :
Une fois l’événement ingéré par PlayFab, il se présente comme suit :
La propriété OriginInfo.Key de l’événement contiendra le nom de la clé utilisée pour ingérer l’événement. Si vous avez configuré plusieurs clés de télémétrie, vous pouvez utiliser cette propriété pour savoir quelle clé a été utilisée pour ingérer l’événement.
Last modified on October 6, 2026