Skip to content
:docs

BuzzBanner

BuzzBanner is a non-rewarded ad product that increases inventory revenue while taking the user experience into account. Integrate BuzzBanner below Feed, Pop Feed or the ad participation guide page, or place it anywhere else you choose.

Integrate BuzzBanner

Add BuzzBanner below Feed, Pop Feed or the ad participation guide page

Add BuzzBanner in these areas without changing code. Contact your Buzzvil representative to enable it.

Integrate BuzzBanner at a custom location

Follow these steps to integrate BuzzBanner wherever you choose.

  1. Choose a BuzzBanner size.

BuzzBanner sizes

SizeEnum
Banner 320 x 50BuzzBanner.BannerSize.W320XH50
Banner 320 x 100BuzzBanner.BannerSize.W320XH100
Banner DYNAMICBuzzBanner.BannerSize.DYNAMIC
  1. Contact your Buzzvil representative to obtain a Placement ID and Banner Size for the integration.
ID typeDescription
Placement IDA unique ID that identifies each ad placement. The banner size must match the Placement ID for ads to be allocated and displayed correctly.
Banner SizeDetermines the size of the displayed BuzzBanner.
  1. Add BuzzBannerView at the desired location.
XML
<com.buzzvil.buzzbanner.BuzzBannerView
    android:id="@+id/buzzBannerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

Configure the BuzzBanner Placement ID and size

There are two ways to configure the BuzzBanner Placement ID and size.

Set attributes in 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" />

Configure in source code

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

Call lifecycle methods on BuzzBannerView

After configuring the banner in XML or source code, you must call the lifecycle methods on BuzzBannerView.

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

Optional: Register an ad callback listener

To receive banner ad callbacks, register a listener on BuzzBannerView that follows the loading state.

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

Integrate additional ad networks to increase BuzzBanner revenue

Follow this guide to integrate additional ad networks and maximize BuzzBanner revenue.

Adfit(Kakao) & BizBoard

  1. Add the following code to the project-level build.gradle file.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { 
            url 'https://devrepo.kakao.com/nexus/content/groups/public/'  
        } 
    }
}
  1. Add the following code to the app-level build.gradle file.
build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

AdMob & GAM

  1. Add the following code to the app-level build.gradle file.
build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}
  1. Obtain a key by following the AdMob guide, and add it to the manifest.
manifest
<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

AppLovin

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

Cauly

  1. Add the following code to the project-level build.gradle file.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven {
            url "s3://repo.cauly.net/releases"
            credentials(AwsCredentials) {
                accessKey "AKIAWRZUK5MFKYVSUOLB"
                secretKey "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"
            }
        }
    }
}
  1. Add the following code to the app-level build.gradle file.
build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

Facebook Audience Network

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

Fyber

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

MezzoMedia

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

Mobon

  1. Add the following code to the app-level build.gradle file.
build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}
  1. Request a key from your Buzzvil representative and add it to the manifest.
manifest
<meta-data
	android:name="com.mobon.sdk.MediaCode"
    android:value="YOUR_mobon_code"/>

Pangle

  1. Add the following code to the project-level build.gradle file.
build.gradle · Groovy
// 프로젝트 레벨의 build.gradle

allprojects {
    repositories {
        maven { url 'https://artifact.bytedance.com/repository/pangle' }
    }
}
  1. Add the following code to the app-level build.gradle file.
build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

UnityAds

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}

Vungle

Add the following code to the app-level build.gradle file.

build.gradle · Code
// 모듈 레벨의 build.gradle


dependencies { 

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

}