> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration des événements dans le portail

> Créez, modifiez, copiez et supprimez des définitions d'événements XBOX Live dans Partner Center afin que votre titre puisse envoyer une télémétrie qui met à jour les statistiques et les succès.

<a id="top" />

<Note>
  Cette rubrique ne s'applique que si vous utilisez des statistiques utilisateur basées sur les événements, et non des statistiques utilisateur gérées par le titre.
</Note>

<Note>
  Cette rubrique décrit des fonctionnalités disponibles uniquement avec les autorisations appropriées. Pour plus d'informations, contactez votre gestionnaire de compte ou un autre contact chez Microsoft.
</Note>

Cette rubrique décrit les procédures d'ajout et de modification d'événements dans la configuration de service de Partner Center pour un titre. Si un titre utilise des statistiques basées sur les événements, les événements constituent les données clés envoyées par le titre aux services XBOX pour mettre à jour les statistiques et les classements, et pour déverrouiller les succès.

Pour une présentation de la configuration des services XBOX, consultez [Vue d'ensemble des services XBOX](/fr/services/xbox-services/fundamentals/live-xbl-overview).

Cette rubrique couvre les points suivants :

* [Qu'est-ce qu'un événement ?](#ID4EKB)
* [Configurer un événement](#ID4EYM)
* [Créer un événement](#ID4EUB)
* [Modifier un événement](#ID4EYE)
* [Copier un événement](#ID4EBG)
* [Supprimer un événement](#ID4EBL)

<a id="ID4EKB" />

## Qu'est-ce qu'un événement ?

Un *événement* est tout ce qui se produit pendant le jeu et qui peut être *capturé*. Un joueur qui acquiert une arme constitue un événement, tout comme le fait de vaincre un ennemi avec cette arme.

Un événement se compose du nom de l'événement, d'une description de l'événement et d'un certain nombre de champs contenant des données liées à l'événement. Lorsqu'un titre écrit un événement, celui-ci est stocké sur l'appareil local jusqu'à ce qu'il puisse être envoyé aux services XBOX. Ceux-ci reçoivent l'événement et l'utilisent pour créer et mettre à jour les statistiques, les classements, les succès et les autres fonctionnalités des statistiques basées sur les événements, selon les règles que vous définissez dans la configuration de service.

Pour plus d'informations sur les événements, consultez [Vue d'ensemble des événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/live-game-events).

[Retour en haut de cette rubrique.](#top)

<a id="ID4EYM" />

## Configurer un événement

1. Connectez-vous à votre compte sur [Partner Center](https://developer.microsoft.com/dashboard/windows/overview).

2. Sélectionnez votre titre, puis sélectionnez **XBOX services** > **Gameplay settings** dans le volet de navigation de gauche.

3. Sélectionnez le lien **Player stats** > **Stat rules**.

4. Sur la page **Events and stat rules**, illustrée ci-dessous, configurez les événements et les règles de statistiques en fonction des événements.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/events-and-stat-rules-1.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=53345d0eb82e9e60332ffa25b1a14054" alt="Capture d'écran de la page Events and stat rules dans Partner Center." width="959" height="654" data-path="images/gdk/services/events-and-stat-rules-1.png" />

[Retour en haut de cette rubrique.](#top)

<a id="ID4EUB" />

## Créer un événement

1. Accédez à la page **Events and stat rules** comme décrit dans la section précédente.

2. Sélectionnez **New event**. La boîte de dialogue **Add new event** s'affiche, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-new-event-dbox.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=25f2ab8246896159d606bf501295cdff" alt="Capture d'écran de la boîte de dialogue Add new event dans Partner Center." width="800" height="532" data-path="images/gdk/services/pctr-add-new-event-dbox.png" />

3. Spécifiez les valeurs des champs suivants.

   * **Base event** : dans la liste déroulante, illustrée ci-dessous, sélectionnez l'événement de base sur lequel vous souhaitez construire votre nouvel événement. L'événement de base sélectionné détermine les champs par défaut avec lesquels votre nouvel événement est prérempli. Vous pouvez ajouter d'autres champs, mais vous ne pouvez pas supprimer les champs par défaut.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-base-event-list.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=bb49035ec3df875ea0727bef1393f243" alt="Capture d'écran de la liste Base event dans Partner Center." width="800" height="534" data-path="images/gdk/services/pctr-base-event-list.png" />

   * **Event name** : entrez un nom qui caractérise l'événement et que vous pouvez facilement mémoriser et reconnaître. Le nom de l'événement ne doit pas nécessairement correspondre au nom de l'événement de base sélectionné pour le nouvel événement. Les noms d'événements ne sont pas affichés au joueur et sont internes au code et au studio de jeu. Les noms d'événements doivent être uniques au sein d'un espace de noms de fournisseur : les studios de jeu ne peuvent pas avoir de noms d'événements en double.

   * **Description** : entrez une brève description de l'événement. Ce texte est facultatif et masqué pour le joueur. La capture d'écran suivante montre la boîte de dialogue **Add new event** avec des informations saisies dans ses champs.

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-new-event-dbox-filled-in.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=b9f6f2325b76a22de9c7ca8d6da63f4b" alt="Capture d'écran de la boîte de dialogue Add new event avec des informations saisies dans ses champs dans Partner Center." width="800" height="535" data-path="images/gdk/services/pctr-add-new-event-dbox-filled-in.png" />

   * **Event fields** :
     * Les champs de cette liste, illustrée ci-dessous, représentent les données qui seront capturées en lien avec le nouvel événement.
     * Pour ajouter un champ d'événement, sélectionnez **Add event field**, puis spécifiez le nom du champ (**Field**) et son type (**DataType**).
     * Les types de champs ont des limites de caractères. Les voici.

       * Nom du succès : 44
       * Nom de la règle de succès : 44
       * Description à l'état verrouillé : 100
       * Description à l'état déverrouillé : 100
       * Nom de la récompense dans l'application : 57
       * Description de la récompense dans l'application : 90
       * Nom de la récompense sous forme d'illustration : 57
       * Description de la récompense sous forme d'illustration : 90
       * Présence enrichie : 44
       * Nom de la statistique principale : 44

   <img src="https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-add-event-field.png?fit=max&auto=format&n=ktEik-YaZoen6Rhy&q=85&s=871e9f749f6af12e6ac3ab9408bf9195" alt="Capture d'écran de l'ajout d'un champ d'événement dans Partner Center" width="800" height="535" data-path="images/gdk/services/pctr-add-event-field.png" />

4. Sélectionnez **Save** pour créer l'événement et fermer la boîte de dialogue, comme illustré ci-dessous.

   <img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-event-dialog.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=99d9aff3f2e437f4f91988f317ab3803" alt="Capture d'écran de la boîte de dialogue Add new event avec un nouvel événement de base Basic dans Partner Center." width="597" height="631" data-path="images/gdk/services/add-event-dialog.png" />

Votre nouvel événement apparaît désormais sur la page **Events and stat rules**, comme illustré ci-dessous.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/events-and-stat-rules-2.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=1bac3e1ee375b5735643f078f684afc4" alt="Capture d'écran de la page Events and stat rules avec l'événement RecruitUnit ajouté dans Partner Center." width="1082" height="750" data-path="images/gdk/services/events-and-stat-rules-2.png" />

Maintenant que vous avez défini un événement, vous pouvez sélectionner la partie droite de la ligne **Events** pour définir une règle de statistique qui utilise cet événement. Pour plus d'informations, consultez [Configuration dans le portail des statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal).

[Retour en haut de cette rubrique.](#top)

<a id="ID4EYE" />

## Modifier un événement

<Info>
  * Une fois qu'un titre a réussi la certification finale, les événements existants de ce titre ne peuvent plus être modifiés, sauf pour ajouter de nouveaux champs d'événement.

  * Il est possible de supprimer des champs d'événement personnalisés, mais *pas* les champs d'événement par défaut fournis automatiquement lors de la création de l'événement.
</Info>

1. Sur la page **Events and stat rules**, sous **Events**, sélectionnez le nom de l'événement que vous souhaitez modifier.

2. Effectuez les modifications dans la boîte de dialogue **Update event**.

3. Sélectionnez **Save**.

[Retour en haut de cette rubrique.](#top)

<a id="ID4EBG" />

## Copier un événement

Vous pouvez créer un nouvel événement en copiant un événement existant et en modifiant ses informations.

1. Sur la page **Events and stat rules**, sous **Events**, sélectionnez **Copy** pour l'événement que vous souhaitez copier.

2. Entrez le nom (**Event name**) de votre nouvel événement.

3. Mettez à jour la description, puis ajoutez ou supprimez des champs d'événement selon les besoins.

4. Sélectionnez **Save** pour créer l'événement et fermer la boîte de dialogue.

[Retour en haut de cette rubrique.](#top)

<a id="ID4EBL" />

## Supprimer un événement

<Info>
  * Une fois qu'un titre a réussi la certification finale, les événements existants de ce titre ne peuvent plus être supprimés.

  * La suppression d'un événement supprime toutes les dépendances chaînées qu'il peut avoir. Avant de supprimer un événement, assurez-vous de vouloir également supprimer toutes ses dépendances.

  * Vous pouvez supprimer des événements pendant le développement de votre titre, mais *pas* après sa sortie de la certification finale, c'est-à-dire après le lancement de votre titre.
</Info>

1. Sur la page **Events and stat rules**, sous **Events**, sélectionnez **Delete** pour l'événement que vous souhaitez supprimer.

2. Dans la boîte de dialogue **Confirmation**, sélectionnez **Delete** ou **Cancel**.

Le diagramme suivant montre comment la suppression d'un événement supprime les dépendances chaînées.

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event_delete_dependency.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=c62fbfb172b5b3ea07af12d6aca27bf6" alt="Image d'un diagramme qui montre comment la suppression d'un événement supprime les dépendances chaînées." width="624" height="297" data-path="images/gdk/services/event_delete_dependency.png" />

[Retour en haut de cette rubrique.](#top)


## Related topics

- [Configuration des événements dans le portail](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-config-nav.md)
- [Configuration dans le portail des statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stats-eb-portal.md)
- [Configuration](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/index.md)
- [Configuration dans le portail des succès basés sur les événements](/fr/services/xbox-services/player-data/achievements/event-based/config/live-achievements-eb-config-nav.md)
- [Configuration dans le portail des classements basés sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-eb-leaderboards-portal.md)
