透過 AdMob 中介服務,您的應用程式就能放送眾多來源 (包括 AdMob 聯播網、第三方廣告聯播網和 AdMob 廣告活動) 提供的廣告。AdMob 中介服務會向多個聯播網送出廣告請求,以確保您透過最合適的聯播網放送廣告,進而提高廣告供應率和收益。 個案研究。
必要條件
您必須先將廣告格式整合到應用程式中,才能整合廣告格式的中介服務:
第一次使用中介服務嗎?閱讀 AdMob 中介服務總覽。
出價:Google Mobile Ads SDK 18.3.0 以上版本。
初始化 Mobile Ads SDK
快速入門指南說明如何初始化 Mobile Ads SDK。在初始化呼叫期間,中介服務和出價轉接程式也會初始化。請務必先等待初始化完成,再載入廣告,以確保從第一個廣告請求中來自每個廣告聯播網的所有機會都能參與。
下列程式碼範例說明如何在發出廣告請求前,檢查每個轉接程式的初始化狀態。
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
for (String adapterClass : statusMap.keySet()) {
AdapterStatus status = statusMap.get(adapterClass);
Log.d("MyApp", String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status.getDescription(), status.getLatency()));
}
// Start loading ads here...
}
});
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
MobileAds.initialize(this) { initializationStatus ->
val statusMap =
initializationStatus.adapterStatusMap
for (adapterClass in statusMap.keys) {
val status = statusMap[adapterClass]
Log.d("MyApp", String.format(
"Adapter name: %s, Description: %s, Latency: %d",
adapterClass, status!!.description, status.latency))
}
// Start loading ads here...
}
查看哪個廣告聯播網轉接程式類別已載入廣告
以下範例程式碼會記錄橫幅廣告的廣告聯播網類別名稱:
Java
public void onAdLoaded() {
Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}
Kotlin
override fun onAdLoaded() {
Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}
如要進一步瞭解這個方法,請參閱 getMediationAdapterClassName()
的 ResponseInfo
說明文件。
使用 Activity 例項初始化廣告物件
在新廣告物件的建構函式 (例如:AdView
) 中,您必須傳入 Context
類型的物件。這個Context
會在使用中介服務時傳遞至其他廣告聯播網。部分廣告聯播網需要更嚴格的 Context
(類型為 Activity
),在沒有 Activity
執行個體的情況下可能無法放送廣告。因此,建議您在初始化廣告物件時傳入 Activity
例項,以確保與中介服務廣告聯播網提供的體驗一致。
橫幅廣告中介服務
對於 AdMob 中介服務中使用的橫幅廣告單元,請務必在所有第三方廣告聯播網 UI 中停用重新整理功能。AdMob 也會根據橫幅廣告單元的重新整理頻率觸發重新整理作業,因此可避免重複重新整理。
原生廣告中介服務
以下是實作原生中介服務時建議考慮的一些最佳做法。
- 原生廣告顯示政策
- 每個廣告聯播網都有各自的政策,使用中介服務時,請務必留意,應用程式仍須遵守提供廣告的中介聯播網相關政策。
- 以
loadAd()
取代loadAds()
loadAds()
方法只會放送 Google 廣告。如果是中介服務廣告,請改用loadAd()
。
美國州級隱私權法律和 GDPR
如果您需要遵守美國州級隱私權法律或一般資料保護法規 (GDPR),請按照美國州級法規設定或 GDPR 設定中的步驟,在 AdMob 隱私權與訊息的美國州級或 GDPR 廣告合作夥伴名單中新增中介服務合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。
進一步瞭解如何啟用受限的資料處理 (RDP),並透過 Google User Messaging Platform (UMP) SDK 取得 GDPR 同意聲明。