Bắt đầu sử dụng AdMob trong dự án C++

Cân nhắc sử dụng SDK iOS và Android của AdMob.


Hướng dẫn bắt đầu nhanh này dành cho những nhà xuất bản và nhà phát triển muốn sử dụng AdMob để kiếm tiền từ một ứng dụng được xây dựng bằng Firebase. Nếu bạn không có ý định đưa Firebase vào ứng dụng của mình, hãy xem hướng dẫn độc lậpAdMob thay thế.

Nếu chưa, hãy tìm hiểu về tất cả các lợi ích của việc sử dụng AdMob, Firebase, và Google Analytics cùng nhau.

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

Trước khi bắt đầu

  • Nếu bạn chưa có dự án Firebase và ứng dụng Firebase, hãy làm theo hướng dẫn bắt đầu sử dụng Firebase: Thêm Firebase vào dự án C++.

  • Đảm bảo bạn đã bật Google Analytics trong dự án Firebase:

    • Nếu bạn đang tạo dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.

    • Nếu có một dự án Firebase hiện có chưa bật Google Analytics, bạn có thể bật Google Analytics từ thẻ Tích hợp trong phần > Cài đặt dự án.

Bước 1: Thiết lập ứng dụng trong tài khoản AdMob

  1. Đăng ký từng biến thể nền tảng của ứng dụng dưới dạng ứng dụng AdMob.

    1. Đăng nhập hoặc đăng ký AdMob tài khoản.

    2. Đăng ký từng biến thể nền tảng của ứng dụng với AdMob. Bước này tạo ra một ứng dụng AdMob có Mã AdMob ứng dụng riêng biệt mà bạn sẽ cần dùng trong hướng dẫn này.

    Bạn sẽ được yêu cầu thêm SDK Mobile Ads vào ứng dụng của mình. Hãy tìm hướng dẫn chi tiết về nhiệm vụ này ở phần sau của hướng dẫn này.

  2. Liên kết từng ứng dụng AdMob với ứng dụng Firebase tương ứng.

    Bạn rất nên làm việc này dù đây là việc không bắt buộc. Tìm hiểu thêm về lợi ích của việc bật chỉ số người dùng và liên kết ứng dụng AdMob với Firebase.

    Đối với từng biến thể nền tảng, hãy hoàn tất 2 bước sau trong trang tổng quan Ứng dụng của tài khoản AdMob:

    1. Bật Chỉ số người dùng để cho phép AdMob xử lý và hiển thị dữ liệu phân tích được tuyển chọn trong tài khoản AdMob. Đây cũng là chế độ cài đặt bắt buộc để bạn liên kết ứng dụng AdMob với Firebase.

    2. Liên kết ứng dụng AdMob với dự án Firebase hiện có và ứng dụng Firebase tương ứng.

      Đảm bảo bạn nhập cùng tên gói (Android) hoặc mã gói (iOS) như đã nhập cho ứng dụng Firebase. Tìm tên gói hoặc mã gói của ứng dụng Firebase trong thẻ Ứng dụng của bạn trong phần cài đặt > Cài đặt dự án.

Bước 2: Thêm Mã ứng dụng AdMob vào ứng dụng

Android

Thêm Mã ứng dụng AdMob vào tệp AndroidManifest.xml của ứng dụng bằng cách thêm thẻ <meta-data> như minh hoạ bên dưới.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

iOS

Trong tệp Info.plist của ứng dụng, hãy thêm khoá GADApplicationIdentifier có giá trị chuỗi là AdMob Mã ứng dụng.

Bạn có thể thực hiện thay đổi này theo phương thức lập trình:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Bạn cũng có thể chỉnh sửa thẻ này trong trình chỉnh sửa danh sách tài sản như sau:

Trình chỉnh sửa danh sách tài sản

Bước 3: Thêm SDK Quảng cáo của Google trên thiết bị di động

Vì SDK C++ Quảng cáo của Google trên thiết bị di động nằm trong không gian tên firebase::gma, hãy tải SDK Firebase C++ xuống, sau đó giải nén vào một thư mục mà 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.

Android

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

    systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK

  2. 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"

  3. 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 đây, bao gồm cả phần phụ thuộc thư viện cho SDK C++ Quảng cáo của Google trên thiết bị di động.

    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
}

  4. Vào tệp CMakeLists.txt của dự án, hãy thêm nội dung sau.

    # 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}")

  5. Đồ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.

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 của Google trên thiết bị di động.

iOS

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

  1. Tải CocoaPods phiên bản 1 trở lên bằng cách chạy:

    sudo gem install cocoapods --pre

  2. Thêm Google Mobile Ads pod từ SDK đã giải nén.

    1. Tạo Podfile nếu bạn chưa có:

      cd YOUR_APP_DIRECTORY
pod init

    2. Vào Podfile, hãy thêm pod cho SDK C++ Quảng cáo của Google trên thiết bị di động:

      pod 'Google-Mobile-Ads-SDK'

    3. Cài đặt pod, sau đó mở tệp .xcworkspace trong Xcode.

      pod install
open YOUR_APP.xcworkspace

    4. Thêm các khung sau đây từ SDK Firebase C++ 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 SDK C++ Quảng cáo của Google trên thiết bị di động.

Bước 4: 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 khởi chạy SDK Mobile Ads bằng cách gọi firebase::gma::Initialize().

Lệnh gọi này trả về một firebase::Future hoàn tất sau khi quá trình khởi chạy kết thúc (hoặc sau khi hết thời gian chờ 30 giây). Chỉ gọi phương thức này một lần và càng sớm càng tốt, tốt nhất là khi bắt đầu chạy ứng dụng.

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 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 chạy đã hoàn tất. Sau khi hoàn tất, ứng dụng của bạn có thể gọi result() để nhận kết quả AdapterInitializationStatus.

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à ứ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ể sử 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ý 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 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.
  }
}

Bước 5: Chọn định dạng quảng cáo để triển khai trong ứng dụng

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. Nhấp vào một nút cho định dạng quảng cáo để xem hướng dẫn triển khai chi tiết trong tài liệu AdMob.

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ó tặng 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

Quảng cáo có tặng thưởng (hoặc "dựa trên phần thưởng") có thể giúp kiếm tiền từ những người dùng chơi miễn phí.

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

Các chủ đề quan tâm khác

Xem chỉ số người dùng và dữ liệu phân tích

Sau khi khởi chạy, Mobile Ads SDK sẽ tự động bắt đầu ghi nhật ký các sự kiện phân tích và thuộc tính người dùng từ ứng dụng của bạn. Bạn có thể xem dữ liệu này mà không cần thêm bất kỳ mã nào vào ứng dụng hoặc triển khai bất kỳ quảng cáo nào. Đây là nơi bạn có thể xem dữ liệu phân tích này:

Xin lưu ý rằng để thể hiện rõ hơn các chỉ số ARPU và ARPPU, bạn có thể muốn đưa dữ liệu từ một sự kiện tuỳ chỉnh phân tích có tên là ecommerce_purchase vào tính toán doanh thu cho các chỉ số này (tìm hiểu cách thực hiện).

(Không bắt buộc) Sử dụng thêm các tính năng của Google Analytics và Firebase

Tận dụng nhiều cơ hội và tính năng hơn để cải thiện khả năng kiếm tiền từ ứng dụng và mức độ tương tác của người dùng: