...
| Expand | |||||
|---|---|---|---|---|---|
| |||||
Lockscreen Activity의 특정한 style 설정이 Android OS 8.0 버전에서 크래시가 발생할 수 있으므로 확인이 필요합니다.
|
준비 사항
항목 | 설명 | 비고 | |
|---|---|---|---|
| 1 | 연동 앱 로그인을 위한 API 서버 | BuzzScreen SDK에 사용자 정보를 등록하기 위한 API입니다. | |
| 2 | 포인트 적립 요청 수신 API | 버즈빌 서버에서 포인트 적립 요청을 보낸 이후, 실제 포인트 지급을 처리할 매체사 API 서버입니다. | |
| 3 | 연동을 위한 키 값 | 버즈빌 BD 매니저로부터 발급받은
|
BuzzScreen 연동하기
1 단계. build.gradle , AndroidManifest.xml 설정
...
| Code Block | ||
|---|---|---|
| ||
repositories {
maven { url "https://dl.buzzvil.com/public/maven" }
}
dependencies {
implementation 'com.buzzvil:buzzscreen:4.3337.+'
} |
| Warning |
|---|
BuzzAd Android용 SDK도 연동하고 있는 경우, 빌드 시 |
...
연동을 위해 초기화, 사용자 정보 설정, 잠금화면 제어 설정을 순서대로 진행하세요.
1) 초기화: init() 및 launch() 호출
항목 | 코드 | 호출 위치 | 설명 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
버즈스크린 초기화
|
|
|
| ||||||||
버즈스크린 시작
|
| 앱 실행 시 처음 실행되는 액티비티에 추가하세요. | - |
아래의 코드 예제를 참고하세요.
| Code Block | ||
|---|---|---|
| ||
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
// BuzzScreen 초기화
BuzzScreen.init("Unit ID", this, SimpleLockerActivity.class, R.drawable.image_on_fail);
}
}
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 앱 실행시 처음 실행되는 액티비티에 추가합니다.
BuzzScreen.getInstance().launch();
}
} |
...
| Note |
|---|
연령, 성별, 지역 등 사용자 정보를 설정하지 않는 경우 타겟팅이 설정된 광고가 보이지 않으므로, 사용자가 볼 수 있는 전체 광고의 수량이 줄어들게 됩니다. 사용자 정보 설정이 불가능한 경우 BD 매니저와 사전에 논의하시기 바랍니다. |
항목 | 코드 | 호출 위치 | 설명 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
사용자 정보 설정을 위한 객체 |
|
| 사용자 정보 설정할 수 있는 | |||||||
사용자 식별 값
|
|
| ||||||||
사용자 연령
|
| 사용자의 출생년도를 4자리 숫자로 입력하여 나이를 설정하세요. | ||||||||
사용자 성별
|
| 미리 정의된 String을 통해 형식에 맞추어 성별을 설정하세요.
| ||||||||
사용자 지역
|
| "시/도 + 공백 + 시/군/구" 형식으로 설정하세요.
| ||||||||
이 외
| 커스텀 타게팅 가이드 참고 | 매체사에서 원하는 사용자 정보로 타겟팅할 수 있습니다. |
아래의 코드 예제를 참고하세요.
| Code Block | ||
|---|---|---|
| ||
// 사용자 정보를 등록하는 코드입니다.
com.buzzvil.buzzscreen.sdk.UserProfile userProfile = BuzzScreen.getInstance().getUserProfile();
userProfile.setUserId("USER_ID");
userProfile.setBirthYear(1985);
userProfile.setGender(UserProfile.USER_GENDER_MALE);
userProfile.setRegion("서울특별시 관악구"); |
3) 잠금화면 제어 설정
항목 | 코드 | 호출 위치 | 설명 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
다른 앱 위에 표시 권한 획득
|
| 버즈스크린 활성화 시점 |
| |||||||||
버즈스크린 활성화
|
| 버즈스크린 활성화 시점
| 이 함수가 호출된 이후부터 잠금화면에 버즈스크린이 나타납니다.
| |||||||||
버즈스크린 비활성화
|
| 버즈스크린 비활성화 시점 | 이 함수가 호출되면 더 이상 잠금화면에 버즈스크린이 나타나지 않습니다. | |||||||||
사용자 로그아웃
|
| 사용자가 로그아웃하는 시점 | 이 함수는 | |||||||||
버즈스크린이 화면에서 사라지는 시간 설정
|
|
| 버즈스크린 액티비티가 화면에 뜬 뒤 일정 시간 동안 유저의 활동이 없을 경우 버즈스크린이 화면에서 사라집니다.
| |||||||||
잠금화면을 활성화한 후 실제로 잠금화면이 처음 준비가 된 시점 확인
|
| 활성화한 후 실제로 잠금화면이 처음 준비가 완료된 시점을 알고 싶을 때, 아래의 interface를 구현하여
| ||||||||||
Notification 커스텀
| 서비스 노티피케이션 문서 참고 | 버즈스크린을 활성화한 후 알림 패널에 생성된 알림의 icon, text 등을 수정하고자 하는 경우 |
4 단계. 다른 앱 위에 표시 권한 획득하기
Android 10부터 변경된 정책에 따라, 잠금화면을 띄우기 위해서는 다른 앱 위에 표시 권한을 획득해야 합니다. 이에 따라 BuzzScreen Android용 SDK는 사용자에게 해당 권한을 요청하는 메시지를 잠금화면과 인앱(In-App)에 노출해 권한 획득 지원 기능을 제공합니다.
...
버즈배너를 연동하려면 연동하려는 앱의 고유 식별자(App ID)와 광고 지면의 고유 식별자(Unit ID)가 필요합니다. ID를 발급받으려면 버즈빌 담당자에게 연락하세요.
ID 유형 | 설명 |
|---|---|
BuzzBannerAppID | 앱을 구분하게 하는 고유 App ID 입니다. |
BuzzBannerSecret | 앱을 구분하게 하는 고유 App Secret 입니다. |
PlacementID | 각 광고 지면을 구분하게 하는 고유 ID 입니다. 배너의 사이즈와 PlacementID 가 제대로 매칭되어야 광고 할당 및 노출이 정상적으로 이루어집니다. |
BuzzBanner 초기화
BuzzScreen을 초기화한 다음 바로 BuzzBanner를 초기화할 수 있습니다. 다음의 절차를 따르세요. .
...
| Code Block | ||||
|---|---|---|---|---|
| ||||
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
// BuzzScreen 초기화
BuzzScreen.init("Unit ID", this, SimpleLockerActivity.class, R.drawable.image_on_fail);
// BuzzBanner 초기화
BuzzScreen.getInstance().initBuzzBanner(this, "YOUR_BUZZ_BANNER_APP_ID", "YOUR_BUZZ_BANNER_APP_SECRET");
BuzzBannerConfig buzzBannerConfig = new BuzzBannerConfig.Builder()
.bannerSize(BuzzBanner.BannerSize.W320XH50)
.placementId("YOUR_BANNER_PLACEMENT_ID")
.build();
BuzzScreen.getInstance().setDefaultBuzzBannerConfig(buzzBannerConfig);
}
} |
사이즈 | Enum |
|---|---|
Banner 320 x 50 |
|
Banner 320 x 100 |
|
SimpleLockerActivity 사용하기
...
| Info |
|---|
|
ADN
| 버전 정보 | maven 저장소 | build.gradle(implementation) | ||||
|---|---|---|---|---|---|---|---|
Adfit(Kakao) | 3.12.7 |
|
| ||||
Cauly | 3.5.22 |
|
| ||||
Mobon | 1.0.0.54 |
|
| ||||
Pangle | 4.7.1.4 |
|
| ||||
UnityAds | 4.3.0 |
|
| ||||
Vungle | 6.11.0 |
|
| ||||
Coupang | 1.2.8 |
|
쿠팡 SDK 1.2.1 버전이 포함되어 있습니다. | ||||
AppLovin(11.3.3) | 1.2.8 |
|
AppLovin SDK 11.3.3 버전이 포함되어 있습니다.
|
한줄뉴스(BuzzHeadlineNews)
한줄뉴스(BuzzHeadlineNews)는 BuzzScreen 4.31.x 부터 버즈스크린에 노출되는 비보상 콘텐츠입니다.
...