插頁式廣告是全螢幕廣告,會覆蓋應用程式的介面,直到使用者關閉為止。通常顯示在應用程式流程中的自然轉換點,例如活動之間或遊戲關卡之間的暫停期間。應用程式顯示插頁式廣告時,使用者可選擇輕觸廣告前往到達網頁,或關閉廣告並返回應用程式。個案研究。
本指南說明如何使用 Google Mobile Ads C++ SDK,將插頁式廣告整合至 Android 和 iOS 應用程式。
必要條件
- 完成開始使用。
- (僅限 Android 裝置) 熟悉如何使用 JNI
jobject
參照 (請參閱 Android JNI 提示)。
一律使用測試廣告進行測試
建構及測試應用程式時,請務必使用測試廣告,而非正式版廣告。否則可能導致帳戶遭到停權。
如要載入測試廣告,最簡單的方法是使用插頁式廣告的專屬測試廣告單元 ID,這個 ID 因裝置平台而異:
- Android:
ca-app-pub-3940256099942544/1033173712
- iOS:
ca-app-pub-3940256099942544/4411468910
由於這類廣告經過特別設定,為每個請求傳回測試廣告;編寫程式碼、測試及偵錯時,您可以在自己的應用程式中自由使用這類廣告。但請注意,請務必先將其換成自己的廣告單元 ID,再發布應用程式。
如要進一步瞭解 Mobile Ads SDK 測試廣告的運作方式,請參閱「測試廣告」一文。
導入作業
整合插頁式廣告的主要步驟如下:
- 載入廣告。
- 註冊回呼。
- 顯示廣告並處理其生命週期事件。
設定 InterstitialAd
插頁式廣告會顯示在 InterstitialAd
物件中,因此要將插頁式廣告整合至應用程式,第一步是建立並初始化 InterstitialAd
物件。
在應用程式的 C++ 程式碼中加入下列標頭:
#include "firebase/gma/interstial_ad.h"
宣告
InterstitialAd
物件並例項化:firebase::gma::InterstitialAd* interstitial_ad; interstitial_ad = new firebase::gma::InterstitialAd();
使用父項檢視畫面轉換為
AdParent
類型,初始化InterstitialAd
例項。父項檢視畫面是 AndroidActivity
的 JNIjobject
參照,或指向 iOSUIView
的指標。// my_ad_parent is a jobject reference to an Android Activity or // a pointer to an iOS UIView. firebase::gma::AdParent ad_parent = static_cast<firebase::gma::AdParent>(my_ad_parent); firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);
除了將未來保留為變數之外,您也可以在
InterstitialAd
物件上叫用InitializeLastResult()
,定期檢查初始化作業的狀態。這有助於追蹤全域遊戲迴圈中的初始化程序。// Monitor the status of the future in your game loop: firebase::Future<void> result = interstitial_ad->InitializeLastResult(); if (result.status() == firebase::kFutureStatusComplete) { // Initialization completed. if(future.error() == firebase::gma::kAdErrorCodeNone) { // Initialization successful. } else { // An error has occurred. } } else { // Initialization on-going. }
如要進一步瞭解如何使用 firebase::Future
,請參閱「使用 Futures 監控方法呼叫的完成狀態」。
載入廣告
使用 InterstitialAd
物件的 LoadAd()
方法即可載入廣告。載入方法需要您初始化 InterstitialAd
物件,且擁有廣告單元 ID 和 AdRequest
物件。系統會傳回 firebase::Future
,可用於監控載入作業的狀態和結果。
下列程式碼顯示如何在 InterstitialAd
成功初始化後載入廣告:
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);
註冊回呼
您必須擴充 FullScreenContentListener
類別,才能接收插頁式廣告顯示和生命週期事件的通知。您可以透過 InterstitialAd::SetFullScreenContentListener()
方法註冊自訂 FullScreenContentListener
子類別,並在廣告成功或失敗時及關閉時收到回呼。
以下程式碼顯示如何擴充類別,並將其指派給廣告:
class ExampleFullScreenContentListener : public firebase::gma::FullScreenContentListener { public: ExampleFullScreenContentListener() {} void OnAdClicked() override { // This method is invoked when the user clicks the ad. } void OnAdDismissedFullScreenContent() override { // This method is invoked when the ad dismisses full screen content. } void OnAdFailedToShowFullScreenContent(const AdError& error) override { // This method is invoked when the ad failed to show full screen content. // Details about the error are contained within the AdError parameter. } void OnAdImpression() override { // This method is invoked when an impression is recorded for an ad. } void OnAdShowedFullScreenContent() override { // This method is invoked when the ad showed its full screen content. } }; ExampleFullScreenContentListener* full_screen_content_listener = new ExampleFullScreenContentListener(); interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);
InterstitialAd
是一次性的物件。也就是說,插頁式廣告一旦顯示,就無法再次顯示。最佳做法是在 FullScreenContentListener
的 OnAdDismissedFullScreenContent()
方法中載入另一個插頁式廣告,這樣就能在關閉上一個插頁式廣告時立即開始載入。
顯示廣告
插頁式廣告應該在應用程式流程中的自然暫停處顯示。例如,在遊戲關卡之間,或是在使用者完成任務後顯示。雖然 FullScreenContentListener
可用來判斷廣告何時顯示全螢幕內容,但 Show()
日後傳回的未來也會指出廣告是否成功顯示。
firebase::Future<void> result = interstitial_ad->Show();
最佳做法
- 請思考插頁式廣告是否為適合您應用程式的廣告類型。
- 插頁式廣告最適合用於含有自然轉換點的應用程式。每當應用程式內的工作結束 (例如分享圖片或完成遊戲關卡) 時,便會建立這類時間點。由於使用者期望在操作過程中休息一下,因此可輕鬆放送插頁式廣告,避免干擾他們體驗。請務必考慮在應用程式工作流程中的哪個時間點顯示插頁式廣告,以及使用者的可能反應。
- 請記得在顯示插頁式廣告時暫停動作。
- 插頁式廣告有多種類型:文字、圖像、影片等。請務必確保應用程式顯示插頁式廣告時,一併暫停使用部分資源,廣告才能利用資源。舉例來說,當您呼叫顯示插頁式廣告時,請務必暫停應用程式產生的任何音訊輸出。您可以使用已安裝
FullScreenContentListener
的OnAdDismissedFullScreenContent
方法繼續播放音效,在使用者完成與廣告互動時叫用。此外,請考慮在廣告顯示期間暫時暫停所有密集的運算工作 (例如遊戲迴圈)。確保使用者不會體驗緩慢或沒有回應的圖像,或影片跳動不流暢。 - 允許充分的載入時間。
- 確保在適當時機顯示插頁式廣告非常重要,而您也應該確保使用者不必等待廣告載入。在您想放送廣告前預先載入廣告,可確保應用程式在準備好顯示時已有完全載入的插頁式廣告。
- 不要讓應用程式廣告氾濫。
- 增加在應用程式中顯示插頁式廣告的頻率也許是提升收益的好方法,但也有可能導致使用者體驗和點閱率下降。請確保使用者不會經常中斷,以免他們無法再使用您的應用程式。
- 請勿利用「載入完成」未來顯示插頁式廣告。
- 這會對使用者體驗造成負面影響。需要在廣告顯示之前預先載入廣告。
其他資源
GitHub 中的範例
- 在 GitHub 中查看快速入門導覽課程應用程式範例的原始碼。
行動廣告學程影片教學課程
成功案例
後續步驟
- 如果您尚未自行建立,請在 AdMob 使用者介面建立自己的插頁式廣告單元。
- 瞭解廣告指定目標和插頁式廣告規範。