开始使用

本指南介绍了如何将中介适配器与 Android 应用相集成。

前提条件

在为广告格式集成中介功能之前，您需要将相应广告格式集成到自己的应用中：

中介功能新手一枚？阅读中介简介。

对于出价： Google 移动广告 SDK 18.3.0 或更高版本。

初始化 Google 移动广告 SDK

本快速入门指南介绍了如何初始化 Google 移动广告 SDK。在初始化调用期间，中介适配器也会初始化。请务必在初始化完成后再加载广告，以验证每个广告联盟是否都可完全参与第一个广告请求。

以下示例代码展示了如何在发出广告请求前检查每个适配器的初始化状态。

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

检查哪个广告联盟适配器类加载了广告

下面是一些示例代码，这些代码记录了横幅广告的广告联盟类名称：

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

如需详细了解此方法，请参阅关于 getMediationAdapterClassName() 的 ResponseInfo 文档。

使用 Activity 实例初始化您的广告对象

在新广告对象（例如 AdManagerAdView）的构造函数中，您必须传入类型为 Context 的对象。使用中介时，此 Context 会传递到其他广告联盟。某些广告联盟需要类型为 Activity 且条件更严格的 Context，并且如果没有 Activity 实例，可能无法投放广告。因此，我们建议在初始化广告对象时传入 Activity 实例，以验证从您所有参与中介的广告联盟获得一致的体验。

将横幅广告与中介搭配使用

对于中介里所使用的横幅广告单元，请确保停用所有第三方广告来源界面中的刷新功能。这可防止重复刷新，因为 Ad Manager 也会根据横幅广告单元的刷新频率而触发刷新。

将原生广告与中介搭配使用

以下是实现原生中介时可以考虑的一些最佳做法。

原生广告展示政策
每个广告联盟都有自己的政策。请注意，使用中介功能时，您的应用仍需遵守提供相应广告的中介广告联盟的政策。
使用 loadAd()，而不要使用 loadAds()
loadAds() 方法仅适用于 Google 广告。对于参与中介的广告，请改为使用 loadAd()。

美国州级隐私保护法律和 GDPR

如果您需要遵守美国州级隐私保护法律或《一般数据保护条例》(GDPR)，请按照美国州级法规设置或 GDPR 设置中的步骤，将您的中介合作伙伴添加到 Ad Manager“隐私权和消息”的美国州级或 GDPR 广告合作伙伴名单中。否则，可能会导致合作伙伴无法在您的应用中投放广告。

详细了解如何使用 Google User Messaging Platform (UMP) SDK 启用受限的数据处理 (RDP) 并征求 GDPR 意见。

下一页
选择广告资源网