설문을 응답한 패널에게 리워드 등을 제공하고자 한다면, 응답자들의 UID 를 구해야 합니다.
UID 란 Dataspace 를 사용하는 회사에서 자체적으로 관리하는 응답자 고유 식별자를 의미합니다.
이 UID 를 응답자들이 받을 설문 링크에 query parameter 형태로 같이 담을 수 있는데, 해당 링크를 통해 응답된 정보를 API 나 OpenAnalytics 를 통해 열람하여 UID 를 얻을 수 있습니다.
1. UID 파라미터 설정
먼저, 설문별로 적용할 수 있는 파라미터 목록에 UID 를 추가해야 합니다. 설문 편집 페이지 - 공통 설정 에서 ‘파라미터 추가' 를 이용할 수 있습니다.
파라미터 키 값이 ‘UID’ 파라미터를 추가합니다.
2. 수집그룹 설정
응답 수집을 위해 수집그룹을 추가합니다. 파라미터가 설정된 경우, ‘기본 링크' 수집그룹을 선택하여야 합니다.
파라미터로 UID 가 등록되었는지 확인합니다. HMAC 을 사용할 경우 ‘HMAC키 사용' 옵션을 켭니다. 파라미터 값을 포함한 응답 링크의 위변조를 방지하기 위해 사용을 권장합니다.
설정들을 확인한 다음, 수집을 시작합니다.
3. 수집그룹 ID 조회
수집그룹 상세 페이지의 URL 을 확인합니다.
https://opensurvey.io/dataspace/surveys/{설문ID}/collector/{수집그룹ID} 형태로, 가장 뒷 부분을 복사하여 수집그룹ID 를 얻을 수 있습니다.
(설문 내 수집그룹 목록 조회 API 를 이용하여 얻을 수도 있습니다.)
4. 응답 링크 획득
1. 응답 URL 조회 API 를 통한 링크 획득
응답 URL 조회 API 를 사용하여, 파라미터 값이(UID) 적용된 응답 링크들을 반환받습니다.
해당 링크들을 각 UID 에 맞는 패널에게 전달하고, 응답을 기다립니다.
응답 URL 조회 API 를 사용시, 요청 건수 제한 정책(rate limit) 을 초과하는지 확인 바랍니다.
1초당 최대 10건의 요청이 가능합니다.
2. 직접 응답 URL 을 생성하여 링크 획득
응답 URL 을 직접 생성하는 것도 가능합니다.
위 그림에 표시된 예시 링크와 같이, 파라미터 값을(UID) Query Parameter 형태로 직접 적용하여 링크를 생성할 수 있습니다.
https://{설정한 응답 URL 도메인}.fdback.me/r/{serial}?uid={uid}&store={store}
위와 같은 형태로 연동 가능합니다.
serial 값 은 수집그룹 마다 생성되는 값으로, 직접 수집그룹 상세 페이지에서 가져오거나 수집그룹 serial 값 조회 API 를 통해 확인 가능합니다.
HMAC 키 사용 시, 서명 가이드를 확인 바랍니다.
5. OpenAnalytics 를 통한 응답자 UID 확인
데이터스페이스 결과 탭에서 응답이 얼마나 모였는지 확인할 수 있습니다.
OpenAnalytics의 ‘다운로드’ 기능을 통해 응답 로데이터를 Excel, CSV 등의 형태로 다운로드 받을 수 있습니다.
아래와 같이 ‘응답자 고유 식별키' 로 UID 를 확인할 수 있습니다.
6. 응답조회 API 를 통한 응답자 UID 확인
설문 상세 페이지의 URL 을 확인합니다.
https://opensurvey.io/dataspace/surveys/{설문ID} 형태로, 가장 뒷 부분을 복사하여 설문ID 를 얻을 수 있습니다.
(설문 목록 조회 API 를 이용할 수도 있습니다.)
응답 메타데이터 조회 API 를 사용하여, 해당 설문의 응답으로 온 모든 데이터와 UID 를 비롯한 파라미터 값을 확인할 수 있습니다.
