튜토리얼

잠금화면을 처음 사용하는 시점에 사용 튜토리얼을 안내하여, M앱에서 버즈스크린을 opt-in 한 유저를 L앱으로 원활히 유도하거나 M앱 또는 L앱의 유저 Engagement를 증대하는 것에 그 목적이 있습니다.

튜토리얼 기능은 BuzzScreen SDK 1.8.9.1 버전 이상부터 사용할 수 있습니다.

1. User Flow

SDK에서 함수로 제공되는 튜토리얼 기능은 버튼 클릭 방식으로 넘어가도록 구성되어 있습니다. 퍼블리셔는 아래의 메소드를 사용하여 튜토리얼 이미지 및 버튼의 리소스를 설정 할 수 있으며, 별도의 튜토리얼 이미지나 버튼 디자인을 제작하지 않는 경우 샘플 앱에 구현되어있는 튜토리얼 이미지와 버튼의 리소스를 M앱 내 리소스에 포함시켜 사용합니다.

샘플 앱 내 리소스: Github Link (drawable 폴더)

버튼은 예시 이미지에 보여지는 위치에 고정되어 있음에 유의해주세요. 버튼 이미지 위치를 변경하기 위해서는 퍼블리셔 자체적으로 튜토리얼을 구현해야합니다.

2. Usage

아래 메소드를 호출할 경우 잠금화면을 최초로 활성화했을 때 튜토리얼 이미지들이 순서대로 노출됩니다.

코드 & 호출 위치	세부 내용

코드 & 호출 위치

세부 내용

useTutorial(List imageDrawables, int buttonDrawable)

호출 위치: 반드시 BuzzScreen.getInstance().activate() 전에 호출해야 함

Parameters

imageDrawables : 튜토리얼 이미지 리소스의 List
- 최초 잠금화면 실행 시 튜토리얼 이미지가 해당 List의 순서대로 잠금화면 위에 overlay 되어 보임
buttonDrawable : 튜토리얼에 포함되는 버튼의 디자인을 변경하고 싶은 경우 해당 파라미터 추가

Sample Code

public class MainActivity extends Activity {
    ...

    // Tutorial 이미지 resource를 List에 추가 
    List<Integer> tutorialResIds = new ArrayList<>();
    tutorialResIds.add(R.drawable.lockscreen_tutorial_1);
    tutorialResIds.add(R.drawable.lockscreen_tutorial_2);
    tutorialResIds.add(R.drawable.lockscreen_tutorial_3);

    // 위 List와 Button에 사용할 resource를 사용하여 useTutorial 호출
    // useTutorial을 activate 전에 호출해야 Tutorial이 있는 잠금화면이 활성화 됩니다.
    BuzzScreen.getInstance().useTutorial(tutorialResIds, R.drawable.lockscreen_tutorial_button);
    BuzzScreen.getInstance().activate();
    ...
}

3. 추가 변경 사항

새 버전의 BuzzScreen SDK를 적용하여 M앱의 잠금화면을 다시 활성화하는 경우, 아래의 사항을 추가적으로 변경해주어야 합니다.

BuzzScreen.init() : 기존 Application Class의 onCreate에 추가된 이 함수의 parameter 중 하나인 appKey를 새로 발급받은 값으로 변경해주어야 합니다. 새로 적용되어야 하는 appKey 값은 BD 매니저에게 문의 바랍니다.

이 변경은 M앱의 init 부분에만 해당하는것이며, L앱은 변경없이 기존에 사용하던 appKey 값을 사용합니다.

public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        ...
        // app_key : 새로 발급 받은 값으로 교체 필요
        BuzzScreen.init("app_key", this, SimpleLockerActivity.class, R.drawable.image_on_fail);
    }
}

android {
    defaultConfig {
        manifestPlaceholders = [buzzScreenAppKey:"my_app_key"] // 변경되지 않음!!
    }
}