> ## 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.

# Piwik PRO Audiences

> Utilice los segmentos de audiencia de Piwik PRO como condiciones de segmentación en los experimentos y personalizaciones de Kameleoon mediante un puente de datos personalizados.

Piwik PRO agrupa a sus visitantes en audiencias que usted define en Piwik PRO, a las que los scripts de este artículo llaman segmentos. Kameleoon no puede usar esas audiencias hasta que los segmentos de cada visitante lleguen a su proyecto de Kameleoon. Esta integración establece los segmentos de cada visitante como datos personalizados en Kameleoon, de modo que pueda seleccionar las audiencias en un segmento y hacer coincidir a los visitantes con ellas.

## Cómo encajan las audiencias de Piwik PRO en su flujo de trabajo

* **Recuperar los segmentos:** Añada el global custom script para que los segmentos de Piwik PRO de cada visitante lleguen a Kameleoon.
* **Crear los datos personalizados:** Cree los datos personalizados de los segmentos de Piwik PRO y añada la lista de segmentos a ellos.
* **Crear un segmento:** Oriente a los visitantes a una o más audiencias de Piwik PRO.
* **Usar los segmentos en Feature Experimentation:** Almacene los segmentos de cada visitante en Kameleoon y léalos con un SDK.

## Antes de empezar

* **Cuenta de Piwik PRO:** una cuenta de Piwik PRO activa con las audiencias que quiere usar.
* **Credenciales de Piwik PRO:** un `client_id` y un `client_secret` para generar un token de portador, como se describe en la referencia de [Piwik PRO authentication](https://developers.piwik.pro/reference/authentication). También necesita su `website_id`, que Piwik PRO llama ID del sitio o de la aplicación. Para encontrarlo, consulte [el artículo de ayuda de Piwik PRO sobre los ID de sitio o de aplicación](https://help.piwik.pro/analytics/how-do-i-find-the-website-id-also-called-idsite-or-site-id/). Los scripts de este artículo usan solo `client_id` y `website_id`.
* **Tracker de Piwik PRO:** su sitio carga el tracker de Piwik PRO, que proporciona el objeto `_paq` que espera el global custom script.
* **Etiqueta de Kameleoon:** su sitio carga la etiqueta de Kameleoon, que proporciona los métodos `Kameleoon.API` que llaman los scripts.

## Recuperar los segmentos de Piwik PRO de cada visitante

El global custom script se ejecuta en cada página donde se carga la etiqueta de Kameleoon. Espera a que se cargue el tracker de Piwik PRO y, después, solicita los segmentos del visitante a un servicio web de Kameleoon.

El script solicita los segmentos solo después de que se cargue el tracker. Si el tracker nunca se carga, el script no establece segmentos para el visitante.

### Añadir el global custom script

Añada el script al global custom script de su proyecto, para que Kameleoon recupere los segmentos de Piwik PRO de cada visitante.

1. Haga clic en **Admin** > **Projects**, y luego en **Edit** en la fila de su proyecto.

2. Haga clic en la pestaña **Scripts**, y después en **Edit** junto a **Global custom script**.

   ![La pestaña Scripts con los editores Global custom script y Variation selection script](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/manage-your-projects/project-scripts.png)

3. Pegue el siguiente script en el editor **Global custom script** y reemplace los marcadores de posición `client_id` y `website_id` por sus valores.

   ```javascript theme={null}
   const getPiwikProSegments = (visitorID) => {
       const clientID = 'Replace this with your client_id';
       const websiteID = 'Replace this with your website_id';
       const xhr = new XMLHttpRequest();
       xhr.onload = function run() {
           if (this.status === 200) {
               Kameleoon.API.Data.setCustomData(
                   'Piwik PRO segments',
                   JSON.parse(xhr.response)
               );
           }
       };
       xhr.open('GET', `https://customers.kameleoon.com/kameleoon/piwik/user/${visitorID}?id=${clientID}&website_id=${websiteID}`, true);
       xhr.send();
   };

   Kameleoon.API.Core.runWhenConditionTrue(() => typeof _paq !== 'undefined', () => {
       _paq.push([function init() {
           getPiwikProSegments(this.getVisitorId());
       }]);
   });
   ```

4. Haga clic en **Save changes**.

Después de que un visitante cargue una página con el tracker de Piwik PRO, el script establece los datos personalizados **Piwik PRO segments** para ese visitante. Si la solicitud al servicio web de Kameleoon falla, el script no establece datos personalizados para esa página.

## Crear datos personalizados para los segmentos de Piwik PRO

Los datos personalizados tienen dos partes. El script global los llena con los segmentos de cada visitante, y un segundo script enumera cada segmento como opción en el Segment Builder. Como los datos personalizados usan el ámbito **Page**, Kameleoon restablece su valor en cada página nueva, por lo que el script global vuelve a establecer los segmentos cada vez que se carga una página.

### Crear los datos personalizados

Cree los datos personalizados que el global custom script llena con los segmentos de cada visitante.

1. Haga clic en **Settings** > **Custom Data**, y después en **New custom data**.
2. Escriba `Piwik PRO segments` como nombre y seleccione su proyecto. El script global establece los datos personalizados con este nombre, por lo que debe escribirlo exactamente igual.
3. Mantenga **Retrieval method** configurado en **Kameleoon Activation API**, que es el valor predeterminado.
4. Establezca **Type** en **List**, **Format** en **String** y **Scope** en **Page**. Con el ámbito **Page**, Kameleoon restablece el valor en cada página nueva, y el script global lo vuelve a establecer cuando se carga la página.
5. Haga clic en **Next** para abrir las opciones.

Kameleoon guarda los datos personalizados al hacer clic en **Create** en el paso de opciones.

### Añadir la lista de segmentos a los datos personalizados

Añada el script que devuelve los segmentos de Piwik PRO como valores de los datos personalizados.

1. Active **Save the values for the targeting condition associated with the custom data point**. Aparece un campo de código.

2. Pegue el siguiente script en el campo de código y reemplace los marcadores de posición `client_id` y `website_id` por sus valores.

   ```javascript theme={null}
   let segmentPW = [];
   const clientID = 'Replace this with your client_id';
   const websiteID = 'Replace this with your website_id';

   const xhr = new XMLHttpRequest();
   xhr.onreadystatechange = function check() {
       if (this.readyState === 4) segmentPW = JSON.parse(xhr.response);
   };
   xhr.open('GET', `https://customers.kameleoon.com/kameleoon/piwik/segments/?id=${clientID}&website_id=${websiteID}`, false);
   xhr.send();
   return segmentPW;
   ```

3. Haga clic en **Create**.

![El paso Options de los datos personalizados de Piwik PRO segments, con el script en el campo de código y el botón Create.](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/integrations/as-a-source/analytics/piwik-pro-audiences/piwik-pro-audiences-custom-data-options-zoom2.png)

El Segment Builder muestra los segmentos de Piwik PRO como valores, para que pueda seleccionarlos al crear un segmento.

## Crear un segmento a partir de las audiencias de Piwik PRO

Cree un segmento que oriente a los visitantes que pertenecen a una o más audiencias de Piwik PRO.

1. Haga clic en **Settings** > **Segments**, y después en **New segment**.
2. En la columna **Conditions**, abra la pestaña **Custom data** y seleccione **Piwik PRO segments**.
3. Seleccione la condición **is among the values** y, después, las audiencias que quiere orientar.
4. Elija si incluir o excluir a los visitantes que cumplen la condición.

El segmento se guarda en la lista **Segments**, donde puede seleccionarlo para un experimento o una personalización.

Para obtener más información sobre los segmentos, consulte [Crear un segmento](https://docs.kameleoon.com/es/user-manual/assets/segments/create-a-segment.md).

## Usar las audiencias de Piwik PRO en Feature Experimentation

El global custom script se ejecuta en el navegador, por lo que los segmentos que establece no están disponibles para los feature flags que evalúan los SDK de Kameleoon. Para usar las audiencias de Piwik PRO en un feature flag, almacene los segmentos de cada visitante en los servidores de Kameleoon y, después, léalos con un SDK.

### Almacenar y leer los segmentos con un SDK

Almacene los segmentos de cada visitante en Kameleoon y, después, establézcalos como datos personalizados en el código de su SDK.

1. Envíe los segmentos de cada visitante al endpoint Map de la Data API, usando el código de visitante o un ID de usuario como clave. Consulte la [referencia del endpoint Map](https://docs.kameleoon.com/api-reference/map/update-data-for-several-keys.md).
2. Haga clic en **Settings** > **Custom Data**, y después en **New custom data**. Escriba un nombre para los datos personalizados, por ejemplo `Piwik PRO audiences`, y seleccione su proyecto.
3. Establezca **Retrieval method** en **Kameleoon SDK method**, **Type** en **List** y **Format** en **String**. Elija el **Scope** que se ajuste a su feature flag.
4. En el código de su SDK, llame a `getRemoteData()` con el código del visitante o el ID de usuario, lea los segmentos del JSON devuelto y establézcalos con `addData()`.

Después de que el SDK establezca el valor, los datos personalizados contienen los segmentos del visitante, que puede seleccionar en un segmento. Para más detalles, consulte [Usar datos externos para segmentar usuarios](https://docs.kameleoon.com/es/developer-docs/feature-experimentation/targeting-and-segmentation/use-external-data-to-target-users.md).
