• 버즈스크린의 UI 및 동작을 커스터마이징하고 싶다면 고급 설정을 참고하여 구현하세요.

• 사용자가 룰렛을 돌려 리워드를 획득할 수 있는 버즈룰렛(BuzzRoulette)을 추가할 수 있습니다. 고수익성의 광고를 제공하고 사용자의 광고 참여 유도에 효과적인 버즈룰렛을 추가하려면 BuzzRoulette 연동 가이드를 참고하세요.

Lockscreen Activity의 특정한 style 설정이 Android OS 8.0 버전에서 크래시가 발생할 수 있으므로 확인이 필요합니다.

• 발생 조건: Android API 26의 설정으로 인해 아래 조건을 모두 충족하는 경우

  1. 앱의 targetSdkVersion 이 27 이상인 경우

  2. 사용자 모바일 기기 OS 버전이 8.0(API 26)인 경우

  3. Lockscreen Activity에 적용된 style에 windowTranslucent, windowIsFloating, windowSwipeToDismiss 중 1개 이상이 true로 설정되어 있는 경우

• 해결 방안

  • styles.xml 에서 windowTranslucent, windowIsFloating,windowSwipeToDismiss 중 true로 세팅된 항목을 제거 또는 false로 변경

<resources>
...
    <style name="YourLockScreenTheme" parent="@style/AppTheme">
        <!-- Items below need to be removed or set to false on specific conditions-->
        <item name="android:windowIsTranslucent">false</item>
        <item name="android:windowIsFloating">false</item>
        <item name="android:windowSwipeToDismiss">false</item>
    </style>
</resources>

android {
    compileSdkVersion 34

    defaultConfig {
        targetSdkVersion 34
    }
} 

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();
    }
}

연령, 성별, 지역 등 사용자 정보를 설정하지 않는 경우 타겟팅이 설정된 광고가 보이지 않으므로, 사용자가 볼 수 있는 전체 광고의 수량이 줄어들게 됩니다. 사용자 정보 설정이 불가능한 경우 BD 매니저와 사전에 논의하시기 바랍니다.

// 사용자 정보를 등록하는 코드입니다.
com.buzzvil.buzzscreen.sdk.UserProfile userProfile = BuzzScreen.getInstance().getUserProfile();
userProfile.setUserId("USER_ID");
userProfile.setBirthYear(1985);
userProfile.setGender(UserProfile.USER_GENDER_MALE);
userProfile.setRegion("서울특별시 관악구");

Android 12부터는 다른 앱 위에 표시 권한을 획득하지 않으면 아래의 문제가 발생할 수 있습니다.

• 일부 모바일 기기에서 잠금화면을 실행할 때 잠금화면 기능이 정상적으로 작동하지 않을 수 있습니다.다.

• 기본 보안 기능 화면 속성 수정 토픽에 안내된 기본 보안 기능 화면이 나타나지 않습니다. 이는 특히 Google Play 정책에 따라 앱 등록 거부를 초래할 수 있으므로 반드시 다른 앱 위에 표시 권한을 요청하는 기능을 추가하세요.

BuzzScreen.init("app_key", this, SimpleLockerActivity.class, R.drawable.image_on_fail, Constants.useGDPR ? BuzzScreen.PrivacyPolicy.GDPR : BuzzScreen.PrivacyPolicy.NONE);
                
BuzzScreen.getInstance().setSecurityConfiguration(
        new SecurityConfiguration.Builder().
                   backgroundResourceId(R.drawable.your_drawable).
                   backgroundImageScaleType(ImageView.ScaleType.FIT_CENTER).
                   backgroundColor(Color.WHITE).
                   backgroundDimAlpha(0.7f).                
                   showClock(true).
                   showDescription(true).
                   build());

// BuzzBannerViewLisetner.java

interface BuzzBannerViewListener {
    public void onLoaded()
    public void onFailed(AdError adError)
    public void onClicked()
}

한줄뉴스의 매출 최적화를 위한 사전 세팅을 할 수 있도록, 반드시 버즈빌 담당자에게 연락하여 연동 계획을 공유해 주시기 바랍니다.

유의사항

한줄뉴스의 위치는 자유롭게 설정이 가능하나, 화면의 상단 기준 630px 이내 또는 하단 기준 630px 이내에 배치하는 것을 권장합니다. 해당 영역을 벗어나게 되면 광고가 가려질 수 있습니다.

// CustomLockerActivity.java
public class CustomLockerActivity extends BaseLockerActivity {
  ...
  BuzzHeadlineNewsView buzzHeadlineNewsView;
  ...
  
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_custom_locker);
    ...
    buzzHeadlineNewsView = findViewById(R.id.buzzHeadlineNewsView);
    bindBuzzHeadlineNews(buzzHeadlineNewsView);
    ...
  }
}

버즈캐시버튼 노출을 위한 사전 세팅이 필요하여, 반드시 버즈빌 담당자에게 연락하여 연동 계획을 공유해 주시기 바랍니다.

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
        maven { url 'https://dl.buzzvil.com/public/maven' }
        maven { url 'https://artifact.bytedance.com/repository/pangle' }
        maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
        maven { url 'https://raw.githubusercontent.com/coupang-ads-sdk/android/main' }
        maven {
          url "s3://repo.cauly.net/releases"
          credentials(AwsCredentials) {
            accessKey "AKIAWRZUK5MFKYVSUOLB"
            secretKey "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"
          }
        }
    }
}

dependencies {
    // Buzzvil BOM
    api platform("com.buzzvil:buzzvil-bom:$buzzvilBomVersion")
    implementation "com.buzzvil:buzzscreen"
    implementation "com.buzzvil:buzz-cashbutton" // 버즈캐시버튼 종속성 추가
}

dependencies {
    ....
    implementation ("com.buzzvil:buzz-roulette") {
        exclude group: 'com.avatye.cashbutton.buzzvil', module:'archive-ads-mezzomedia'
    }
}