확장된 등록 양식

작동 방식

사용자 등록 도중, 다음 주요 필드가 필요합니다:

  • API 호출 사용 시:
    • 사용자 이름
    • 이메일
    • 비밀번호
    사용자 이름이메일필드는 같은 값이어야 합니다.
  • 모든 버전의 로그인 위젯 사용 시:
    • 이메일
    • 비밀번호

필요한 경우 사용자에게 추가 필드를 요청할 수 있습니다.

사용자

로그인을 이미 통합한 파트너.

획득 방법

확장 등록 양식에서 사용 가능한 필드 세트는 사용자 데이터에 사용하는 로그인 통합 및 스토리지에 따라 다릅니다. 양식을 설정하려면 통합 및 스토리지 유형을 선택하고 지침을 따르세요.

Login API를 통한 통합

Login API를 통해 통합하는 경우:

  1. 계정 관리자에게 연락하고 필드 목록을 전송합니다. 각 필드에 다음을 명기합니다:
    1. 이름;
    2. 유형;
    3. 필요 여부;
    4. 등록을 위해 API 호출 요청 시 사용하는 매개변수 이름.

기본 필드 옵션:

필드 이름

유형매개변수 이름
사용자 이름(항상 필수)stringusername
이름stringgiven-name
stringfamily-name
별명stringnickname
생년월일date (YYYY-MM-DD)bday
성별enum (f or m)gender
나라select (ISO 3166-1 alpha-2)country-name
뉴스레터 구독하기booleanpromo_email_agreement

  1. Register new user 요청에서 fields 매개변수를 필요 필드와 함께 전달합니다.

요청 사례:

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"}}'

로그인 위젯을 통한 통합

모든 버전의 로그인 위젯을 통해 통합하는 경우, 계정 관리자에게 연락하고 필드 목록을 송부합니다. 각 필드에 대하여 이름과 필요 여부를 명시합니다.

기본 필드 옵션:

  • 사용자 이름 (항상 필수)
  • 이름
  • 별명
  • 출생일
  • 성별
  • 플랫폼
  • 국가
  • 뉴스레터 구독하기

Note
엑솔라 스토리지를 사용하면 플랫폼 필드는 사용할 수 없습니다.

엑솔라 스토리지

엑솔라 스토리지를 사용하는 경우, 나열된 필드만을 사용할 수 있습니다. 필드 값은 엑솔라 측에 저장됩니다.

PlayFab 스토리지

PlayFab 스토리지를 사용하는 경우, 추가 필드는 사용자 데이터로써 여러분의 Title PlayFab에 저장됩니다.

나열된 필드에 부가하여, 다른 필드를 다음 정보와 함께 전달할 수 있습니다:

  • 이름
  • 유형:
    • string
    • date
    • select — 목록에서 하나의 옵션 선택
    • multi-select — 목록에서 다수의 옵션 선택
  • 필요 여부
API 호출을 통한 통합 시, 모든 필드 이름이 가능합니다. 필드 selectmulti-select의 경우, 이러한 필드에 사용 가능한 값 세트를 계정 관리자에게 전달합니다.

PlayFab API 혹은 여러분의 Playfab 계정을 통해 사용자 데이터를 가져올 수 있습니다:

  1. Players로 이동하여 사용자 ID를 클릭합니다.

  1. Player Data (Title) 탭을 선택하세요.

사용자 정의 스토리지

사용자 정의 스토리지를 사용하는 경우, 추가 필드는 신규 사용자 URL로의 등록 요청에 포함하여 송부됩니다.

나열된 필드에 부가하여, 다른 필드를 다음 정보와 함께 전달할 수 있습니다:

  • 이름
  • 유형:
    • string
    • date
    • select — 목록에서 하나의 옵션 선택
    • multi-select — 목록에서 다수의 옵션 선택
  • 필요 여부
API 호출을 통한 통합 시, 모든 필드 이름이 가능합니다. 필드 selectmulti-select의 경우, 이러한 필드에 사용 가능한 값 세트를 계정 관리자에게 전달합니다.

예제

다음 필드가 설정되었습니다:

  • 별명
  • 국가
  • 맞춤 설정 필드 platformmulti-select 유형 및 가능한 값과 함께windows, mac os, linux
사용자 등록 중 다음 요청이 신규 사용자 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"]}'

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

답하기 원하지 않습니다

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

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

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