런처 설치 프로그램을 통해 사용자 데이터를 전송하는 방법

작동 방식

런처 설치 프로그램을 통해 웹사이트에서 게임으로 사용자 데이터를 전송할 수 있습니다. 예시:

  • 프로모션 또는 런처 설치 프로그램 다운로드 소스를 추적하기 위한 정보
  • 수명이 제한된 데이터. 게임 내 사용자 정의 인증 및 게임 관련 중요한 정보 전송에 사용
런처로 데이터를 전송하기 위해 일회용 암호의 확장 기능이 사용됩니다(기본 시나리오는 지침에 설명되어 있음).

사용자

이미 런처로그인을 연동하고 OAuth 2.0 인증을 연결한 파트너.

획득 방법

사용자 데이터 전송을 사용하려면 다음을 구현합니다.

  1. 일회용 암호 검색
  2. 설치 프로그램 이름에 일회용 암호 추가
  3. 게임으로 전송된 사용자 데이터 처리(선택 사항)

일회용 암호 검색

일회용 암호 가져오기를 구현하려면 https://launcher.xsolla.com/otp URL 주소로 POST 요청을 보냅니다. 요청 본문에서 다음 매개 변수가 포함된 JSON을 전달합니다.
  • tracking_payload - 수명이 제한되지 않은 사용자 데이터. 최대 문자열 길이는 255자입니다.
  • common_payload - 수명이 제한적인 사용자 데이터. 이러한 데이터는 덮어쓸 수 있습니다. 최대 문자열 길이는 255자입니다.
  • expires_in - 유닉스 시간 형식의 common_payload 매개 변수에 전달된 데이터의 수명(밀리초). common_payload가 전송되는 경우 필수입니다.
일회용 암호를 얻기 위한 요청의 예시:
Copy
Full screen
Small screen
    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
    Full screen
    Small screen
      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
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        알림
        런처는 게임이 시작될 때마다 사용자 데이터를 게임으로 전송합니다.
        브라우저 게임 실행 시 런처는 아래 예시에 제시되어 있는 바와 같이 tracking_payload 매개 변수에 수신된 데이터를 tracking_payload 쿼리 매개 변수의 값으로 전달합니다.
        Copy
        Full screen
        Small screen
          https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
          

          tracking_payload 매개 변수는 UTF-8 인코딩으로 전달됩니다. 이를 디코딩하려면 게임 측에서 decodeURIComponent(<tracking_payload>) 함수를 실행하세요.

          이 기사가 도움이 되었나요?
          감사합니다!
          개선해야 할 점이 있을까요? 메시지
          유감입니다
          이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
          의견을 보내 주셔서 감사드립니다!
          메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
          마지막 업데이트: 2024년 9월 24일

          오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

          문제 보고
          콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
          후속 조치를 위해 이메일을 제공해 주세요
          의견을 보내 주셔서 감사드립니다!