Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CreateEventTracker
Crea un rastreador de eventos que se usa al agregar datos de eventos a un grupo de conjuntos de datos específico mediante la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
**nota**
Solo se puede asociar un único rastreador de ventas con un grupo de conjuntos de datos. Se producirá un error si llama a `CreateEventTracker` utilizando el mismo grupo de conjuntos de datos que un rastreador de eventos existente.
Al crear un rastreador de eventos, la respuesta incluye un ID de seguimiento, que se transfiere como parámetro cuando se utiliza la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)operación. A continuación, Amazon Personalize anexa los datos del evento al conjunto de datos de interacciones de elementos del grupo de conjuntos de datos que especifique en el rastreador de eventos.
El rastreador de eventos de puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Para obtener el estado del rastreador de eventos, llama [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).
**nota**
El rastreador de eventos debe estar en estado ACTIVO antes de usar el ID de seguimiento.
**Relacionado 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)
## Sintaxis de la solicitud
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que recibe los datos del evento.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Obligatorio: sí
** [name](#API_CreateEventTracker_RequestSyntax) **
El nombre del rastreador de eventos.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`
Obligatorio: sí
** [tags](#API_CreateEventTracker_RequestSyntax) **
Una lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar al rastreador de eventos.
Tipo: matriz de objetos [Tag](API_Tag.md)
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Obligatorio: no
## Sintaxis de la respuesta
```
{
"eventTrackerArn": "string",
"trackingId": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
El ARN del rastreador de eventos.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
ID del rastreador de eventos. Incluye este ID en las solicitudes a la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
## Errores
** InvalidInputException **
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
** LimitExceededException **
Se ha excedido el límite en el número de solicitudes por segundo.
Código de estado HTTP: 400
** ResourceAlreadyExistsException **
El recurso especificado ya existe.
Código de estado HTTP: 400
** ResourceInUseException **
El recurso especificado está en uso.
Código de estado HTTP: 400
** ResourceNotFoundException **
No se ha encontrado el recurso especificado.
Código de estado HTTP: 400
** TooManyTagsException **
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)