Tải quảng cáo gốc

Chọn nền tảng: Android (beta) Mới chọn Android iOS Flutter Unity

Quảng cáo gốc là tài sản quảng cáo hiển thị cho người dùng thông qua các thành phần giao diện người dùng vốn có của nền tảng. Bạn có thể hiển thị những quảng cáo này bằng cách sử dụng các loại chế độ xem tương tự mà bạn đã tạo bố cục. Đồng thời, bạn có thể định dạng các quảng cáo này cho phù hợp với kiểu thiết kế trực quan của ứng dụng.

Khi một quảng cáo gốc tải, ứng dụng của bạn sẽ nhận được một đối tượng quảng cáo chứa các tài sản của quảng cáo đó, và khi đó ứng dụng (thay vì GMA Next-Gen SDK) sẽ chịu trách nhiệm hiển thị các tài sản đó.

Nói chung, có hai phần để triển khai thành công quảng cáo gốc: Tải quảng cáo bằng SDK rồi hiển thị nội dung quảng cáo trong ứng dụng của bạn.

Trang này trình bày cách sử dụng SDK để tải quảng cáo gốc.

Điều kiện tiên quyết

Luôn thử nghiệm bằng quảng cáo thử nghiệm

Khi bạn tạo và thử nghiệm ứng dụng, hãy nhớ sử dụng quảng cáo thử nghiệm thay vì quảng cáo đang chạy trong thực tế. Chúng tôi có thể tạm ngưng tài khoản của bạn nếu bạn không làm như vậy.

Cách dễ nhất để tải quảng cáo thử nghiệm là sử dụng mã đơn vị quảng cáo thử nghiệm dành riêng cho quảng cáo gốc:

Định dạng quảng cáo Mã đơn vị quảng cáo mẫu
Mã gốc /21775744923/example/native
Quảng cáo video gốc /21775744923/example/native-video

Tải quảng cáo

Để tải quảng cáo gốc, hãy gọi NativeAdLoader.load() phương thức. Phương thức này sẽ lấy một NativeAdRequest và một NativeAdLoaderCallback.

import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAd
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoader
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoaderCallback
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdRequest

class NativeFragment : Fragment() {

  private var nativeAd: NativeAd? = null

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    loadAd()
  }

  private fun loadAd() {
    // Build an ad request with native ad options to customize the ad.
    val adRequest = NativeAdRequest
      .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
      .build()

    val adCallback =
      object : NativeAdLoaderCallback {
        override fun onNativeAdLoaded(nativeAd: NativeAd) {
          // Called when a native ad has loaded.
        }
        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Called when a native ad has failed to load.
        }
      }

    // Load the native ad with our request and callback.
    NativeAdLoader.load(adRequest, adCallback)
  }

  companion object {
    // Sample native ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/native"
  }
}

Đặt lệnh gọi lại sự kiện quảng cáo gốc

Khi xử lý onNativeAdLoaded, hãy đặt NativeAd đã nhận được bằng NativeAdEventCallback để xác định các hàm nhận sự kiện vòng đời quảng cáo gốc:

  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Native ad showed full screen content.
      }
      override fun onAdDismissedFullScreenContent() {
        // Native ad dismissed full screen content.
      }
      override fun onAdFailedToShowFullScreenContent {
        // Native ad failed to show full screen content.
      }
      override fun onAdImpression() {
        // Native ad recorded an impression.
      }
      override fun onAdClicked() {
        // Native ad recorded a click.
      }
    }

Không bắt buộc: Tải nhiều quảng cáo

Để tải nhiều quảng cáo, hãy gọi load() bằng tham số numberOfAds không bắt buộc. Giá trị tối đa mà bạn có thể đặt là 5, đại diện cho số lượng quảng cáo. GMA Next-Gen SDK có thể không trả về chính xác số lượng quảng cáo mà bạn yêu cầu.

private fun loadAd() {
  // Build an ad request with native ad options to customize the ad.
  val adRequest = NativeAdRequest
    .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
    .build()

  val adCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Called when a native ad has loaded.
      }
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Called when a native ad has failed to load.
      }
      override fun onAdLoadingCompleted() {
        // Called when all native ads have loaded.
      }
    }

  // Load the native ad with our request and callback.
  NativeAdLoader.load(adRequest, 3, adCallback)
}

Quảng cáo mà GMA Next-Gen SDK trả về là duy nhất, mặc dù quảng cáo từ khoảng không quảng cáo dành riêng hoặc bên mua thuộc bên thứ ba có thể không phải là duy nhất.

Nếu bạn đang sử dụng tính năng dàn xếp, đừng gọi phương thức load(). Yêu cầu cho nhiều quảng cáo gốc không hoạt động đối với các mã đơn vị quảng cáo được định cấu hình cho tính năng dàn xếp.

Các phương pháp hay nhất

Khi tải quảng cáo, hãy tuân theo các quy tắc sau.

  • Các ứng dụng sử dụng quảng cáo gốc trong danh sách nên lưu trước vào bộ nhớ đệm danh sách quảng cáo.

  • Khi lưu trước vào bộ nhớ đệm quảng cáo, hãy xoá bộ nhớ đệm và tải lại sau một giờ.

  • Chỉ lưu vào bộ nhớ đệm quảng cáo gốc những quảng cáo cần thiết. Ví dụ: khi lưu trước vào bộ nhớ đệm, chỉ lưu vào bộ nhớ đệm những quảng cáo hiển thị ngay trên màn hình. Quảng cáo gốc có mức sử dụng bộ nhớ lớn và việc lưu vào bộ nhớ đệm quảng cáo gốc mà không hủy bỏ quảng cáo sẽ dẫn đến tình trạng sử dụng quá nhiều bộ nhớ.

  • Huỷ quảng cáo gốc khi không còn sử dụng.

Tăng tốc phần cứng cho quảng cáo dạng video

Để quảng cáo dạng video hiển thị thành công ở chế độ xem quảng cáo gốc, bạn phải bật tính năng tăng tốc phần cứng.

Tính năng tăng tốc phần cứng được bật theo mặc định, nhưng một số ứng dụng cũng có thể chọn tắt tính năng này. Nếu sử dụng tính năng tăng tốc phần cứng cho ứng dụng của mình, bạn nên bật tính năng này cho các lớp Hoạt động có sử dụng quảng cáo.

Bật tính năng tăng tốc phần cứng

Nếu ứng dụng của bạn hoạt động không đúng cách trên toàn cầu khi tính năng tăng tốc phần cứng đang bật, thì bạn vẫn có thể kiểm soát tính năng này cho các hoạt động riêng lẻ. Để bật hoặc tắt tính năng tăng tốc phần cứng, hãy sử dụng thuộc tính android:hardwareAccelerated cho các phần tử <application> và <activity> trong AndroidManifest.xml. Ví dụ sau đây sẽ bật tính năng tăng tốc phần cứng cho toàn bộ ứng dụng, nhưng sẽ tắt tính năng này cho một hoạt động:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

HardwareAccelerationSnippet.xml

Xem hướng dẫn tăng tốc phần cứng để biết thêm thông tin về các cách kiểm soát tính năng tăng tốc phần cứng. Xin lưu ý rằng hệ thống không thể bật chế độ xem quảng cáo riêng lẻ để tăng tốc phần cứng nếu Hoạt động đang tắt, do đó, Hoạt động phải tự bật tính năng tăng tốc phần cứng.

Hiển thị quảng cáo

Sau khi bạn đã tải quảng cáo, tất cả công việc còn lại là hiển thị quảng cáo cho người dùng. Hãy xem Hướng dẫn về Quảng cáo gốc nâng cao của chúng tôi để biết cách thực hiện.

Ví dụ:

Tải xuống và chạy ứng dụng mẫu minh hoạ cách sử dụng GMA Next-Gen SDK.