Google Mobile Ads SDK で、MRAID v2 の既存のサポートを基盤として構築された MRAID v3 のベータ版サポートが開始されました。これにより、広告主様はアド マネージャーのパブリッシャーに MRAID v3 クリエイティブを配信できるようになります。このガイドでは、MRAID v3 仕様で不明確で解釈の余地があった MRAID の実装の詳細を明確にします。対象読者は MRAID v3 クリエイティブの作成者です。
前提条件
パブリッシャーは次の条件を満たしている必要があります。
役立つ入門ガイド
MRAID について詳しくは、IAB MRAID のページをご覧ください。また、MRAID v3 の定義ドキュメントをダウンロードすることもできます。このドキュメントには、以下で説明するすべてのパラメータの詳細が記載されています。また、MRAID v3 に関する IAB のブログ投稿もご覧ください。
MRAID v3（ベータ版）の実装の詳細
視認性 - exposureChange イベント
このイベントはサポートされています。非推奨の viewableChange イベントではなく、新しい exposureChange イベントのリスナーを使用することをおすすめします。メソッド mraid.isViewable() も非推奨になりました。ただし、下位互換性を維持するために、これらの非推奨メソッドは引き続きサポートされます。
exposureChange イベント定義は、広告ビューが変更されるたびにディスパッチされます。SDK には、イベントが大量に生成されるのを防ぐためのポーリング メカニズムがあります。初期状態は、広告がリスナーを登録した後に非同期で送信されます。コールバックには、0.0 から 100.0 の間の浮動小数点数である exposed_percentage パラメータが含まれます。
使用例については、MRAID v3 仕様をご覧ください。
MRAID の検出と初期化、MRAID_ENV 属性
この SDK は、MRAID v3 仕様で定義されている初期化プロトコルに準拠しています。
MRAID_ENV オブジェクトでは、SDK は IDFA、limitAdTracking、アプリ ID、COPPA（これらは省略可）を送信しません。MRAID バージョン、SDK 名、SDK バージョンなど、必要なすべての変数が MRAID_ENV オブジェクトで提供されます。
聴認性の測定
音声が聞こえるかどうか、音量が変更されたタイミングを特定するための新しいイベント（audioVolumeChange）が導入されました。
audioVolumeChange イベントには、volume_percentage という 1 つのパラメータがあります。値は最大音声再生音量の割合です。0.0～100.0 の間の浮動小数点数（再生が許可されていない場合は 0.0）、または音量を特定できない場合は null です。
使用例については、MRAID v3 仕様をご覧ください。
mraid.getLocation()
mraid.getLocation() はサポートされていないため、常に -1 を返します。
mraid.unload()
このメソッドはいつでも呼び出すことができ、SDK は広告を閉じ、リソースを割り当て解除し、ウェブビューを削除するか、別のドキュメントまたは新しい広告に置き換えることで対応します。
クリエイティブが unload() を呼び出すと、ネイティブ レイヤはクリエイティブ タイプに応じて次のように応答します。
| タイプ | unload() の動作 |
|---|---|
| バナー | 現在の広告と同じリクエスト パラメータを使用して新しい広告リクエストを行います。 |
| インタースティシャル | インタースティシャルを閉じます。 |
VPAID（Video Player Ad Interface Definition）
Google Mobile Ads SDK は VPAID をサポートしていません。mraid.supports('vpaid') は false を返します。
mraid.useCustomClose()
mraid.useCustomClose() は、フォーマットとクリエイティブのタイプによってはサポートされない場合があります。
MRAID v2 の実装の詳細
mraid.getVersion()
mraid.getVersion() は、クリエイティブが読み込まれるまで 2.0 を返しません。mraid.getState() が loading を返す間は、MRAID バージョンをチェックしないでください。
mraid.resize()
mraid.resize() が呼び出されると、元のバナーがバナーのスクリーンショット画像に置き換えられます。サイズ変更された広告が元の広告スペースをカバーしていない場合、このことが顕著になります。
サイズ変更された広告も、元のバナーのフレームには従いません。バナーがスクロール ビューに配置されている場合、サイズ変更された広告はバナーとともにスクロールしません。
mraid.setResizeProperties()
mraid.setResizeProperties() のすべての呼び出しには、必須プロパティの完全なリストが含まれている必要があります。サイズ変更プロパティが無効な場合、デフォルトに戻され、mraid.setResizeProperties() が有効なパラメータで再度呼び出されるまで、後続の mraid.resize() の呼び出しはすべて失敗します。
mraid.getMaxSize()
mraid.getMaxSize() は、サイズ変更された広告の最大サイズを決定する場合にのみ使用してください。エキスパンド広告のサイズを決定するには、mraid.getScreenSize() を使用します。
mraid.setOrientationProperties()
allowOrientationChange プロパティが true に設定された状態で mraid.setOrientationProperties() を呼び出すと、forceOrientation プロパティを設定しても何も行われません。向きを強制的に設定したいクリエイティブは、allowOrientationChange を false に設定する必要があります。
mraid.isViewable()
ビューが本来表示されるはずの広告を覆っている場合でも、mraid.isViewable() は true を返します。アプリのコンテンツで表示されている広告を覆わないようにしてください。
mraid.getCurrentPosition()
2 つの部分からなるエキスパンド広告が展開状態にある場合、最初の部分で mraid.getCurrentPosition() を呼び出すと、画面のサイズが返されます。
mraid.storePicture()
アプリが mraid.storePicture() をサポートするには、android.permission.WRITE_EXTERNAL_STORAGE 権限を含める必要があります。