AdLoader API

v2.9.20241105以降のFiveSDKはAdLoader APIと呼ばれるAPIをサポートしています。 このAPIはSDKの初期化と広告ロードの方法を置きかえるAPIで、v3.0.0以降ではAdLoader APIを推奨しています。 従来のSDK初期化と広告ロードのAPIは非推奨です。

AdLoader APIを利用するには、まずFADAdLoaderのインスタンスを取得する必要があります。 このページではFADAdLoaderのインスタンスの取得方法を解説します。

FADConfigオブジェクト

FADAdLoaderのインスタンスを取得するには、まずアプリ全体の設定を管理するFADConfigオブジェクトを作る必要があります。

以下のようなコードでFADConfigオブジェクトを生成します。 your-app-idは登録したアプリIDで置きかえてください。

FiveSDK v3.1.0未満のテストモード設定

FiveSDK v3.1.0未満でテスト広告を配信する場合は、FADConfigのisTestフラグを有効にします。 FiveSDK v3.1.0以降では、広告フォーマットごとの実装方法で説明するFADAdSlotConfigのテストモードを利用してください。

FADAdLoaderの取得

設定したFADConfigを利用してFADAdLoaderのインスタンスを取得します。

FADAdLoaderのインスタンスはSDK内部でキャッシュされており、同一の設定に対しては同じインスタンスを返します。 ただし、スレッドセーフを保証するためのコストがかかるため、基本的には一度取得したFADAdLoaderのインスタンスはそのまま保持しておくことをお勧めします。

TIP

v2.9.20250507以降のFiveSDKでは複数の異なる設定のFADAdLoaderのインスタンスを取得できる設計になっています。 ただし、現在は同一アプリに複数のアプリIDを発行しない構成になっているため、これはテスト用途以外では活用できません。 この設計は今後のアップデートを意識したものです。

FADAdLoaderのインスタンスを取得したら、広告をロードして表示することが可能となります。 以降のページでは広告フォーマットごとの実装方法について解説します。