開始使用

本指南說明如何將中介服務轉接器整合至 Android 應用程式。

必要條件

您必須先將廣告格式整合至應用程式，才能整合廣告格式的中介服務：

• 橫幅廣告
• 插頁式廣告
• 原生廣告
• 獎勵廣告
• 插頁式獎勵廣告

第一次使用中介服務嗎？請參閱中介服務簡介。

出價： Google Mobile Ads SDK 18.3.0 以上版本。

初始化 Mobile Ads SDK

快速入門指南會說明如何初始化 Mobile Ads SDK。在初始化呼叫期間，中介服務適配器也會進行初始化。請務必等待初始化作業完成，再載入廣告，以確保每個廣告聯播網都能在第一個廣告請求中完整參與。

以下程式碼範例說明如何在發出廣告要求前，檢查每個轉接程式初始化的狀態。

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);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        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...
                        }))
            .start();
    }
}

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { 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...
      }
    }
  }
}

檢查哪個廣告聯播網轉接程式類別載入廣告

以下是記錄橫幅廣告廣告聯播網類別名稱的部分程式碼範例：

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

如要進一步瞭解這個方法，請參閱 getMediationAdapterClassName() 的 ResponseInfo 說明文件。

使用活動例項初始化廣告物件

在新廣告物件 (例如 AdManagerAdView) 的建構函式中，您必須傳入 Context 類型的物件。使用中介服務時，這個 Context 會傳遞至其他廣告聯播網。部分廣告聯播網需要使用限制較嚴格的 Context，類型為 Activity，且可能無法在沒有 Activity 例項的情況下放送廣告。因此，建議您在初始化廣告物件時傳入 Activity 例項，確保與中介廣告聯播網的一致體驗。

搭配中介服務使用橫幅廣告

請務必針對中介服務中使用的橫幅廣告單元，在所有第三方廣告來源 UI 中停用重新整理功能。這樣做可避免重複重新整理，因為 Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理作業。

搭配中介服務使用原生廣告

以下是實作原生中介服務時，可考慮採用的最佳做法。

原生廣告呈現方式政策

每個廣告聯播網都有各自的政策。使用中介服務時，請務必記住，您的應用程式仍須遵守提供廣告的中介服務網路的政策。

以 loadAd() 取代 loadAds()

loadAds() 方法只會放送 Google 廣告。如果是經由中介服務刊登的廣告，請改用 loadAd()。

美國州級隱私權法律和 GDPR

如果您需要遵守《美國州級隱私權法律》或《一般資料保護規則 (GDPR)》，請按照「美國州級法規設定」或「GDPR 設定」中的步驟，在 Ad Manager 隱私權與訊息的美國州或 GDPR 廣告合作夥伴清單中新增中介合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。