概要
ネイティブ広告はアプリのデザインに合わせて広告UIを自由にカスタマイズできる広告フォーマットです。広告素材(画像、動画)、タイトル、説明、CTAボタンなどの要素を個別に配置して自然なユーザー体験を提供できます。主な機能
- 完全なUIカスタマイズ:アプリのデザインシステムに合わせて広告レイアウトを自由に構成
- 多様なメディア対応:画像および動画広告素材対応
- 柔軟なクリック処理:全体クリックまたはカスタムクリック処理が可能
- プロフィール情報表示:広告主プロフィールロゴおよび名前対応
- バックフィル広告対応:バックフィル広告かどうか確認可能
AdropNativeAdクラス
ネイティブ広告をロードして管理するメインクラスです。コンストラクタ
string
必須
広告ユニットID(コンソールで発行)
boolean
デフォルト:"false"
カスタムクリック処理使用有無
true:開発者が直接クリック処理を実装(ビデオ広告コントローラー使用可能)false:AdropNativeAdViewがすべてのクリックイベントを自動処理
AdropAdChoicesPosition
デフォルト:"AdropAdChoicesPosition.topRight"
バックフィルネイティブ広告のAdChoicesマーク表示位置
メソッド
プロパティ
AdropNativeAdViewコンポーネント
ネイティブ広告を表示するコンテナコンポーネントです。Props
AdropNativeAd
表示するネイティブ広告インスタンス
使用例
AdropNativeAdViewは広告コンテキストを提供するため、すべての広告要素ビューはこのコンポーネント内部に配置する必要があります。ネイティブ広告要素ビュー
AdropProfileLogoView
広告主プロフィールロゴを表示する画像コンポーネントです。Omit<ImageProps, 'source'>(React NativeのImageコンポーネントプロパティ、sourceは自動設定されます)
AdropProfileNameView
広告主プロフィール名を表示するテキストコンポーネントです。TextProps(React NativeのTextコンポーネントプロパティ)
AdropHeadLineView
広告タイトルを表示するテキストコンポーネントです。TextProps(React NativeのTextコンポーネントプロパティ)
AdropBodyView
広告本文を表示するテキストコンポーネントです。TextProps(React NativeのTextコンポーネントプロパティ)
AdropMediaView
広告画像または動画を表示するメディアコンポーネントです。ViewProps(React NativeのViewコンポーネントプロパティ)
AdropCallToActionView
行動誘導フレーズ(CTA)を表示するテキストコンポーネントです。TextProps(React NativeのTextコンポーネントプロパティ)
AdropAdvertiserView
広告主名を表示するテキストコンポーネントです。TextProps(React NativeのTextコンポーネントプロパティ)
AdropIconView
広告アイコンを表示する画像コンポーネントです。Omit<ImageProps, 'source'>(React NativeのImageコンポーネントプロパティ、sourceは自動設定されます)
AdropNativeAdListenerインターフェース
広告イベントを処理するリスナーインターフェースです。AdropNativePropertiesタイプ
広告プロパティ情報を含むタイプです。AdropNativeProfileタイプ
広告主プロフィール情報を含むタイプです。実装例
以下はネイティブ広告を実装する完全な例です。テストユニットID
開発およびテスト時には以下のテストユニットIDを使用してください。エラー処理
広告ロード失敗時にonAdFailedToReceiveコールバックでエラーコードを受け取ることができます。
主なエラーコード
エラー処理の例
ベストプラクティス
1. リソース解放
コンポーネントアンマウント時に必ず広告リソースを解放してください。2. ビデオ広告およびバックフィル広告処理
ビデオ広告かどうか、およびバックフィル広告かどうかに応じて適切なレンダリング方式を選択してください。3. URL処理
WebViewでURLクリック時に外部ブラウザで開くように処理してください。4. 広告要素の選択的使用
アプリのデザインに合わせて必要な広告要素のみ選択的に使用してください。動画トラッキングとVTR
Adropはネイティブ広告の動画指標 — VTR(動画完了率)、onAdVideoStart、onAdVideoEnd — を、SDKメディアコンテナ内で動画がレンダリングされる場合にのみ収集します。React Nativeでは実装例セクションのように、properties.creative(HTMLペイロード)をWebViewでレンダリングする方式がこれに該当します。これは広告のメインメディア(メディア 1)に当てはまります。複数メディアのクリエイティブのそれ以外のメディアについては、複数メディアのクリエイティブを参照してください。
properties.assetフィールドは元の画像または動画ファイルのURLを返します。これはサムネイル表示や媒体社独自分析などの補助メタデータとして公開されており、再生を直接行うためのものではありません。
推奨パターン
動画クリエイティブはAdropNativeAdView内部に配置したWebViewでHTMLクリエイティブをレンダリングしてください。
AdropNativeAdのisVideoAdとisBackfilledフラグを使用すると、asset URLを直接検査することなく、<AdropMediaView />(画像またはバックフィルクリエイティブ)と<WebView />(ダイレクト動画クリエイティブ)を分岐できます。
特定の面がどうしても独自プレイヤーを使う必要があり、VTRが計測されないことを許容する場合、広告を
AdropNativeAdViewにバインドしたままにすることで、クリックとインプレッションのアトリビューションは引き続き確保できます。ただしその面を社内レポートで非VTRインベントリとして分類し、SDKが計測した動画パフォーマンスと混在させないでください。複数メディアのクリエイティブ
adrop-ads-react-native 1.16.0以降が必要です。バックフィルを使う場合は、バックフィルモジュールも1.16.0に更新してください。properties.extraAssetsには、広告のすべてのメディアがコンソールで設定したメディアIDをキーとして格納されています。メディア 1は常にm1で、それ以外のメディアには広告ユニット詳細画面のメディアサイズに表示されるID(例:m2、m3)が使われます。
- メディア 1(
m1)はproperties.asset、properties.creativeと同じメディアです。これまでどおり表示し、それ以外のメディアだけを自分で描画してください。 - メディアが1つのユニットのクリエイティブとバックフィル広告では、
extraAssetsは空です。これらの広告は通常どおり表示してください。 - メディアは順序に頼らず、IDで取得してください。
- 広告がダークモードで配信される場合、画像メディアもダークモード用の画像になります。
- 複数メディアのクリエイティブでレイアウトを確認するには、テストデバイスでクリエイティブをプレビューしてください。
AdropNativeAssetタイプ
メディアの表示
- 画像:
useCustomClickの設定にかかわらず、AdropNativeAdView内のタップは広告クリックになるため、その中に置いた画像のタップも、広告のほかの部分と同じように集計されます。画像のcreativeHTMLはクリックをAdropに報告しないため、読み込まないでください。 - 動画:
assetURLではなくcreativeHTMLを再生してください。HTMLに動画プレイヤーとトラッキングが含まれているため、動画指標はこのHTMLでのみ計測されます。WebViewはAdropNativeAdViewの外に配置してください。中に置くと、プレイヤーのコントロールのタップを含め、動画のタップが広告クリックとしても集計されることがあります。HTMLは事前に読み込まず、広告が画面に表示される直前に読み込んでください。 - ランディングページ: ユーザーが動画をタップすると、HTMLがクリックを報告し、ランディングページを新しいウィンドウまたは同じウィンドウで開くよう要求します。要求されたURLを
onOpenWindowとonShouldStartLoadWithRequestで開いてください。
インプレッションとクリック
インプレッション、クリック、動画指標は、SDKとメディアの両方が報告しても、メディア単位ではなく広告ごとに1回だけ集計されます。動画のどのタップがクリックとして集計されるかは、ユニットの動画コントローラー設定によって異なります。コントローラーがオフの場合は動画のすべてのタップがクリックになり、オンの場合は再生・ミュートのコントロールのタップはクリックになりません。
例
メディア 2(m2)が画像の場合はAdropNativeAdViewの中に、動画の場合はそのすぐ下に表示する例です。m2はユニットのメディアIDに置き換えてください。
AdChoicesの位置調整
バックフィルネイティブ広告で、AdChoicesマークを表示するコーナーを指定できます。AdropNativeAdコンストラクタの3番目の引数としてpreferredAdChoicesPositionを渡してください。
この設定はバックフィルネットワークに渡される希望位置のヒントで、バックフィルネイティブ広告にのみ適用されます — ダイレクト広告には影響しません。バックフィルネットワークがポリシー上別の位置に表示する場合があります。
次のステップ
バナー広告
バナー広告を実装する
インタースティシャル広告
インタースティシャル広告を実装する
ポップアップ広告
ポップアップ広告を実装する
リワード広告
リワード広告を実装する