Trang này được dịch bởi Cloud Translation API.

Bắt đầu

KHÔNG DÙNG NỮA: SDK Quảng cáo trên thiết bị di động của Google cho C++ không dùng nữa kể từ ngày 17 tháng 6 năm 2024 và không nên sử dụng trong những dự án chưa dùng SDK này. SDK này sẽ bước vào giai đoạn Kết thúc bảo trì (EoM) từ ngày 17 tháng 6 năm 2025. Xin lưu ý rằng các phiên bản SDK được phát hành trước ngày EoM sẽ tiếp tục hoạt động, nhưng sẽ không có bản sửa lỗi hoặc thay đổi nào khác được phát hành sau ngày EoM.

Thay vì SDK quảng cáo trên thiết bị di động của Google cho C++, hãy cân nhắc sử dụng SDK cho iOS và SDK cho Android của AdMob. Để được hỗ trợ, hãy liên hệ với Diễn đàn kỹ thuật về SDK quảng cáo trên thiết bị di động của Google.

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++ thông qua 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 AdMob với Firebase của hướng dẫn này.

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

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

Nếu đây là lần đầu tiên xem hướng dẫn này, bạn nên tải xuống và làm theo hướng dẫn bằng cách sử dụng ứng dụng kiểm thử Quảng cáo di động của Google bằng C++.

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

Android

Sử dụng Android Studio 3.2 trở lên
Đảm bảo rằng tệp bản dựng của ứng dụng sử dụng các giá trị sau:
- minSdkVersion từ 16 trở lên
- compileSdkVersion 28 trở lên

iOS

Sử dụng Xcode 13 trở lên
Nhắm đến iOS 10.0 trở lên

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

Làm theo các bước sau để đăng ký ứng dụng của bạn dưới dạng ứng dụng AdMob:

Đăng nhập vào hoặc đăng ký tài khoản AdMob.
Đăng ký ứng dụng của bạn với AdMob. Bước này tạo một ứng dụng AdMob có mã ứng dụng AdMob riêng biệt mà bạn sẽ cần dùng trong phần sau của hướng dẫn này.

Cài đặt SDK C++ của Google Mobile Ads

Vì SDK Google Quảng cáo trên thiết bị di động bằng C++ nằm trong không gian tên firebase::gma, hãy tải SDK Firebase bằng C++ xuống, sau đó giải nén SDK này vào một thư mục mà bạn chọn.

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

Android

Bạn nên sử dụng CMake, nhưng bạn có thể tìm thấy hướng dẫn về ndk-build trong Hướng dẫn chung về cách bắt đầu sử dụng Firebase C++ SDK để liên kết libfirebase_app.a và libfirebase_gma.a với ứng dụng của mình.

Trong tệp gradle.properties của dự án, hãy chỉ định vị trí của SDK chưa giải nén:
```
systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
```

Thêm nội dung sau vào tệp settings.gradle của dự án:

def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')

gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
includeBuild "$firebase_cpp_sdk_dir"

Vào tệp Gradle của mô-đun (cấp ứng dụng) – thường là app/build.gradle – hãy thêm nội dung sau, bao gồm cả phần phụ thuộc thư viện cho SDK Quảng cáo của Google trên thiết bị di động bằng C++.

android.defaultConfig.externalNativeBuild.cmake {
  arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
}

# Add the dependency for the Google Mobile Ads C++ SDK
apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
firebaseCpp.dependencies {
  gma
}

Thêm nội dung sau vào tệp CMakeLists.txt của dự án.

# Add Firebase libraries to the target using the function from the SDK.
add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)

# Add the Google Mobile Ads C++ SDK.

# The Firebase C++ library `firebase_app` is required,
# and it must always be listed last.

set(firebase_libs
  firebase_gma
  firebase_app
)

target_link_libraries(${target_name} "${firebase_libs}")

Đồng bộ hoá ứng dụng để đảm bảo rằng tất cả phần phụ thuộc đều có các phiên bản cần thiết.

iOS

Các bước trong phần này là một ví dụ về cách thêm SDK Quảng cáo của Google trên thiết bị di động C++ vào dự án iOS.

Tải CocoaPods phiên bản 1 trở lên bằng cách chạy:
```
sudo gem install cocoapods --pre
```
Thêm pod Quảng cáo của Google trên thiết bị di động từ SDK đã giải nén.
1. Tạo Podfile nếu bạn chưa có:
```
cd APP_DIRECTORY
pod init
```
2. Vào Podfile, hãy thêm các pod cho Google Mobile Ads SDK cho C++, SDK Nền tảng thông báo cho người dùng của Google và SDK Firebase Core tối thiểu (do GMA SDK cho C++ yêu cầu):
```
pod 'Firebase/CoreOnly'
pod 'Google-Mobile-Ads-SDK'
pod 'GoogleUserMessagingPlatform'
```
3. Cài đặt các pod, sau đó mở tệp .xcworkspace trong Xcode.
```
pod install
open APP.xcworkspace
```
4. Thêm các khung sau đây từ Firebase C++ SDK vào dự án:
  - xcframeworks/firebase.xcframework
  - xcframeworks/firebase_gma.xcframework

Bạn đã hoàn tất! Ứng dụng C++ của bạn được định cấu hình để sử dụng Google Mobile Ads C++ SDK 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

Android

Làm theo bước 3 trong phần Định cấu hình ứng dụng như mô tả trong hướng dẫn về SDK quảng cáo trên thiết bị di động dành cho Android, rồi quay lại trang này.

iOS

Làm theo bước Cập nhật Info.plist như mô tả trong hướng dẫn về SDK quảng cáo trên thiết bị di động cho iOS, sau đó quay lại trang này.

Khởi 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++ Quảng cáo của Google trên thiết bị di động 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 mộ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 của Google trên thiết bị di động (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 nhận được sự đồng ý của người dùng ở Khu vực kinh tế Châu Âu (EEA), hãy đặt tất cả các cờ theo yêu cầu cụ thể (chẳng hạn như tag_for_child_directed_treatment hoặc tag_for_under_age_of_consent), hoặc hành động trước khi tải quảng cáo, đồng thời hãy nhớ làm điều đó 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 bằng C++. Để biết thêm thông tin, hãy xem hướng dẫn Nhắm mục tiêu của chúng tôi.

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

Android

// 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.
}

iOS

// 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 tất của một 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 mới sẽ được tạo và trả về. Sau đó, ứng dụng của bạn có thể thăm dò status() của Future để xác định thời điểm quá trình khởi tạo hoàn tất. Sau khi hoàn tất, ứng dụng của bạn có thể gọi result() để nhận AdapterInitializationStatus kết quả.

Các phương thức trả về Future có một phương thức "kết quả gần đây nhất" tương ứng mà các ứng dụng có thể 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 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 của trạng thái này là firebase::gma::kAdErrorCodeNone, thì tức là thao tác đã hoàn tất thành công.

Bạn cũng có thể đăng ký các lệnh gọi lại sẽ đượ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 một 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 một định dạng quảng cáo

Lúc này, bạn đã nhập xong SDK C++ Quảng cáo của Google trên thiết bị di động và sẵn sàng triển khai quảng cáo. AdMob cung cấp nhiều định dạng quảng cáo để bạn có thể chọn đị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.

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

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 những video ngắn và tương tác với cuộc khảo sát hoặc quảng cáo có thể chơi. 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

Bắt đầu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

Android

iOS

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

Cài đặt SDK C++ của Google Mobile Ads

Android

iOS

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

Android

iOS

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

Android

iOS

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

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

Biểu ngữ

Quảng cáo xen kẽ

Được thưởng

Bắt đầu

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