设置对 Ad Exchange 的直接访问权限

Google 移动广告 SDK 支持通过 Ad Exchange 媒体资源通过您的应用变现。本指南将向您介绍如何针对 Ad Exchange 支持的所有广告格式配置应用。

前提条件

配置您的应用以访问 Ad Exchange

通过包含 android:name="com.google.android.gms.ads.APPLICATION_ID" 的 <meta-data> 标记，将您的 Ad Manager 应用 ID（可在 Ad Manager 界面中找到）添加到应用的 AndroidManifest.xml 文件中。对于 android:value，请插入您自己的 Ad Manager 应用 ID，并用英文引号括起来。

<manifest>
    <application>
        <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

另请注意，未能添加上述 <meta-data> 标记会导致崩溃，并显示以下消息：

Missing application ID.

接下来，您可以初始化 Google 移动广告 SDK 并选择要展示的广告格式。本指南的其余部分将实施横幅广告格式，以说明如何从 Ad Exchange 加载广告。同样的步骤适用于 Google 移动广告 SDK 支持的任何广告格式。

从 Ad Exchange 加载广告

您可以在应用中使用尾随正斜杠的 Ad Exchange 网络媒体资源代码来代替广告单元 ID。

例如，如需通过在 Activity 的布局中放置 AdManagerAdView 来加载横幅广告，如下所示：

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

请注意，如果未能在 Ad Exchange 网络媒体资源代码中添加尾随正斜杠（如上所示），会导致广告请求错误，并显示以下消息：

Invalid Request. Cannot determine request type. Is your ad unit id correct?

另请注意，您还可以将 Ad Exchange 网络媒体资源代码转换为广告单元。 之后，您可以使用 Ad Manager 界面生成 Ad Exchange 代码并将其复制到您的应用中。生成的代码应包含 Ad Exchange 网站媒体资源代码，后跟不带正斜线的后代广告单元 ID，例如：ca-mb-app-pub-5629679302779023/banner

或者，您也可以通过程序化方式创建 AdManagerAdView：

Java

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

Kotlin

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

添加 AdManagerAdView 后，您便可以调用 AdManagerAdView 类中的 loadAd() 方法，并使用广告事件自定义广告的行为。

大功告成！现在，您的应用就可以加载和展示来自 Ad Exchange 的横幅广告了。

此外，您可以按照相应的指南，使用 Ad Exchange 网站媒体资源加载和展示 Ad Exchange 中的其他广告格式：

（仅限已获批准的欧洲发布商）添加底价

您可以提交使用“底价”功能的请求。

获得批准后，您可以分别使用 pubf 和 pvtf 参数在广告请求中添加公开楼层或不公开楼层。在以下代码示例中，请将“123”替换为以微单位表示的底价和广告联盟的默认币种。微单位应用方式示例：如果您的默认货币是美元，则输入“6000000”相当于 $6.00。

Java

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();