百度移動(dòng)推廣SDK 用戶手冊(cè) (Android版)

百度移動(dòng)推廣SDK3.0百度移動(dòng)推廣SDK用戶手冊(cè)(Android版)3.0百度在線網(wǎng)絡(luò)技術(shù)（北京）有限公司（版權(quán)所有,翻版必究）

修改記錄版本更新時(shí)間變更內(nèi)容1.02011-7-24文檔創(chuàng)建2.02012-5-8增加“HYPERLINK接口和監(jiān)聽(tīng)器”章節(jié)2.02012-5-8增加“HYPERLINK常用接口”2.02012-5-8增加“HYPERLINK附件1申請(qǐng)APPSID、APPSEC”2.12012-8-15新版本文檔3.02012-10-29增加“HYPERLINK方形廣告接口”章節(jié)3.02012-10-29修改“HYPERLINKAdViewListener部分接口”

目錄一、 簡(jiǎn)介 4二、 閱讀對(duì)象 4三、 運(yùn)行環(huán)境 4四、 工程設(shè)置 41. 申請(qǐng)應(yīng)用APPSID和計(jì)費(fèi)名 42. 導(dǎo)入JAR包 53. 文檔使用 54. 配置AndroidManifest.xml 55. 聲明式布局 66. 代碼式布局 77. 代碼混淆 8五、 接口和監(jiān)聽(tīng)器 81. 常用接口 82. 監(jiān)聽(tīng)器 8六、 示例 9七、 聯(lián)系我們 9八、 附件1：申請(qǐng)APPSID、APPSEC 11簡(jiǎn)介百度移動(dòng)推廣SDK(Android)是百度官方推出的移動(dòng)推廣SDK在Android平臺(tái)上的版本（以下簡(jiǎn)稱SDK）。SDK的發(fā)行版本（完整下載包為android.zip）中包括JAR包、文檔、示例以及您正在閱讀的用戶手冊(cè)。以下使用<SDK_PATH>代表android.zip解壓后的根目錄。JAR包：<SDK_PATH>/android_api.jar，開(kāi)發(fā)過(guò)程中導(dǎo)入Android項(xiàng)目；文檔：<SDK_PATH>/android_doc，提供開(kāi)發(fā)幫助信息；示例：<SDK_PATH>/android_demo，從易到難的多個(gè)示例程序代碼，幫助您迅速熟悉SDK的使用方式；用戶手冊(cè)：本文檔。閱讀對(duì)象本文檔面向所有使用該SDK的開(kāi)發(fā)人員、測(cè)試人員、合作伙伴以及對(duì)此感興趣的其他用戶。運(yùn)行環(huán)境可運(yùn)行于Android1.5（APILevel3）及以上版本。工程設(shè)置（注：以下提及的各個(gè)文件均可在<SDK_PATH>/android_demo中找到。）申請(qǐng)應(yīng)用APPSID和計(jì)費(fèi)名首先，你需要在AndroidManifest.xml中設(shè)置meta-data（詳見(jiàn)“4配置”）BaiduMobAd_APP_ID(簡(jiǎn)稱”APPSID”)和BaiduMobAd_APP_SEC（下稱“計(jì)費(fèi)名”）。APPSID和計(jì)費(fèi)名在百度移動(dòng)推廣平臺(tái)申請(qǐng)，只有使用生效的應(yīng)用版本的APPSID和計(jì)費(fèi)名才能正常計(jì)費(fèi)。調(diào)試期間您可以使用“debug”。SDK2.0開(kāi)始您還可以通過(guò)調(diào)用AdView.setAppSid和AdView.setAppSec設(shè)置對(duì)應(yīng)值。導(dǎo)入JAR包將SDK中的JAR包導(dǎo)入您創(chuàng)建的Android項(xiàng)目，以下假設(shè)您已經(jīng)創(chuàng)建了項(xiàng)目A。右鍵點(diǎn)擊你的工程，然后選擇”P(pán)roperties”；在工程屬性對(duì)話框左邊選擇”JavaBuildPath”；在工程屬性對(duì)話框主窗口選擇”Libraries”；點(diǎn)擊”AddJARs”，添加<SDK_PATH>/android_api.jar。文檔使用若是在eclipse或其他IDE下開(kāi)發(fā)，可設(shè)置JAR包的Javadoc路徑為<SDK_PATH>/doc，便于在IDE中獲得即時(shí)的開(kāi)發(fā)幫助信息；也可以直接在瀏覽器中打開(kāi)<SDK_PATH>/doc/index.html查看該文檔。配置AndroidManifest.xml具體的信息參見(jiàn)圖1。加亮文字標(biāo)示了需要配置的信息：meta-data：BaiduMobAd_APP_ID為應(yīng)用程序的發(fā)布ID，如此處為"debug"，請(qǐng)根據(jù)需要替換；BaiduMobAd_APP_SEC為計(jì)費(fèi)名，測(cè)試期間為“debug”，正式上線后可以替換。上述2個(gè)信息，可以通過(guò)AdView.setAppSid和AdView.setAppSec設(shè)置，并且會(huì)覆蓋AndroidManifest.xml中的設(shè)置。注：調(diào)用需要在AdView實(shí)例化之前進(jìn)行，可參見(jiàn)Demo中的“代碼式布局”，“高級(jí)應(yīng)用（文本）”代碼中的注釋部分。添加AppActivity申明添加必要的權(quán)限必要權(quán)限：您必須申明的權(quán)限可選權(quán)限：您可根據(jù)實(shí)際需求設(shè)置圖1AndroidManifest.xml聲明式布局參照以下步驟（參見(jiàn)示例程序中“聲明式布局”、“高級(jí)應(yīng)用”）：在A中/res/layout/simple_declaring.xml聲明com.baidu.mobads.AdView：首先在第一個(gè)xml布局元素中添加baiduadsdk名字空間如下圖所示，再申明AdView視圖圖3simple_declaring.xml其中，adSize是res/values/attrs.xml中讀取的屬性，當(dāng)adSize取0時(shí)，為橫幅廣告；取1時(shí)，為方形廣告。圖4res/values/attrs.xml代碼式布局在代碼的合適位置添加如下語(yǔ)句，其中context為android.content.Context類的實(shí)例： AdViewadView=newAdView(context);或 AdViewadView=newAdView(context，AdSize.Square);代碼混淆如果您需要使用proguard混淆代碼，請(qǐng)確保不要混淆SDK的代碼，請(qǐng)?jiān)趐roguard.cfg文件尾部添加如下配置信息：-keepclasscom.baidu.mobads.**{publicprotected*;}接口和監(jiān)聽(tīng)器常用接口 表1AdView中的常用接口SDK版本接口詳細(xì)說(shuō)明1.0setListener資源下載成功輪播過(guò)程可能有多次推廣更新，每次成功均被觸發(fā)1.0setVisibility可見(jiàn)性若要隱藏AdView空間，請(qǐng)直接調(diào)用AdView.setVisibility(View.GONE)；請(qǐng)不要在AdView可見(jiàn)時(shí)隱藏AdView的父控件。1.0setTextColor設(shè)置文字顏色，2.1+不再支持1.0setBackgroundColor設(shè)置背景顏色，2.1+不再支持2.0setAppSid設(shè)置appsid調(diào)用改方法設(shè)置的appsid將覆蓋AndroidManifest.xml中的設(shè)置2.0setAppSec設(shè)置計(jì)費(fèi)名調(diào)用該方法設(shè)置的計(jì)費(fèi)名將覆蓋AndroidManifest.xml中的設(shè)置3.0AdView(Contextcontext,AdSizeadSize)指定廣告類型調(diào)用該構(gòu)造函數(shù)，可指定橫幅或方形廣告。監(jiān)聽(tīng)器開(kāi)發(fā)者需要在推廣展示過(guò)程中捕獲一系列事件：或用于啟動(dòng)廣告展示、或用于統(tǒng)計(jì)廣告計(jì)費(fèi)信息（展現(xiàn)、點(diǎn)擊等）、或用于監(jiān)控異常情況。為此我們提供的監(jiān)聽(tīng)器（AdViewListener）包含如下一組接口：表2監(jiān)聽(tīng)器接口SDK版本接口詳細(xì)說(shuō)明1.0onReceiveSuccess資源下載成功[已刪除]1.0onReceiveFail資源下載失敗[已刪除]1.0onAdSwitch推廣輪播切換每次推廣切換時(shí)均被觸發(fā)2.0onAdReady資源下載且界面構(gòu)造完畢實(shí)例化AdView后觸發(fā)，且只觸發(fā)一次2.0onAdFailed推廣無(wú)法繼續(xù)展示由于網(wǎng)絡(luò)或無(wú)推廣資源可用等情況觸發(fā)3.0onAdShow(JSONObjectinfo)展示計(jì)費(fèi)事件每次展現(xiàn)計(jì)費(fèi)時(shí)被觸發(fā)目前info參數(shù)還未提供任何信息3.0onAdClick(JSONObjectinfo)點(diǎn)擊計(jì)費(fèi)事件有網(wǎng)絡(luò)狀態(tài)下點(diǎn)擊進(jìn)入推廣頁(yè)面前觸發(fā)；或有信號(hào)狀態(tài)下進(jìn)入撥號(hào)界面前觸發(fā)目前info參數(shù)還未提供任何信息示例示例中總共包含3個(gè)不同的示例：“聲明式布局”、“代碼式布局”、“高級(jí)應(yīng)用”?！奥暶魇讲季帧笔纠纠性趓es/layout/simple_declaring.xml中聲明com.baidu.mobads.AdView視圖類?！按a式布局”示例示例中在Activity（SimpleCodingLayout）中直接使用代碼實(shí)例化com.baidu.mobads.AdView視圖類。聯(lián)系我們感謝您的閱讀,如果有問(wèn)題請(qǐng)email我們。郵箱:mobads-sup@

附件1：申請(qǐng)APPSID、APPSEC為何需要申請(qǐng)？調(diào)試過(guò)程使用debug，我們的計(jì)費(fèi)后臺(tái)會(huì)忽略這些計(jì)費(fèi)日志；您的App上線前，請(qǐng)務(wù)必替換debug為真實(shí)值。為何要在移動(dòng)聯(lián)盟中上傳App您選擇使用JS版SDK，通常不愿意改動(dòng)App再通過(guò)各個(gè)渠道到發(fā)布。您在“申請(qǐng)流程”中上傳的App只是為了申請(qǐng)APPSID和APPSEC；并觸發(fā)后續(xù)我們審核人員讓APPSID和APPSEC通過(guò)審核。申請(qǐng)流程？移動(dòng)聯(lián)盟HYP