PopConfig 설정
PopConfig를 통해 Pop의 기능을 설정할 수 있습니다. BuzzAdBenefitConfig에 PopConfig
를 추가합니다.
PopConfig popConfig = new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID") .build(); final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context) ...생략... .setPopConfig(popConfig) .build(); BuzzAdBenefit.init(this, buzzAdBenefitConfig);
커스텀 페이지 추가
Pop 지면을 이용하여 원하는 내용을 표시할 수 있습니다. 커스텀 페이지는 툴바와 컨텐츠로 이루어져있습니다.
툴바에는 타이틀을 설정할 수 있습니다.
컨텐츠영역에 원하는 Fragment를 설정할 수 있습니다.
아래 예시 코드에 따라 구현할 수 있습니다.
new PopNavigator().launchCustomFragment( context, new CustomInAppLandingInfo( new YourFragment(), R.stirng.your_title ) )
커스텀 페이지는 자유롭게 구현하여 사용할 수 있습니다. 예를 들어, 유틸리티 영역 혹은 툴바 영역에 버튼을 추가하고 원하는 페이지를 보여주기 위해 사용합니다. 유틸리티 영역과 툴바 영역의 커스터마이징은 https://buzzvil.atlassian.net/wiki/spaces/BDG/pages/2270135213/ver+2.25.x+6.2.3.#Pop-Feed-%EC%BB%A4%EC%8A%A4%ED%84%B0%EB%A7%88%EC%9D%B4%EC%A7%95에서 확인할 수 있습니다.
Pop Service Notification 자체 구현
Pop이 정상적으로 동작하기 위해서 Service 를 필요로 합니다. 그래서 Pop이 활성화되어 있는 동안에 Service Notification이 보입니다.
다음은 Service Notification 을 직접 구현하여 BuzzAd Android SDK에서 제공하는 Notification 을 대체하는 방법을 안내합니다. Notification의 동작, UI 레이아웃까지 직접 구현하여 수정할 수 있습니다. 만일 BuzzAd Android SDK에서 제공하는 Notification 을 기반으로 간단한 UI 수정을 원하는 경우는 Notification UI 수정을 참고하시기 바랍니다.
Pop Notification 을 수정하기 위해서는 PopControlService
의 상속 클래스를 구현합니다. 필요에 따라 notificationChannel 을 생성하거나 View 를 등록할 수 있습니다. NotificationId는 PopNotificationConfig에서 설정할 수 있습니다. 구현한 상속 클래스는 Manifest 에 등록해야합니다.
PopControlService
은 몇가지 편리한 기능을 제공합니다. 필요에 따라 사용할 수 있습니다.
API | 설명 |
---|---|
| Pop 지면으로 진입하는 PendingIntent 를 제공합니다. |
아래는 Pop Service Notification 자체 구현하는 예시입니다.
public class YourControlService extends PopControlService { @Override protected Notification buildForegroundNotification(@NonNull String unitId, @NonNull PopNotificationConfig popNotificationConfig) { // Pop을 표시하는 PendingIntent (원형 아이콘ㅇ) PendingIntent popPendingIntent = getPopPendingIntent(unitId, this); // 필요에 따라 notificationChannel을 등록합니다. NotificationCompat.Builder builder; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { createNotificationChannelIfNeeded(); builder = new NotificationCompat.Builder(this, NOTIFICATION_CHANNEL_ID); } else { builder = new NotificationCompat.Builder(this); } // Pop Service Notification 에 사용할 View 를 등록합니다. RemoteViews remoteView = new RemoteViews(getPackageName(), R.layout.view_custom_notification); builder.setSmallIcon(popNotificationConfig.getSmallIconResId()) .setContent(remoteView) .setContentIntent(popPendingIntent) .setPriority(PRIORITY_LOW) .setShowWhen(false); if (popNotificationConfig.getColor() == null) { builder.setColor(popNotificationConfig.getColor()); } return builder.build(); } @TargetApi(Build.VERSION_CODES.O) private void createNotificationChannelIfNeeded() { final NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); if (notificationManager.getNotificationChannel(NOTIFICATION_CHANNEL_ID) == null) { final NotificationChannel channel = new NotificationChannel(NOTIFICATION_CHANNEL_ID, NOTIFICATION_CHANNEL_NAME, NotificationManager.IMPORTANCE_LOW); channel.setShowBadge(false); notificationManager.createNotificationChannel(channel); } } }
final PopNotificationConfig popNotificationConfig = new PopNotificationConfig.Builder() .notificationId(NOTIFICATION_ID) .build(); final PopConfig popConfig = new PopConfig.Builder(getApplicationContext(), UNIT_ID_POP) .popNotificationConfig(popNotificationConfig) .controlService(YourControlService.class) .build(); final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context) .setPopConfig(popConfig) .build();
// AndroidManifest.xml <application ...생략... <service android:name=".java.YourControlService" /> ...생략... </application>
Interstitial 광고 지면 추가
popExitUnitId
를 설정하면 사용자가 Pop 지면에서 이탈을 할 때, Interstitial 광고를 노출합니다. Interstitial 지면의 unit id 발급을 원하시는 경우에는 버즈빌 매니저에게 문의하시기 바랍니다.
PopConfig popConfig = new PopConfig.Builder(context, "YOUR_POP_UNIT_ID") .popExitUnitId("YOUR_POP_EXIT_UNIT_ID") .build();
Pop 종료 시 보이는 Interstitial 지면은 ADN 광고를 포함한 버즈빌의 광고를 함께 할당합니다. 더 많은 광고 물량 확보를 위해 ADN 연동을 권장합니다. ADN 광고를 연동하기 위해서 (ver 2.25.x) 7. 추가 Adnetwork 연동를 참고하시기 바랍니다.