Personalización

Cómo funciona

La personalización permite especificar las condiciones de visualización del catálogo de artículos y la aplicación de las promociones sólo para determinados usuarios autorizados.

Te permite:

• ofrecer artículos y promociones más relevantes para usuarios específicos
• con el fin de motivarles a realizar su primera compra dentro del juego

Existen los siguientes tipos de personalización:

• Personalización desde el servidor de Xsolla. Las reglas y la lógica de personalización se configuran y almacenan en el servidor de Xsolla. El socio envía los atributos del usuario a Xsolla y, luego, Xsolla crea el catálogo según la lógica configurada.
• Personalización desde el servidor del socio. Las reglas y la lógica de personalización son configuradas y almacenadas por el socio, quien luego autoriza un catálogo para un usuario específico para Xsolla.

configurar una personalización está disponible con cualquier tipo de autenticación: a través de User ID o de Xsolla Login.

Personalización desde el servidor de Xsolla

Flujo del usuario

1. El usuario no autorizado accede al catálogo de artículos. Dependiendo de si la opción Show items to unauthorized users está activada o no, el usuario ve:
   • artículos a los que no se aplican reglas de personalización
   • todos los artículos, incluidos los que tienen reglas de personalización
2. El usuario hace clic en Log in y se autoriza a través de Xsolla Login o de ID de usuario.

3. Xsolla solicita los atributos del usuario a través de Xsolla Login o mediante webhook.
4. Xsolla muestra un catálogo personalizado basándose en las reglas de disponibilidad del artículo, las promociones establecidas en el lado de Xsolla y en los atributos del usuario obtenidos en el paso 3.

5. El usuario ve el catálogo personalizado y pulsa en Buy Now.

6. En el momento de la compra, Xsolla vuelve a solicitar los atributos del usuario y los compara con las reglas de personalización:
   • Si un artículo ya no está disponible para su compra, al usuario se le notifica que no puede comprarlo.
   • Si el artículo está disponible para su compra, el usuario se dirige a la pasarela de pago.

Configurar un catálogo de artículos personalizados

1. Configure los atributos de usuario.
2. Habilite la personalización.
3. Establezca las reglas de visualización del catálogo. Puede hacerlo activando la personalización o en un proyecto de Cuenta del editor en la sección Store > Catalog management > Catalog display rules.

Para activar la personalización:

1. Abra su proyecto en Cuenta del editor y vaya a Store > Personalization.
2. Si la personalización no está configurada, haga clic en Set up personalization.
3. Seleccione el tipo Xsolla side personalization.
4. Haga clic en Next.

5. Cree una regla de visualización de catálogo:
   • Si no hay reglas de visualización de catálogo todavía, se abrirá automáticamente la ventana para crear reglas.
   • Si ya existen reglas de visualización de catálogo, en la sección Catalog display rules, haga clic en Create rule.

6. Indique el nombre de la regla y defina las condiciones para mostrar los artículos en el catálogo.

7. Para que los artículos con reglas aplicadas se muestren a los usuarios no autorizados, active la opción Show affected items to users who haven’t logged in.

8. Haga clic en Next.
9. Seleccione los artículos a los que se aplicará la regla.

10. Haga clic en Next.
11. Compruebe la configuración. Si es necesario, haga clic en el botón Edit para realizar cambios.

12. Haga clic en Save and exit.

Para editar o eliminar reglas, vaya a la página Catalog display rules, haga clic en el icono ••• de la fila de la regla y seleccione la opción de menú deseada. Para activar o desactivar una regla, cambie su estado.

Establecer atributos

Establezca los atributos de usuario en el producto Login y mantenga actualizados los valores de los atributos: actualice los valores de atributos en Xsolla cuando se modifiquen para el usuario en el juego.

La secuencia de actualización de atributos depende de la opción de autorización de usuarios empleada en Web Shop.

Configurar promociones personalizadas

Puede configurar promociones personalizadas, como ofrecer descuentos en la compra de artículos virtuales a los usuarios que tengan, al menos, un determinado nivel en el juego.

Puede establecer una o varias condiciones. Tenga en cuenta que mientras la promoción esté activa, no podrá modificarlas. Lea Configurar campañas promocionales para obtener más información sobre los tipos de promociones y su configuración.

Para configurar promociones personalizadas:

1. Configurar atributos de usuario en el producto Inicio de sesión.
2. Configure una campaña promocional con bonificaciones o una campaña con descuentos. Establezca el conmutador Trigger promotion only for specific users en On y especifique las condiciones.

Personalización desde el servidor del socio

Elija este tipo si utiliza una lógica de personalización avanzada implementada por su parte y no quiere establecer reglas o especificar atributos en el lado de Xsolla.

Para utilizar la personalización de catálogo de artículos implementada por su parte:

1. Cree un catálogo de artículos en el lado de Xsolla y sincronícelo con su catálogo. Cada artículo en su sistema debe tener su item_id o SKU correspondiente en Xsolla.
2. Active la personalización en Cuenta del editor.
3. Configure el procesamiento de la personalización del catálogo en el webhook del socio.

Flujo del usuario

1. El usuario no autorizado accede al catálogo de artículos. Dependiendo de si la opción Show relevant items to users who haven’t logged in está activada o no, el usuario ve:
   • todos los artículos del catálogo
   • los artículos que devuelve en respuesta al webhook Personalización del catálogo en el lado del socio

El orden en el que se muestran los artículos al usuario depende de si la opción Get sku order via webhook response está activada o no.

2. El usuario hace clic en Log in y autoriza.

3. Xsolla envía un webhook que solicita artículos por ID de usuario.
4. La respuesta del socio devuelve una lista de SKU de artículos disponibles para este usuario.
5. El usuario selecciona un artículo del catálogo personalizado y hace clic en Buy now.

6. En el lado de Xsolla, se ejecutan los pasos 3 y 4 de este flujo para comprobar la disponibilidad de los artículos en el momento de la compra:
   • Si un artículo ya no está disponible para su compra, el usuario recibe un mensaje indicándole que no puede comprarlo.
   • Si el artículo está disponible, el usuario procede al pago.

Configurar un catálogo de artículos personalizados

Para activar la personalización:

1. Abra su proyecto en Cuenta del editor y vaya a Store > Personalization.
2. Si la personalización no está configurada, haga clic en Set up personalization.
3. Seleccione el tipo Partner side personalization.

4. Haga clic en Next.
5. Configure la visualización de artículos. Para ello, habilite los botones correspondientes:
   • Show relevant items to users who haven’t logged in: para mostrar a los usuarios no autorizados solamente los artículos devueltos en respuesta al webhook Personalización del catálogo en el lado del socio.
   • Get SKUs order via webhook response: para mostrar los artículos al usuario en el orden que transmita en respuesta al webhook Personalización del catálogo en el lado del socio. Si la opción no está activa, los artículos se mostrarán al usuario en el orden establecido en el lado de Xsolla. Para establecer o recuperar el orden de visualización de los artículos en el lado de Xsolla, utilice el parámetro order en la subsección Admin del grupo Virtual items and currency.

6. Haga clic en Save changes.

Configuración del procesamiento de webhooks

Xsolla enviará un webhook Personalización del catálogo en el lado del socio que contiene los parámetros de usuario y proyecto a la URL del webhook cuando un usuario interactúe con el catálogo de artículos. Configure el procesamiento de webhooks:

1. En su proyecto en Cuenta del editor, vaya a Project settings > Webhooks e introduzca la URL para enviar webhooks. Este paso es opcional si ya ha establecido webhooks.
2. Como respuesta, debe devolver una lista de SKU de artículos disponibles para el usuario. En este caso, también puede incluir información sobre límites de compra por artículo o periodos de disponibilidad específicos. Esta función le permite controlar el número y el tipo de artículos disponibles para el usuario.

Todas las solicitudes enviadas a Xsolla para recuperar el catálogo generan una nueva solicitud de Xsolla al servidor de juegos. Xsolla usa el almacenamiento en caché de datos para reducir el número de solicitudes al servidor de juegos y envía el webhook partner_side_catalog cuando termina la vida útil de la memoria caché.

Si la memoria caché aún no está llena, el webhook partner_side_catalog se envía con cada solicitud realizada a Xsolla. Por ejemplo, Xsolla recibe varias solicitudes de catálogo de forma simultánea y el servidor de juegos responde con demora.

Para probar el webhook, puede consultar el catálogo de artículos. Recibirá como respuesta un webhook en la URL configurada.

Cambiar el tipo de personalización

Configuración en Web Shop

Para mostrar artículos con la personalización configurada en Web Shop:

1. En su proyecto en Cuenta del editor, vaya a la sección Site Builder.
2. En el panel del sitio de su Web Shop, haga clic en Open Site Builder.
3. En el bloque Store, acceda a la sección Store.
4. En los campos Item type y Item group, seleccione los artículos con la personalización configurada.
5. Para aplicar los cambios, publique su sitio web.

Última actualización: 21 de Marzo de 2025