Difference between revisions of "Android SDK Getting Start"

From AdLocus
Jump to: navigation, search
(→‎InApp)
Line 63: Line 63:
  
 
== InApp ==
 
== InApp ==
−
* [[Android_InApp|啟用 InApp 版位]]
+
* [[Android_InApp|詳細說明]]
  
 
== Promotion ==
 
== Promotion ==
−
適地性優惠通知服務是依據全區定向或特定地理位置定向提供與您的使用者最適合的主動式訊息。
+
* [[Android_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 ==
 
您的專案若有透過 Proguard 進行混淆,請加入下列設定檔維持相容性。
 
您的專案若有透過 Proguard 進行混淆,請加入下列設定檔維持相容性。

Revision as of 21:06, 2 October 2014

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

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);