開始使用

將 Google Mobile Ads SDK 整合至應用程式,是顯示廣告並賺取收益的第一步。整合 SDK 後,您可以選擇廣告格式 (例如原生或獎勵影片廣告),然後按照步驟導入。

事前準備

如要讓應用程式做好準備,請完成下列各節的步驟。

應用程式必要條件

  • 請確認應用程式的版本檔案使用下列的值:

    • SDK 最低版本為 19 或以上版本
    • 編譯33以上版本

在 AdMob 帳戶中設定應用程式

完成下列步驟,即可將應用程式註冊為 AdMob 應用程式:

  1. 登入註冊 AdMob 帳戶。

  2. 向 AdMob 註冊應用程式。 這個步驟會使用專屬 AdMob 應用程式 ID 建立 AdMob 應用程式,本指南稍後將會用到。

設定應用程式

  1. 在專案層級的 build.gradle 檔案中,同時在 buildscriptallprojects 區段中納入 Google Maven 存放區Maven 中央存放區

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. 將 Google Mobile Ads SDK 的依附元件加進模組的應用程式層級 Gradle 檔案,通常為 app/build.gradle

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.0'
    }
    
  3. AdMob網頁介面中的應用程式 ID AdMob 加入應用程式的 AndroidManifest.xml 檔案中。如要這樣做,請新增含有 android:name="com.google.android.gms.ads.APPLICATION_ID"<meta-data> 標記。您可以在網頁介面中找到應用程式 ID。 AdMob 針對 android:value,插入您自己的 AdMob 應用程式 ID,並以半形引號括住。

    <manifest>
      <application>
        <!-- Sample AdMob 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>
    

    在實際應用程式中,請將範例應用程式 ID 換成實際的AdMob 應用程式 ID。如果您只是在 Hello World 應用程式中測試 SDK,可以使用範例 ID。

    另請注意,如果無法完全按照顯示的方式新增 <meta-data> 標記,會導致當機並出現以下訊息:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (選用) 宣告先前版本的 AD_ID 權限,以便與 Android 13 搭配使用。

    如果應用程式使用 Google Mobile Ads SDK 20.4.0 以上版本,您可以略過這個步驟,因為 SDK 會自動宣告 com.google.android.gms.permission.AD_ID 權限,並在可用時存取廣告 ID。

    如果應用程式使用 Google Mobile Ads SDK 20.3.0 以下版本,且指定目標為 Android 13,則您必須在 AndroidManifest.xml 檔案中新增 com.google.android.gms.permission.AD_ID 權限,讓 Google Mobile Ads SDK 存取廣告 ID:

    <manifest>
     <application>
       <meta-data
           android:name="com.google.android.gms.ads.APPLICATION_ID"
           android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
       <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
       <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    
     </application>
    </manifest>
    

    如要進一步瞭解 com.google.android.gms.permission.AD_ID 權限宣告,包括如何停用權限,請參閱這篇 Play 管理中心文章

初始化 Google Mobile Ads SDK

在載入廣告之前,請呼叫 MobileAds.initialize() 來初始化 Google Mobile Ads SDK。

這個方法會初始化 SDK,並在 Google Mobile Ads SDK 和轉接程式的初始化作業完成,或經過 30 秒逾時後,呼叫完成事件監聽器。此操作只需執行一次,最好在應用程式啟動時執行。

在初始化時,廣告可由 Google Mobile Ads SDK 或中介服務合作夥伴 SDK 預先載入。如需取得歐洲經濟區 (EEA) 使用者的同意聲明,請設定任何請求專屬標記,例如 setTagForChildDirectedTreatment()setTagForUnderAgeOfConsent()、 或以其他方式載入 Google Mobile Ads SDK。

以下範例說明如何在 Activity 中呼叫 initialize() 方法:

Java

import com.google.android.gms.ads.MobileAds;
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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

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

    MobileAds.initialize(this) {}
  }
}

選取廣告格式

現已匯入 Google Mobile Ads SDK,您現在可以開始導入廣告。AdMob 提供多種廣告格式,您可以挑選最適合應用程式使用者體驗的格式。

橫幅廣告單元會顯示佔用應用程式版面配置一部分的矩形廣告。且會在一段時間後自動重新整理。這表示即使使用者一直留在應用程式的同一個畫面,仍會定期看到新廣告。這也是最簡單的導入廣告格式。

導入橫幅廣告

插頁式

插頁式廣告單元會在應用程式中顯示全版廣告,將廣告放在應用程式介面上的自然中斷點和轉換點,例如在遊戲應用程式中過關後。

導入插頁式廣告

原生

原生廣告是可讓您自訂素材資源 (例如廣告標題和行動號召) 在應用程式中的顯示方式。自行設定廣告樣式,就能製作出自然、不會幹擾的廣告簡報,為使用者體驗增添更多元的體驗。

導入原生廣告

已獲得獎勵

獎勵廣告單元可讓使用者透過玩遊戲、參加問卷調查或觀看影片,獲得應用程式內獎勵,例如金幣、額外生命或積分。您可為不同的廣告單元設定不同的獎勵,並指定使用者獲得的獎勵價值和項目。

導入獎勵廣告

插頁式獎勵廣告

插頁式獎勵廣告是新型的獎勵廣告格式,可讓您針對在應用程式自然轉換期間自動顯示的廣告提供獎勵 (例如金幣或額外生命)。

與獎勵廣告不同的是,獎勵廣告不需要等使用者選擇觀看。

插頁式獎勵廣告會顯示選擇觀看提示,而不是在獎勵廣告中顯示選擇觀看提示,改為提供簡介畫面,讓使用者有機會選擇是否取消訂閱。

導入插頁式獎勵廣告

應用程式開啟頁面廣告

應用程式開啟頁面廣告是一種廣告格式,會在使用者開啟或切換回應用程式時顯示,廣告會重疊在載入畫面。

導入應用程式開啟頁面廣告

其他資源

GitHub 上的 Google 行動廣告存放區示範如何使用這個 API 提供的各種廣告格式。