본문으로 건너뛰기
:docs

버즈배너(BuzzBanner)

버즈배너(BuzzBanner)는 사용자 경험을 고려한 동시에 인벤토리 수익을 증대할 수 있는 비보상형 광고 상품입니다. 버즈배너는 피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 연동할 수 있으며, 이 외에도 원하는 위치 어디에나 연동할 수 있습니다.

버즈배너 연동하기

피드, 팝 피드, 광고 참여 안내 페이지 하단에 연동하기

피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 코드 수정 없이 쉽고 버즈배너를 연동할 수 있습니다. 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.

원하는 위치에 버즈배너 연동하기

원하는 위치에 버즈배너를 연동하려면 다음의 절차를 따르세요.

  1. 원하는 버즈배너 사이즈를 결정하세요.

버즈배너 사이즈

SizeEnum
Banner 320 x 50BuzzBanner.BannerSize.W320XH50
Banner 320 x 100BuzzBanner.BannerSize.W320XH100
Banner DYNAMICBuzzBanner.BannerSize.DYNAMIC
  1. 버즈빌 담당자에게 연락하여 연동을 위한 Placement ID, Banner Size 를 받으세요.
ID 유형설명
Placement ID각 광고 지면을 구분하게 하는 고유 ID 입니다. 배너의 사이즈와 PlacementID 가 제대로 매칭되어야 광고 할당 및 노출이 정상적으로 이루어집니다.
Banner Size노출되는 버즈배너의 사이즈를 결정해주는 값입니다.
  1. 원하는 위치에 BuzzBannerView 를 추가하세요.
XML
<com.buzzvil.buzzbanner.BuzzBannerView
    android:id="@+id/buzzBannerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

버즈배너 Placement ID와 사이즈 설정하기

버즈배너 Placement ID와 사이즈를 설정하는 방법은 두 가지가 있습니다.

XML 파일에서 속성으로 설정하기

XML
<com.buzzvil.buzzbanner.BuzzBannerView
    android:id="@+id/buzzBannerView"
    app:bz_placement_id="BANNER_PLACEMENT_ID"
    app:bz_banner_size="size_320x50"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

소스코드에서 설정하기

Java
private void setBuzzBannerConfig() {
    BuzzBannerConfig buzzBannerConfig = new BuzzBannerConfig.Builder()
            .bannerSize(BuzzBanner.BannerSize.W320XH50) // BuzzBanner.BannerSize.W320XH50 or BuzzBanner.BannerSize.W320XH100 or BuzzBanner.BannerSize.DYNAMIC
            .placementId("BANNER_PLACEMENT_ID")
            .build();

    BuzzBannerView buzzBannerView = findViewById(R.id.buzzBannerView);
    buzzBannerView.setBuzzBannerConfig(buzzBannerConfig);
}

BuzzBannerView 의 Lifecycle 관련 함수 호출하기

XML 파일 또는 소스코드에서 설정한 후에는 반드시 BuzzBannerView의 Lifecycle 관련 함수를 호출해 주어야 합니다.

Java
public class YourActivity extends AppCompatActivity {
    ...
    private BuzzBannerView buzzBannerView;
  
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_your);
        
        buzzBannerView = findViewById(R.id.buzzBannerView);
        setBuzzBannerConfig();
    }
  
    private void setBuzzBannerConfig() {
        BuzzBannerConfig buzzBannerConfig = new BuzzBannerConfig.Builder()
                .bannerSize(BuzzBanner.BannerSize.W320XH50) // BuzzBanner.BannerSize.W320XH50 or BuzzBanner.BannerSize.W320XH100
                .placementId("BANNER_PLACEMENT_ID")
                .build();

        buzzBannerView.setBuzzBannerConfig(buzzBannerConfig);
    }

    @Override
    protected void onResume() {
        super.onResume();

        buzzBannerView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();

        buzzBannerView.onPause();
    }

    @Override
    protected void onDestroy() {
        buzzBannerView.onDestroy();

        super.onDestroy();
    }
    ...
}

옵션: 버즈배너 광고 콜백 리스너 등록하기

배너 광고에 대한 콜백을 받기 위해 BuzzBannerView에 Load 상태를 따르는 리스너를 등록할 수 있습니다.

Java
public class YourActivity extends AppCompatActivity {
    ...
    // 배너 광고의 상태를 얻기 위한 리스너
    private final BuzzBannerViewListener buzzBannerViewListener = new BuzzBannerViewListener() {
        @Override
        public void onClicked() {
            Log.d("BuzzBannerViewListener", "onClicked()");
        }

        @Override
        public void onFailed(@NonNull AdError adError) {
            Log.d("BuzzBannerViewListener", "onFailed(" + adError + ")");
        }

        @Override
        public void onLoaded() {
            Log.d("BuzzBannerViewListener", "onLoaded()");
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...

        // 리스너 등록
        buzzBannerView.setBuzzBannerViewListener(buzzBannerViewListener);
    }
    ...
}

BuzzBanner 수익 증대를 위한 ADN 추가 연동

BuzzBanner의 매출 극대화를 위해 추가 연동 가능한 Ad Network 연동 가이드입니다.

Adfit(Kakao) & BizBoard

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { 
            url 'https://devrepo.kakao.com/nexus/content/groups/public/'  
        } 
    }
}
  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-adfit:3.2.2.32"

}

AdMob & GAM

  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-admob:3.2.2.32"

}
  1. AdMob 가이드에 따라 키를 발급 받아서 manifest 에 키를 추가하세요.
manifest
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

AppLovin

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation 
com.avatye.cashblock:ad-plus-applovin:3.2.2.32"

}

Cauly

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven {
            url "s3://repo.cauly.net/releases"
            credentials(AwsCredentials) {
                accessKey "AKIAWRZUK5MFKYVSUOLB"
                secretKey "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"
            }
        }
    }
}
  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-cauly:3.2.2.32"

}

Facebook Audience Network

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-fan:3.2.2.32"

}

Fyber

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-fyber:3.2.2.32"

}

MezzoMedia

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-mezzomedia:3.2.2.32"

}

Mobon

  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-mobon:3.2.2.32"

}
  1. 버즈빌 매니저에게 요청하여 키를 발급받아서 manifest 에 키를 추가하세요.
manifest
<meta-data
	android:name="com.mobon.sdk.MediaCode"
    android:value="YOUR_mobon_code"/>

Pangle

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { url 'https://artifact.bytedance.com/repository/pangle' }
    }
}
  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-pangle:3.2.2.32"

}

UnityAds

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-unity:3.2.2.32"

}

Vungle

App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.

build.gradle · 코드
// 모듈 레벨의 build.gradle


dependencies { 

    implementation "com.avatye.cashblock:ad-plus-vungle:3.2.2.32"

}