목차
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
개요
...
팝은 Pop은 스크린 최상단에 뜨는 UI를 통해 Feed 사용자를 광고 지면으로 유저를 유도합니다. 팝은 한 번 실행되면 Pop을 활성화하면 화면을 껐다 켤 때마다 팝이 지속적으로 화면에 보이게 됩니다.
...
Android 12에 적용되는 오버레이의 터치 이벤트 차단에 대응하기 위해 팝(Pop) 버튼에 투명도를 적용하여 안정적인 앱 동작을 지원합니다.
준비 사항
...
)
Pop 준비
Pop 지면을 사용하기 위해 FeedConfig를 설정합니다. 고도화된 사용을 위해서는 별도로 PopConfig가 필요합니다. PopConfig 설정를 참고할 수 있습니다.
FeedConfig 설정
FeedConfig에 Pop사용 설정을 하면 Pop을 이용할 수 있습니다다음은 FeedConfig를 설정하는 예시입니다.
| Code Block |
|---|
FeedConfig feedConfig = new FeedConfig.Builder(getApplicationContext(), "YOUR_FEEDPOP_UNIT_ID") ... 생략 ... .optInFeatureList(Collections.singletonList(OptInFeature.Pop)) .build(); final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context) ... 생략 ... .setFeedConfig(feedConfig) .build(); BuzzAdBenefit.init(this, buzzAdBenefitConfig); |
위 스텝을 진행한 이후에는 Pop이 준비되면 Feed 지면에 Pop 활성화 버튼이 노출됩니다. 자세한 사항은 여기 Pop 활성화 버튼에서 확인할 수 있습니다.
...
Pop 초기화 및 활성화
...
마시멜로(Android API 23) 이상 버전에서 Pop을 실행시키기 위해서 다른 앱 위에 그리기 권한을 획득해야 합니다. BuzzAdPop 클래스는 유저가 다른 앱 위에 그리기 권한을 활성화 하도록 권한이 필요합니다. 원활한 권한 획득을 위해 BuzzAd Android SDK는 사용자가 권한을 활성화하도록 유도하는 기능을 제공하고 있습니다.
| Info |
|---|
Pop을 연동하려는 앱이 다른 앱 위에 그리기 권한을 이미 가지고 있다면 다음 단계로 넘어가세요. |
...
다음 가이드에 따라 다른 앱위에 그리기 권한을 받고 Pop 을 활성화 할 수 있습니다.
Activity에 BuzzAdPop 클래스를 멤버 변수로 추가합니다.
| Code Block | ||
|---|---|---|
| ||
private BuzzAdPop buzzAdPop; |
...
Activity의 onCreate에서 BuzzAdPop의 인스턴스를 만들어 줍니다.
| Code Block | ||
|---|---|---|
| ||
this.buzzAdPop = new BuzzAdPop(context, "YOUR_ |
...
POP_UNIT_ID"); |
Pop 실행 전, 다른 앱 위에 그리기 권한을 얻어야 합니다. requestPermissionWithDialog를 호출하여 유저에게 다른 앱 위에 그리기 권한을 부여하도록 유도할 수 있습니다.
| Code Block | ||
|---|---|---|
| ||
public static final int REQUEST_CODE_SHOW_POP = 1024;
public void showPopOrRequestPermissionWithDialog() {
// 권한 확인
if (BuzzAdPop.hasPermission(context) || Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {
// Pop 실행
buzzAdPop.preloadAndShowPop();
} else {
// 권한 요청
BuzzAdPop.requestPermissionWithDialog((Activity) context,
new PopOverlayPermissionConfig.Builder(R.string.pop_name)
.settingsIntent(OverlayPermission.createIntentToRequestOverlayPermission(context))
.requestCode(REQUEST_CODE_SHOW_POP)
.build()
);
}
}
|
다른 앱 위에 그리기 권한이 부여되면 자동으로
...
Activity로 돌아오며, Intent를 통해 결과를
...
확인합니다. 권한 획득이 확인되면 preloadAndShowPop을 호출하여 Pop을 실행합니다.
| Code Block | ||
|---|---|---|
| ||
import static com.buzzvil.lib.buzzsettingsmonitor.SettingsMonitor.KEY_SETTINGS_REQUEST_CODE; import static com.buzzvil.lib.buzzsettingsmonitor.SettingsMonitor.KEY_SETTINGS_RESULT; public class MainActivity extends AppCompatActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); if (getIntent().getBooleanExtra(KEY_SETTINGS_RESULT, false) && getIntent().getIntExtra(KEY_SETTINGS_REQUEST_CODE, 0) == REQUEST_CODE_SHOW_POP) { // 권한 획득 확인 후 pop 실행 buzzAdPop.preloadAndShowPop(); } } } |
Pop 비활성화
buzzAdPop.removePop(Context) 을 호출하여 Pop을 비활성화 할 수 있습니다. Pop이 비활성화되면 Service Notification이 사라집니다.
다음은 Pop을 비활성화하는 예시입니다.
| Code Block |
|---|
buzzAdPop.removePop(context); |
커스터마이징
Customize 페이지 에서 Pop 아이콘 이미지 변경, 유틸리티 기능 등 Customize 가능 한 기능들을 확인할 수 있습니다.
추가 리소스
Github의 샘플
...
...