Bắt đầu

Bước đầu tiên để tích hợp SDK Quảng cáo của Google trên thiết bị di động là vào một ứng dụng hiển thị quảng cáo và tạo ra doanh thu. 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 video có tặng thưởng) và làm theo các bước để hãy triển khai nó.

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 của 21 hoặc cao hơn
    • Biên dịch phiên bản SDK của 33 hoặc cao hơn

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

  1. Trong tệp cài đặt Gradle của bạn, hãy đưa vào 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 bản dựng cấp ứng dụng tệp:

    Kotlin

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

    Groovy

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.3.0'
    }
  3. Thêm mã ứng dụng Ad Manager của bạn, như được xác định trong Ad Manager giao diện web cho ứng dụng của bạn AndroidManifest.xml. Để 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 của bạn trong Ad Manager giao diện web. Để android:value, hãy chèn mã ứng dụng Ad Manager của riêng bạn, trong dấu ngoặc kép.

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

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

    Ngoài ra, xin lưu ý rằng nếu không thêm được thẻ <meta-data> chính xác như kết quả hiển thị gặp 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 trước hoạt động với Android 13.

    Nếu ứng dụng của bạn sử dụng SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.4.0 hoặc nên 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 ứng dụng sử dụng SDK Quảng cáo của Google trên thiết bị di động phiên bản 20.3.0 hoặc 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 cho 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ề chính sách Khai báo quyền com.google.android.gms.permission.AD_ID, kể cả cách tắt tính năng đó, hãy tham khảo Play này Bài viết trên bảng điều khiển.

Chạy SDK Quảng cáo của Google trên thiết bị di động

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 một trình nghe hoàn thành sau khi cả Quá trình khởi chạy SDK quảng cáo trên thiết bị di động của Google và bộ chuyển đổi đã hoàn tất hoặc sau khi 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 bắt đầu 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 có được sự đồng ý của người dùng ở Châu Âu Khu vực kinh tế (EEA), đặt mọi cờ dành riêng cho từng yêu cầu, chẳng hạn như setTagForChildDirectedTreatment() hoặc setTagForUnderAgeOfConsent(), hoặc nếu không, hãy thực hiện hành động trước khi tải quảng cáo, hãy nhớ thực hiện trước khi khởi chạy SDK quảng cáo trên thiết bị di động của Google.

Dưới đây là ví dụ về cách gọi phương thức initialize() khi ở chế độ nền chuỗi 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

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

Đơn vị quảng cáo biểu ngữ hiển thị quảng cáo hình chữ nhật chiếm một phần của bạn. Những 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 xem một quảng cáo mới đều đặn, ngay cả khi họ không thay đổi trong ứng dụng của bạn. Đây cũng là định dạng quảng cáo triển khai đơn giản 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. Đặt chúng ở vị trí tự nhiên điểm ngắt và chuyển tiếp trong giao diện của ứng dụng, chẳng hạn như sau khi hoàn thành 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 thức 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 của bạn. Bằng cách tự tạo kiểu cho quảng cáo, bạn có thể tạo bản trình bày quảng cáo tự nhiên, không phô trương có thể thêm vào người dùng phong phú của bạn.

Google Ad Manager cung cấp hai cách để triển khai quảng cáo gốc: kiểu gốc và quảng cáo gốc chuẩn thông qua hiển thị tuỳ chỉnh.

Kiểu gốc đã được thiết kế để đơn giản hoá việc triển khai quảng cáo gốc, và đó là lựa chọn tuyệt vời nếu bạn mới sử dụng định dạng này. Tính năng hiển thị tuỳ chỉnh nhằm tối đa hoá sự thoải mái khi bạn tạo bản trình bày.

Triển khai kiểu gốc Triển khai quảng cáo gốc (hiển thị tuỳ chỉnh)

Đượ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, thực hiện các cuộc khảo sát hoặc xem video để nhận phần thưởng trong ứng dụng, chẳng hạn như 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, đồng thời chỉ định giá trị phần thưởng và các mục 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ó trả 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 trong quá trình chuyển đổi ứng dụng tự nhiên.

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 có tặng thưởng quảng cáo xen kẽ.

Thay vì đưa ra lời 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 có màn hình giới thiệu công bố phần thưởng và cho phép người dùng chọn không tham gia họ muốn làm như vậy.

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

Quảng cáo khi mở ứng dụng

Quảng cáo khi mở ứng dụng là định dạng quảng cáo xuất hiện khi người dùng mở hoặc quay lại . Quảng cáo phủ lên màn hình 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 các định dạng quảng cáo khác nhau mà API này cung cấp.