Thiết lập quảng cáo gốc

Quảng cáo gốc cung cấp cho bạn các thành phần quảng cáo riêng lẻ, chẳng hạn như dòng tiêu đề, hình ảnh và văn bản nhắc, mà bạn có thể tạo kiểu và sắp xếp cho phù hợp với thiết kế hình ảnh của ứng dụng. Để xử lý việc theo dõi lượt nhấp, lượt hiển thị và phát nội dung nghe nhìn, Google Mobile Ads SDK for React Native cung cấp các thành phần sau:

Để biết thông tin chi tiết về cách hiển thị quảng cáo gốc theo đúng quy định, hãy xem bài viết Quảng cáo gốc sử dụng quảng cáo gốc nâng cao.

Trang này trình bày cách tải một và nhiều quảng cáo gốc, quản lý bộ nhớ và vòng đời của quảng cáo, cũng như bật tính năng tăng tốc phần cứng cho quảng cáo dạng video trên Android.

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

Trước khi tiếp tục, hãy làm như sau:

Android

Định dạng Mã đơn vị quảng cáo mẫu
Mã gốc ca-app-pub-3940256099942544/2247696110
Video gốc ca-app-pub-3940256099942544/1044960115

iOS

Định dạng Mã đơn vị quảng cáo mẫu
Mã gốc ca-app-pub-3940256099942544/3986624511
Video gốc ca-app-pub-3940256099942544/2521693316

Tải một quảng cáo

Để tải quảng cáo gốc, hãy gọi phương thức NativeAd.load bằng đối tượng NativeAdRequest chứa mã đơn vị quảng cáo của bạn. Phương thức này trả về một lời hứa sẽ phân giải bằng đối tượng NativeAd đã tải hoặc từ chối bằng đối tượng LoadAdError.

Ví dụ sau đây tải một quảng cáo gốc, trả về quảng cáo đã tải khi thành công và ghi lại thông báo lỗi khi không thành công:

export async function loadNativeAd(adUnitId: string): Promise<NativeAd | null> {
  try {
    const ad = await NativeAd.load({adUnitId});
    return ad;
  } catch (error) {
    const loadError = error as LoadAdError;
    console.error('Failed to load native ad:', loadError.message);
    return null;
  }
}

Khi tải và quản lý quảng cáo gốc, bạn nên làm như sau:

  • Giới hạn số lượng quảng cáo được tải: Thành phần quảng cáo gốc tiêu tốn bộ nhớ. Chỉ tải những quảng cáo mà người dùng sắp xem, chẳng hạn như một đến hai vị trí đặt quảng cáo tiếp theo, thay vì tải nhiều quảng cáo cùng một lúc.
  • Dọn dẹp quảng cáo chưa được gắn: Khi bạn xoá hoặc thay thế một quảng cáo khỏi màn hình hoặc khi thành phần chứa quảng cáo đó chưa được gắn, hãy gọi phương thức ad.destroy. Phương thức này giải phóng tài nguyên và bộ nhớ mà quảng cáo sử dụng.
  • Hiển thị quảng cáo đã tải trong vòng một giờ: Mẫu quảng cáo gốc sẽ hết hạn sau 60 phút. Nếu bạn chưa hiển thị quảng cáo đã tải trong một giờ, hãy huỷ quảng cáo đó và yêu cầu một quảng cáo khác.

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

Để tải nhiều quảng cáo trong một yêu cầu, hãy gọi phương thức NativeAd.loadAds bằng đối tượng NativeAdRequest, số lượng quảng cáo cần yêu cầu và đối tượng NativeAdLoadCallback. Yêu cầu có thể chứa tối đa 5 quảng cáo.

Ví dụ sau đây yêu cầu nhiều quảng cáo gốc và xử lý từng quảng cáo đã tải, lỗi tải và hoàn tất yêu cầu bằng cách sử dụng lệnh gọi lại:

export function loadMultipleNativeAds(adUnitId: string, numAds: number): void {
  NativeAd.loadAds({adUnitId}, numAds, {
    // Called when an individual native ad finishes loading.
    onNativeAdLoad: (ad) => {
      console.log('Loaded native ad:', ad.headline);
    },
    // Called when an individual native ad fails to load.
    onAdFailedToLoad: (error) => {
      console.error('Failed to load native ad:', error.message);
    },
    // Called when all requested ads have finished loading.
    onAdLoadingCompleted: () => {
      console.log('All requested native ads finished loading.');
    },
  });
}

Nếu bạn hiển thị quảng cáo trong một nguồn cấp dữ liệu có thể cuộn, hãy tải quảng cáo trước. Quá trình này cho phép quảng cáo hiển thị khi người dùng truy cập vào quảng cáo.

Bật chế độ tăng tốc phần cứng

Để hiển thị quảng cáo dạng video trong chế độ xem quảng cáo gốc trên Android, hãy bật tính năng tăng tốc phần cứng.

Theo mặc định, Android bật tính năng tăng tốc phần cứng. Ứng dụng có thể tắt tính năng tăng tốc phần cứng trên toàn cục. Nếu ứng dụng của bạn tắt tính năng tăng tốc phần cứng trên toàn hệ thống, hãy bật chế độ cài đặt này cho các lớp Activity hiển thị quảng cáo.

Nếu bạn bật tính năng tăng tốc phần cứng trên toàn cục và ứng dụng của bạn không hoạt động như mong đợi, hãy kiểm soát tính năng tăng tốc phần cứng cho từng hoạt động. Để 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 tệp AndroidManifest.xml.

Ví dụ sau đây bật tính năng tăng tốc phần cứng trên toàn cục cho ứng dụng và tắt chế độ cài đặt 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>

Các bước tiếp theo

Sau khi bạn tải một quảng cáo, hãy hiển thị quảng cáo đó trong giao diện người dùng React Native bằng cách sử dụng các thành phần NativeAdView và NativeAdMediaView. Để biết thông tin chi tiết, hãy xem bài viết Hiển thị quảng cáo gốc.