Bắt đầu

Hướng dẫn này dành cho những nhà xuất bản muốn kiếm tiền từ ứng dụng C++ bằng AdMob, mà không sử dụng Firebase. Nếu bạn dự định đưa Firebase vào ứng dụng của mình hoặc nếu bạn đang cân nhắc việc đó, hãy xem phiên bản hướng dẫn dành cho AdMob với Firebase.

Bước đầu tiên để tích hợp SDK C++ của Quảng cáo trên thiết bị di động của Google 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 xen kẽ hoặc quảng cáo có tặng thưởng, rồi làm theo các bước để triển khai định dạng đó.

SDK C++ của Google Mobile Ads bao gồm SDK iOS và Android của Google Mobile Ads, đồng thời chỉ có trên các nền tảng đó. SDK C++ của quảng cáo trên thiết bị di động của Google tạo sử dụng các cấu trúc C++ của Firebase để hỗ trợ các hoạt động không đồng bộ, vì vậy, cấu trúc này nằm trong không gian tên firebase::gma.

Nếu đây là lần đầu tiên bạn đọc hướng dẫn này, bạn nên tải xuống và làm theo bằng ứng dụng kiểm thử C++ của Google Mobile Ads.

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

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

Đă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. Bước này sẽ tạo một AdMob ứng dụng có mã ứng dụng AdMob duy nhất mà bạn cần có trong phần sau của hướng dẫn này.

Cài đặt SDK C++ cho Google Mobile Ads

Vì SDK C++ của quảng cáo trên thiết bị di động của Google nằm trong không gian tên firebase::gma, nên tải Firebase C++ SDK xuống, rồi giải nén tệp vào một thư mục bạn chọn.

SDK Firebase C++ không dành riêng cho nền tảng, nhưng yêu cầu cấu hình thư viện dành riêng cho nền tảng.

Bạn đã hoàn tất! Ứng dụng C++ của bạn được định cấu hình để sử dụng SDK Google Mobile Ads C++ mà không cần bất kỳ dịch vụ Firebase nào khác.

Định cấu hình mã ứng dụng AdMob của ứng dụng

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 để ứng dụng của bạn khởi chạy SDK C++ cho Google Mobile Ads bằng cách gọi firebase::gma::Initialize(). Lệnh gọi này sẽ khởi chạy SDK và hoàn tất firebase::Future sau khi quá trình khởi chạy 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.

Khi gọi Initialize(), SDK quảng cáo trên thiết bị di động của Google cho C++ hoặc SDK của đối tác dàn xếp có thể tải trước quảng cáo. Nếu bạn cần có sự đồng ý từ người dùng ở Khu vực kinh tế Châu Âu (EEA), hãy đặt tất cả các cờ riêng cho từng yêu cầu (chẳng hạn như tag_for_child_directed_treatment hoặc tag_for_under_age_of_consent), hoặc thực hiện hành động trước khi tải quảng cáo, đồng thời hãy nhớ làm việc này bằng cách gọi firebase::gma::SetRequestConfiguration() trước khi khởi chạy SDK Quảng cáo của Google trên thiết bị di động. Để biết thêm thông tin, hãy xem Hướng dẫn về Nhắm mục tiêu.

Dưới đây là ví dụ về cách gọi Initialize():

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

Sử dụng Future để theo dõi trạng thái hoàn thành của lệnh gọi phương thức

Future cung cấp cho bạn một cách để xác định trạng thái hoàn tất của các lệnh gọi phương thức không đồng bộ.

Ví dụ: khi ứng dụng của bạn gọi firebase::gma::Initialize(), một firebase::Future được tạo và trả về. Sau đó, ứng dụng của bạn có thể thăm dò ý kiến status() của Future để xác định thời điểm quá trình khởi chạy hoàn tất. Sau khi hoàn tất, ứng dụng của bạn có thể gọi result() để lấy AdapterInitializationStatus thu được.

Các phương thức trả về Future có một phương thức "kết quả cuối cùng" tương ứng mà ứng dụng có thể sử dụng để truy xuất Future gần đây nhất cho một hành động nhất định. Ví dụ: firebase::gma::Initialize() có một phương thức tương ứng có tên là firebase::gma::InitializeLastResult(). Phương thức này trả về một Future mà ứng dụng của bạn có thể dùng để kiểm tra trạng thái của lệnh gọi gần đây nhất đến firebase::gma::Initialize().

Nếu trạng thái của Future là hoàn tất và mã lỗi là firebase::gma::kAdErrorCodeNone, thì thao tác đã hoàn tất thành công.

Bạn cũng có thể đăng ký lệnh gọi lại để được gọi khi Future hoàn tất. Trong một số trường hợp, lệnh gọi lại sẽ chạy trong một luồng khác, vì vậy, hãy đảm bảo mã của bạn an toàn cho luồng. Đoạn mã này sử dụng con trỏ hàm cho lệnh gọi lại:

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

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

Giờ thì bạn đã nhập xong SDK C++ của quảng cáo trên thiết bị di động của Google và sẵn sàng triển khai một 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 của mình.

Biểu ngữ

Quảng cáo hình chữ nhật xuất hiện ở đầu hoặc cuối màn hình thiết bị. Quảng cáo biểu ngữ vẫn hiển thị 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 mới sử dụng thiết bị di động quảng cáo.

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

Quảng cáo xen kẽ

Quảng cáo toàn màn hình che phủ giao diện của một ứng dụng cho đến khi người dùng đóng lại. Bạn nên sử dụng quảng cáo xen kẽ tại các điểm dừng tự nhiên trong luồng thực thi của ứng dụng, chẳng hạn như giữa các cấp độ của trò chơi hoặc ngay sau khi hoàn thành một nhiệm vụ.

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

Được thưởng

Quảng cáo tặng thưởng cho người dùng khi họ xem video ngắn và tương tác với nội dung có thể chơi quảng cáo và khảo sát. Dùng để kiếm tiền từ các ứng dụng chơi miễn phí.

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