Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# CreateEventTracker
Crée un outil de suivi des événements que vous utilisez lorsque vous ajoutez des données d'événements à un groupe de jeux de données spécifié à l'aide de l'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
**Note**
Un seul dispositif de suivi d'événement peut être associé à un groupe d'ensembles de données. Vous obtenez une erreur si vous appelez `CreateEventTracker` à l'aide du même groupe d'ensembles de données qu'un dispositif de suivi d'événement existant.
Lorsque vous créez un suivi d'événements, la réponse inclut un identifiant de suivi, que vous transmettez en paramètre lorsque vous utilisez l'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)opération. Amazon Personalize ajoute ensuite les données de l'événement au jeu de données sur les interactions entre articles du groupe de données que vous spécifiez dans votre outil de suivi des événements.
Le système de suivi des événements peut se trouver dans l'un des états suivants :
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -ou- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Pour connaître l'état du suivi des événements, appelez [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).
**Note**
Le suivi des événements doit être à l'état ACTIF avant d'utiliser l'identifiant de suivi.
**Relié APIs**
+ [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html)
+ [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)
+ [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html)
## Syntaxe de la requête
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
Le nom de ressource Amazon (ARN) du groupe de données qui reçoit les données de l'événement.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`
Obligatoire : oui
** [name](#API_CreateEventTracker_RequestSyntax) **
Nom de l'outil de suivi des événements.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.
Modèle : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`
Obligatoire : oui
** [tags](#API_CreateEventTracker_RequestSyntax) **
Une liste de [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer au suivi des événements.
Type : tableau d’objets [Tag](API_Tag.md)
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : non
## Syntaxe de la réponse
```
{
"eventTrackerArn": "string",
"trackingId": "string"
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
L'ARN du suivi des événements.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
L'identifiant du suivi des événements. Incluez cet ID dans les demandes adressées à l'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
## Erreurs
** InvalidInputException **
Entrez une valeur valide pour le champ ou le paramètre.
Code d’état HTTP : 400
** LimitExceededException **
La limite du nombre de demandes par seconde a été dépassée.
Code d’état HTTP : 400
** ResourceAlreadyExistsException **
La ressource spécifiée existe déjà.
Code d’état HTTP : 400
** ResourceInUseException **
La ressource spécifiée est en cours d'utilisation.
Code d’état HTTP : 400
** ResourceNotFoundException **
Impossible de trouver la ressource spécifiée.
Code d’état HTTP : 400
** TooManyTagsException **
Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)