使ってみる

<ph type="x-smartling-placeholder">


このガイドは、AdMob を使用して C++ アプリを収益化したいと考えている 説明しますアプリに Firebase を組み込みたい場合や、 詳しくは このバージョンの Firebase バージョン ガイドをご覧ください。

Google Mobile Ads C++ SDK のアプリへの統合は、 広告を表示して収益を得ることができます。SDK を統合すると、次のことが可能になります。 インタースティシャルやリワードなどの広告フォーマットを選択し、手順に沿って 実装します。

Google Mobile Ads C++ SDK は、iOS と Android の Google Mobile Ads SDK をラップしています。 これらのプラットフォームでのみ利用可能ですGoogle Mobile Ads C++ SDK を使用すると 非同期オペレーションをサポートするために Firebase C++ コンストラクトを使用するため、 firebase::gma Namespace。

このガイドを初めてお読みになる場合は、 Google Mobile Ads C++ テストをダウンロードし、そのまま使用できます アプリ

前提条件

Android

  • Android Studio 3.2 以降を使用している
  • アプリのビルドファイルで次の値が使用されていることを確認します。 <ph type="x-smartling-placeholder">
      </ph>
    • 16 以上の minSdkVersion
    • 28 以上の compileSdkVersion

iOS

  • Xcode 13 以降を使用している
  • iOS 10.0 以降をターゲットとする

AdMob アカウントでアプリを設定する

アプリを AdMob アプリとして登録する手順は次のとおりです。

  1. ログインまたは登録 必要です。

  2. アプリを登録 AdMob。このステップでは、AdMob の 固有の AdMob アプリ ID を持つアプリ これについては、このガイドの後半で説明します。

Google Mobile Ads C++ SDK をインストールする

Google Mobile Ads C++ SDK は firebase::gma 名前空間にあるため、 Firebase C++ SDK をダウンロードします。 任意のディレクトリに解凍します。

Firebase C++ SDK はプラットフォーム固有ではありませんが、 プラットフォーム固有のライブラリ構成を使用します。

Android

CMake の使用をおすすめしますが、ndk-build の手順については、 一般的な Firebase C++ SDK のスタートガイド ガイド libfirebase_app.alibfirebase_gma.a をアプリにリンクします。

  1. プロジェクトの gradle.properties ファイルで、 解凍した SDK:

    systemProp.firebase_cpp_sdk.dir=FULL_PATH_TO_SDK
    
  2. プロジェクトの settings.gradle ファイルに次の内容を追加します。

    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. モジュール(アプリレベル)の Gradle ファイル(通常は app/build.gradle - 次の内容を追加します。 Google Mobile Ads C++ SDK のライブラリ依存関係です。

    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. プロジェクトの CMakeLists.txt ファイルに次の内容を追加します。

    # 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. アプリを同期して、すべての依存関係に必要なバージョンがあることを確認します。

iOS

このセクションの手順は、Google モバイル広告を C++ SDK を iOS プロジェクトに追加します。

  1. 次のコマンドを実行して、CocoaPods バージョン 1 以降を取得します。

    sudo gem install cocoapods --pre
    
  2. 解凍した SDK から Google Mobile Ads Pod を追加します。

    1. Podfile がない場合は作成します。

      cd APP_DIRECTORY
      pod init
      
    2. Podfile に、Google Mobile Ads C++ SDK の連続配信広告、 Google User Messaging Platform SDK と最小限の Firebase コア SDK (GMA C++ SDK で必須):

      pod 'Firebase/CoreOnly'
      pod 'Google-Mobile-Ads-SDK'
      pod 'GoogleUserMessagingPlatform'
      
    3. Pod をインストールし、Xcode で .xcworkspace ファイルを開きます。

      pod install
      open APP.xcworkspace
      
    4. Firebase C++ SDK の次のフレームワークをプロジェクトに追加します。

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

これで完了です。C++ アプリが Google Mobile Ads C++ SDK を使用するように設定されている 他の Firebase サービスは必要ありません。

アプリの AdMob アプリ ID を設定する

Android

Mobile Ads SDK の設定のステップ 3 を行います Android ガイド このページに戻ってください

iOS

Mobile Ads SDK に記載されているInfo.plist のステップに従います iOS ガイドを確認して戻ってきてください このページにリンクできます

Google Mobile Ads SDK を初期化する

広告を読み込む前に、次の方法で Google Mobile Ads C++ SDK をアプリで初期化します。 firebase::gma::Initialize() を呼び出して SDK を初期化し、 firebase::Future初期化の完了後(または 30 秒が経過した後) あります。この処理は 1 回だけ行います(アプリの起動時に行うのが理想的です)。

Google Mobile Ads C++ SDK またはメディエーション パートナーの SDK によって広告がプリロードされる場合があります。 Initialize() の呼び出し時。 リクエスト固有のフラグ(EEA など)を設定します。 tag_for_child_directed_treatmenttag_for_under_age_of_consent)、または 広告を読み込む前にアクションを実行する場合は、 firebase::gma::SetRequestConfiguration()後に Google モバイルを初期化する Ads C++ SDK。詳細については、 ターゲティング ガイドをご覧ください。

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

Future を使用してメソッド呼び出しの完了ステータスをモニタリングする

Future は、完了したタスクの完了ステータスを判断するための 非同期メソッド呼び出しです

たとえば、アプリが firebase::gma::Initialize() を呼び出すと、新しい firebase::Future が作成されて返されます。その後、アプリはリクエストを 初期化が完了したかどうかを判別するための Futurestatus()。 完了すると、アプリは result() を呼び出して、結果を取得できます。 AdapterInitializationStatus

Future を返すメソッドには、対応する「前回の結果」があります。メソッドを アプリは、特定のアクションに対して最新の Future を取得できます。対象 たとえば、firebase::gma::Initialize() には、対応するメソッドである firebase::gma::InitializeLastResult() は、アプリが作成した Future を返します。 最後の firebase::gma::Initialize() 呼び出しのステータスを確認できます。

Future のステータスが完了しており、エラーコードが firebase::gma::kAdErrorCodeNone、オペレーションは完了しています。 確認します。

Future が完了したときに呼び出すコールバックを登録することもできます。イン コールバックは別のスレッドで実行される場合があるため、 スレッドセーフです。このコード スニペットでは、関数ポインタを 次のコールバックを使用します。

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

広告フォーマットの選択

これで Google Mobile Ads C++ SDK がインポートされ、 表示されます。AdMob にはさまざまな広告フォーマットが用意されており、その中から適切なものを選択できます アプリのユーザー エクスペリエンスに最適なアプリを選択できます。

デバイス画面の上部または下部に表示される長方形の広告です。 ユーザーがアプリを操作している間、バナー広告は画面に表示され続けます。 一定時間経過後に自動更新されますモバイル初心者の場合 その出発点として最適です

バナー広告を実装する

インタースティシャル

ユーザーが閉じるまでアプリのインターフェース上に全画面表示される広告です。 アプリの実行フローが自然に一時停止するタイミングで使用することをおすすめします。 ゲームのレベルクリア後や、タスクが完了した直後に行います。

インタースティシャル広告を実装する

特典

短い動画の視聴や体験プレイを操作したユーザーに報酬を進呈する広告 表示されなくなります。無料アプリの収益化に使用されます。

リワード広告を実装する