本指南可協助發布商將 Google Mobile Ads Android SDK 搶先體驗版整合至自家 Android 應用程式。搶先體驗版可讓發布商直接運用 Google Mobile Ads SDK 的新功能,無需等到下一個 Google Play 服務推出就能享有以下好處:
一旦 APK 搶先體驗功能推出,廣告就會自動開始使用從 Google Play 服務 APK 導入的新版 Google Mobile Ads SDK。
這些程式庫經過全面測試,且符合 Google 的 Maven 存放區或 SDK Manager 中公開版本的發布條件。
這些是 Google Mobile Ads SDK 的完整版本,雖然比精簡 SDK 還大,但不受 Lite SDK 限制的影響。
這類 API 可用於全球,不限於透過 Google Play 發行的應用程式。
請按照本頁步驟,透過搶先體驗 Google Mobile Ads SDK 設定本機 Maven 存放區,並在 Android 應用程式中將其參照為依附元件。
必要條件
- 使用 Android Studio 3.0 以上版本
- 指定 Android API 級別 16 或以上版本
- 搶先體驗由客戶經理提供的 Google Mobile Ads SDK ZIP 檔案
設定自訂 Maven 存放區
下載搶先體驗的 Google Mobile Ads SDK ZIP 檔案。在專案的頂層目錄中建立 gma_sdk_repo
資料夾,然後將 ZIP 的所有內容放入該資料夾。您的目錄結構應如 <project_root_dir>/gma_sdk_repo/com/google/...
所示。
開啟應用程式的專案層級 build.gradle
檔案。
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
將粗體顯示的行新增至 allprojects/repositories
區段。這會指示 Gradle 在解析依附元件時,在您建立的 gma_sdk_repo
資料夾中尋找 Maven 存放區。
新增建構依附元件
如要在專案中使用 Google Mobile Ads SDK 的搶先體驗版,您需要將其參照為應用程式層級的 build.gradle
檔案中的依附元件:開啟應用程式層級的 build.gradle
檔案,然後將程式碼片段中的粗體行新增至 dependencies
區段。
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
如要確定依附元件版本 (可由上一個程式碼片段中的 x.y.z 顯示),可以前往 Google Mobile Ads Android SDK ZIP 搶先體驗版 Google Mobile Ads Android SDK ZIP 檔案的 com/google/android/gms/play-services-ads/
目錄下,找出 com/google/android/gms/play-services-ads/
目錄底下的最新版本。
解決 Firebase 衝突
如果您將 Firebase 程式庫與 Mobile Ads SDK 搭配使用,專案中可以同時包含 com.google.android.gms:play-services-measurement-api
和 com.google.android.gms:play-services-measurement-sdk-api
依附元件。這兩個依附元件的版本必須相符,但您可能會發現 Mobile Ads SDK 搶先體驗版版本和目前的 Firebase 版本針對這兩個依附元件提取不同版本。
如要解決這個問題,您可以在應用程式的 build.gradle
檔案中,將依附元件強制解析為特定版本的 play-services-measurement-sdk-api
程式庫,如下所示:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
x.y.z
版本取決於您的 Firebase 版本。以下是近期的 Firebase 版本的正確版本:
firebase-core 版本
|
play-services-measurement-sdk-api 版本
|
---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
如要查詢其他 Firebase 版本的正確版本,請為應用程式執行 gradle androidDependencies
,並使用 com.google.android.gms:play-services-measurement-api
依附元件的列印版本。
您的 Android 應用程式現在已可使用 Google Mobile Ads Android SDK 的搶先體驗版。