Android Access Guide

Quick integration

This document introduces how to integrate the Android-side HadesAdx SDK (hereinafter referred to as SDK), The SDK supports banner advertising (Banner), interstitial advertising (Interstitial) and open-screen advertising (Splash).

1．Import and configuration

 

 

2．Initialization

//You need to pass in the tokenid and appid applied by the developer platform.

HDSCore.initialization(context, "tokenid", "appid");

 

3．Splash ad

// Interface initialization
// Parameters 1: Activity handle
// Parameters 2: Placement ID
// Parameters 3: Countdown(by seconds)
HDSSplash hdsSplash = new HDSSplash(MainActivity.this, "PI00000004", 10);
// Advertising status monitoring
hdsSplash.setSplashListener(new HDSSplashListener() {
	@Override
	public void onSplashLoaded() {
		// Ad loaded successfully
	}
	@Override
	public void onSplashLoadedFail(HDSADError var1) {
		// Ad loading failed
	}
	@Override
	public void onSplashClick() {
		// Click ad
	}
	@Override
	public void onSplashShow() {
		// Display ad
	}
	@Override
	public void onSplashShowFail() {
		// Display ad failed
	}
	@Override
	public void onSplashClose() {
		Intent intent = new Intent(MainActivity.this, TargetActivity.class);
		finish();
		startActivity(intent);
	}
});
// Load advertising
hdsSplash.loadAd();

// Display advertising, and call display after receiving onSplashLoaded callback：
if (hdsSplash!= null && hdsSplash.isAdReady()) {
	hdsSplash.show();
}

 

4．Interstitial ad

HDSInterstitial interstitial = new HDSInterstitial(MainActivity.this);
// Set advertising placement ID
interstitial.setPlacementId("PI00000002");
// Advertising status monitoring
interstitial.setInterstitialListener(new HDSInterstitialListener() {
	@Override
	public void onInterstitialLoaded() {
		// Ad loaded successfully
	}

	@Override
	public void onInterstitialLoadFail(HDSADError var1) {
	   // Ad loading failed
	}

	@Override
	public void onInterstitialClicked() {
	   // Click ad
	}

	@Override
	public void onInterstitialShow() {
	   // Display ad
	}

	@Override
	public void onInterstitialShowFail() {
	   // Display ad failed
	}

	@Override
	public void onInterstitialClose() {
	   // Close ad
	}
});
// Load advertising
interstitial.loadAd();

// Display advertising, and call display after receiving onInterstitialLoaded callback：
if (interstitial!= null && interstitial.isAdReady()) {
	interstitial.show();
}

 

5．Banner ad

Add a View to display the banner in the layout

<FrameLayout
    android:id="@+id/view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"/>

Code

HDSBanner banner = new HDSBanner(MainActivity.this);
// Set advertising placement ID
banner.setPlacementId("PI00000001");
// Set the banner display position. Currently, the default banner display size is 320*50, and the display position supports Banner_TOP, Banner_CENTER, and Banner_BOTTOM
banner.setBannerPosition(HDSBannerPosition.Banner_TOP);
// Advertising status monitoring
banner.setListener(new HDSBannerListener() {
    @Override
    public void onBannerLoaded() {
       // Ad loaded successfully
    }

    @Override
    public void onBannerFailed(HDSADError var1) {
        // Ad loading failed
    }

    @Override
    public void onBannerClicked() {
        // Click ad
    }

    @Override
    public void onBannerShow() {
        // Display ad
    }

    @Override
    public void onBannerClose() {
        // Close ad
    }
});
// Load advertising
banner.loadAd();

You can choose :

① Display advertising after receiving onBannerLoaded callback

FrameLayout view = findViewById(R.id.view);
view.removeAllViews();
view.addView(banner.getView());

② Or directly display

if (banner.isAdReady()) {
	banner.show();
}

 

6．Error code description

HadesAdx SDK error code information description

Error code	Description
10000	Initialization not completed
10001	Request too frequently
10002	Server error
10003	There is no ad response
10004	Network error
10005	Advertising error