Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagejava
// 앱 모듈의 build.gradle
dependencies {
    implementation "com.buzzvil:buzzad-benefit:$benefitVersion" //3.1.0 이상의 버전 지정+"
    implementation "com.buzzvil:buzz-roulette:$rouletteVersion" // 2.2.1 이상의 버전 지정+"
}

3. 버즈빌 담당자에게 BuzzRoulette 사용 여부를 알려 주세요.

  • BuzzRoulette 적용을 위해 필요한 사항을 버즈빌 담당자가 설정합니다.

  • 룰렛 화면 상단의 타이틀을 최대 10자까지, 적립 리워드 단위(예: 캐시, 머니 등)를 최대 5자까지 변경할 수 있습니다. 변경이 필요한 경우 버즈빌 담당자에게 연락하세요.

    Image Added

Pangle ADN 연동하기

BuzzRoulette에 광고를 공급하려면 Pangle ADN을 연동해야 합니다.
Pangle ADN을 연동하려면 다음의 절차를 따르세요.

  1. 프로젝트 레벨의 build.gradle 파일에 Pangle ADN 저장소를 추가하세요.

    Code Block
    languagejava
    // 프로젝트 레벨의 build.gradle
    allprojects { 
        repositories {
            maven { url 'https://artifact.bytedance.com/repository/pangle' } //pangle ADN 저장소 추가
        }
    }
  2. 앱 모듈의 build.gradle 파일에서 dependencies 블록에  implementation 원격 바이너리 종속 항목의 구성을 지정하세요.

    Code Block
    languagejava
    // 앱 모듈의 build.gradle
    dependencies {
        implementation 'com.pangle.global:ads-sdk:3.5.0.5'
    }
  3. AndroidManifest.xml 파일에서 WAKE_LOCK 권한과 제공자를 추가하세요.

    Code Block
    languagexml
    <manifest>
        <application> 
           <!-- 애플리케이션 태그 사이에 제공자를 추가하세요. -->
           <provider 
               android:name="com.bytedance.sdk.openadsdk.multipro.TTMultiProvider" 
               android:authorities="${applicationId}.TTMultiProvider" 
               android:exported="false" />
        </application>
        <!-- textureView로 재생되는 동영상 광고의 블랙스크린 발생을 방지하기 위해 추가하는 권한입니다. -->
        <uses-permission android:name="android.permission.WAKE_LOCK" />
    </manifest>     
  4. 프로젝트 레벨의 proguard-rules.pro 파일에 난독화 방지 설정을 추가하세요.

    Code Block
    languagejava
    // 프로젝트 레벨의 proguard-rules.pro 파일
    
    -keep class com.bytedance.sdk.** { *; } 
    -keep class com.pgl.sys.ces.* {*;}
Note

난독화 방지 설정을 하지 않으면 Pangle ADN이 공급하는 광고를 정상적으로 게재하지 못할 수 있습니다.

Feed 툴바에 룰렛 아이콘 추가하기

Feed 지면과 Pop Feed 지면의 툴바에 룰렛 아이콘을 추가하여 사용자가 BuzzRoulette을 사용할 수 있는 엔트리 포인트를 제공할 수 있습니다. SDK에서 아이콘 생성을 위한 코드를 설정하고 버즈빌이 서버에서 BuzzRoulette 활성화 설정을 완료하면 룰렛 아이콘이 표시됩니다.

Note
  • 룰렛 아이콘을 표시하거나 제거하려면 반드시 버즈빌의 서버 설정이 병행되어야 합니다.

  • 버즈빌이 서버에서 BuzzRoulette을 비활성화한 앱에는 룰렛 아이콘이 표시되지 않습니다.

  • 버즈빌 서버에서 변경된 설정이 적용되기까지 최대 6시간이 소요될 수 있습니다.

Info

Custom View로 직접 구현한 툴바에는 룰렛 아이콘을 추가할 수 없습니다.

FeedToolbar에 룰렛 아이콘 추가하기

BuzzAd Android용 SDK에서 제공하는 FeedToolbar 기본 UI를 수정하여 Feed 툴바에 룰렛 아이콘을 추가할 수 있습니다. 룰렛 아이콘을 추가하려면 addRouletteMenuItemView를 호출하세요.

...

Code Block
languagejava
public class YourFeedToolbarHolder extends DefaultFeedToolbarHolder {

    @Override
    public View getView(Activity activity, @NonNull final String unitId) {
        toolbar = new FeedToolbar(activity); // FeedToolbar에서 제공하는 기본 템플릿을 사용합니다.
        // ...생략 ...
        addRouletteMenuItemView(activity); // 룰렛 버튼을 이 함수를 통해 추가할 수 있습니다.
        return toolbar;
    }
    ...
}

PopToolbar에 룰렛 아이콘 추가하기

BuzzAd Android용 SDK에서 제공하는 PopToolbar 기본 UI를 수정하여 Pop Feed 툴바에 룰렛 아이콘을 추가할 수 있습니다. 룰렛 아이콘을 추가하려면 addRouletteMenuItemView를 호출하세요.

Code Block
languagejava
class YourPopToolbarHolder extends DefaultPopToolbarHolder {
    @Override
    public View getView(Activity activity, @NonNull final String unitId) {
        toolbar = new PopToolbar(activity); // PopToolbar 에서 제공하는 기본 Template 사용
        // ...생략 ...
        addRouletteMenuItemView(activity); // 룰렛 버튼 추가
        // ...생략 ...
        return toolbar;
    }
    ...
}

티켓박스 푸시 알림 기능

티켓박스 푸시 알림은 사용자에게 획득할 수 있는 티켓 또는 티켓박스가 있음을 알리는 로컬 푸시 알림입니다. 티켓박스는 사용자가 광고에 참여하지 않아도 룰렛용 티켓을 하루에 한 번 획득할 수 있는 기능으로, 룰렛 화면에 진입하는 비율을 효과적으로 높이는 기능을 수행합니다.

...