🔗 999플러스 통합 연동 가이드

⚠️리뷰챌린지 테스트 환경 주의사항

테스트 환경 리뷰 참여 절차

• 리뷰챌린지의 광고에 참여합니다.
• 영수증 내려받기, 리뷰 복사, 포토 내려받기(필요한 경우) 등을 수행합니다.
• N플레이스로 이동합니다. 이후 아무런 액션 없이 바로 리뷰 사이트로 복귀합니다.
• 스크린샷 업로드 — 아무 이미지나 업로드합니다.
• 연락 채널을 통해 승인 요청 시 빠른 승인 처리가 가능합니다.
• 승인 시 테스트 환경에 등록된 포스트백을 통해 정식 포스트백이 전송됩니다.

1매체사 관리자 사이트

매체사 관리자 사이트는 연동 기본 설정, 보상 지급 이력, 정산 데이터 등을 확인할 수 있습니다. 안내 받으신 계정 정보로 접속해 주세요.

접속 주소

기본 정보 설정

관리자 사이트의 기본 정보 설정 메뉴에서 아래 정보를 확인 및 설정할 수 있습니다.

2999plus 미션 사이트 연동 필수

999plus 미션 수행은 당사의 웹사이트에서 진행됩니다. 아래 URL에 파라메터를 지정하여 외부 웹 브라우저로 오픈해 주세요.

서버 주소

https://connect.999plus.kr?mkey=xxx&userId=xxx&adid=xxx&uname=xxx&wv=0&category=xxx

https://bridge.bravo6.kr/?mkey=xxx&userId=xxx&adid=xxx&uname=xxx&wv=0&category=xxx

쿼리 파라메터

3리워드 포스트백 연동 필수

이용자 미션 승인 시 999plus 서버에서 매체사 서버로 보상 지급을 요청합니다. 포스트백 수신을 위한 API 엔드포인트를 구현해 주셔야 합니다.

전송 타입 및 헤더

Body 파라메터

처리 결과 응답

JSON 형식으로 처리 결과를 반환해 주세요. (HTTP 상태코드가 아닌 JSON 결과값으로 판단합니다)

{ "result": "success" }   // 또는 "duplicate" | "invaliduserid" | "failed"

4알림 포스트백 구현 선택

이용자에게 발송되는 각종 알림 메시지를 매체사 서버로 전송합니다. 관리자 페이지의 알림 포스트백 수신 주소 설정 시 활성화됩니다.

수신된 알림 메시지를 귀사의 앱 알림 시스템 또는 푸시 알림으로 표시해 주세요. 메시지 길이가 앱 시스템 한도를 초과하면 허용 범위까지만 표시하면 됩니다.

전송 타입 및 헤더

Body 파라메터

처리 결과 응답

JSON 형식으로 처리 결과를 반환해 주세요.

{ "result": "success" }   // 또는 "duplicate" | "invaliduserid" | "failed"

5포스트백 테스트

포스트백 연동이 올바르게 구현되었는지 관리자 사이트에서 테스트할 수 있습니다.

테스트 방법

• 사전 준비: 관리자 기본설정 페이지에서 포스트백 주소, 리워드 이름, 유저지급 리워드 수치를 올바르게 설정
• 메뉴 진입: 관리자 → "포스트백 테스트" 메뉴
• 유저 ID 지정: 999plus 미션 사이트 연동 시 사용한 이용자 ID를 입력
• 테스트 발송: 리워드 포스트백 / 알림 포스트백 각각 발송 가능
• 내역 확인: 포스트백 발송 내역에서 최근 발송된 테스트 포스트백 3건 확인 가능

6서버 IP 목록

귀사 보안 시스템에 999plus 서버 IP 등록이 필요한 경우 아래 IP를 화이트리스트에 추가해 주세요.

7웹뷰 연동 안내

999plus는 기본적으로 웹브라우저에서 실행되는 환경으로 작업되어 있습니다. 하지만 제한적으로 웹뷰 연동은 가능합니다.

웹뷰 연동 시 웹뷰 내 사이트 이동을 감지하고, URL에 따라서 별도 처리를 하지 않으면 제대로 작동하지 않습니다.

웹뷰 내에서 이동 처리해도 되는 URL

이동할 URL이 다음과 같이 시작하는 경우에는 웹뷰 내에서 이동 처리하면 됩니다.

AndroidManifest.xml 설정

안드로이드일 경우 AndroidManifest.xml 내에 다음의 쿼리를 추가해야 합니다.

<queries>
    <package android:name="com.nhn.android.search" />
    <package android:name="com.nhn.android.nmap" />

    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="intent" />
    </intent>

    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="naversearchapp" />
    </intent>
</queries>