Cómo transferir datos de usuario a través del instalador del lanzador

Cómo funciona

Puede transferir datos de usuario del sitio web al juego a través del instalador del lanzador, por ejemplo:

• Información para hacer seguimiento de promociones o el origen de la descarga del instalador del lanzador.
• Datos con una vida útil limitada. Utilizados para la autenticación personalizada en el juego y la transferencia de información crítica relativa al juego.

¿Quién puede utilizarlo?

Socios que ya han integrado Launcher y Login, y han conectado la autenticación OAuth 2.0.

Cómo conseguirlo

Para posibilitar la transferencia de datos de usuario, implemente los siguientes pasos:

1. Recuperación de una contraseña de un solo uso.
2. Añadir la contraseña de un solo uso al nombre del instalador.
3. Procesamiento de los datos de usuario transmitidos al juego (opcional).

Recuperación de una contraseña de un solo uso

Para implementar la obtención de una contraseña de un solo uso, haga una solicitud POST a la dirección URL https://launcher.xsolla.com/otp. En el cuerpo de la solicitud, transmita un JSON con los siguientes parámetros:

• tracking_payload - datos de usuario con una vida útil ilimitada. La longitud máxima de la cadena (string) es de 255 caracteres.
• common_payload - datos de usuario con una vida útil limitada. Estos datos pueden sobrescribirse. La longitud máxima de la cadena es de 255 caracteres.
• expires_in - la vida útil de los datos transmitidos en el parámetro common_payload en el formato tiempo Unix, en milisegundos. Obligatorio si se está transmitiendo common_payload.

1curl -X POST "https://launcher.xsolla.com/otp?common_payload=<common_payload>" \
2  -H "accept: application/json" \
3  -H "Content-Type: application/json"

1curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" \
2  -H "accept: application/json" \
3  -H "Content-Type: application/json"

Agregar la contraseña de un solo uso al nombre del instalador

La contraseña de un solo uso recibida es un string de 36 caracteres en formato UUID. Añada la contraseña de un solo uso al nombre del archivo de instalación cuando realice la descarga con el siguiente formato: LauncherName_<OTP>.exe, en el cual <OTP> es la contraseña de un solo uso.

Recuperación de los datos de usuario realizada por el juego

El lanzador transmite los datos recibidos en el parámetro tracking_payload como valor del argumento de línea de comandos –tracking_payload, como se muestra en el siguiente ejemplo. También comprueba la presencia y vida útil de los datos transmitidos en el parámetro common_payload y los transmite como el valor del argumento de línea de comandos –xsolla-common-payload, como se muestra en el siguiente ejemplo.

1game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=

1https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>

El parámetro tracking_payload se transmite en codificación UTF-8. Para descodificarlo, ejecute la función decodeURIComponent(<tracking_payload>) en el lado del juego.