먼저, 설문별로 적용할 수 있는 파라미터 목록에 UID 를 추가해야 합니다. 설문 편집 페이지 - 공통 설정 에서 ‘파라미터 추가' 를 이용할 수 있습니다.

파라미터 키 값이 ‘UID’ 파라미터를 추가합니다.

응답 수집을 위해 수집그룹을 추가합니다. 파라미터가 설정된 경우, ‘기본 링크' 수집그룹을 선택하여야 합니다.

파라미터로 UID 가 등록되었는지 확인합니다. HMAC 을 사용할 경우 ‘HMAC키 사용' 옵션을 켭니다. 파라미터 값을 포함한 응답 링크의 위변조를 방지하기 위해 사용을 권장합니다.

설정들을 확인한 다음, 수집을 시작합니다.

수집그룹 상세 페이지의 URL 을 확인합니다.

https://opensurvey.io/dataspace/surveys/{설문ID}/collector/{수집그룹ID} 형태로, 가장 뒷 부분을 복사하여 수집그룹ID 를 얻을 수 있습니다.

(설문 내 수집그룹 목록 조회 API 를 이용하여 얻을 수도 있습니다.)

응답 URL 조회 API 를 사용하여, 파라미터 값이(UID) 적용된 응답 링크들을 반환받습니다.

해당 링크들을 각 UID 에 맞는 패널에게 전달하고, 응답을 기다립니다.

응답 URL 조회 API 를 사용시, 요청 건수 제한 정책(rate limit) 을 초과하는지 확인 바랍니다.

1초당 최대 10건의 요청이 가능합니다.

응답 URL 을 직접 생성하는 것도 가능합니다.

위 그림에 표시된 예시 링크와 같이, 파라미터 값을(UID) Query Parameter 형태로 직접 적용하여 링크를 생성할 수 있습니다.

위와 같은 형태로 연동 가능합니다.

serial 값 은 수집그룹 마다 생성되는 값으로, 직접 수집그룹 상세 페이지에서 가져오거나 수집그룹 serial 값 조회 API 를 통해 확인 가능합니다.

HMAC 키 사용 시, 서명 가이드를 확인 바랍니다.

데이터스페이스 메트릭 탭에서 응답이 얼마나 모였는지 확인할 수 있습니다.

분석의 ‘다운로드’ 기능을 통해 응답 로데이터를 Excel, CSV 등의 형태로 다운로드 받을 수 있습니다.

아래와 같이 ‘응답자 고유 식별키' 로 UID 를 확인할 수 있습니다.

설문 상세 페이지의 URL 을 확인합니다.

https://opensurvey.io/dataspace/surveys/{설문ID} 형태로, 가장 뒷 부분을 복사하여 설문ID 를 얻을 수 있습니다.

(설문 목록 조회 API 를 이용할 수도 있습니다.)

응답 메타데이터 조회 API 를 사용하여, 해당 설문의 응답으로 온 모든 데이터와 UID 를 비롯한 파라미터 값을 확인할 수 있습니다.