광고/컨텐츠 설정

버즈스크린에 노출되는 광고와 컨텐츠에 대한 세부 설정을 선택할 수 있는 기능들입니다.
기능에 따라 유저가 개별 설정 가능하도록 UI를 오픈할 수 있는 경우도 있으니 자세한 내용은 각 기능 설명을 확인해주세요.

하위 항목은 아래와 같습니다.

잠금화면 상하단 스크롤 시 화면에 나오는 광고와 컨텐츠의 비율을 조절할 수 있는 기능입니다. 단, 광고가 나올 순서에 노출 가능한 광고가 없을 경우 Backfill로 컨텐츠가 노출됩니다.

유저에게 UI를 오픈하여 직접 설정값을 선택하도록 할 수도 있습니다.

	항목	코드 & 호출 위치	세부내용

항목

코드 & 호출 위치

세부내용

1

설정값 선택

BuzzScreen.getInstance().setSettings(BuzzScreen.Settings.PAGE_DISPLAY_RATIO, String page_display_ratio)

page_display_ratio : 설정할 광고:컨텐츠 비율. 아래 값들 중 선택 가능

"1:1"
"1:2"
"1:3"

2

설정된 값 확인

BuzzScreen.getInstance().getSettings(BuzzScreen.Settings.PAGE_DISPLAY_RATIO)

세팅된 String page_display_ratio 값을 리턴
위 1번의 setSettings() 로 설정한 값이 없을 경우 null 리턴

버즈스크린에 노출되는 동영상 광고의 자동재생 여부를 유저가 직접 선택할 수 있는 기능입니다. 유저가 선택한 설정값은 유닛의 자동재생 설정값에 우선합니다.

	항목	코드 & 호출 위치	세부내용

	항목	코드 & 호출 위치	세부내용
1	설정값 선택	인앱, 잠금화면 상 등에 자동재생 여부 설정 가능한 UI 구현 `BuzzScreen.getInstance().setAutoplayType(enum AutoplayType)` 호출	`setAutoplayType`에 자동재생 설정값을 파라미터로 전달해야 함 `BuzzScreen.AutoplayType.ENABLED` : 항상 자동재생 `BuzzScreen.AutoplayType.ON_WIFI` : 와이파이에서만 자동재생 `BuzzScreen.AutoplayType.DISABLED` : 자동재생하지 않음
2	설정된 값 확인	`BuzzScreen.getInstance().getAutoplayType()`	세팅된 `AutoplayType` 값을 리턴 위 1번의 `setAutoplayType()`로 설정한 값이 없을 경우 `null` 리턴
3	재생되고 있는 동영상의 현재 설정값 표시	`onVideoAutoplay(AutoplayState autoplayState)`	재생중인 동영상의 현재 설정값이 `autoplayState` 파라미터를 통해서 들어옴 해당 값에 따라 이용자에게 메세지를 표시 protected void onVideoAutoplay(AutoplayState autoplayState) { int messageResourceId; switch (autoplayState) { case AutoPlay: messageResourceId = R.string.autoplay_enabled_always; break; case AutoPlayOnWIFI: messageResourceId = R.string.autoplay_enabled_on_wifi; break; case NotAllowed: messageResourceId = R.string.autoplay_disabled; break; default: return; } final Snackbar snackbar = Snackbar.make(findViewById(android.R.id.content), messageResourceId, Snackbar.LENGTH_SHORT); ... snackbar.show(); }

유저가 잠금화면 상의 광고나 컨텐츠, 혹은 컨텐츠 채널에 대해 피드백을 할 수 있는 기능입니다. 잠금화면 상에 노출된 소재 별 세부적인 기능 및 적용 방법은 아래와 같습니다.

1. User Flow

참고: 유저 플로우

1) 광고

기능	설명

기능	설명
광고 숨기기	해당 광고 즉시 노출 중단
광고 신고하기	신고 사유 선택 후 즉시 노출 중단
(Adchoice url이 있을 경우 표시) 이 광고가 표시되는 이유는?	외부 브라우저로 해당 광고의 Adchoice url을 로드

2) 컨텐츠

기능	설명

기능	설명
컨텐츠 숨기기	해당 컨텐츠 즉시 노출 중단
컨텐츠 신고하기	신고 사유 선택 후 즉시 노출 중단
"컨텐츠 채널"의 컨텐츠 숨기기	해당 컨텐츠 채널의 모든 컨텐츠가 롤링 목록에서 즉시 제거됨
(컨텐츠 채널을 1개 이상 숨겼을 경우 표시) 숨긴 채널 보기	숨긴 채널 목록에서 특정 채널을 체크하면 숨김이 해제되며, 다음 할당 시부터 해당 컨텐츠 채널의 컨텐츠 재노출

"컨텐츠 채널"이란?
잠금화면에 컨텐츠를 제공하는 매체사를 의미합니다. 매체사에 따라 뉴스, 건강, 연예 등 여러 카테고리의 컨텐츠를 제공할 수 있으며, 위 기능으로 하나의 컨텐츠 채널을 숨기면 카테고리를 불문하고 해당 채널의 모든 컨텐츠가 필터링됩니다.

3) 디폴트 이미지

다이얼로그 박스에 "이 화면이 표시되는 이유는?" 메뉴가 뜨며, 클릭 시 디폴트 이미지가 뜨는 원인 및 해결 방안을 안내합니다.

"디폴트 이미지"란?
BuzzScreen.init()에서 호출하는 imageResourceIdOnFail, 즉 네트워크 에러 혹은 일시적으로 잠금화면에 보여줄 캠페인이 없을 경우 나타나는 이미지입니다. (기본 설정 문서의 초기화 부분 참고)

2. Usage

잠금화면 UI에 해당 기능을 위한 버튼 구현
해당 버튼의 onClickListener에서 showLockerContextMenu() 호출

findViewById(R.id.locker_menu).setOnClickListener(new View.OnClickListener() {

    @Override
    public void onClick(View v) {
        showLockerContextMenu();
    }
});

cf) 메뉴 아이콘 속성 예제

<ImageButton
    android:id="@+id/locker_menu"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignParentRight="true"
    android:layout_marginRight="16dp"
    android:padding="16dp"
    android:background="@drawable/bs_locker_icon_menu"/>