如何通过启动器安装程序传输用户数据
运行机制
您可以通过启动器安装程序将用户数据从网站发送到游戏，例如以下数据：
- 用于跟踪促销活动的信息或启动器安装程序下载的来源。
- 具有一定有效期的数据。用于游戏中的自定义身份认证或重要游戏相关信息的发送。
适用对象
集成了启动器和登录管理器并连接了OAuth 2.0身份认证的合作伙伴。
如何获取
要启用用户数据传输，请实现以下项：
获取一次性密码
要实现一次性密码的获取，请向URL地址https://launcher.xsolla.com/otp发送POST请求。在请求正文中，传入具有以下参数的JSON：tracking_payload— 具有一定有效期的用户数据。最大字符串长度是255个字符。common_payload— 具有一定有效期的用户数据。这些数据可被覆写。最大字符串长度是255个字符。expires_in—common_payload参数中传入的数据有效期，格式为Unix时间，单位为毫秒。如发送了common_payload，则此参数为必需。
Copy
curl
-X POST
"https://launcher.xsolla.com/otp?common_payload=<common_payload>"
-H
"accept: application/json"
-H
"Content-Type: application/json"
注：
如使用了
tracking_payload、common_payload或expires_in参数，它们的值不能为空。tracking_payload作为查询参数传入。Copy
curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" -H "accept: application/json" -H "Content-Type: application/json"
将一次性密码添加到安装程序的名称中
收到的一次性密码是UUID格式的36个字符长度的字符串。请实现下载时将一次性密码添加到安装文件名称中，格式如下：LauncherName_<OTP>.exe，其中<OTP>是一次性密码。游戏检索用户数据
启动器将tracking_payload参数中收到的数据作为–tracking_payload命令行参数的值传入，如下例所示。它还会检查common_payload参数中是否存在数据及其有效期，并将这些数据作为–xsolla-common-payload命令行参数的值传入，如下例所示。Copy
game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
注：
每次游戏启动时，启动器将用户数据发送给游戏。
tracking_payload参数中收到数据以查询参数tracking_payload值的形式传递，如下例所示。Copy
https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
tracking_payload参数以UTF-8编码的格式传入。要进行解码，请在游戏侧实现执行decodeURIComponent(<tracking_payload>)函数。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
