開始使用

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

事前準備

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

應用程式必要條件

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

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

設定應用程式

  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:22.6.0'
    }
    
  3. Ad Manager網頁介面中的應用程式 ID Ad Manager 加入應用程式的 AndroidManifest.xml 檔案中。如要這樣做,請新增含有 android:name="com.google.android.gms.ads.APPLICATION_ID"<meta-data> 標記。您可以在網頁介面中找到應用程式 ID。 Ad Manager 針對 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>
    

    在實際應用程式中,請將範例應用程式 ID 換成實際的Ad Manager 應用程式 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() ,即可初始化 SDK,並在初始化完成後或 30 秒逾時後回呼完成事件監聽器。此操作只需執行一次,最好能在應用程式啟動時執行。

在呼叫 MobileAds.initialize() 時,廣告可能會由 Google Mobile Ads SDK 或中介服務合作夥伴 SDK 預先載入。如果您需要取得歐洲經濟區 (EEA) 使用者的同意聲明,請設定任何要求專屬標記 (例如 tagForChildDirectedTreatmenttag_for_under_age_of_consent),或是在載入廣告前採取必要行動,請務必在初始化 Google Mobile Ads SDK 之前完成此操作。

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

MainActivity 範例 (摘錄)

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,您現在可以開始導入廣告。Ad Manager 提供多種廣告格式,您可以挑選最適合應用程式使用者體驗的格式。

顯示在裝置螢幕頂端或底部的矩形廣告。 使用者與應用程式互動時,橫幅廣告會停留在畫面上,且會在一段時間後自動重新整理。如果您是第一次使用行動廣告 不妨從這裡著手

導入橫幅廣告

插頁式

全螢幕廣告,會蓋住應用程式介面,直到使用者關閉為止。 最適合用於應用程式執行流程中的自然暫停點,例如遊戲關卡之間或剛完成任務後。

導入插頁式廣告

原生

可自訂的廣告能融入應用程式的外觀和風格。廣告出現的方式和位置由您決定,可讓版面配置與應用程式設計更加一致。

Google Ad Manager 提供兩種導入原生廣告的方式:原生樣式和標準原生廣告透過自訂顯示。

原生樣式的設計可簡化原生廣告的導入程序,如果您是這種格式新手,不妨使用這個選項。自訂顯示功能的設計宗旨,就是讓您盡可能自由製作簡報。

導入原生樣式 導入原生廣告 (自訂顯示)

已獲得獎勵

獎勵使用者觀看短片或與可試玩廣告和問卷調查互動的廣告。用於透過免費應用程式營利。

導入獎勵廣告

其他資源

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