ADs+

Appearance

一、简介 ​

主要介绍在Android项目中如何集成 AdsPlus SDK的开屏广告：

二、代码集成 ​

1、在自己的Application 中初始化SDK ​

上线请替换正式的APPID

java
ADP.initialize(new ADPConfig.Builder()
             //  默认false
                            // true-屏蔽个性化推荐广告(关闭)
                            //false-不屏蔽个性化推荐广告(打开)
                            .setPersonalRecommend(false)
                            .setDebug(true).build(),
                    "adp-app-6447554214", this, new ADP.InitCallback() {
                        @Override
                        public void onSuccess() {

                        }

                        @Override
                        public void onError(AdpError error) {
                           
                        }
                    });

2、创建Activity设置为MAIN入口 ​

java
<activity
            android:name=".SplashActivity"
            android:label="@string/app_name"
            android:exported="true"
            android:launchMode="singleTask"
            android:screenOrientation="portrait"
            android:windowSoftInputMode="stateHidden|stateAlwaysHidden"
            android:theme="@style/Theme.Testsdk.NoActionBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

3、创建布局文件 ​

java
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!--  避免第一次授权时界面空白 这里设置自己的启动背景图片和logo-->
    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <RelativeLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:background="@android:color/white">
            <!--  启动时默认的logo-->
            <ImageView
                android:id="@+id/app_logo"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_alignParentBottom="true"
                android:layout_centerHorizontal="true"
                android:src="@drawable/ad_logo" />
            <!--  启动时默认的背景-->
            <ImageView
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:layout_above="@id/app_logo"
                android:scaleType="fitXY"
                android:src="@drawable/ad_splash_holder" />
        </RelativeLayout>
	  <!-- 开屏传入进去的布局 这个布局文件不能隐藏不然不会计算收入-->
        <LinearLayout
            android:id="@+id/splashLayout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical"></LinearLayout>
    </FrameLayout>


</LinearLayout>

4、初始化对象并且打开广告并监听 ​

*** 应用上线时请替换为正式的广告位ID***

测试posid：adp-unit-1354914108

java

/*
         *  activity activity
         *  splashAdId 广告位ID
         *  layout  要添加到布局文件
         *  fetchDelay 拉取广告的超时时长：取值范围[3000, 5000]，设为0默认的超时时长。
         *  isFullScreen 是否全屏 全屏不显示LOGO
         *  logoid 启动logo图片id 
         *  logobackgroundid APP启动背景ID可以默认0
         *  adpSplashADListener 监听器
         */
        ADPSplashAdLoader adLoader = new ADPSplashAdLoader(activity, posId, adContainer,
                fetchDelay, true, R.drawable.ad_logo, R.drawable.ad_splash_holder, this);
              
       
       public interface ADPSplashADListener {
       //关闭
        void onADDismissed();
		//错误
        void onADError(AdpError var1);
		//展示
        void onADPresent();
		//点击
        void onADClicked();
		//倒计时有些没有
        void onADTick(long var1);
		//收到广告加载成功
        void onADReceive(long var1);
    }

5、加载广告 ​

java

  adLoader.loadAD();

6、打开广告 ​

java
在广告监听中等广告加载成功后再打开
 public void onADReceive(long expireTimestamp) {
		if(!isShow){
            // 隐藏自己的开机界面
            splashbg.setVisibility(View.GONE);
            isShow=true;
            //显示广告
            adLoader.showAD();
        }
 }

7、销毁广告 ​

 protected void onDestroy() {
        super.onDestroy();
        if(null!=adLoader){
            adLoader.destroy();
        }
    }

8、自定义下载信息展示 ​

自定义下载提示

java
adLoader.setDownloadConfirmListener(DownloadConfirmHelper.DOWNLOAD_CONFIRM_LISTENER );

9、个性化广告的开关 ​

初始化参数可以设置可性化是否开和关setPersonalRecommend

java
 new ADPConfig.Builder()
                            // true-屏蔽个性化推荐广告(关闭)
                            //false-不屏蔽个性化推荐广告(打开)
                            .setPersonalRecommend(false)
                            .setDebug(true).build()

10、注意事项 ​

1、在调试时如果出现5004或者102006等错误码时可能是当前设备请求广告过于频繁，请换台设备或稍后重试，或者多次点击几下;

2、 应用上线时请替换为正式的广告位ID

3、参考DEMO开屏代码

4、开屏需要屏蔽用户返回

java
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_BACK ) {
        return false;
    }
    return super.onKeyDown(keyCode, event);
}

5、如果需要app运行状态下回到桌面后再次打开开票可参考DEMO，DemoApplication onTrimMemory方法和BaseActivity中的onResume方法，时间一般不少于10分钟。