跳至主要内容

Android Getting Started SDK8

簡介​

TAmedia SDK提供Android Mobile App開發者簡易迅速的方式整合行動App廣告, 廣告的種類包含

  • Banner

  • Interstitial

  • InRead Anchor

  • Native

系統需求​

Android 6.0以上 (API Level 23+)

SDK說明文件​

SDK說明文件

APP專案整合SDK​

請按照下列方式設置專案

Step 1: 將SDK放入app專案的libs資料夾

請至下載 Download SDK下載SDK,並將壓縮檔內的AAR檔放至專案的libs資料夾, 若無libs資料夾請自行建立

TAMTutorial/
└── app/
├── libs/ ← 放這裡(若無請自行建立)
│ └── adpmobile-lib-r8.0.7.aar
├── src/
├── build.gradle
└── proguard-rules.pro

Step 2-1: 編輯app專案中build.gradle

TAMTutorial/
└── app/
├── libs/
│ └── adpmobile-lib-r8.0.7.aar
├── src/
├── build.gradle ← 編輯這個檔案
└── proguard-rules.pro
MADP SDK 8.0.6 (Kotlin 1.8.x ~ 1.9.22)​
dependencies {
// MADP SDK
implementation files('libs/adpmobile-lib-r8.0.0.aar')
implementation files('libs/omsdk-android-1.3.37-release.aar')

// MADP SDK 相依套件
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
implementation 'com.squareup.retrofit2:converter-scalars:2.9.0'
implementation 'com.google.android.gms:play-services-ads-identifier:17.0.1' // 廣告 ID
implementation 'com.google.android.gms:play-services-appset:16.0.1' // App Set ID
implementation 'com.google.code.gson:gson:2.8.6'
implementation 'androidx.security:security-crypto:1.1.0-alpha03'
implementation 'androidx.activity:activity-ktx:1.9.3'
}
MADP SDK 8.0.7 (Kotlin 2.0.0+)​
dependencies {
// MADP SDK
implementation files('libs/adpmobile-lib-r8.0.7.aar')
implementation files('libs/omsdk-android-1.3.37-release.aar')

// MADP SDK 相依套件
implementation 'com.squareup.retrofit2:retrofit:3.0.0'
implementation 'com.squareup.retrofit2:converter-gson:3.0.0'
implementation 'com.squareup.retrofit2:converter-scalars:3.0.0'
implementation 'com.google.android.gms:play-services-ads-identifier:18.2.0' // 廣告 ID
implementation 'com.google.android.gms:play-services-appset:16.1.0' // App Set ID
implementation 'com.google.code.gson:gson:2.13.2'
implementation 'androidx.security:security-crypto:1.1.0'
implementation 'androidx.activity:activity-ktx:1.11.0'
}

權限設定​

請於 app 專案的 AndroidManifest.xml 中加入下列權限

TAMTutorial/
└── app/
├── libs/
├── src/
│ └── main/
│ ├── java/
│ ├── res/
│ └── AndroidManifest.xml ← 編輯這個檔案
├── build.gradle
└── proguard-rules.pro
  • Required Permission
<!-- TAmedia Required Permission -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  • Optional Permission
<!-- TAmedia Optional Permission -->
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

闔家適用計畫 / 兒童導向應用程式​

本SDK的相依套件 play-services-ads-identifier 已於其manifest中宣告AD_ID權限,manifest合併後會自動出現在您的應用程式中。

若您的應用程式屬於 闔家適用計畫,或為兒童導向應用程式,請於AndroidManifest.xml中加入下列設定,移除AD_ID使用權限

<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">

<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove" />

</manifest>

註:移除 AD_ID 權限後,應用程式取得的廣告 ID 會被置換為全為零的字串。一般應用程式請勿移除,SDK 已透過相依套件自動宣告此權限。

詳情可參考Google網站說明:
2021 年 Google Play 服務更新
Google Play Policy - 家庭