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 cần 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 này), 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à tạo doanh thu là tích hợp SDK C++ của quảng cáo trên thiết bị di động của Google. 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 có tặng thưởng, rồi thực hiện theo các bước để triển khai định dạng đó.
SDK C++ quảng cáo trên thiết bị di động của Google bao gồm SDK quảng cáo trên thiết bị di động của Google dành cho iOS và Android,
và chỉ có sẵn trên các nền tảng đó. SDK C++ cho quảng cáo trên thiết bị di động của Google
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, 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 bằng cách sử dụng ứng dụng thử nghiệm C++ cho Quảng cáo trên thiết bị di động của Google.
Điều kiện tiên quyết
Android
- Sử dụng phiên bản 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:
minSdkVersiontừ 16 trở lêncompileSdkVersiontừ 28 trở lên
iOS
- Sử dụng Xcode 13 trở lên
- Nhắm mục tiêu iOS 10.0 trở lên
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:
Đă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 để tạo ra một ứng dụng AdMob có Mã ứng dụng AdMob riêng biệt mà bạn cần dùng trong phần sau của hướng dẫn này.
Cài đặt SDK C++ cho quảng cáo trên thiết bị di động của Google
Vì SDK C++ cho quảng cáo trên thiết bị di động của Google nằm trong vùng chứa tên firebase::gma,
hãy tải SDK C++ Firebase xuống,
rồi giải nén vào thư mục bạn chọn.
SDK C++ của Firebase không dành riêng cho nền tảng, nhưng cần 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 hướng dẫn về ndk-build trong Hướng dẫn bắt đầu sử dụng SDK C++ của Firebase chung của chúng tôi để liên kết libfirebase_app.a và libfirebase_gma.a với ứng dụng của bạn.
Trong tệp
gradle.propertiescủa dự án, hãy chỉ định vị trí của SDK đã giải nén:systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDKVào tệp
settings.gradlecủa dự án, hãy thêm nội dung sau: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 mô-đun (cấp ứng dụng) của bạn (thường là
app/build.gradle), hãy thêm nội dung sau, bao gồm phần phụ thuộc thư viện cho SDK C++ quảng cáo trên thiết bị di động của Google.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 }Vào tệp
CMakeLists.txtcủa dự án, hãy thêm nội dung sau đây.# 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ó phiên bản cần thiết.
iOS
Các bước trong phần này là ví dụ về cách thêm SDK C++ quảng cáo trên thiết bị di động của Google vào dự án iOS của bạn.
Tải CocoaPods phiên bản 1 trở lên bằng cách chạy:
sudo gem install cocoapods --preThêm nhóm Quảng cáo trên thiết bị di động của Google từ SDK đã giải nén.
Tạo Podfile nếu bạn chưa có:
cd APP_DIRECTORYpod initĐối với Podfile của bạn, hãy thêm các nhóm cho SDK C++ của quảng cáo trên thiết bị di động của Google, SDK Nền tảng thông báo cho người dùng của Google và SDK cốt lõi tối thiểu của Firebase (theo yêu cầu của SDK GMA C++):
pod 'Firebase/CoreOnly' pod 'Google-Mobile-Ads-SDK' pod 'GoogleUserMessagingPlatform'Cài đặt các nhóm, sau đó mở tệp
.xcworkspacetrong Xcode.pod installopen APP.xcworkspaceThêm các khung sau từ SDK C++ của Firebase vào dự án:
xcframeworks/firebase.xcframeworkxcframeworks/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 SDK C++ quảng cáo trên thiết bị di động của Google 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
Hãy làm theo bước 3 của bài viết Đị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 cho Android rồi quay lại trang này.
iOS
Làm theo bước Cập nhật tệp Info.plist như mô tả trong hướng dẫn dành cho iOS về SDK quảng cáo trên thiết bị di động, rồi quay lại trang này.
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 quảng cáo trên thiết bị di động của Google bằng cách
gọi firebase::gma::Initialize() để khởi chạy SDK và hoàn tất
firebase::Future sau khi khởi chạy xong (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 bắt đầu chạy ứng dụng.
Khi gọi Initialize(), SDK C++ của quảng cáo trên thiết bị di động của Google 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 người dùng ở
Khu vực kinh tế Châu Âu (EEA) đồng ý, hãy đặt bất kỳ cờ nào dành riêng cho 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
bạn có thể thực hiện hành động trước khi tải quảng cáo, hãy nhớ gọi
firebase::gma::SetRequestConfiguration() trước khi khởi chạy SDK
C++ của quảng cáo trên thiết bị di động của Google. Để 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 thành của lệnh gọi phương thức
Future cung cấp cho bạn cách xác định trạng thái hoàn thành 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ó thể thăm dò status() của Future để xác định thời điểm hoàn tất quá trình khởi chạy.
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ó phương thức "kết quả cuối cùng" tương ứng mà ứng dụng có thể dùng để truy xuất Future gần đây nhất cho một thao tác nhất định. Ví dụ: firebase::gma::Initialize() có phương thức tương ứng tên là firebase::gma::InitializeLastResult(). Phương thức này trả về 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 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 này đã hoàn tất thành công.
Bạn cũng có thể đăng ký các 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 với 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
SDK C++ quảng cáo trên thiết bị di động của Google hiện đã được nhập và bạn có thể 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.
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 của thiết bị. Quảng cáo biểu ngữ luô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 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.
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ụ.
Đượ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 quảng cáo có thể chơi cũng như khảo sát. Dùng để kiếm tiền từ các ứng dụng chơi miễn phí.