일반

기기 리소스

note

지난 수 년간의 SDK 개발을 통해, 배터리 소모량은 최적화되어 있습니다. 국내 유수의 대기업들의 강도 높은 QA 를 통과한 점을 참조해주시길 바랍니다.

지난 수 년간의 SDK 개발을 통해, 배터리 소모량은 최적화되어 있습니다. 국내 유수의 대기업들의 강도 높은 QA 를 통과한 점을 참조해주시길 바랍니다.

2016년, Galaxy S6 기기로 진행한 테스트에 의하면

  • 1일 100회 잠금해제시, BuzzScreen이 안드로이드 시스템 잠금화면을 사용하는 것 대비 약 0.28% 만큼 배터리를 더 소모하였습니다. (7mAh, 최대 용량 2,500mAh인 배터리 기준)

  • 1일 100회 잠금해제시, BuzzScreen이 잠금화면을 아예 사용하지 않는 것 대비 약 2.4% 만큼 배터리를 더 소모하였습니다. (62mAh, 최대 용량 2,500mAh인 배터리 기준)

일 60회를 모두 참여하는 경우 평균: 0.6MB / day, MAX: 12MB / day가 소비됩니다.

일반적으로 이미지 한 장당 100kb을 사용하며, 첫 화면과 두번째 화면까지만 캐싱을 진행하고 나머지 화면은 유저가 스크롤을 할 때 캐싱합니다.

개인 정보

버즈스크린 SDK 는 유저의 개인정보를 요구하지 않습니다. 단, 광고 타게팅을 위한 성별과 나이 정보만을 받고 있습니다.

수집되는 정보는 개인 식별이 불가능한 아래와 같은 데이터입니다.

  • 구글 광고 ID

  • 안드로이드 ID

  • 기기 언어 (한국어, 영어, 일본어 등)

  • 기기 제조사

  • 기기 모델

  • 통신사

  • OS 및 OS 버전

  • User Agent

  • 성별 (있을 경우)

  • 연령 (있을 경우)

  • 지역 정보 (있을 경우)

  • 설치된 앱 목록 (있을 경우)

성별, 연령 정보는 반드시 연동해야 하며, 지역 정보의 경우 선택적으로 연동할 수 있습니다.

구글 광고 아이디(GAID)와 암호화된 안드로이드 디바이스 정보를 수집하고 있으며, 광고 성과 측정 및 어뷰징 방지에 사용하고 있습니다. 파트너사에서는 리워드 지급을 위해 필요한 유저 아이디와 광고 타게팅을 위해 필요한 성별, 나이 정보를 받고 있습니다. 용도 및 보관과 관련해서는 버즈빌 개인정보 이용약관을 참조해주시길 바랍니다.

테스트

GitHub의 'Sample Project' 를 다운받아서 앱을 빌드하시면 샘플을 확인하실 수 있습니다.

버즈빌 담당자에게 사용하실 이메일 주소와 함께 문의해주시면, 계정을 생성해드립니다.

Buzzscreen 대시보드에서 현재 송출중인 광고와 컨텐츠를 확인할 수 있습니다.

제공되는 Buzzscreen 대시보드에서 테스트 컨텐츠를 등록할 수 있고, 현재 송출 중인 컨텐츠를 확인할 수 있습니다. 설정된 광고와 컨텐츠는 잠금화면에 바로 노출됩니다.

SDK 연동

연동

약 1MB입니다.

연동 소요 기간은 개발사의 리소스 할당 상황에 따라 상이합니다. 일반적으로 SDK & API 연동이 1개월 정도 소요됩니다. 2주 테스트 기간까지 고려하면 평균 1~2개월 정도를 예상하실 수 있습니다. 커스텀 디자인 개발을 추가할 경우, 소요 시간이 증가할 수 있습니다. 인력 측면에서도 커스텀 기능 스펙에 따라 필요 규모가 달라집니다. 최소한으로 진행한다면 개발자 1인의 리소스로 3일 안에 가능합니다. 한편, 파트너사에서 다양한 기능을 추가한다면 인력 규모 및 소요시간이 추가됩니다.

minSDK 15를 적극 권장하고 있으나, 불가피한 경우 다음 코드를 참고하시고 build.gradle에서 exclude를, 앱의 AndroidManifest.xml에서 override를 각각 진행하면 됩니다.

// exclude
implementation ('com.buzzvil:buzzscreen:1.x.x.x') {
    exclude group: 'com.buzzvil.buzzscreen.ext', module: 'mediation'
}

// override
<uses-sdk tools:overrideLibrary="
com.buzzvil.buzzscreen.sdk,
com.buzzvil.buzzscreen.sdk.mp,
com.buzzvil.buzzscreen.sdk.migration,
com.buzzvil.exoplayer2,
com.buzzvil.buzzscreen.sdk.bridge" />

디자인

커스텀 개발은 원칙적으로 파트너사의 역할입니다. 예외적으로 지원해드릴 수 있는 범위는 버즈빌 담당자와 상의해주시기 바랍니다.

UI 커스터마이징 문서의 “슬라이더 속성 사용 예제” 부분을 확인해주세요.

Q) GUI 가이드 기준 해상도인 1080px * 1920px 으로 진행해도 무방한가요? %로 정의되어 있는데, safe area는 기존 가이드와 동일하게 dpi별 수치값으로 적용해도 되나요?


A) 1080*1920의 "비율"을 기준으로 작업해 주시면 됩니다. 그리고 직접적인 수치들은 해상도, dpi별로 해당 %에 맞게 디자인 해주세요.

정해진 규격은 없습니다. 자유롭게 하시되 안드로이드 스크린 파편화를 고려하여 scalable한 디자인을 해주시면 됩니다.

Q) safe area에서 좌상단 버튼 클릭 시 팝업이 뜨는 영역, 우측 버튼을 왼쪽으로 swipe 했을 때 나오는 영역, 시간/날짜 영역은 자유롭게 정의해도 되나요?


A) 자유롭게 정의해주시면 됩니다. 다만 해당 safe area는 광고가 잘 나와야 하므로 최대한 광고를 가리지 않도록 디자인 부탁드립니다.

직접 만드셔도 되고, Buzzscreen에서 제공해드리는 widget을 쓰셔도 됩니다. 제공 widget을 사용하는 경우 icon들은 custom하게 디자인할 수 있습니다.

서버 / DB

DB

매체사 포인트 적립 포스트백 API 연동 문서의 정보를 참고 부탁드립니다.

해당 항목의 DB 별 String 크기는 아래 표를 참고 부탁드립니다.

DB 타입

데이터 타입

단위

캐릭터셋

사이즈*

비고

Oracle

VARCHAR2

byte

EUC-KR,
KSC5601

510

NLS_LENGTH_SEMANTICS가 byte인 경우, character-set에 따름

Oracle

VARCHAR2

byte

UTF-8

765

NLS_LENGTH_SEMANTICS가 byte인 경우, character-set에 따름

Oracle

VARCHAR2

char

-

255

NLS_LENGTH_SEMANTICS가 char인 경우, 최대 사이즈만큼 한글을 넣을 수 있음

SQL Server/MS-SQL

VARCHAR

byte

-

510

non-Unicode string data

SQL Server/MS-SQL

NVARCHAR

char

-

255

최대 사이즈만큼 한글을 넣을 수 있음

PostgreSQL/PAAS

VARCHAR

char

Unicode
(UTF-8)

255

char 단위

MySQL 5.0 이상

VARCHAR

char

-

255

5.0 이상은 char 단위, 4.0 이하는 byte 단위

MySQL 5.0 미만

VARCHAR

byte

EUC-KR,
KSC5601

510


MySQL 5.0 미만

VARCHAR

byte

UTF-8

765


MariaDB

VARCHAR

char

-

255

char 단위

note

*사이즈: campaign_name 255자 기준으로 필요한 컬럼 사이즈

*사이즈: campaign_name 255자 기준으로 필요한 컬럼 사이즈

네트워크

기본포인트 지급 주기에 따라 파트너사에 전송하는 트래픽 양이 달라질 수 있습니다. 기본포인트를 약 2.5시간을 주기로 지급할 경우 DAU 수의 5배 정도, 주기를 약 1.5시간으로 줄일 경우 DAU 수의 9배 정도의 트래픽을 예상하실 수 있습니다.

사전에 설정한 디폴트 페이지가 보여집니다. 연동과정에서 디폴트 이미지를 설정할 수 있습니다. 디폴트 이미지의 샘플은 버즈빌 담당자에게 문의해주세요.

특이 사항 없이 잠금화면을 사용할 수 있습니다. 다만, 원하지 않는 데이터 소모가 있을 수 있기 때문에 잠금화면을 일시적으로 끄는 것을 권장합니다.

Postback / Request

일별 포인트 적립 request는 기본포인트 주기에 따라 달라집니다. 보통 주기를 최소 1.5시간, 길게는 3,4시간까지 늘리게 되는데 각각 다음의 range를 가집니다. 평균DAU * 5 (기본포인트 주기를 2.5시간으로 했을 때) or DAU * 9 (기본포인트 주기를 1.5시간으로 했을 때)

버즈스크린 서버에서 매체 서버로 보낸 요청이 200 응답을 받았을 때입니다. 200이 아닌 경우 재시도가 이뤄집니다.

리워드가 적립되지 않을 경우 24시간 이내, Exponential 하게 5회 재적립 요청을 합니다. 1분, 10분, 1시간, 3시간, 24시간의 빈도로 재시도 됩니다.

보안

http인 경우 적용되어 있지 않으며, https인 경우 적용되어 있는 것입니다. Postback 설정 시 https 사용을 강력히 권장합니다.

기본적으로 https로 보안이 되며, 필요한 경우 AES 암호화를 제공합니다.

버즈빌 담당자에게 확인해 주세요.