Bắt đầu

Bước đầu tiên để hiển thị quảng cáo và kiếm doanh thu là tích hợp SDK quảng cáo trên thiết bị di động của Google vào ứng dụng. Sau khi tích hợp SDK, bạn có thể chọn một định dạng quảng cáo (chẳng hạn như quảng cáo gốc hoặc quảng cáo dạng video có tặng thưởng) rồi thực hiện theo các bước để triển khai định dạng đó.

Trước khi bắt đầu

Để chuẩn bị cho ứng dụng của bạn, hãy hoàn tất các bước trong những phần sau.

Điều kiện tiên quyết đối với ứng dụng

  • Hãy đảm bảo tệp bản dựng của ứng dụng sử dụng các giá trị sau:

    • Phiên bản SDK tối thiểu là 21 trở lên
    • Biên dịch phiên bản SDK của 34 trở lên

Thiết lập ứng dụng trong tài khoản AdMob

Hãy đăng ký ứng dụng của bạn dưới dạng ứng dụng AdMob bằng cách hoàn tất các bước sau:

  1. Đăng nhập vào hoặc đăng ký tài khoản AdMob.

  2. Đăng ký ứng dụng của bạn với AdMob. để tạo ra một ứng dụng AdMob có Mã ứng dụng AdMob riêng biệt mà bạn sẽ cần dùng trong phần sau của hướng dẫn này.

Định cấu hình ứng dụng

  1. Trong tệp cài đặt Gradle, hãy thêm kho lưu trữ Maven của Googlekho lưu trữ trung tâm Maven:

    Kotlin

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include(":app")

    Groovy

    pluginManagement {
      repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
      }
    }
    
    dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
        google()
        mavenCentral()
      }
    }
    
    rootProject.name = "My Application"
    include ':app'
  2. Thêm các phần phụ thuộc cho SDK Quảng cáo của Google trên thiết bị di động vào tệp bản dựng cấp ứng dụng:

    Kotlin

    dependencies {
      implementation("com.google.android.gms:play-services-ads:23.6.0")
    }

    Groovy

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.6.0'
    }
  3. Thêm mã ứng dụng AdMob (được xác định trong giao diện web AdMob) vào tệp AndroidManifest.xml của ứng dụng. Để làm như vậy, hãy thêm thẻ <meta-data> với android:name="com.google.android.gms.ads.APPLICATION_ID". Bạn có thể tìm thấy mã ứng dụng trong giao diện web của AdMob. Đối với android:value, hãy chèn mã ứng dụng AdMob của bạn trong dấu ngoặc kép.

    <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>
    

    Trong một ứng dụng thực tế, hãy thay thế mã ứng dụng mẫu bằng mã ứng dụng AdMob thực tế. Bạn có thể sử dụng mã mẫu nếu chỉ đang thử nghiệm SDK trong ứng dụng Hello World.

    Ngoài ra, xin lưu ý rằng nếu không thêm thẻ <meta-data> chính xác như hướng dẫn ở trên, bạn sẽ gặp một sự cố với thông báo:

    Missing application ID.
    

    (Không bắt buộc) Khai báo quyền AD_ID để các phiên bản cũ hoạt động với Android 13.

    Nếu ứng dụng của bạn dùng SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.4.0 trở lên, thì bạn có thể bỏ qua bước này vì SDK sẽ tự động khai báo quyền com.google.android.gms.permission.AD_ID và có thể truy cập vào Mã nhận dạng cho quảng cáo bất cứ khi nào có sẵn.

    Đối với những ứng dụng dùng SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.3.0 trở xuống và đang nhắm đến Android 13, bạn phải thêm quyền com.google.android.gms.permission.AD_ID trong tệp AndroidManifest.xml để SDK Quảng cáo của Google trên thiết bị di động truy cập vào Mã nhận dạng cho quảng cáo:

    <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>

    Để tìm hiểu thêm về tính năng khai báo quyền com.google.android.gms.permission.AD_ID, bao gồm cả cách tắt tính năng này, hãy tham khảo bài viết này trên Play Console.

Khởi chạy SDK quảng cáo trên thiết bị di động của Google

Trước khi tải quảng cáo, hãy khởi chạy SDK Quảng cáo của Google trên thiết bị di động bằng cách gọi MobileAds.initialize().

Phương thức này khởi chạy SDK và gọi trình nghe hoàn tất sau khi cả SDK quảng cáo trên thiết bị di động của Google và quá trình khởi chạy bộ chuyển đổi đã hoàn tất hoặc sau khi hết thời gian chờ 30 giây. Bạn chỉ cần thực hiện việc này một lần, tốt nhất là khi khởi chạy ứng dụng.

SDK quảng cáo của Google trên thiết bị di động hoặc SDK của đối tác dàn xếp có thể tải trước quảng cáo khi khởi chạy. Nếu bạn cần nhận được sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA), hãy đặt tất cả các cờ theo yêu cầu cụ thể, chẳng hạn như setTagForChildDirectedTreatment() hoặc setTagForUnderAgeOfConsent(), hoặc hành động trước khi tải quảng cáo và hãy nhớ làm điều đó trước khi khởi chạy SDK quảng cáo của Google trên thiết bị di động.

Dưới đây là ví dụ về cách gọi phương thức initialize() trên luồng nền trong một Hoạt động:

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);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

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

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

Chọn định dạng quảng cáo

Lúc này, bạn đã nhập xong SDK Quảng cáo của Google trên thiết bị di động và sẵn sàng triển khai quảng cáo. AdMob cung cấp nhiều định dạng quảng cáo để bạn có thể chọn một định dạng phù hợp nhất với trải nghiệm người dùng trong ứng dụng.

Đơn vị quảng cáo biểu ngữ hiển thị những quảng cáo hình chữ nhật chiếm một phần bố cục của ứng dụng. Những đơn vị quảng cáo này có thể tự động làm mới sau một khoảng thời gian nhất định. Điều này có nghĩa là người dùng sẽ thấy một quảng cáo mới theo định kỳ, ngay cả khi họ vẫn đang xem cùng một màn hình trong ứng dụng của bạn. Đây cũng là định dạng quảng cáo dễ triển khai nhất.

Triển khai quảng cáo biểu ngữ

Quảng cáo xen kẽ

Đơn vị quảng cáo xen kẽ hiển thị quảng cáo toàn trang trong ứng dụng của bạn. Hãy đặt các quảng cáo này tại các điểm ngắt và điểm chuyển tiếp tự nhiên trong giao diện ứng dụng của bạn, chẳng hạn như sau khi người dùng hoàn thành một cấp độ trong một ứng dụng trò chơi.

Triển khai quảng cáo xen kẽ

Mã gốc

Quảng cáo gốc là quảng cáo mà bạn có thể tuỳ chỉnh cách các thành phần (như dòng tiêu đề và lời kêu gọi hành động) hiển thị trong ứng dụng. Bằng cách tự tạo kiểu cho quảng cáo, bạn có thể tạo bố cục quảng cáo tự nhiên, không phô trương và có thể làm phong phú trải nghiệm người dùng.

Triển khai quảng cáo gốc

Được thưởng

Đơn vị quảng cáo có tặng thưởng cho phép người dùng chơi trò chơi, làm bài khảo sát hoặc xem video để nhận phần thưởng trong ứng dụng, chẳng hạn như tiền xu, thêm mạng hoặc điểm. Bạn có thể đặt các phần thưởng khác nhau cho các đơn vị quảng cáo khác nhau, cũng như chỉ định giá trị phần thưởng và vật phẩm mà người dùng nhận được.

Triển khai quảng cáo có tặng thưởng

Quảng cáo xen kẽ có tặng thưởng

Quảng cáo xen kẽ có tặng thưởng là một loại định dạng quảng cáo có tặng thưởng mới, cho phép bạn tặng thưởng (chẳng hạn như tiền xu hoặc thêm mạng) cho những quảng cáo tự động xuất hiện tại các điểm chuyển đổi tự nhiên của ứng dụng.

Không giống như quảng cáo có tặng thưởng, người dùng không bắt buộc phải chọn xem quảng cáo xen kẽ có tặng thưởng.

Thay vì sử dụng thông báo nhắc chọn xem trong quảng cáo có tặng thưởng, quảng cáo xen kẽ có tặng thưởng cần phải có một màn hình giới thiệu về phần thưởng và cho phép người dùng chọn không xem nếu muốn.

Triển khai quảng cáo xen kẽ có tặng thưởng

Mở ứng dụng

Quảng cáo khi mở ứng dụng là một định dạng quảng cáo xuất hiện khi người dùng mở hoặc quay lại ứng dụng của bạn. Quảng cáo này sẽ phủ lên màn hình đang tải.

Triển khai quảng cáo khi mở ứng dụng

Tài nguyên khác

Kho lưu trữ Quảng cáo trên thiết bị di động của Google trên GitHub minh hoạ cách sử dụng nhiều định dạng quảng cáo mà API này cung cấp.