Difference between revisions of "Android SDK Getting Start"

From AdLocus
Jump to: navigation, search
Line 15: Line 15:
 
* AdLocus Library Project
 
* AdLocus Library Project
 
** 第一步: 加入 AdLocus Library Project 到您的 Eclipse Workspace 中
 
** 第一步: 加入 AdLocus Library Project 到您的 Eclipse Workspace 中
−
[[File:LibProj_1.jpg]]
 
  
−
[[File:LibProj_2.jpg]]
+
  [[File:LibProj_1.jpg]]
−
 
+
  [[File:LibProj_2.jpg]]
−
[[File:LibProj_3.jpg]]
+
  [[File:LibProj_3.jpg]]
  
 
** 第二步: 在您的專案內啟用 AdLocus Library Project
 
** 第二步: 在您的專案內啟用 AdLocus Library Project

Revision as of 20:14, 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

在 Activity 中加入以下程式碼

import com.adlocus.*;
 
usLayout adlocusLayout = 
new AdLocusLayout(this,
AdLocusLayout.AD_SIZE_BANNER, //設定廣告大小,通常為 Banner
your app key, //填入 app key
15); //設定輪播時間,最低 15 秒,-1 為不輪播只顯示一則
 
// 設定輪播動畫,預設為淡入,範例設定為隨機動畫
adlocusLayout.setTransitionAnimation(AdLocusLayout.ANIMATION_RANDOM); 
LinearLayout.LayoutParams adlocusLayoutParams = new LinearLayout.LayoutParams(
				ViewGroup.LayoutParams.WRAP_CONTENT, 
				ViewGroup.LayoutParams.WRAP_CONTENT);
// 設定置中
adlocusLayoutParams.gravity = Gravity.CENTER;
// 加入到你的 layout 中
yourLayout.addView(adlocusLayout, adlocusLayoutParams);
yourLayout.setGravity(Gravity.CENTER_HORIZONTAL);
yourLayout.invalidate();

AD SIZE 說明: AdSize Constant Size (WxH) Availability

  1. AD_SIZE_BANNER 320x50 (dp) 手機及平板
  2. AD_SIZE_IAB_MRECT 300x250 (dp) 平板
  3. AD_SIZE_IAB_LEADERBOARD 728x90 (dp) 平板

注意 : 請確保 layout 的空間大於等於您所設定的 AD size,否則將不會展示廣告。

若您需要監聽廣告互動結果

加入以下程式碼即可監聽相關事件

adlocusLayout.setListener(new AdListener()
{
    @Override
    public void onReceiveAd(Ad adView)
    {
    }
 
    @Override
    public void onFailedToReceiveAd(Ad adView, AdLocusLayout$ErrorCode errorCode)
    {
        switch (errorCode)
        {
            case NO_FILL:          //無廣告展示.
                break; 
            case INVAILD_KEY:      //錯誤的APP KEY.
                break;
            case NETWORK_ERROR:    //網路連線問題
                break;
            case SERVICE_ERROR:    //伺服器忙碌或維護中
                break;
            default:
                break;
        }
    }
});

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