사용자 데이터 수집 관리

작동 방식

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

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

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

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

획득 방법

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

관리자 페이지에서 설정

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

4. 사용자 등록 양식에 다음 필드와 확인란이 표시될 수 있습니다.
   • 사용자 이름
   • 이름
   • 성
   • 생년월일
   • 국가
   • 성별
   • 뉴스 레터 - 사용자가 뉴스 레터를 구독할 수 있는 체크 박스입니다. 사용자가 이 확인란을 선택하면 Mailchimp가 프로젝트에 연결되어 있는 경우 연락처가 자동으로 Mailchimp로 내보내집니다.
   • 추가 동의 - 사용자가 추가 동의에 서명할 수 있는 확인란입니다. 관리자 페이지를 통해 또는 API 메소드를 통해 추가 동의에 서명한 사용자 목록을 얻을 수 있습니다. 이 목록은 additional_agreement.csv 파일에서 확인할 수 있습니다.

5. 필드를 필수로 설정하려면 필드 설명 줄에서 ★ 아이콘을 클릭합니다. 아이콘이 파란색으로 바뀝니다.

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

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

관리자 페이지에서 사용할 수 있는 필드 외에도 자체 필드를 등록 양식에 추가할 수 있습니다. 이렇게 하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com로 이메일을 보내서 각 필드에 다음 정보를 포함하는 필드 목록을 제공합니다 :

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

select와 multi-select 필드의 경우 고객 성공 매니저에게 이러한 필드에 사용할 수 있는 값 세트를 제공해야 합니다.

애플리케이션 측 통합

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

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

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

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 저장소
• Firebase 저장소
• 사용자 정의 저장소

엑솔라 스토리지

PlayFab 스토리지

PlayFab 저장소를 사용할 경우 관리자 페이지에서 사용할 수 있는 필드와 자체 필드를 모두 등록 양식에 추가할 수 있습니다.

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

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

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

Firebase 저장소

사용자 정의 스토리지

사용자 정의 저장소를 사용할 경우 관리자 페이지에서 사용할 수 있는 필드와 자체 필드를 모두 등록 양식에 추가할 수 있습니다.

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

예제:

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

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

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

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