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

# Amplitude Event Streaming como fuente

> Envíe eventos de Amplitude a Kameleoon para que Kameleoon cree objetivos y registre conversiones de los visitantes de sus experimentos.

Es posible que su equipo ya haga seguimiento de las acciones de los usuarios en Amplitude, y recrear ese plan de seguimiento en Kameleoon consume tiempo de desarrolladores. Esta integración envía a Kameleoon sus eventos de Amplitude. Kameleoon crea un objetivo personalizado con el nombre de cada evento y registra una conversión para el visitante correspondiente. No necesita escribir código para activar estos objetivos, pero sí debe pasar el código de visitante de Kameleoon a Amplitude para que cada evento coincida con un visitante.

## Cómo encaja la integración en su flujo de trabajo

* **Conectar Amplitude con Kameleoon:** Genere una clave de API REST, busque su sitecode y [cree una sincronización en Amplitude](https://amplitude.com/docs/data/destination-catalog/kameleoon) que envíe sus eventos a Kameleoon.
* **Hacer coincidir los usuarios de Amplitude con los visitantes de Kameleoon:** Pase el código de visitante de Kameleoon a Amplitude con cada evento.
* **Gestionar los objetivos creados a partir de eventos de Amplitude:** Busque y renombre los objetivos que Kameleoon crea a partir de eventos de Amplitude.

## Antes de empezar

* **Plan de pago:** un plan de pago de Kameleoon, que requiere la integración.
* **Clave de API REST:** la clave que permite a Amplitude enviar eventos a su proyecto. Se genera a partir de su client ID y su client secret.
* **Sitecode:** el identificador del proyecto de Kameleoon que recibe los eventos. Puede [encontrarlo en el panel de su proyecto](https://docs.kameleoon.com/es/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode).
* **Proyectos de Amplitude:** cada proyecto de Amplitude que envíe eventos necesita su propio destino habilitado.

## Conectar Amplitude con Kameleoon

Amplitude envía eventos a Kameleoon a través de un destino que usted crea en Amplitude. El destino necesita su clave de API REST y su sitecode, que identifican su proyecto de Kameleoon. Amplitude envía todas las propiedades de usuario, de evento y de grupo con cada evento. Kameleoon acepta datos de eventos de hasta 1 MB por evento.

### Generar una clave de API REST

Genere una clave de API REST a partir de su client ID y su client secret.

1. Copie su `client_id` y su `client_secret` de la página de [Credenciales de API](https://docs.kameleoon.com/es/user-manual/account-and-team-management/users-and-teams/api-credentials.md). Si no tiene un client secret, haga clic en **Generate a new Client-Secret key** en esa página.
2. Abra la siguiente URL en un navegador y reemplace `CLIENT_ID` y `CLIENT_SECRET` por sus valores.

   ```
   https://customers.kameleoon.com/kameleoon/amplitude/getapikey?id=CLIENT_ID&secret=CLIENT_SECRET
   ```

Tenga la clave preparada para la configuración del destino de Amplitude.

### Obtener su sitecode

Busque el sitecode del proyecto de Kameleoon que recibe los eventos. Puede encontrarlo en el panel del proyecto. Consulte [Encontrar su sitecode](https://docs.kameleoon.com/es/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode) para saber dónde se encuentra.

### Configurar el destino de Amplitude

Configure el destino en Amplitude, no en la aplicación de Kameleoon. Siga la [guía de Amplitude para el destino de Kameleoon](https://amplitude.com/docs/data/destination-catalog/kameleoon) para crear la sincronización. Cuando Amplitude le pida la clave de API REST de Kameleoon y el sitecode, use los valores de los pasos anteriores.

La tarjeta **Amplitude** en **Admin** > **Integrations** es una integración independiente, etiquetada como Destination. Envía a Amplitude los resultados de experimentos de Kameleoon, y en ella no configura la transmisión de eventos.

## Hacer coincidir los usuarios de Amplitude con los visitantes de Kameleoon

Kameleoon solo puede atribuir un evento de Amplitude a un visitante cuando ambas herramientas identifican a ese visitante con el mismo valor. Si su proyecto usa experimentos o personalizaciones de Kameleoon, Kameleoon coloca una cookie para cada visitante que almacena un identificador único anónimo: el código de visitante de Kameleoon. Elija una de las siguientes opciones para pasar ese código a Amplitude:

* **Opción 1:** Pase el código de visitante como `userId` del evento de Amplitude. Kameleoon atribuye entonces todos los datos del evento de Amplitude al visitante correcto.
* **Opción 2:** Establezca la propiedad de usuario `kameleoon_visitorcode` en los eventos de Amplitude. Su valor es el código de visitante.

Si su proyecto usa Feature Experimentation, establezca su propio ID en el SDK de Kameleoon en lugar del código de visitante generado. Consulte la [descripción general de Feature Experimentation](https://docs.kameleoon.com/es/developer-docs/feature-experimentation/get-started/overview.md) para saber cómo establecer su propio ID en el SDK.

### Usar el código de visitante como ID de usuario de Amplitude

Establezca el ID de usuario de Amplitude con el código de visitante mediante el Amplitude Browser SDK.

```javascript theme={null}
amplitude.setUserId(Kameleoon.API.Visitor.code);
```

### Almacenar el código de visitante en una propiedad de usuario

Establezca la propiedad de usuario `kameleoon_visitorcode` con el código de visitante en cada llamada posterior de Amplitude.

```javascript theme={null}
const visitorcode = Kameleoon.API.Visitor.code;

const identifyEvent = new amplitude.Identify();
identifyEvent.set('kameleoon_visitorcode', visitorcode);

amplitude.identify(identifyEvent);
```

## Gestionar los objetivos creados a partir de eventos de Amplitude

Cuando Kameleoon recibe un evento de Amplitude que no tiene un objetivo correspondiente, crea un [objetivo personalizado](https://docs.kameleoon.com/es/user-manual/assets/goals/create-a-goal.md#objetivo-personalizado) llamado `Amplitude - <event name>`. Kameleoon etiqueta cada objetivo que crea con `amplitude`. Kameleoon crea como máximo 50 objetivos en cualquier periodo de 10 segundos y como máximo 1 000 objetivos en cualquier periodo de 60 minutos.

### Encontrar los objetivos creados a partir de eventos de Amplitude

Filtre los objetivos por la etiqueta `amplitude` para listar los que crearon los eventos de Amplitude.

1. Abra el panel de **Goals**.
2. Filtre los objetivos por la etiqueta `amplitude` en el panel lateral.

### Renombrar los objetivos creados automáticamente

Kameleoon encuentra el objetivo de un evento de Amplitude por su nombre. Si renombra un objetivo, Kameleoon ya no podrá encontrarlo, por lo que el siguiente evento creará un objetivo nuevo con el nombre del evento de Amplitude. Las conversiones registradas antes del cambio de nombre permanecen en el objetivo anterior.

Para mantener las conversiones en un solo objetivo, renombre el evento de Amplitude para que coincida con el nuevo nombre del objetivo. Si renombra un evento de Amplitude, renombre también su objetivo para que coincida con el nuevo nombre del evento.

### Convertir objetivos automáticamente

Kameleoon convierte un objetivo cuando Amplitude envía el evento asociado. Si el nombre de un evento de Amplitude coincide exactamente con el nombre de un objetivo existente en su cuenta de Kameleoon, Kameleoon asocia cada conversión a ese objetivo, tanto si Kameleoon lo creó como si no. No necesita llamar a la API de Activación ni a un SDK para convertir estos objetivos, ni añadir código de frontend o de backend para activarlos.
