Search

API SDK, 웹오퍼월 관련 알아두면 좋은 내용

1.
network API를 통해서 구현하고자 하시는 Point 무료 충전소를 구성하시는 건 가능합니다.
→ ads_json API Response 결과를 무료 충전소 리스트에 뿌려주시면 그게 1:1 구조의 광고 참여 배너가 되는 구조입니다.
여기서 해당 배너를 유저가 클릭 했을 때 Click API 호출을 해주시면 되는데, 호출 시점에 app_uid, adid or idfa 같은 매체사가 저희에게 제공 해주셔야 하는 필수 파라미터 값을 같이 붙여서 호출 해주시면 됩니다.
호출이 정상적으로 된 경우 보내주신 유저 정보를 통해서 참여 가능 이력을 확인 하고 참여 가능 하다고 판단 되는 경우
{ "rst": "S", "msg": "", "url": "https://mpcp.memplus.co.kr:447/m/....." }
위 json 구조의 reponse 를 내려드립니다.
해당 reponse 에서 url 로 페이지를 이동 시켜 주시면 캠페인 참여를 위한 랜딩 url로 이동 시키실 수 있습니다.
→ 네트워크 API 연동 방식을 사용하시는 경우 화면 및 리스트 구성을 직접 구현하셔야 하기 때문에 유저의 참여 이력을 따로 관리하셔야 합니다. (이미 참여한 이력이 있는 광고를 유저에게 보여주면 안되기 때문)
ads_json API 에 나오는 캠페인 리스트의 결과물은 8ball 에게 저희가 제공해 드릴 수 있는 광고 리스트를 보여드린 것이지
8ball 의 A 유저가 참여 가능한 리스트를 보여드린게 아니기 때문에 postback 통신 과정에서 참여가 확실해진 경우
해당 이력을 적재 해주신 후 유저의 화면에서 해당 광고가 노출되지 않도록 하는 비즈니스 로직을 짜주셔야 합니다.
→ 마찬가지의 맥락으로 ads_json 호출 결과에 따라 캠페인 노출 리스트를 조정 해주셔야 합니다.
처음 호출에 A B C 캠페인을 response 해드렸다가 다음 호출에 A C 캠페인만 response 해드렸다면 B 광고는 소진 및 특성 사유로 광고가 종료된 것이기 때문에
B 광고가 전체 유저에게 노출되지 않도록 리스트에서 지워주셔야 합니다.
※ sample 코드 제공이 불가능 한 부분에 대한 추가 안내 사항
SDK, 웹 오퍼월 연동 방식의 경우는 저희가 이미 완성 해 놓은 wall 을 제공해 드리는 것이기 때문에 해당 wall 을 띄우는 방법만 알려드리면 되기 때문에 샘플 코드가 존재하지만,
네트워크 API는 최소한의 캠페인 정보로 개발 및 설계를 각 매체사가 입맛에 맞게 알아서 화면 구성부터 후 처리 비즈니스 로직까지 구성 해주셔야 하기 때문에 저희 측에서 샘플 코드를 제공 하고싶어도 할 수가 없습니다.
ADID/IDFA가 있는 경우 ADID/ IDFA 로 유저 참여 체크를 하고 있습니다.(리워드 지급 대상, 중복 참여 등) app_uid만 있는 경우(ADID/IDFA 없음) app_uid로 유저 참여 체크 하고 있습니다.
리워드 자체가 모바일 환경에 최적화 되어있어 데스크탑 웹은 진행 어려움
캠페인이 모바일 환경에서 참여할 수 있도록 되어 있기 때문에 PC에서는 참여 불가합니다. 추가로 ADID/IDFA 수집이 어려운 경우 운영 가능한 캠페인
1.
퀴즈형
2.
구독형 등
3.
앱 설치가 필요한 캠페인, ADID/ IDFA가 있어야 하는 캠페인은 진행이 불가
만약 ADID/IDFA 수집이 어렵다면 ADID/IDFA 수집 불가하다는 내용과 함께
귀사에서 별도로 유저에게 부여한 고유 식별값을 저희에게 전달주시면 됩니다. (내부적으로 app_uid 라 부르고 있습니다)
app_uid만 있어도 참여 가능한 캠페인은 아래와 같습니다.1. 구독형 캠페인(유튜브, 인스타그램, 네이버 플레이스 캠페인 등) 2. app_uid만 있어도 참여 가능한 일부 캠페인(일부 게임 캠페인은 진행 가능합니다)
- API 연동 시 귀사에서 노출 구좌에 광고 On/Off, CS 처리, UI 구성 모두 진행하셔야 하며, 리워드 캠페인(그린피가 제공하는 캠페인)의 경우 실시간으로 On/Off 되는 특징이 있는 점 참고 부탁드립니다. (API 호출 주기는 5분 내외로 진행하시는 것을 추천드립니다.
-CS
1.
api 연동이면 귀사에서 처리
2.
sdk연동이면 그린피에서 처리
1. SDK 연동 시 CS 처리 아래 첨부드린 이미지와 같이 그린피 SDK 오퍼월 내에는 유저가 CS 문의할 수 있는 페이지를 만들어 뒀습니다. 문의하기 페이지에서 유저 정보, 문의하는 캠페인 정보 등을 기입하여 문의하기 버튼을 누르면 그린피 운영자 어드민에 자동으로 해당 데이터가 쌓여 그린피 운영자가 직접 CS 처리 및 유저에게 처리 내용을 안내드릴 수 있습니다.
2. API 연동 시 CS 처리 API는 그린피에서 광고 정보에 대한 값만 JSON 형태로 API만 제공하다보니 운영하다 생기는 CS건에 대한 페이지는 8ballarena 측에서 만드셔야 합니다. 만드신 CS 문의 페이지에서 들어온 데이터(유저 정보, 문의하는 캠페인 정보 등)는 그린피 운영팀에게 메일 혹은 구글 시트로 전달주시면 그린피 운영팀이 해당 유저 참여 여부 체크하여 회신드리고 있습니다.
[운영방식에 따른 광고 노출]
-API 연동시 귀사에서 원하는 광고만 틀 수 있음
-SDK는 그린피에서 내리는 모든 광고가 노출
SDK는 귀사에서 연동만 진행
이후 cs, ui 기능 광고 운영 모두 그린피에서 처리
API 연동 진행 시 그린피에서는 광고 정보에 대한 값을 JSON 형태로 API 제공만 해드립니다. 그 외 UI, 어떤 광고를 노출할지, 유저가 해당 캠페인 참여했을때 발생하는 CS 등 모든 처리는 귀사에서 진행하셔야 합니다.