文档中心
Return to top
233乐园广告SDK文档
编辑

233乐园广告SDK文档 ​

文档版本修订日期说明
v1.0.12020.08.09创建文档
v1.0.22020.10.18更新联运广告接入
v1.0.32020.04.08优化广告展示
v1.0.42021.07.31添加插屏广告的支持
v1.0.4.12021.08.05优化初始化接口、新增unity插件
v1.0.4.22021.08.18优化播放视频广告接口
v1.0.52021.08.25添加Banner广告的支持
v1.0.62022.01.111、添加关闭Banner广告的功能 2、添加开启或关闭个性化广告推荐的开关
v1.0.72022.07.12修复部分bug提升稳定性

SDK说明 ​

SDK开发者： 北京龙威互动科技有限公司

SDK名称： 233乐园广告SDK

SDK主要功能： 用于广告投放活动，包括广告展示、监测、归因及投放效果分析与优化功能，提供个性化推荐服务。

用户信息与隐私策略 ​

如果您是开发者，在为用户提供服务前请阅读《233乐园广告SDK隐私政策》 与 《233乐园广告SDK合规使用说明》，了解SDK对个人信息收集范围、处理目的以及权限使用情况。请您向用户提供服务时，告知相关信息并取得用户同意。

如果您是用户，请在使用我们的服务前阅读《233乐园广告SDK隐私政策》 与 《233乐园广告SDK合规使用说明》，了解SDK对个人信息收集范围、处理目的以及权限使用情况。充分理解后再开始使用我们的服务。

SDK ​

参数申请 ​

请登录开发者后台，申请联运广告合作。 我们会返回给您以下参数：

参数说明
appKey应用的联运key

备注：关于联运合作，还可以接入登录和支付哦。

SDK集成 ​

下载广告SDK解压并将mpg-cm-v1.0.7.aar文件复制到您项目Project/app/libs文件夹下。

在您app的build.gradle中添加：

bash
dependencies {
    ...
    implementation files('libs/mpg-cm-v1.0.7.aar')
}
dependencies {
    ...
    implementation files('libs/mpg-cm-v1.0.7.aar')
}

unity游戏可直接使用压缩文件中的unity插件导入接口，无需单独拷贝aar

初始化接口 ​

示例代码

java
MetaAdApi.get().init(application, APP_KEY, new InitCallback() {
            @Override
            public void onInitSuccess() {
                Log.d(TAG, "onInitSuccess");
            }
            @Override
            public void onInitFailed(int errorCode, String errorMsg) {
              Log.d(TAG, String.format("onInitFailed: code: %1d,  msg: %2s", errorCode, errorMsg));
            }
        });
MetaAdApi.get().init(application, APP_KEY, new InitCallback() {
            @Override
            public void onInitSuccess() {
                Log.d(TAG, "onInitSuccess");
            }
            @Override
            public void onInitFailed(int errorCode, String errorMsg) {
              Log.d(TAG, String.format("onInitFailed: code: %1d,  msg: %2s", errorCode, errorMsg));
            }
        });

视频广告接口 ​

视频广告包含激励视频&全屏视频两种广告样式

示例代码

java
//pos: int值；平台申请的激励视频或全屏视频广告位ID
 MetaAdApi.get().showVideoAd(pos, new IAdCallback.IVideoIAdCallback() {
                @Override
                public void onAdShow() {
                    // 播放成功
                    Log.d("MetaAdApi", "onAdShow");
                }
                @Override
                 public void onAdShowFailed(int errCode, String errMsg) {
                    // 播放失败
                    Log.d("MetaAdApi", "onAdShowFailed： " + errMsg);
                }
                @Override
                public void onAdClick() {
                    //点击广告
                    Log.d("MetaAdApi", "onAdClick");
                }
                @Override
                public void onAdClose() {
                    //  广告关闭
                }
              
                @Override
                public void onAdClickSkip() {
                    // 播放点击跳过
                    Log.d("MetaAdApi", "onAdClickSkip");
                }
                @Override
                public void onAdReward() {
                    //发放激励
                    Log.d("MetaAdApi", "onAdReward");
                }
                @Override
                public void onAdClose(Boolean aBoolean) {
                    // 广告关闭, 废弃 ,建议使用onAdClose 和 onAdReward
                    Log.d("MetaAdApi", "onAdClose");
                }
            });
//pos: int值；平台申请的激励视频或全屏视频广告位ID
 MetaAdApi.get().showVideoAd(pos, new IAdCallback.IVideoIAdCallback() {
                @Override
                public void onAdShow() {
                    // 播放成功
                    Log.d("MetaAdApi", "onAdShow");
                }
                @Override
                 public void onAdShowFailed(int errCode, String errMsg) {
                    // 播放失败
                    Log.d("MetaAdApi", "onAdShowFailed： " + errMsg);
                }
                @Override
                public void onAdClick() {
                    //点击广告
                    Log.d("MetaAdApi", "onAdClick");
                }
                @Override
                public void onAdClose() {
                    //  广告关闭
                }
              
                @Override
                public void onAdClickSkip() {
                    // 播放点击跳过
                    Log.d("MetaAdApi", "onAdClickSkip");
                }
                @Override
                public void onAdReward() {
                    //发放激励
                    Log.d("MetaAdApi", "onAdReward");
                }
                @Override
                public void onAdClose(Boolean aBoolean) {
                    // 广告关闭, 废弃 ,建议使用onAdClose 和 onAdReward
                    Log.d("MetaAdApi", "onAdClose");
                }
            });

插屏广告接口 ​

示例代码：

java
//pos: int值；平台申请的插屏类型广告位ID
MetaAdApi.get().showInterstitialAd(pos, new IAdCallback() {
            @Override
            public void onAdShow() {
                //广告展示
            }
            @Override
            public void onAdShowFailed(int errCode, String errMsg) {
                //展示失败
            }
            @Override
            public void onAdClick() {
                //广告被点击
            }
            @Override
            public void onAdClose() {
                //广告被关闭
            }
        });
//pos: int值；平台申请的插屏类型广告位ID
MetaAdApi.get().showInterstitialAd(pos, new IAdCallback() {
            @Override
            public void onAdShow() {
                //广告展示
            }
            @Override
            public void onAdShowFailed(int errCode, String errMsg) {
                //展示失败
            }
            @Override
            public void onAdClick() {
                //广告被点击
            }
            @Override
            public void onAdClose() {
                //广告被关闭
            }
        });

Banner广告接口 ​

注意

该广告类型暂停使用，不进行展示

示例代码：

java
//pos: int值；平台申请的Banner类型广告位ID
MetaAdApi.get().showBannerAd(pos, new IAdCallback() {
            @Override
            public void onAdShow() {
                //广告展示
            }
            @Override
            public void onAdShowFailed(String s) {
                //展示失败
            }
            @Override
            public void onAdClick() {
                //广告被点击
            }
            @Override
            public void onAdClose() {
                //广告被关闭
            }
        });
//pos: int值；平台申请的Banner类型广告位ID
MetaAdApi.get().showBannerAd(pos, new IAdCallback() {
            @Override
            public void onAdShow() {
                //广告展示
            }
            @Override
            public void onAdShowFailed(String s) {
                //展示失败
            }
            @Override
            public void onAdClick() {
                //广告被点击
            }
            @Override
            public void onAdClose() {
                //广告被关闭
            }
        });

关闭Banner广告 ​

示例代码：

java
MetaAdApi.get().closeBannerAd();
MetaAdApi.get().closeBannerAd();

广告个性化推荐开关接口 ​

示例代码：

java
//isOpen: boolean值；true: 打开个性化开关；false: 关闭个性化开关；
boolean isOpen = true;
MetaAdApi.get().setPersonalRecommendAd(isOpen);
//isOpen: boolean值；true: 打开个性化开关；false: 关闭个性化开关；
boolean isOpen = true;
MetaAdApi.get().setPersonalRecommendAd(isOpen);

版本支持接口 ​

关于版本是否支持联运广告，除了在播放广告失败回调信息“version not support”外，还可以通过接口获取：

java

//参数type位广告类型，该方法不支持检测Banner类型
//取值：AdType.AD_TYPE_VIDEO  : 视频（激励&全屏）  
//     AdType.AD_TYPE_INTERSTITIAL ：插屏  
//
if (MetaAdApi.get().isInSupportVersion(int type)) {
    // 当前版本支持该广告类型
}

//参数type位广告类型，该方法不支持检测Banner类型
//取值：AdType.AD_TYPE_VIDEO  : 视频（激励&全屏）  
//     AdType.AD_TYPE_INTERSTITIAL ：插屏  
//
if (MetaAdApi.get().isInSupportVersion(int type)) {
    // 当前版本支持该广告类型
}

type ：广告类型；

插屏广告只能在3.6.0.3以上的233乐园版本中才能展示，铺量持续进行中。 Banner广告只能在3.15.0.0以上的233乐园版本中才能展示（目前因为单价过低，已关闭）。 请重新下载“自测工具”，使用最新的自测工具来测试新类型广告。

错误码参考 ​

错误码错误信息处理方案
200请求成功
10001网络异常未清除自测工具缓存
20002游戏未验证通过 未收录在游戏目录中
20003未初始化成功包名或appkey有误，请检查参数
10004参数无效包名、appkey有误，请确认参数
30007233乐园不支持此类型广告未使用最新自测工具打开游戏，自测工具见SDK压缩包内
30008第三方Sdk引发的错误onAdShowFailed 30008一般有以下情况： ①广告位没有关联； ②广告pos值错了，检查下插屏/全屏的pos是不是正确的。 ③banner请求过于频繁会报错，需要调整间隔时间为60s