Help center

您的問題,我們來解決!

1. 必要條件

運行環境為Android1.6(Level-4)及以上版本;

本著更方便開發者嵌入和使用SDK的原則,limei_Android_SDK在集成和使用方式上都有較大的變動,因此無論您是否是第一次使用limei_SDK,都建議您仔細的閱讀以下內容。文檔中的示例代碼段都可以在Sample工程中找到。

2. 從力美官網獲得廣告位ID

如果想在APP中使用力美的廣告,首先需要創建應用和獲取相應廣告位ID(AdUnitID),廣告位ID是區分和識別不同廣告類型的唯一標識,新創建的廣告位只有通過審核,才會有相應的廣告填充。

3. 添加力美jar庫文件到項目中

下面以Eclipse為例,首先將ImmobSDK.jar拷貝到您的Android項目的libs目錄下,右鍵點擊工程根目錄,選擇 Properties -> Java Build Path ->Librarie,然后點擊 Add External JARs... 按鈕,選擇指向ImmobSDK.jar的路徑,點擊 OK,即導入成功。如下圖:

4. 配置AndroidManifest

力美廣告SDK需要通過網絡連接來獲取廣告數據,因此開發者需要在APP的“AndroidManifest.xml”中添加相應的必要權限。如果您正使用Eclipse,請按照以下步驟添加權限:

第一步,在項目窗口中選中AndroidManifest.xml文件 ;

第二步,雙擊或者按F3打開文件,選擇AndroidManifest.xml中的標簽來顯示純xml文本;

第三步,在 標簽區域配置 Android 權限信息;


* 必選權限:

<!-- 這個權限是訪問網絡的權限,如果沒有添加這個權限將不會加載廣告-->

<uses-permissionandroid:name="android.permission.INTERNET"/>

 

<!-- 讀取手機狀態的權限,如果沒有添加這個權限將影響到你的收入 -->
<uses-permissionandroid:name="android.permission.READ_PHONE_STATE" />

 

<!-- 操作SD卡的權限,如果沒有添加這個權限有可能會影響廣告展示,以及影響積分墻廣告收入? -->
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

 

<!--? 讀取網絡狀態的權限,如果沒有這個權限廣告將不能正常加載? -->
<uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/>

<!--? 讀取wifi網絡狀態的權限,加載廣告時優先使用wifi狀態下的網絡? -->
<uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"/>


* 可選權限

<!--? 位置權限將使設備可以接收地理位置相關的廣告? -- >

<uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"/>

 

<!--?? 地圖權限允許用戶快速定位和查看目標地圖? -- >

<uses-permissionandroid:name="android.permission.WRITE_GSERVICES"/>

 

<!--? 電話和短信權限是讓用戶可以直接撥打廣告中的電話和發送短信? -- >

<uses-permissionandroid:name="android.permission.SEND_SMS"/>
<uses-permissionandroid:name="android.permission.CALL_PHONE"/>

 

<!--? 日程表權限可以方便用戶記錄和參與相關廣告活動? -- >

<uses-permissionandroid:name="android.permission.WRITE_CALENDAR"/>

 

<!--? 震動感應權限是互動廣告的重要組成部分? -- >

<uses-permissionandroid:name="android.permission.VIBRATE"/>


* 注意:為了使SDK正常工作,開發者需要在AndroidManifest.xml的<application>標簽內加入如下聲明。

<activityandroid:name="cn.immob.sdk.BrowserActivity"></activity>

 

<!--? 如果不添加這個service, sdk將無法正常加載廣告? -->

<serviceandroid:name="cn.immob.sdk.net.DownloadService"></service>

<activityandroid:name="cn.immob.sdk.util.LMActionHandler"></activity>

<!--? 如果不添加這個廣播, 會影響積分墻廣告收入 -->

<receiverandroid:name="cn.immob.sdk.brocastreceiver.AppChangeBrocastreceiver">

<intent-filter>

???? <actionandroid:name="android.intent.action.BOOT_COMPLETED" />

???? <actionandroid:name="android.intent.action.PACKAGE_ADDED"/>

???? <dataandroid:scheme="package"/>

</intent-filter>

</receiver>

1. 必要條件

使用Xcode4.5或更高版本

運行環境為iOS4.3或更高版本

2. 從力美官網獲得廣告位ID

如果想在APP中使用力美的廣告,首先需要創建應用和獲取相應廣告位ID(AdUnitID),廣告位ID是區分和識別不同廣告類型的唯一標識,新創建的廣告位只有通過審核,才會有相應的廣告填充。

3. 將SDK添加到項目中

按照以下步驟添加依賴框架(framework)

第一步,將immobSDK.framework添加到Xcode項目中。在添加過程中,Xcode會詢問開發者使用哪種方式來添加文件。我們建議開發者使用拷貝模式,如下圖:

第二步,添加SDK的所依賴的類庫,缺少這些類庫會影響SDK的正常運行。

點擊工程,選擇 Targets->Build Phases->Link Binary With Libraries->Add Items“+”,選擇以下 framework->Add;


類庫清單:

AudioToolbox.framework

CFNetwork.framework

CoreLocation.framework

CoreTelephony.framework

EventKit.framework

EventKitUI.framework

MapKit.framework

MediaPlayer.framework

MessageUI.framework

MobileCoreServices.framework

QuartzCore.framework

Security.framework

StoreKit.framework

AdSupport.framework

SystemConfiguration.framework

libz.1.2.5.dylib

4. 廣告視圖的使用

4.1.積分墻廣告使用

若在應用中添加廣告墻廣告,只需簡單幾步:

a) 導入頭文件 #import <immobSDK/immobView.h>

b) 實例化immobView對象,使用您從力美官網獲得廣告位ID作為參數傳入;

c) 添加immobView的Delegate來監聽廣告接收狀態;

d) 添加userAccount屬性,此屬性針對多賬戶應用所使用,用于區分不同賬戶下的積分(可選);

e) 加載廣告(即:immobViewRequest),將immobView添加到界面后,調用immobViewDisplay顯示廣告列表;

f) 設置必需的ViewController,如果此方法的返回值為空,會導致廣告無法正常運行。

通過下面代碼創建廣告墻廣告:

#import <immobSDK/immobView.h>

// 在頭文件中聲明immobView并添加immobViewDelegate來監聽廣告接收狀態

@interface ViewController :UIViewController<immobViewDelegate>

@property (nonatomic, retain)immobView *adView_adWall;

-(void)enterAdWall;

-(void)QueryScore;

-(void)ReduceScore;

@end

@implementationViewController

@synthesizeadView_adWall;

// 進入積分墻

-(void)enterAdWall{

// 實例化immobView對象,在此處替換在力美廣告平臺申請到的廣告位ID;

self.adView_adWall=[[immobViewalloc] initWithAdUnitID:@"d2b0c4296dc009ddc00d10da9c4cf83e"];

//添加immobView的Delegate;

self.adView_adWall.delegate=self;

//添加userAccount屬性,此屬性針對多賬戶應用所使用,用于區分不同賬戶下的積分(可選)。

[self.adView_adWall.UserAttributesetObject:@" 當前APP的用戶登陸賬號Lily" forKey:@"accountname"];

//開始加載廣告。,

[self.adView_adWallimmobViewRequest];

}

// 設置必需的UIViewController, 此方法的返回值如果為空,會導致廣告展示不正常。

- (UIViewController *)immobViewController{

returnself;

}

[- (void) immobViewDidReceiveAd:(immobView*)immobView {

//將immobView添加到界面上。

[[self.viewaddSubview:adView_adWall];

//將immobView添加到界面后,調用immobViewDisplay。

[[self.adView_adWallimmobViewDisplay];

}

積分操作方法:

// 查詢積分

-(void)QueryScore{

[self.adView_adWall

immobViewQueryScoreWithAdUnitID:@"d2b0c4296dc009ddc00d10da9c4cf83e"WithAccountID:@" 當前APP的用戶登陸賬號Lily"];

}

// 查詢積分回調

-(void)immobViewQueryScore:(NSUInteger)score WithMessage:(NSString *)message{

UIAlertView *uA=[[UIAlertViewalloc] initWithTitle:@"積分查詢" message: ![message isEqualToString:@""]?[NSStringstringWithFormat:@"%@",message]:[NSStringstringWithFormat:@"當前積分為:%i",score] delegate:selfcancelButtonTitle:@"YES"otherButtonTitles:nil, nil];

[uA show];

[uA release];

}

//減少積分

-(void)ReduceScore{

[self.adView_adWall immobViewReduceScore:99WithAdUnitID:@"d2b0c4296dc009ddc00d10da9c4cf83e"WithAccountID:@" 當前APP的用戶登陸賬號Lily"];

}

// 減少積分回調

-(void) immobViewReduceScore:(BOOL)status WithMessage:(NSString *)message{

UIAlertView *uA=[[UIAlertViewalloc] initWithTitle:status?@"積分減少成功":@"積分減少失敗" message: status?@"":[NSStringstringWithFormat:@"%@",message] delegate:selfcancelButtonTitle:@"YES"otherButtonTitles:nil, nil];

[uA show];

[uA release];

}

廣告事件的回調方法:

@optional

//當廣告被點擊,將要返回返回主程序見面時被調用。

- (void) onDismissScreen:(immobView *)immobView;

// 當廣告調用一個新的頁面并且會導致離開目前運行程序時被調用。如:調用本地地圖程序。

- (void) onLeaveApplication:(immobView *)immobView;

// 當廣告頁面被創建并且顯示在覆蓋在屏幕上面時調用本方法。

- (void) onPresentScreen:(immobView *)immobView;

//當廣告加載出現異常時會回調本方法。

- (void) immobView: (immobView*) immobViewdidFailReceiveimmobViewWithError: (NSInteger) errorCode;

//email賬號未設置。

- (void) emailNotSetupForAd:(immobView *)immobView;

用戶相關信息設置:

注意:此屬性需要在immobViewRequest方法調用前設置。此外,網絡游戲賬號綁定或是多賬戶應用程序(綁定后,力美積分會反饋到相應的網游賬號下)也可以通過以下方式來設置當前用戶賬號

// 通過以下方式向服務器傳輸有效信息

adView.UserAttributesetObject:@"當前APP的用戶登陸賬號"forKey:@"accountname"];

//是否禁用應用內部彈出AppStore

[adView.UserAttributesetObject:@"YES"forKey:@"disableStoreKit"];

4.2. 插屏廣告使用

若在應用中添加插屏廣告,只需簡單幾步:

a) 導入頭文件 #import

b) 實例化immobView對象,使用您從力美官網獲得廣告位ID作為參數傳入;

c) 添加immobView的Delegate監聽廣告狀態;

d) 加載廣告(即:immobViewRequest)并將immobView添加到界面;

e) 后續展示調用immobViewDisplay顯示廣告,在調用此方法時,請保證immobView在最上層;

f) 設置必需的ViewController,如果此方法的返回值為空,會導致廣告無法正常運行

通過下面代碼創建插屏廣告:

#import<immobSDK/immobView.h>

@interfaceViewController ()<immobViewDelegate>,

@property (nonatomic,retain) immobView *ad;

@end

@implementationViewController

@synthesize ad;

- (void)viewDidLoad

{

[superviewDidLoad];

if (!ad) {

// 實例化immobView對象,在此處替換在力美廣告平臺申請到的廣告位Id;

immobView *tmpAd=[[immobViewalloc] initWithAdUnitID:@" d1ce616d93d301f4c23991f273242723"];

self.ad=tmpAd;

//添加immobView的Delegate;

self.ad.delegate=self;

//開始加載廣告。

[adimmobViewRequest];

//添加廣告到界面

[self.viewaddSubview:ad];

} }

// 設置必需的ViewController, 此方法的返回值如果為空,會導致廣告展示不正常。

- (UIViewController *)immobViewController{

return self;

}

//展示插屏廣告

- (IBAction)open:(id)sender{

if (ad.isAdReady) {

[adimmobViewDisplay];

}else{

NSLog(@"廣告未加載成功.廣告不可展示");

}

}

廣告事件的回調方法:

@optional

//當廣告被點擊,將要返回返回主程序見面時被調用。

- (void) onDismissScreen:(immobView *)immobView;

// 當廣告調用一個新的頁面并且會導致離開目前運行程序時被調用。如:調用本地地圖程序。

- (void) onLeaveApplication:(immobView *)immobView;

// 當廣告頁面被創建并且顯示在覆蓋在屏幕上面時調用本方法。

- (void) onPresentScreen:(immobView *)immobView;

//當廣告加載出現異常時會回調本方法。

- (void) immobView: (immobView*) immobViewdidFailReceiveimmobViewWithError: (NSInteger) errorCode;

//email賬號未設置。

- (void) emailNotSetupForAd:(immobView *)immobView;

廣告狀態查詢:

除了事件通知機制以外,開發者可以調用immobView類中的isAdReady屬性來查詢并獲得廣告加載狀態。對于需要即時判斷跳轉場景的需求可以使用以下方式。

adView=[[immobViewalloc] initWithAdUnitID:@"d2b0c4296dc009ddc00d10da9c4cf83e"];

adView.delegate=self;

if (adView.isAdReady) {

// 廣告位已經就緒,可以被展示

} else {

// 后臺廣告未準備好

// 直接跳轉到另一程序邏輯和界面

}

5. 其他

更詳細的使用方法,請參考發行文件中的Sample程序;

如還有疑問,歡迎隨時發郵件到service@limei.com獲得更多幫助;

其他聯系方式,電話:+86 (10) 6582 0230、QQ:984584719。

{转码词1},{转码词2},{转码词3},{转码词},{转码词},{转码词},{转码词},{转码词} 百度 好搜 搜狗

警告:本站禁止未滿18周歲訪客瀏覽,如果當地法律禁止請自覺離開本站!收藏本站:請使用Ctrl+D進行收藏