런처 설치 프로그램을 통해 사용자 데이터를 전송하는 방법
작동 방식
런처 설치 프로그램을 통해 웹사이트에서 게임으로 사용자 데이터를 전송할 수 있습니다. 예시:
- 프로모션 또는 런처 설치 프로그램 다운로드 소스를 추적하기 위한 정보
- 수명이 제한된 데이터. 게임 내 사용자 정의 인증 및 게임 관련 중요한 정보 전송에 사용
사용자
이미 런처와 로그인을 연동하고 OAuth 2.0 인증을 연결한 파트너.
획득 방법
사용자 데이터 전송을 사용하려면 다음을 구현합니다.
일회용 암호 검색
일회용 암호 가져오기를 구현하려면https://launcher.xsolla.com/otp
URL 주소로 POST 요청을 보냅니다. 요청 본문에서 다음 매개 변수가 포함된 JSON을 전달합니다.tracking_payload
- 수명이 제한되지 않은 사용자 데이터. 최대 문자열 길이는 255자입니다.common_payload
- 수명이 제한적인 사용자 데이터. 이러한 데이터는 덮어쓸 수 있습니다. 최대 문자열 길이는 255자입니다.expires_in
- 유닉스 시간 형식의common_payload
매개 변수에 전달된 데이터의 수명(밀리초).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>)
함수를 실행하세요.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.