Quảng cáo biểu ngữ

Quảng cáo biểu ngữ chiếm một vùng trong bố cục của ứng dụng, ở trên cùng hoặc dưới cùng của màn hình thiết bị. Những quảng cáo này lưu lại trên màn hình trong khi người dùng tương tác với ứng dụng, và có thể tự động làm mới sau một khoảng thời gian nhất định. Nếu bạn mới sử dụng quảng cáo trên thiết bị di động, thì đây là loại quảng cáo rất phù hợp để bắt đầu. Nghiên cứu điển hình.

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

• Hoàn thành các bước Bắt đầu.
• (Chỉ dành cho Android) Làm quen với việc sử dụng các tham chiếu JNI jobject (xem bài viết Mẹo về JNI Android).

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 biểu ngữ. Mã này khác nhau tuỳ theo nền tảng thiết bị:

• Android: ca-app-pub-3940256099942544/6300978111
• iOS: ca-app-pub-3940256099942544/2934735716

Các mã đơn vị quảng cáo này được định cấu hình đặc biệt để trả về quảng cáo thử nghiệm cho mọi yêu cầu và bạn có thể sử dụng mã này trong ứng dụng của mình khi viết mã, chạy thử nghiệm và gỡ lỗi. Bạn chỉ cần thay thế mã này bằng mã đơn vị quảng cáo của mình trước khi xuất bản ứng dụng.

Để biết thêm thông tin về cách hoạt động của quảng cáo thử nghiệm của SDK quảng cáo trên thiết bị di động, hãy xem Quảng cáo thử nghiệm.

Triển khai

Định cấu hình AdView

Quảng cáo biểu ngữ hiển thị trong các đối tượng AdView, do đó, bước đầu tiên để tích hợp quảng cáo biểu ngữ là tạo và đặt AdView.

1. Thêm tiêu đề sau vào mã C++ của ứng dụng:

    #include "firebase/gma/ad_view.h"

2. Khai báo và khởi tạo đối tượng AdView:

     firebase::gma::AdView* ad_view;
     ad_view = new firebase::gma::AdView();

3. Tạo AdSize và khởi chạy lượt xem quảng cáo bằng cách sử dụng chế độ xem mẹ AdParent. Chế độ xem của cha mẹ là một tham chiếu JNI jobject đến một Activity Android hoặc một con trỏ đến một UIView iOS được chuyển đổi đến một loại AdParent:

    // my_ad_parent is a jobject reference
    // to an Android Activity or a pointer to an iOS UIView.
    firebase::gma::AdParent ad_parent = static_cast<firebase::gma::AdParent>(my_ad_parent);
    firebase::Future result =
      ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

4. Ngoài việc giữ lại tương lai dưới dạng một biến, bạn có thể định kỳ kiểm tra trạng thái của thao tác khởi chạy bằng cách gọi InitializeLastResult() trên đối tượng AdView. Điều này có thể hữu ích để theo dõi quá trình khởi chạy trong vòng lặp trò chơi toàn cục.

     // Monitor the status of the future in your game loop:
     firebase::Future<void> result = ad_view->InitializeLastResult();
     if (result.status() == firebase::kFutureStatusComplete) {
       // Initialization completed.
       if(future.error() == firebase::gma::kAdErrorCodeNone) {
         // Initialization successful.
       } else {
         // An error has occurred.
       }
     } else {
       // Initialization on-going.
     }
   

5. Để biết thêm thông tin về cách sử dụng firebase::Future, hãy xem bài viết Sử dụng Futures để theo dõi trạng thái hoàn tất của các lệnh gọi phương thức.

Đặt vị trí của quảng cáo

Bạn có thể đặt vị trí của AdView bất cứ lúc nào sau khi khởi chạy:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

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

Bạn có thể tải một quảng cáo sau khi AdView được khởi chạy:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

Đối tượng AdRequest đại diện cho một yêu cầu quảng cáo và chứa các thuộc tính cho thông tin như nhắm mục tiêu.

Hiển thị quảng cáo

Cuối cùng, hãy hiển thị quảng cáo trên màn hình bằng cách gọi Show(). Bạn có thể gọi phương thức này bất cứ lúc nào sau khi quảng cáo được khởi chạy:

firebase::Future<void> result = ad_view->Show();

Sự kiện quảng cáo

SDK quảng cáo trên thiết bị di động của Google C++ cung cấp một lớp AdListener mà bạn có thể mở rộng và truyền đến AdView::SetListener() để được thông báo về các thay đổi đối với trạng thái của chế độ xem quảng cáo.

Bạn có thể chọn mở rộng các phương thức trong AdListener, vì vậy, bạn chỉ cần triển khai các phương thức mà bạn muốn. Dưới đây là ví dụ về cách triển khai một lớp mở rộng tất cả các phương thức của lớp AdListener:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

  void OnAdClosed() override {
   // This method is invoked when the user closes the ad.
  }

  void OnAdImpression() override {
    // This method is invoked when an impression is recorded for an ad.
  }

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

Kích thước biểu ngữ

Dưới đây là bảng liệt kê các kích thước biểu ngữ chuẩn.

Kích thước quảng cáo tuỳ chỉnh

Để xác định kích thước của quảng cáo biểu ngữ tuỳ chỉnh, hãy đặt kích thước mà bạn muốn bằng cách sử dụng hàm khởi tạo firebase::gma::AdSize với các tham số chiều rộng và chiều cao như dưới đây:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

Tài nguyên khác

Ví dụ trên GitHub

• Xem mã nguồn của ứng dụng khởi động nhanh mẫu của chúng tôi trên GitHub.

Câu chuyện thành công

• Trường hợp sử dụng mẫu.