插頁式廣告是全螢幕廣告,會覆蓋應用程式介面,直到 使用者關閉的內容這類廣告通常出現在 應用程式的流程,例如活動之間或暫停期間 遊戲關卡使用者可選擇在應用程式顯示插頁式廣告時 讓使用者輕觸廣告前往到達網頁,或關閉廣告並返回 加入 App Engine 應用程式 個案研究。
本指南說明如何將插頁式廣告整合至 Android 和 iOS 應用程式 Google Mobile Ads C++ SDK
必要條件
- 完成開始使用。
- (僅限 Android) 熟悉使用 JNI
jobject
參照 (請參閱 Android JNI 提示)。
一律使用測試廣告進行測試
建構及測試應用程式時,請務必使用測試廣告,而非 現場及正式環境廣告否則可能導致帳戶遭到停權。
要載入測試廣告,最簡單的方法是使用我們專屬的測試廣告單元編號。 插頁式廣告,因裝置平台而異:
- Android:
ca-app-pub-3940256099942544/1033173712
- iOS:
ca-app-pub-3940256099942544/4411468910
已設定為針對每次請求傳回測試廣告 您可以在自己的應用程式中自由使用這項 API,編寫程式碼、進行測試及偵錯。 發布廣告素材前,請務必將其換成自己的廣告單元編號 應用程式。
若要進一步瞭解 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();
使用父項檢視畫面初始化
InterstitialAd
例項,並將層級轉換為AdParent
類型。父項檢視畫面是 Android 的 JNIjobject
參照Activity
或指標,指向 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);
除了將 Future 保留為變數之外,您也可以定期 透過叫用
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
,請參閱
使用 Future 監控方法的完成狀態
呼叫。
載入廣告
系統會使用 LoadAd()
方法,
InterstitialAd
物件。使用載入方法,您必須先初始化
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
類別才能接收
插頁式廣告顯示和生命週期事件的通知。您的自訂
FullScreenContentListener
子類別可透過
InterstitialAd::SetFullScreenContentListener()
方法,
廣告成功或失敗以及
就會設為關閉
下列程式碼顯示如何擴充類別並指派給廣告:
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
是一次性的物件。也就是說
卻無法再次顯示。最佳做法是載入
在您網頁的 OnAdDismissedFullScreenContent()
方法中
FullScreenContentListener
,這樣系統才會在
就會立即刪除
顯示廣告
插頁式廣告必須在應用程式流程中的自然暫停期間顯示。
在遊戲關卡之間,或是使用者完成任務後,就是不錯的範例。
雖然 FullScreenContentListener
可用來判斷廣告
顯示全螢幕內容,Show()
傳回的未來也會發出信號
廣告成功顯示時。
firebase::Future<void> result = interstitial_ad->Show();
最佳做法
- 請思考插頁式廣告是否適合您應用程式的廣告類型。
- 插頁式廣告最適合包含自然轉換點的應用程式。 應用程式內的工作結尾,例如分享圖片或完成遊戲 則會建立這類點由於使用者預期在 您就能輕鬆顯示插頁式廣告,而且不會中斷 無須專人管理請務必考慮在應用程式工作流程中的哪個階段 顯示插頁式廣告以及使用者的回應方式
- 提醒您,顯示插頁式廣告時應將動作暫停。
- 插頁式廣告分成幾種不同類型的插頁式廣告:文字、圖像、
影片等。請務必確認應用程式顯示
也會暫時停止使用部分資源,以便讓廣告
善加利用這些原則舉例來說,如果您呼叫以顯示
插頁式廣告,請務必暫停應用程式產生的任何音訊輸出。
您可以透過以下的
OnAdDismissedFullScreenContent
方法繼續播放音效: 已安裝的FullScreenContentListener
,系統會在使用者 與廣告互動完成。此外,請考慮暫時 播放期間任何密集運算作業 (例如遊戲迴圈) 高度。確保使用者不會遇到 無回應圖像或影片延遲。 - 提供足夠的載入時間。
- 同樣重要的是,務必在 並確保使用者不必等待 載入內容請提早 載入廣告 您應用程式當時已完全載入的插頁式廣告 。
- 不要讓應用程式廣告氾濫。
- 雖然增加應用程式內插頁式廣告的顯示頻率, 不但有助於增加收益,也可能損及使用者體驗 導致點閱率降低確認使用者不常使用 幹擾,無法繼續享受您的應用程式。
- 請不要利用載入完成的未來顯示插頁式廣告。
- 這會對使用者體驗造成負面影響。請在 表示需要出示的標誌
其他資源
GitHub 中的範例
- 查看範例的原始碼 快速入門導覽課程應用程式 。