Difference between revisions of "Android SDK Getting Start"

From AdLocus
Jump to: navigation, search
(→‎取得您的 App Key)
 
(14 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
自我檢查
 
自我檢查
−
* 已整入 jar 檔 (Y/N)
+
=== Android Studio ===
−
* 已整入 Library Project (Y/N)
+
* Gradle 中加入AdLocus  (Y/N)
−
* 已在專案內勾選 AdLocusLib (Y/N)
+
* Tool > Android > Sync Project With Gradle Files  (Y/N)
−
* 已加入權限與 Recevier 到 AndroidManifest.xml 中 (Y/N)
+
  
 +
若您已完成上述檢查卻無法正確啟用相關服務, 請來信 support@adlocus.com , 我們將有專人與您聯繫.
  
 
== 取得您的 App Key ==
 
== 取得您的 App Key ==
−
** 至 http://adlocus.com/ 申請帳號並登入。
+
* 至 https://adlocus.com/ 點 <開發商> 申請帳號並登入。
−
** 在「應用程式」中「新增」您的應用程式並取得app key。
+
* 在「應用程式」中「新增」您的應用程式並取得app key。
  
 
== 準備將 SDK 加入到您的專案 ==
 
== 準備將 SDK 加入到您的專案 ==
−
* AdLocus JAR 檔
+
* [[Android_AddSDK|加入SDK]]
−
** 在專案底下建立 libs 資料夾 ( 在專案上按右鍵 > New > Folder,在 Folder name 填入 libs ,點選 Finish)
+
−
** 將 adlocus_<version>.jar 複製到 libs 資料夾底下
+
−
 
+
−
* AdLocus Library Project
+
−
** 第一步: 加入 AdLocus Library Project 到您的 Eclipse Workspace 中
+
−
  [[File:LibProj_1.jpg]]
+
−
  [[File:LibProj_2.jpg]]
+
−
  [[File:LibProj_3.jpg]]
+
−
** 第二步: 在您的專案內啟用 AdLocus Library Project
+
−
  [[File:LibProj_p1.jpg]]
+
−
  [[File:LibProj_p2.jpg]]
+
−
  [[File:LibProj_p3.jpg]]
+
−
  [[File:LibProj_p4.jpg]]
+
−
* AndroidManifest.xml 中加入以下權限
+
−
<syntaxhighlight lang="java">
+
−
// 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>
+
−
 
+
−
</syntaxhighlight>
+
−
 
+
−
就這麼簡單,您已完成SDK的前期作業。
+
−
 
+
  
 
== InApp ==
 
== InApp ==
Line 74: Line 23:
 
* [[Android_Promotion|詳細說明]]
 
* [[Android_Promotion|詳細說明]]
  
−
== ProGuard ==
+
== Interstitial ==
−
您的專案若有透過 Proguard 進行混淆,請加入下列設定檔維持相容性。
+
* [[Android_Interstitial|詳細說明]]
  
−
<syntaxhighlight lang="java">
+
== Video ==
−
-keep public class com.adlocus.** {*;}
+
* [[Android_Video|詳細說明]]
−
-keep class com.adlocus.adapters.AdLocusAdapter$MyJavaScriptInterface{<methods>;}
+
 
−
</syntaxhighlight>
+
== AdMob Mediation ==
 +
* [[Android_AdMM|詳細說明]]
  
 
== 測試模式與觀眾定向(Optional) ==
 
== 測試模式與觀眾定向(Optional) ==
Line 104: Line 54:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
== 開啟測試/定向 ==
+
=== 開啟測試/定向 ===
  
−
=== InApp ===
+
==== InApp ====
 
<syntaxhighlight lang="java">
 
<syntaxhighlight lang="java">
 
AdLocusLayout adlocusLayout1 =  new AdLocusLayout(this,
 
AdLocusLayout adlocusLayout1 =  new AdLocusLayout(this,
Line 115: Line 65:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
=== Promotion ===  
+
==== Promotion ====
 
<syntaxhighlight lang="java">
 
<syntaxhighlight lang="java">
−
AdLocusTargeting.enablePush(this, app key, targeting);
+
PushAd.enablePush(this, "your app key", promotionIntent, targeting);
 
</syntaxhighlight>
 
</syntaxhighlight>

Latest revision as of 10:24, 3 December 2019

Getting Start with AdLocus

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

自我檢查

Android Studio

  • Gradle 中加入AdLocus (Y/N)
  • Tool > Android > Sync Project With Gradle Files (Y/N)

若您已完成上述檢查卻無法正確啟用相關服務, 請來信 support@adlocus.com , 我們將有專人與您聯繫.

取得您的 App Key

  • 至 https://adlocus.com/ 點 <開發商> 申請帳號並登入。
  • 在「應用程式」中「新增」您的應用程式並取得app key。

準備將 SDK 加入到您的專案

InApp

Promotion

Interstitial

Video

AdMob Mediation

測試模式與觀眾定向(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

PushAd.enablePush(this, "your app key", promotionIntent, targeting);