해당 문서는 BuzzAd Ext.point SDK의 광고 지면 타입 중 하나인, Pop Type 을 연동하는 문서입니다. Pop Type 은 쳇헤드 (Chat Head) 를 사용하여 앱 밖에서도 광고 참여 여부를 확인할 수 있습니다. Pop Feed 를 통해 앱 지면 바깥에서도 광고를 참여할 수 있으며, 클릭을 통해 앱으로 이동하여 유저의 앱 사용을 크게 증가시킵니다.

...

•  Android Studio 3.2 혹은 그 이상
•  minSdkVersion 15 혹은 그 이상
•  compileSdkVersion 29 혹은 그 이상

...

연동하기

1. SDK 및 설정 변경하기

build.gradle 변경하기

[1] build.gradle 의 dependencies 에 아래의 코드를 제거해야 합니다.

repositories {
    maven { url "https://dl.bintraybuzzvil.com/buzzvilpublic/maven/" }
}

...

dependencies {
    // 버전 정보는 이전 단계에서 적용했으니 생략합니다.
    implementation ("com.buzzvil:buzzad-benefit:2.X.X") {
        ...
        // 아래 코드를 제거해야 합니다.
        exclude group: 'com.buzzvil', module: 'buzzad-benefit-pop'
        
        ...
    }
}

...

[2] '[Ext.point] 공통 적용 항목 연동' 단계에서 생성한 BuzzAdBenefitConfig에 PopConfig를 추가합니다.

...

연동하기

2. 다른 앱 위에 그리기 권한 설정 및 Pop 실행하기

다른 앱 위에 그리기

•  Pop을 연동하려는 앱이 다른 앱 위에 그리기권한을 이미 가지고 있다면 해당 과정은 넘어가도 됩니다.
•  해당 가이드 외의 다른 방식으로 구현하여 사용할 경우, 다음 과정으로 넘어가도 됩니다.

...

BuzzAdPop buzzAdPop = new BuzzAdPop(context, "POP_UNIT_ID");
buzzAdPop.preloadAndShowPop(context);

...

연동하기

3. Config 설정하기

다음 항목에 대한 확인이 필요합니다.

•  연동하기 - [2. 다른 앱 위에 그리기 권한 설정 및 Pop 실행하기] 를 통해 정상적으로 다른 앱 위에 그리기 권한 획득이 이루어지는지 확인
•  연동하기 - [1. 기본 설정을 적용하여 구현하기], [2. 다른 앱 위에 그리기 권한 설정 및 Pop 실행하기] 를 통해 기본 값으로 구현을 완료한 광고 지면에서 정상적으로 광고를 확인하고 참여할 수 있는지 확인

...

final PopNotificationConfig popNotificationConfig = new PopNotificationConfig.Builder(getApplicationContext())
        .smallIconResId(R.mipmap.ic_launcher)
        .titleResId(R.string.pop_notification_title)
        .textResId(R.string.pop_notification_text)
        .colorResId(R.color.colorPrimary)
        .notificationId(NOTIFICATION_ID)
        .build();
final PopConfig popConfig = new PopConfig.Builder(getApplicationContext(), UNIT_ID_POP)
        .initialSidePosition(new SidePosition(SidePosition.Side.RIGHT, 0.6f))
        .initialPopIdleMode(PopConfig.PopIdleMode.INVISIBLE)
        .feedConfig(feedConfig) // optional
        .popNotificationConfig(popNotificationConfig)
        .build();

final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
        .add(popConfig)
        .build();
BuzzAdBenefit.init(this, buzzAdBenefitConfig);

...

연동하기

4. (선택) Custom Service Notification 등록하기

다음 항목에 대한 확인이 필요합니다.

•  연동하기 - [3. Config 설정하기] 의 구현을 완료한 뒤, 정상적으로 적용이 되었는지 확인

...

<application
    ... 
    <service android:name=".java.CustomControlService" />
</application>

...

다음 과정으로 넘어가기

→ Pop 커스터마이즈 하기 (링크)

커스터마이즈가 분리된 이유

Config 설정 외에 디자인 가이드의 양이 많아, 효율적인 연동을 위해 해당 내용을 분리했습니다.

...