[Archived] BuzzBenefit Web 연동가이드
본 문서는 archived 처리 되었으므로 BuzzBenefit Web 연동을 위해선 BuzzBenefit Web 연동 가이드 를 참고해 주세요.
웹뷰 연동 개발
도메인 연동
Staging(테스트환경)
https://pointhub-staging.buzzvil.com/buzzbenefit/[버즈빌 발급 앱아이디]?pquery
Prod
https://pointhub.buzzvil.com/buzzbenefit/[버즈빌 발급 앱아이디]?pquery
예시
https://pointhub-staging.buzzvil.com/buzzbenefit/[버즈빌 발급 앱아이디]?p=JTdCJTIycHVpZCUyMiUzQSUy[…]U5QyUyMCVFQSVCMCU5NSVFQiU4MiVBOCVFQSVCNSVBQyUyMiU3RA==
URL
url : {domain}?p=JTdCJTIyaWZhJTIyJTNBJTIyRVRFR0RHUkVHLTExQUFBLUJCQjIyMzQ1JTIyJTJDJTIyYWdlJTIyJTNBMzAlMkMlMjJzZXglMjIlM0ElMjJNJTIyJTJDJTIycGxhdGZvcm0lMjIlM0ElMjJBJTIyJTJDJTIyY2FycmllciUyMiUzQSUyMmt0JTIyJTJDJTIyZGV2aWNlX25hbWUlMjIlM0ElMjJTSFYtRTI1MFMlMjIlMkMlMjJyZWdpb24lMjIlM0ElMjIlRUMlODQlOUMlRUMlOUElQjglRUQlOEElQjklRUIlQjMlODQlRUMlOEIlOUMlMjAlRUElQjAlOTUlRUIlODIlQTglRUElQjUlQUMlMjIlN0Q=
p쿼리 값 생성하는법(예시는 자바스크립트)
[ puid - 매체사 암호화 유저ID, ifa - 광고 ID, birthday: 생년월일 또는(year_of_birth - 출생년도), gender - 성별, platform - OS정보, carrier - 통신사, device_name - 단말기기, region - 지역 ]
birthday의 우선순위가 yaer_of_birth보다 높습니다.(만나이 계산을 위함)
JSON string 생성 - '{“puid”: “매체사 암호화 유저ID”,"ifa":”a31752d2-5d7e-4f41-a45c-af4d39d2fb2d",”birthday”:“yyyy-mm-dd“,"year_of_birth":”1989”,"sex":"M | F","platform":"A | I","carrier":"kt | skt | lgt | null","device_name":"SHV-E250S","region":"서울특별시 강남구"}'
uri인코딩 encodeURIComponent → base64encdoe : btoa(encodeURIComponent( json스트링값 ))
웹뷰 JS 인터페이스 버즈빌로 전달 필요 (필수)
광고 참여와 CS 처리를 위해 웹뷰를 동작시키는 JS 인터페이스 제공이 필요합니다.
웹뷰 열기
웹뷰 닫기
새탭 열기
외부 브라우저 열기
공유하기(선택)
어뷰징 방지를 위해 앱에서 연 브라우저인지 체크하는 기능 제공이 필요합니다.
만약 제공되지 않는다면, 앱에서 연 브라우저인지 구분할 수 없어 웹뷰 진입이 막힙니다.
앱에서 띄운 웹뷰가 맞는지 체크하는 js인터페이스 제공 필요.
만약 해당 인터페이스 제공이 어렵다면, 웹브라우저 user-agent에서 매체사 웹뷰를 구분할 수 있도록 사용하는 방식이 있는지 확인 필요.
예시코드) const isPaycoWebview = () => /PAYCO\//.test(window?.navigator.userAgent);
지면 UI/UX
테마 컬러, 포인트 단위, 문의하기 버튼의 위치 등 지면의 디자인을 결정해서 버즈빌로 전달해 주어야 합니다.
하기 링크의 문서를 다운로드해서 각 시트별 선택 사항을 기입한 후 버즈빌 연동 담당자에게 전달해 주세요.