設定 Ad Exchange 的直接存取權

選取平台： Android iOS

Google Mobile Ads SDK 支援透過 Ad Exchange 資源在應用程式中營利。本指南說明如何為 Ad Exchange 支援的所有廣告格式設定應用程式。

必要條件

設定應用程式以存取 Ad Exchange

在應用程式的 AndroidManifest.xml 檔案中，透過 <meta-data> 標籤和 android:name="com.google.android.gms.ads.APPLICATION_ID"，加入 Ad Manager 應用程式 ID (顯示於 Ad Manager UI 中)。在 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 Mobile Ads SDK，並選取要顯示的廣告格式。本指南的其餘部分會實作橫幅格式，說明如何從 Ad Exchange 載入廣告。這些步驟也適用於 Google Mobile Ads 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 就位後，您可以在 AdManagerAdView 類別中呼叫 loadAd() 方法，並使用廣告事件自訂廣告行為。

請注意，如果未在 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」替換成以微元為單位的底價，以及聯播網的預設幣別。微元的使用範例：如果預設貨幣為美元，輸入「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();