为 Ad Exchange 设置直接访问权限

选择平台： Android 新 Android iOS

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。例如，ca-mb-app-pub-5629679302779023/。

例如，如需通过在 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>

或者，您也可以通过编程方式创建视图层次结构：

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 放置到位后，您可以 调用 loadAd() 方法 在 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。

大功告成！您的应用现已准备好加载和展示 Ad Exchange 横幅广告了。

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

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

您可以申请使用“底价” 功能。

获得批准后，您可以使用 pubf 和 pvtf 参数分别在广告请求中添加公开底价或私下底价。在以下代码 示例中，将“123”替换为以微单位和您的 网络 的默认币种表示的底价。微单位应用示例：如果默认币种为 USD，输入“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();