Page Comparison

...

BuzzAdPush SDK를 안드로이드에 연동하기 위한 문서입니다.
BuzzAdPush는 BuzzAd의 광고 상품 중 하나로 Push를 광고 지면으로 이용해 광고를 유저에게 보여줍니다. Notification 을 통해 유저가 Feed 지면에 진입할 수 있도록 도와줍니다.

유저가 잠금화면, Pop 등 앱의 별도 서비스를 사용할 때만 Push를 enable하도록 하는 것을 권장합니다.

SDK를 앱에 연동하기 전, 아래 사항을 먼저 준비해야 합니다.

...

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

Index

Table of Contents

...

Code Block
dependencies { implementation "com.buzzvil:buzzad-benefit-push:2.919.+" implementation 'com.android.support:multidex:1.0.3' }

Info
BuzzAdPush는 BuzzAdBenefit SDK에 통합되어 배포되고 있습니다.

...

Code Block
android { ... compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } } …

Step 2:

...

BuzzAdBenefit SDK 초기화

BuzzAdPop은 BuzzAdBenefit SDK에 통합되어 관리되고 있기 때문에 Pop을 Push을 초기화 하기 위해서 BuzzAdBenefit을 초기화 해야 합니다. 초기화 코드는 앱 실행시 한번만 실행하면 됩니다. 아래 코드는 init() 함수를 Application에서 호출해 주는 코드의 예시입니다.

APP_ID: 전달받은 app id 로 변경
UNIT_ID_PUSH: 전달받은 unit id 로 변경RestartReceiver 에서도 사용하므로 Application 클래스에 static 함수로 구현합니다.
PushDialogConfig 설정: PushDialog 관련 config 입니다.
- colorConfirm: 확인버튼 색상 color resource id
- colorCancel: 취소버튼 색상 color resource id
- imageRegisterLogo: register dialog 로고 이미지 drawable resource id
- imageUnregisterLogo: unregister dialog 로고 이미지 drawable resource id

Code Block

package ...
import ...
import com.buzzvil.buzzad.benefit.BuzzAdBenefit;
import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig;

public class App extends MultiDexApplication {
    
public static final String APP_ID = "APP_ID";
    public static final String UNIT_ID_PUSH = "UNIT_ID_PUSH";
         @Override
    public void onCreate() {
        super.onCreate();
        
        BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(APP_IDthis)
                .build();
        BuzzAdBenefit.init(this, buzzAdBenefitConfig);
    }
}

Step 3: 로그인

유저가 매체사 앱에 로그인한 시점에 아래와 같이 UserProfile 을 세팅합니다. 설정값 수정 시, 기존 user profile 값을 호출하여 수정 가능합니다.

주의 : User ID와 타게팅 정보 (성별, 연령)는 원활한 서비스 운영을 위해 제공해야 할 필수 항목입니다. 해당 값을 입력하는 setUserProfile 함수가 호출되지 않으면 광고가 제공되지 않습니다.

userId : 매체사 서비스 유저를 unique 하게 구분할 수 있는 식별값
- 매체사 서비스에서 유니크하다고 판단되는 유저에 대하여, userId 값이 복수 개 연동되거나 변경될 가능성이 있을 경우 사전에 BD 매니저와 논의해야 합니다.
- 예: 매체사 앱 삭제 후 재설치 시 userId 값이 변경되는 경우
gender
- UserProfile.Gender.MALE: 남성
- UserProfile.Gender.FEMALE: 여성
birthYear: 출생년도

Code Block

final UserProfile.Builder builder = new UserProfile.Builder(BuzzAdBenefit.getUserProfile());
final UserProfile userProfile = builder
        .userId("Your_Service_User_ID")
        .gender(UserProfile.Gender.MALE)
        .birthYear(1985)
        .build();
  
BuzzAdBenefit.setUserProfile(userProfile);

로그아웃 시에는 UserProfile을 null로 설정해 주는 작업이 필요합니다.

Code Block
BuzzAdBenefit.setUserProfile(null);

Step 4. Register/Unregister

Image RemovedImage Removed

그림 1. register 설명 다이얼로그 그림 2. register(시간설정) 다이얼로그

Register

Push 를 활성화 하기 위해서buzzAdPush.registerWithDialog() or buzzAdPush.register() 를 호출합니다. 한번 활성화 하면 설정된 시간에 광고 Notification 을 보여주게 됩니다.

FeedConfig 설정: FeedConfig 를 설정합니다.
- feedToolbarHolderClass: 피드의 타이틀을 설정합니다. 자세한 내용은 toolbar customize를 확인해주세요.
RewardNotificationConfig 설정: Reward 를 받았을 때 보여주는 Notification 의 Config 를 설정합니다.
NotificationConfig 설정: Push 의 Notification 관련 config 를 설정합니다.
- .putExtra(FeedActivity.EXTRA_CONFIG, feedConfig) 위에서 생성한 FeedConfig 를 설정합니다.

NotificationConfig 는 아래와 같이 NotificationWorker 를 상속받은 CustomNotificationWorker 클래스의 getNotificationConfig 함수를 오버라이딩 해서 설정합니다.

Code Block

public class CustomNotificationWorker extends NotificationWorker {
    public CustomNotificationWorker(@NonNull Context context,
    public static PushDialogConfig getPushDialogConfig() {
        return                             @NonNull WorkerParameters workerParams) {new PushDialogConfig.Builder()
         super(context, workerParams);     }
 .colorConfirm(R.color.colorAccent)
    @Override     @NonNull     public NotificationConfig getNotificationConfig() {.colorCancel(R.color.colorPrimary)
           final FeedConfig feedConfig = new FeedConfig.Builder(getApplicationContext(), App.UNIT_ID_NOTI_PLUSimageRegisterLogo(R.drawable.benefit_push_dialog_image_logo)
                .feedToolbarHolderClass(CustomFeedToolbarHolder::class.javaimageUnregisterLogo(R.drawable.benefit_push_dialog_image_logo)
                .build();
        final RewardNotificationConfig rewardNotificationConfig = new RewardNotificationConfig.Builder().build();
        return new NotificationConfig.Builder(App.}
}

Step 4. BuzzAdPush SDK 초기화

UNIT_ID_PUSH
BuzzAdPush 초기화
- unitId: Push unit id
- notificationWorkerClass: CustomNotificationWorker
- pushDialogConfig: PushDialog 관련 config

Code Block

language	java

String UNIT_ID_PUSH = "UNIT_ID_PUSH)";

BuzzAdPush          buzzAdPush = new BuzzAdPush(
    .putExtra(FeedActivity.EXTRA_CONFIGUNIT_ID_PUSH,
feedConfig)    CustomNotificationWorker.class,
            .build();
    }
}

...

PushDialogConfig 설정: PushDialog 관련 config 입니다.

colorConfirm: 확인버튼 색상 color resource id
colorCancel: 취소버튼 색상 color resource id
imageRegisterLogo: register dialog 로고 이미지 drawable resource id
imageUnregisterLogo: unregister dialog 로고 이미지 drawable resource id

...

App.getPushDialogConfig()
);

Register

Push 를 활성화 하기 위해서buzzAdPush.registerWithDialog() or buzzAdPush.register() 를 호출합니다. 한번 활성화 하면 설정된 시간에 광고 Notification 을 보여주게 됩니다.

FeedConfig 설정: FeedConfig 를 설정합니다.
- feedToolbarHolderClass: 피드의 타이틀을 설정합니다. 자세한 내용은 toolbar customize를 확인해주세요.
RewardNotificationConfig 설정: Reward 를 받았을 때 보여주는 Notification 의 Config 를 설정합니다.
NotificationConfig 설정: Push 의 Notification 관련 config 를 설정합니다.
- .putExtra(FeedActivity.EXTRA_CONFIG, feedConfig) 위에서 생성한 FeedConfig 를 설정합니다.

NotificationConfig 는 아래와 같이 NotificationWorker 를 상속받은 CustomNotificationWorker 클래스의 getNotificationConfig 함수를 오버라이딩 해서 설정합니다.

Code Block

public class AppCustomNotificationWorker extends MultiDexApplicationNotificationWorker {
    public CustomNotificationWorker(@NonNull Context context,
            ...           public static PushDialogConfig getPushDialogConfig() {         return@NonNull new PushDialogConfig.Builder(WorkerParameters workerParams) {
        super(context, workerParams);
     .colorConfirm(R.color.colorAccent)}

    @Override
    @NonNull
    public NotificationConfig .colorCancel(R.color.colorPrimarygetNotificationConfig() {
        final FeedConfig feedConfig = new   .imageRegisterLogo(R.drawable.benefit_push_dialog_image_logoFeedConfig.Builder(getApplicationContext(), App.UNIT_ID_NOTI_PLUS)
                .imageUnregisterLogo(R.drawable.benefit_push_dialog_image_logofeedToolbarHolderClass(CustomFeedToolbarHolder::class.java)
                .build();

   } }

BuzzAdPush 초기화
- unitId: Push unit id
- notificationWorkerClass: CustomNotificationWorker
- pushDialogConfig: PushDialog 관련 config

Code Block

BuzzAdPush buzzAdPush =  final RewardNotificationConfig rewardNotificationConfig = new BuzzAdPush( RewardNotificationConfig.Builder().build();
        return    new NotificationConfig.Builder(App.UNIT_ID_PUSH,)
                CustomNotificationWorker.class,.putExtra(FeedActivity.EXTRA_CONFIG, feedConfig)
                App.getPushDialogConfigbuild();
    }
);}

Image AddedImage Added

그림 1. register 설명 다이얼로그 그림 2. register(시간설정) 다이얼로그

1) Register with Description

...

Versions Compared

Old Version 12

New Version 13

Key

Step 2:

BuzzAdBenefit SDK 초기화

Step 3: 로그인

Step 4. Register/Unregister

Register

Step 4. BuzzAdPush SDK 초기화

Register

1) Register with Description