一、 - PDF 免费下载

2015 年 6 月 30 日卓易广告平台 SDK1.0

二申请流程...7 卓易广告平台 SDK1.0

一简介卓易移动推广 SDK(Android) 是卓易官方推出的移动推广 SDK 在 Android 平台上的版本 ( 以下简称 SDK) SDK 的发行版本 ( 完整下载包为 Adroi_MobAds_SDK.zip) 中包括 JAR 包 javadoc 文档示例以及您正在阅读的用户手册以下使用 <SDK_PATH> 代表 Adroi_MobAds_SDK.zip 解压后的根目录 JAR 包 :<SDK_PATH>/Adroi.sdk.jar, 开发时导入工程中 ; 文档 :<SDK_PATH>/doc.rar, 提供 javadoc 帮助信息 ; 示例 :<SDK_PATH>/Adroi_sdk_demo.rar, 多个示例程序代码, 帮助您迅速熟悉 SDK 的使用方式 ; 用户手册 : 本文档二运行环境可运行于 Android 1.5(API Level 3) 及以上版本三 SDK 包导入及权限配置 1. 申请应用的 APPSID 和计费名 : (1) 见附件一 ; 2. 导入 jar 包将卓易广告的 jar 包复制到您工程的 Libs 目录下, 并按如下步骤将其导入 : (1) 右键点击你的工程, 然后选择 Properties ; (2) 在工程属性对话框左边选择 Java Build Path ; (3) 工程属性对话框主窗口选择 Libraries; (4) 点击 Add JARs, 添加 Adroi sdk jar 包 3. 配置 AndroidMainfest.xml 1

( 一 ) 增加权限  <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.read_phone_state" /> <uses-permission android:name="android.permission.access_network_state" /> <uses-permission android:name="android.permission.access_coarse_location" /> <uses-permission android:name="android.permission.write_external_storage" /> <uses-permission android:name="android.permission.access_wifi_state" />  <uses-permission android:name="android.permission.get_tasks" /> <uses-permission android:name="android.permission.system_alert_window" /> <uses-permission android:name="android.permission.read_logs" /> ( 二 ) 添加 AppActivity 声明 <activity android:name="com.adroi.sdk.appactivity" android:configchanges="keyboard keyboardhidden orientation" android:screenorientation="portrait" /> 四视图卓易广告 SDK 支持横幅 banner 广告插屏广告开屏广告原生广告四种广告形式详细嵌入步骤如下 : 注 : 使用下面的广告形式前需要调用 AdView.preLoad(this, "XXXXXX"), 方法进行设置 APP 应用 ID 1. 横幅 Banner 广告在 Activity 的 oncreate 函数中 : this.setcontentview(r.layout.main); final RelativeLayout rl = (RelativeLayout)this.findViewById(R.id.adViewParent); final AdView banneradview = new AdView(MainActivity.this, AdSize.Banner, "sa018ef0"); banneradview.setlistener(new AdViewListener() {...); rl.addview(banneradview); 2

注 : 此处用的广告位为 demo 的专用广告位, 实际开发中需要填入自己申请的广告位 ; 2. 插屏广告插屏广告调用方法和 Banner 不同, 展示的时候需要调用 showinterstialad() 方法 // 插屏 interstialadview = new AdView(MainActivity.this, AdSize.Interstitial, "s3ecbdb0"); interstialadview.setlistener(new AdViewListener() {...); 当需要显示插屏广告的时候需要执行下面的方法 interstialadview.showinterstialad(); 3. 开屏广告 ( 一 ) 自带动画显示广告在 Activity 的 oncreate 的方法中 // 开屏实现方式 1(SDK 自带动画, 无需手动添加至控件树 ) new AdView(this, AdSize.Initial, "s3ecbdb0"); ( 二 ) 无动画显示广告 // 开屏实现方式 2( 无动画, 需要开发者将 adview 添加到控件树 ) final AdView init = new AdView(this, AdSize.InitialNoAnimation, "s3ecbdb0"); addcontentview(init, new FrameLayout.LayoutParams(-1,-1)); 3

详细使用方法请见 Demo 中 MainActivity.java 文件中 4. 原生广告原生广告提供广告的物料和相关监听接口, 展现的形式由开发者自己设计, 一般可以展现为 List 列表形式在 public Activity class 中创建多个原生广告对象实例 NativeAdsActivity extends ListActivity { NativeAds[] nativeads = new NativeAds[2]; 在 Activity 的 oncreate 的方法中添加监听加载原生广告物料资源成功和失败的函数 NativeAds.preLoad(this, "4c74c08b"); nativeads[0] = new NativeAds(this, "s3ecbdb0"); nativeads[0].setlistener(new NativeAdsListener() { @Override public void onadready(jsonobject arg0) { Map<String, Object> map = new HashMap<String, Object>(); map.put("account", nativeads[0].getaccount()); map.put("desc", nativeads[0].getdesc1()); map.put("img", getbitmapfromurl(nativeads[0].getimgurl())); map.put("type", "ads"); map.put("nativeadobj",nativeads[0]); mdata.add(2, map); adapter.notifydatasetchanged(); nativeads[0].setadimpression(); ); @Override public void onadfailed(jsonobject data) { Toast.makeText(NativeAdsActivity.this, data.optstring("info"), Toast.LENGTH_SHORT).show(); 4

在列表显示 getview 函数中添加原生广告的显示以及注册展示点击监听函数 public View getview(final int position, View convertview, ViewGroup parent) { holder.img.setimagebitmap((bitmap) mdata.get(position).get("img")); holder.account.settext((string) mdata.get(position).get("account")); holder.desc.settext((string) mdata.get(position).get("desc")); if (((String) mdata.get(position).get("type")).equals("ads")) { holder.type.settextcolor(color.red); holder.type.settext(" 推广 "); convertview.setonclicklistener(new OnClickListener() { @Override public void onclick(view v) { NativeAds obj = (NativeAds) mdata.get(position).get("nativeadobj"); obj.setadclick(); ); 详细使用方法请见 Demo 中 NativeAdsActivity.java 文件中五代码混淆如果您需要使用 proguard 混淆代码, 需确保不要混淆 SDK 的代码请在 proguard.cfg 文件 ( 或其他混淆文件 ) 尾部添加如下配置 : -keep class com.adroi.sdk.** { public protected *; 5

六联系我们 6

附件一 : 申请 APPID 和广告位一作用 APP ID( 应用 ID) 用于标识您的应用广告位 ID 用于标识您的广告位 APP ID 和广告位 ID 是获取广告物料的必备条件, 请参照一下流程正确获取二申请流程在卓易开放平台注册账号并登录到媒体主平台 7

1. 创建应用登录后, 点击媒体管理添加应用, 如下图所示点击添加应用按钮之后, 正确填写各项信息, 点击保存按钮, 完成 App 添加这时, 您就获得了所填应用的 APP ID 了, 如下图广告位 ID 的获取, 请继续阅读流程 3 1. 创建广告位点击流程 2 中生成的媒体 ID(APP ID), 在打开的广告位列表页面中点击添加广告位按钮, 并填写广告位信息, 点击确定按钮后点击后面的保存按钮完成广告位的创建, 如下图 8

2. 获取到 APP ID 和广告位 ID 后, 请按照该用户手册中的指导进行代码的部署注意 : 请正确使用 APP ID 和广告位 ID, 否则有可能影响到您的收益 3. 在效果报告页面中, 您可以查看您的收益以及每个应用的详细数据 9