本指南適用於希望透過 AdMob 而非 Firebase 為 C++ 應用程式創造收益的發布商。如果您打算在應用程式中加入 Firebase,或正在考慮這麼做,請改為參閱AdMob 搭配 Firebase 版本的指南。
將 Google Mobile Ads C++ SDK 整合至應用程式,是刊登廣告及賺取收益的第一步。整合 SDK 後,您可以選擇插頁式廣告或獎勵廣告等廣告格式,然後按照步驟導入。
Google Mobile Ads C++ SDK 會包裝 Google Mobile Ads iOS 和 Android SDK,且僅適用於這些平台。Google Mobile Ads C++ SDK 利用 Firebase C++ 建構支援非同步作業,因此位於 firebase::gma
命名空間中。
如果這是您第一次閱讀本指南,建議您下載並使用 Google 行動廣告 C++ 測試應用程式進行操作。
必要條件
Android
- 使用 Android Studio 3.2 以上版本
- 請確認應用程式的建構檔案使用下列值:
minSdkVersion
16 以上compileSdkVersion
為 28 以上
iOS
- 使用 Xcode 13 以上版本
- 指定 iOS 10.0 以上版本
在 AdMob 帳戶中設定應用程式
完成下列步驟,將應用程式註冊為 AdMob 應用程式:
向 AdMob 註冊應用程式。這個步驟會使用專屬的 AdMob 應用程式 ID 建立 AdMob 應用程式,本指南稍後會需要這個 ID。
安裝 Google Mobile Ads C++ SDK
由於 Google Mobile Ads C++ SDK 位於 firebase::gma
命名空間,請下載 Firebase C++ SDK,然後將其解壓縮至所選目錄。
Firebase C++ SDK 並非平台專屬,但需要平台專屬的程式庫設定。
Android
我們建議您使用 CMake,但您也可以在我們的一般 Firebase C++ SDK 入門指南中找到 ndk-build 的操作說明,將 libfirebase_app.a
和 libfirebase_gma.a
連結至應用程式。
在專案的
gradle.properties
檔案中,指定未解壓縮的 SDK 位置:systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
在專案的
settings.gradle
檔案中新增以下內容:def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir') gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir" includeBuild "$firebase_cpp_sdk_dir"
在模組 (應用程式層級) Gradle 檔案 (通常為
app/build.gradle
) 中,加入下列內容,其中包含 Google Mobile Ads C++ SDK 的程式庫依附元件。android.defaultConfig.externalNativeBuild.cmake { arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir" } # Add the dependency for the Google Mobile Ads C++ SDK apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle" firebaseCpp.dependencies { gma }
在專案的
CMakeLists.txt
檔案中加入以下內容。# Add Firebase libraries to the target using the function from the SDK. add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL) # Add the Google Mobile Ads C++ SDK. # The Firebase C++ library `firebase_app` is required, # and it must always be listed last. set(firebase_libs firebase_gma firebase_app ) target_link_libraries(${target_name} "${firebase_libs}")
同步處理應用程式,確保所有依附元件皆為必要的版本。
iOS
本節將示範如何將 Google Mobile Ads C++ SDK 加進 iOS 專案。
執行下列指令,取得 CocoaPods 1 以上版本:
sudo gem install cocoapods --pre
從解壓縮的 SDK 中加入 Google Mobile Ads Pod。
如果您尚未建立 Podfile,請建立一個:
cd APP_DIRECTORY
pod init
在 Podfile 中加入 Google Mobile Ads C++ SDK、Google User Messaging Platform SDK 和最小 Firebase 核心 SDK 的 Pod (由 GMA C++ SDK 所需):
pod 'Firebase/CoreOnly' pod 'Google-Mobile-Ads-SDK' pod 'GoogleUserMessagingPlatform'
安裝 Pod,然後在 Xcode 中開啟
.xcworkspace
檔案。pod install
open APP.xcworkspace
將 Firebase C++ SDK 中的下列架構新增至專案:
xcframeworks/firebase.xcframework
xcframeworks/firebase_gma.xcframework
太好了!C++ 應用程式已設定為使用 Google Mobile Ads C++ SDK,而非任何其他 Firebase 服務。
設定應用程式的 AdMob 應用程式 ID
Android
請按照 Mobile Ads SDK Android 指南所述的「設定應用程式」步驟 3 操作,然後返回本頁。
iOS
請按照更新 Info.plist 步驟操作,如 Mobile Ads SDK iOS 指南所述,然後返回本頁。
初始化 Google Mobile Ads SDK
在載入廣告之前,請讓應用程式透過呼叫 firebase::gma::Initialize()
初始化 Google Mobile Ads C++ SDK,這項作業會在初始化完成後 (或 30 秒逾時後) 初始化 SDK 並完成 firebase::Future
。這項操作只需進行一次,最好在應用程式啟動時。
呼叫 Initialize()
時,Google Mobile Ads C++ SDK 或中介服務合作夥伴 SDK 可預先載入廣告。如果您需要向歐洲經濟區 (EEA) 的使用者取得同意聲明、設定任何要求專屬標記 (例如 tag_for_child_directed_treatment
或 tag_for_under_age_of_consent
),或是在載入廣告前採取其他行動,請務必先在初始化 Google Mobile Ads C++ SDK 前,呼叫 firebase::gma::SetRequestConfiguration()
才能執行這些操作。詳情請參閱「指定目標」指南。
以下是如何呼叫 Initialize()
的範例:
Android
// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
firebase::gma::Initialize(jni_env, j_activity, &result);
if (result != kInitResultSuccess) {
// Initialization immediately failed, most likely due to a missing
// dependency. Check the device logs for more information.
return;
}
// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
future.error() == firebase::gma::kAdErrorCodeNone) {
// Initialization completed.
} else {
// Initialization on-going, or an error has occurred.
}
iOS
// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
firebase::gma::Initialize(&result);
if (result != kInitResultSuccess) {
// Initialization immediately failed, most likely due to a missing
// dependency. Check the device logs for more information.
return;
}
// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
future.error() == firebase::gma::kAdErrorCodeNone) {
// Initialization completed.
} else {
// Initialization on-going, or an error has occurred.
}
使用 Future
監控方法呼叫的完成狀態
Future
可讓您判斷非同步方法呼叫的完成狀態。
舉例來說,當應用程式呼叫 firebase::gma::Initialize()
時,系統會建立新的 firebase::Future
並傳回。這樣一來,應用程式就可以輪詢 Future
的 status()
,判斷初始化何時完成。完成後,應用程式可以叫用 result()
來取得結果 AdapterInitializationStatus
。
傳回 Future
的方法會有對應的「最後結果」方法,應用程式可使用該方法擷取特定動作的最新 Future
。舉例來說,firebase::gma::Initialize()
有一個名為 firebase::gma::InitializeLastResult()
的對應方法,可傳回 Future
,讓應用程式用於檢查上次對 firebase::gma::Initialize()
的呼叫狀態。
如果 Future
的狀態已完成,且錯誤代碼為 firebase::gma::kAdErrorCodeNone
,表示作業已順利完成。
您也可以註冊回呼,在 Future
完成時呼叫。在某些情況下,回呼會在不同的執行緒中執行,因此請確保程式碼具有執行緒安全性。下列程式碼片段使用回呼函式指標:
// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
/*user_data=*/nullptr);
// The OnCompletion callback function.
static void OnCompletionCallback(
const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
// Called when the Future is completed for the last call to firebase::gma::Initialize().
// If the error code is firebase::gma::kAdErrorCodeNone,
// then the SDK has been successfully initialized.
if (future.error() == firebase::gma::kAdErrorCodeNone) {
// success!
} else {
// failure.
}
}
選取廣告格式
Google Mobile Ads C++ SDK 現已匯入,您可以開始導入廣告了。AdMob 提供多種不同的廣告格式,您可以選擇最適合應用程式使用者體驗的廣告格式。
橫幅廣告
這類矩形廣告會顯示在裝置畫面頂端或底部。使用者與應用程式互動時,橫幅廣告會停留在畫面上,且經過一段時間後會自動重新整理。如果您不熟悉行動廣告,不妨從這裡開始。
插頁式
全螢幕廣告會覆蓋應用程式的介面,直到使用者關閉為止。這類廣告最適合用於應用程式執行流程中的自然暫停時間,例如遊戲關卡之間,或任務完成後。
已獲得獎勵
在使用者看完短片、與可試玩廣告及問卷調查互動後提供獎勵的廣告。用於透過免付費遊戲應用程式營利。