Android SDK Getting Start

From AdLocus
Revision as of 20:52, 2 October 2014 by Sfchang (Talk | contribs)

Jump to: navigation, search

Getting Start with AdLocus

以下將說明您怎麼整入 AdLocus SDK.


取得您的 App Key

    • 至 http://adlocus.com/ 申請帳號並登入。
    • 在「應用程式」中「新增」您的應用程式並取得app key。

準備將 SDK 加入到您的專案

  • AdLocus JAR 檔
    • 在專案底下建立 libs 資料夾 ( 在專案上按右鍵 > New > Folder,在 Folder name 填入 libs ,點選 Finish)
    • 將 adlocus_<version>.jar 複製到 libs 資料夾底下
  • AdLocus Library Project
    • 第一步: 加入 AdLocus Library Project 到您的 Eclipse Workspace 中
 LibProj 1.jpg
 LibProj 2.jpg
 LibProj 3.jpg
    • 第二步: 在您的專案內啟用 AdLocus Library Project
 LibProj p1.jpg
 LibProj p2.jpg
 LibProj p3.jpg
 LibProj p4.jpg
  • AndroidManifest.xml 中加入以下權限
// InApp
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 
// Promotion
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="com.adlocus.permission.SEND" />
<permission android:name = "com.adlocus.permission.SEND" />
 
<service android:name="com.adlocus.push.PushService" 
         android:process=":adlocus">
</service>
 
<receiver 
	android:enabled="true" 
        android:process=":adlocus"
	android:name="com.adlocus.push.PushReceive"
        android:permission="com.adlocus.permission.SEND">
	<intent-filter>
		<action android:name="android.intent.action.BOOT_COMPLETED" />
		<category android:name="android.intent.category.DEFAULT" />
	</intent-filter>
        <intent-filter>
                <action android:name="com.adlocus.action.RECEIVE" />
        </intent-filter>
</receiver>

就這麼簡單,您已完成SDK的前期作業。


InApp


Promotion

適地性優惠通知服務是依據全區定向或特定地理位置定向提供與您的使用者最適合的主動式訊息。

啟動優惠通知服務,請將相關程式碼加在整個程式的進入點(例如:Application 的 onCreate )

  • 如欲使用新型態優惠通知服務啟動方式請使用10.2步驟啟動

10.新型態優惠通知服務 10.1AndroidManifest.xml 的 Application 底下加入下列程式碼。 背景Activity 需填入主畫面Activity,如:”.MainAcitvity” 或 “com.example.ExampleApp” 10.2啟動優惠通知服務。 背景Activity 需填入與10.1步驟相同的主畫面Activity,如:MainActivity.class

  • 與9.5請擇一使用


新型優惠通知服務

關閉優惠通知服務請使用下列程式碼

9.6可加入按鈕讓使用者開啟個人化優惠通知的設定頁面

9.7測試優惠通知服務是否成功整合

如果整合成功將出現測試優惠通知,如下圖所示。

如果未出現請重新檢查。


ProGuard

您的專案若有透過 Proguard 進行混淆,請加入下列設定檔維持相容性。

-keep public class com.adlocus.** {*;}
-keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{<methods>;}

測試模式與觀眾定向(Optional)

當您完成 SDK 整合後,您可透過設定下列參數開啟測試模式(測試模式下的互動在平台上將不記錄).

  • 年齡
  • 生日
  • 性別
  • 測試模式
// 設定使用者年齡 (也可使用 setBirthday())
void setAge(int age) 
void setBirthDate(GregorianCalendar birthday))
void setGender(AdLocusTargeting$Gender gender)
void setTestMode(boolean isTesting)
 
// 設置範例:
AdLocusTargeting targeting = new AdLocusTargeting();
targeting.setAge(23); 
targeting.setBirthDate(new GregorianCalendar(1990, 12, 29));
targeting.setGender(AdLocusTargeting$Gender.MALE); 
targeting.setTestMode(true);  //使用測試模式

開啟測試/定向

InApp

AdLocusLayout adlocusLayout1 =  new AdLocusLayout(this,
				AdLocusLayout.AD_SIZE_IAB_MRECT,
				appKey, 
				15,
				targeting);

Promotion

AdLocusTargeting.enablePush(this, app key, targeting);