사용자 데이터 수집 관리

작동 방식

사용자를 등록하는 동안 다음 기본 데이터가 요청됩니다.

  • 로그인 API를 사용하는 경우:
    • 사용자 이름
    • 이메일
    • 암호
  • 로그인 위젯을 사용하는 경우:
    • 이메일
    • 암호

사용자에게 추가 개인 데이터를 요청할 수 있습니다. 이렇게 하려면 게시자 계정에서 등록 양식에 포함해야 하는 추가 필드를 지정해야 합니다. 사용자 등록은 필수로 표시한 모든 필드를 입력한 후에만 가능합니다. 사용자가 제공한 데이터는 데이터베이스의 프로필에 저장됩니다.

이전에 등록한 사용자를 인증하는 동안 프로필의 일부 필드에 정보를 입력하지 않은 것이 발견되면 로그인 제품은 누락된 정보를 수집하기 위한 양식을 표시합니다. 로그인하려면 이 양식의 모든 필수 필드에 정보를 입력해야 합니다.

획득 방법

  1. 게시자 계정에서 로그인 프로젝트를 설정합니다.
  2. 사용자 등록 양식에 사용자 정의 필드를 포함하도록 계정 관리자에게 요청을 보냅니다(선택 사항).
  3. 애플리케이션 측에서 솔루션을 통합합니다.

게시자 계정에서 설정

  1. 게시자 계정에서 프로젝트를 열고 로그인 섹션으로 이동합니다.
  2. 로그인 프로젝트의 패널에서 구성을 클릭합니다.
  3. 탐색 페이지에서 사용자 데이터베이스 블록으로 이동한 후 추가 사용자 정보 섹션을 선택합니다.

  1. 수집하려는 사용자 정보를 선택합니다. 다음 필드를 사용할 수 있습니다.
    • 사용자 이름
    • 이름
    • 생년월일
    • 국가
    • 성별
  2. 필드를 필수 입력 필드로 만들려면 필드 설명 줄에서 ★ 아이콘을 클릭합니다. 그러면 아이콘이 파란색으로 변경됩니다.

  1. 변경 내용 저장을 클릭합니다.

등록 양식에 사용자 정의 필드 추가 요청하기

게시자 계정에서 사용할 수 있는 필드 외에도 자체 필드를 등록 양식에 추가할 수 있습니다. 이렇게 하려면 계정 관리자에게 문의한 후(혹은 am@xsolla.com으로 이메일 전송) and 각 필드에 다음 정보를 포함하여 필드 목록을 제공합니다

  • 필드 이름(영어로)
  • 유형:
    • string
    • date
    • select — 목록에서 옵션 하나를 선택
    • multi-select — 목록에서 여러 옵션을 선택
  • 필드가 필수인지 여부

selectmulti-select 필드의 경우 계정 관리자에게 이러한 필드에 사용할 수 있는 값 세트를 제공해야 합니다.

알림
엑솔라 저장소는 사용자 등록 양식에서 사용자 정의 필드 사용하도록 지원하지 않습니다.

애플리케이션 측 통합

로그인 위젯으로 통합 기능을 사용한 경우 애플리케이션 측에서 확장 등록 양식을 통합하기 위해 필요한 작업은 없습니다.

엑솔라 SDK를 사용하여 통합할 경우 사용자에 대한 추가 정보 수집 기능은 아직 사용할 수 없습니다.

로그인 API를 사용하여 통합할 경우 fields 매개변수를 사용하여 새 사용자 등록 요청에서 수집한 추가 사용자 데이터를 전달합니다. 이 매개변수는 속성-값 쌍의 세트입니다. 게시자 계정에서 연결할 수 있는 등록 양식의 필드는 fields 매개변수의 다음 속성에 해당합니다.

필드 이름

유형fields 매개변수 속성
사용자 이름stringusername
이름stringgiven-name
stringfamily-name
생년월일date (YYYY-MM-DD)bday
나라select (ISO 3166-1 alpha-2)country-name
성별enum(fm 값)gender
주의
새 사용자 등록 요청은 모든 필수 필드의 값을 전달해야 합니다.

요청 사례:

Copy
Full screen
Small screen
http
  • http
  • curl
POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json

{
  "username": "john-email@email.com",
  "password": "123456",
  "email": "john-email@email.com",
  "fields": {
     "nickname": "John",
     "country-name": "US",
     "bday": "1997-07-16"
  }
}
curl --request POST \
  --url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
  --header 'content-type: application/json' \
  --data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'

등록 양식에 필드를 추가하는 옵션과 수집된 정보를 저장하는 위치는 선택한 사용자 데이터 저장소 유형에 따라 다릅니다.

엑솔라 스토리지

엑솔라 저장소를 사용할 경우 게시자 계정에서 사용할 수 있는 필드만 등록 양식에 추가할 수 있습니다. 사용자로부터 수집된 추가 정보는 엑솔라 측에 저장됩니다.

PlayFab 스토리지

PlayFab 저장소를 사용할 경우 게시자 계정에서 사용할 수 있는 필드자체 필드를 모두 등록 양식에 추가할 수 있습니다.

추가 필드 및 필드의 값에 대한 정보는 PlayFab 저장소에 사용자 데이터로 저장됩니다. 이러한 사용자 데이터는 PlayFab API 혹은 다음과 같이 PlayFab 계정에서 액세스할 수 있습니다.

  1. 플레이어 섹션으로 이동한 후 사용자 ID를 클릭합니다.

  1. 플레이어 데이터(제목) 탭을 선택합니다.

Firebase 저장소

Firebase 저장소를 사용할 경우 게시자 계정에서 사용할 수 있는 필드자체 필드를 모두 등록 양식에 추가할 수 있습니다. 사용자로부터 수집된 추가 정보는 엑솔라 측에 저장됩니다.

사용자 정의 스토리지

사용자 정의 저장소를 사용할 경우 게시자 계정에서 사용할 수 있는 필드자체 필드를 모두 등록 양식에 추가할 수 있습니다.

추가 필드 및 필드 값에 대한 정보는 등록 요청의 엑솔라 로그인 서버에 의해 사용자 정의 저장소를 연결할 때 게시자 계정의 새 사용자 URL 필드에서 지정한 URL로 전송됩니다.

예제:

다음 필드가 사용자 등록 양식에 추가됩니다.

  • 국가.
  • string 유형의 사용자 정의 nickname 필드.
  • 가능한 값을 있는 multi-select 유형의 사용자 정의 platform 필드: windows, mac oslinux.

사용자를 등록하는 동안 엑솔라 로그인 서버는 다음 요청을 새 사용자 URL로 전송합니다.

Copy
Full screen
Small screen
http
  • http
  • curl
POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "email": "john@gmail.com",
  "password": "123456",
  "country-name": "DE",
  "nickname": "JohnSnow",
  "platform": ["windows", "mac os"]
}
curl --request POST \
  --url 'https://your.hostname/new_user_url.path' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'

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

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2022년 8월 31일

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

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