Domob Android DBox SDK

关于多宝屋

请参见 About DBox

必要条件

Android sdk 2.2或更高版本

获取SDK

请发送邮件到 support-dbox@domob.cn 获取最新的 Android DBox SDK 发行包。

配置资源及权限

1 多宝屋内含丰富的界面交互，并自带两套模版，这些资源('res/'目录下)需要拷贝到宿主项目，与宿主项目融合。具体包括图片资源、布局资源、字符串资源、颜色资源、样式主题资源等。

2 配置应用权限，这些权限主要用于接入网络、标示设备、定位用户等。若原程序已添加，无需重复添加，若程序尚未包含，请添加以下权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

3 拷贝libs下面的jar包dbox_sdk.jar到项目中，并且 Add to Build Path。

SDK的使用方式和步骤

开发者可以使用 SDK 提供的模版 UI 和 Control 来展示多宝屋广告，可以节省一些界面开发的时间。效果如下：

入口	主界面

上面是 Demo 应用对模版的使用效果，当点击“加载数据”后，多宝屋模版入口即可弹出，并按照服务器后台设置的模式(如，平铺、卡片等)展现广告。

下面就Demo为例，详细说明模版的使用步骤

1 准备好申请的开发者ID(Publisher ID)和多宝屋的广告位 ID(Placement ID)。

public final static String publisherID = "56OJw+rouN8xags3p9";
public final static String placementID = "16TLuFnvAp2psNU06G25s9Si";

2 声明 DBoxManager，并设置DBoxViewListener监听。应用会在关键时刻回调。

// 初始化DBoxManager对象
mDBoxManager = new DBoxManager(mContext, publisherID,placementID);
//设置关键时刻回调
mDBoxManager.setDBoxViewListener(new DBoxViewListener() {

    @Override
    public void onSuccessReceiveData(String entranceRemind) {
        // 当获取到数据时回调，entranceRemind参数为入口提醒标示，

    }

    @Override
    public void onFailReceiveData(String errorInfo) {
        // 当获取数据失败时回调，errorInfo为错误原因

    }

    @Override
    public void onDBoxViewClosed() {
        // 当界面被关闭时回调

    }

    @Override
    public void onLeaveApplication() {
        // 当离开宿主应用时，如打开外置浏览器，调出拨号盘等

    }

    @Override
    public void onDBoxViewPresent() {
        // 当开始展现多宝屋界面时

    }
});

3 预先获取广告数据(不展现界面)，若不需要预先加载数据，可忽略此歩。可以在你App界面启动阶段获取，也可以在某个按钮点击后获取。

// 预加载，至于预先加载的时机，建议应用启动后，或者入口展现后
mDBoxManager.preLoadData();

4 展现多宝屋页面,直接调用pressentWall()方法即可。

//展现多宝屋界面
mDBoxManager.presentWall();

5 在入口展现时，发送入口展现报告。

// 入口展现报告，切记一定要放在多宝屋“入口”真正展现的时候
mDBoxManager.doEntryReports(EntryReportType.ENTRY_IMP);

6 在“入口”点击时，发送入口点击报告。

// 入口点击报告
mDBoxManager.doEntryReports(EntryReportType.ENTRY_CLK);

备注

1 DBoxManager支持多个广告位，也就是说，我们可以用不同的广告位ID(Placement ID)来实例化多个DBoxManager；

2 通过后台设置，我们也可以使不同广告位ID的DBoxManager展示不同模式的入口界面，即平铺模式和卡片模式；

SDK模版嵌入方式

SDK 附带的demo展示了三种SDK模版嵌入方式，分别是：

1 固定&弹出最常用也是最普通的方式，如，设定一个界面上的按钮作为多宝屋的入口，那么当点击某个按钮时，入口界面即弹出；

固定&弹出	主界面

2 小把手&弹出为节省界面空间，也可以用一个侧边把手来作为入口，当点击后，弹出入口界面。

小把手&弹出	主界面

3 嵌入式将多宝屋的界面融入您的app之中，使其自然成为app的一部分，

嵌入式	主界面

具体的使用请参见SDK所附带的demo程序。

注意事项

多宝屋 Android SDK集成注意事项：

Publisher ID 和 Placement ID 一定要用媒体自己申请的，不要用多宝屋Demo中的默认 ID；
发送入口点击报告
发送入口展现报告：

请您在集成完毕后务必逐一核查以上各项。保证各项的正确性，以免影响收入。

审核注意事项

如有任何问题，请直接联系客服 support-dbox@domob.cn。