소개

h1. 개인 데이터 마켓

h2. 준비 항목

|_. # |_. 항목 |

| 1 | 제안 노출 범위 |

| 2 | 제안 참여 조건 |

| 3 | 최대 모집 인원 |

| 4 | 참여자 모집 기간 |

| 5 | 데이터 수집 기간 |

| 6 | 데이터 수집 횟수 |

| 7 | 데이터 수집 주기 |

| 8 | 이용권당 지급 최대 비용 |

| 9 | 수집 1회당 최대 데이터 개수(1인 기준) |

| 10 | 수집 데이터 질의 |

h2. 작성 예시

|_. 키 |_. 형식 |_. 설명 |_. 작성 예시 |

| Purpose | int | 제안의 사용 목적 | 

<pre>

100</pre>

 |

| Filter | string | 제안의 노출 범위

* 어떤 사용자에게 제안을 보여 줄 것인지 지정 | "*" |

| Category | int[] | 구매 데이터의 범주 코드 목록

* 코드 확인: <notextile></notextile>"수집 개인정보":https://snplab.synology.me/confluence/pages/viewpage.action?pageId=27558064 | 

<pre>

[4, 200]</pre>

 |

| MaxIssuable | int | 이용권 발행 최대 횟수

* 최대 구매 인원수 | 

<pre>

1000</pre>

 |

| Duration | string | 이용권의 유효 기간

* -TicketValidUntil과 배타적으로 사용되어야 함-

* 기간 또는 절대 시간 형식으로 지정

* 유효 기간의 시작 시간에 대한 설명은 TicketValidFrom 항목 참조 | 

<pre>

"10d"</pre>

 |

| ImageURL | string[] | 제안자에 대한 이미지 목록

* 회사 로고 이미지 (Icon) | 

<pre>

[

    "Icon=icon-image-url" 

]</pre>

 |

| Description | string[] | 제안에 대한 설명 목록

* 회사 이름 (CompanyName)

* -제안 제목 (Title)-

* -제안 유의사항 (Disclaimer)-

* -제안 개인정보처리방침 (PrivacyPolicy)- | 

<pre>

[

    "CompanyName=company-name",

    "Title=title",

    "Disclaimer=disclaimer",

    "PrivacyPolicy=privacy-policy-url" 

]</pre>

 |

| NotBefore | string | 모집 시작 시간

* 예를 들어 모집 시작일이 2021-03-26이면 "2021-03-26T00:00:00+09:00"을 필드값으로 기록

* 제안 활성화 시점을 모집 시작 시간으로 지정할 수 있음 | 

<pre>

"2021-03-26T00:00:00+09:00"</pre>

 |

| NotAfter | string | 모집 종료 시간

* 예를 들어 모집 종료일이 2021-03-31이면 "2021-04-01T00:00:00+09:00"을 필드값으로 기록

* 수집 시작 시점을 모집 종료 시간으로 지정할 수 있음 | 

<pre>

"2021-04-01T00:00:00+09:00"</pre>

 |

| Content | JSON Object | 구매 관련 내용

* 구매 제목 (Title)

* -구매 요약 정보 이미지 URL (Banner)-

* -구매 상세 정보 이미지 URL (Landing)-

* 구매 설명 (Description)

* 구매 유의사항 URL (Disclaimer)

* 수집 URL (UploadUrl)

* 수집 데이터 질의 (SelectQuery)

LDP 설정 정보

* 프라이버시 예산(PrivacyBudget)

* 스피너 확률 계산 공식(Formula) | 

<pre>

{

    "Purchase": {

        "Title": "title",

        "Banner": "banner-image-url",

        "Landing": "landing-image-url",

        "Description": "description" 

        "Disclaimer": "disclaimer-url",

        "UploadUrl": "data-upload-url",

        "SelectQuery": "select-query" 

    },</pre>

<pre>

    "LdpConfig": {

        "PrivacyBudget": 4.0,

        "Formula": 1

    }

}</pre>

 |

| RewardPolicy | JSON Object | 포인트 지급 기준

* 지급 유형: 이용권 사용할 때마다 포인트 (데이터 개수 x 데이터 단가) 지급

* 지급량: 이용권당 지급 최대 비용 | 

<pre>

{

    "Type": 2,

    "Amount": 2000

}</pre>

 |

| ConsumePolicy | JSON Object | 이용권 사용 기준

* 소모 유형: -제안-이용권 발행자가 소모

** 현재 온-프레미스 서버가 이용권 발행자의 접근 토큰으로 호출하는 것으로 구현 (추후 설계 개선시 제안 발행자가 소모하는 것이 바람직한 방향)*<notextile></notextile> 소모 허용 횟수: 수집 횟수

* 소모 주기: Duration 필드와 같은 형식

* 최대 데이터 개수: 소모당 업로드 최대 데이터 개수 | 

<pre>

{

    "Type": 2,

    "Count": 10,

    "Period": "1d",

    "MaxDataCount": 500

}</pre>

 |

| DisallowMultiIssue | bool | 이용권 중복 발행 금지 | true |

| Condition | string | 제안 참여 조건 | "*" |

| TicketValidFrom | string | 이용권 유효 기간의 시작 시간

* 참여한 사용자들로부터의 데이터 수집 시간을 맞추려면 처음 수집 시간 또는 그 이전의 시간을 지정하면 됨

* 이 항목이 없을 경우 이용권 발행 시점을 유효기간의 시작 시간으로 간주함

** 참여한 사용자들간에 데이터 수집 시간이 일치하지 않는 현상이 발생함 | "2021-04-01T00:00:00+09:00" |

| -TicketValidUntil- | string | 이용권 유효 기간의 만료 시간

* 마지막 수집 시간 이후의 시간을 지정하면 됨

* Duration과 배타적으로 사용되어야 함 | "2021-04-11T00:00:00+09:00" |