概要
ポップアップ広告は、特定の瞬間に画面に表示される広告フォーマットです。アプリ起動時、コンテンツ読み込み完了時、特定のイベント発生時など、任意のタイミングで表示でき、ユーザーが閉じるボタンを押すか「今日は表示しない」を選択して終了できます。特徴
- 画面中央または下部に表示されるポップアップ形式
- 画像および動画広告に対応
- 閉じる、Dim(背景)クリック、「今日は表示しない」オプションを提供
- 背景色、テキストカラーなどのカスタマイズ可能
- ユーザーの邪魔にならず効果的な広告体験
開発環境ではテストユニットIDを使用してください。テストユニットIDセクションを参照してください。
実装手順
ポップアップ広告は次の4ステップで実装します:- 初期化 - AdropPopupAdインスタンスの生成
- デリゲートの設定 - 広告および閉じるイベント受信のためのデリゲート設定
- 広告の読み込み - 広告リクエストと受信
- 広告の表示 - 画面への広告表示
UIKit実装
基本実装
デリゲートの実装
SwiftUI実装
SwiftUIでは、UIViewControllerRepresentableを使用するか、UIWindowからrootViewControllerを取得して表示できます。
ViewModelパターン
カスタマイズ
ポップアップ広告の外観をカスタマイズできます。背景色とテキストカラーの設定
カスタマイズオプション
| プロパティ | 型 | 説明 | デフォルト |
|---|---|---|---|
backgroundColor | UIColor? | アクションバーの背景色 | nil |
hideForTodayTextColor | UIColor? | 「今日は表示しない」テキストカラー | 白 |
closeTextColor | UIColor? | 閉じるボタンテキストカラー | 白 |
ctaTextColor | UIColor? | CTA(Call to Action)ボタンテキストカラー | 白 |
デリゲートメソッド
AdropPopupAdDelegate(広告イベント)
必須メソッド
広告受信成功時に呼び出されます。この時点で
show()を呼び出して広告を表示できます。広告受信失敗時に呼び出されます。エラーコードで失敗原因を確認できます。
オプションメソッド
広告インプレッションが記録されたときに呼び出されます。
ユーザーが広告をクリックしたときに呼び出されます。
ポップアップ広告が表示される直前に呼び出されます。
ポップアップ広告が画面に表示された直後に呼び出されます。
ポップアップ広告が閉じられる直前に呼び出されます。
ポップアップ広告が閉じられた直後に呼び出されます。次の広告を事前読み込みするのに適したタイミングです。
広告表示失敗時に呼び出されます。エラーコードで失敗原因を確認できます。
動画広告の再生が開始されたときに呼び出されます。
動画広告の再生が完了したときに呼び出されます。
AdropPopupAdCloseDelegate(閉じるイベント)
すべてのメソッドはオプションです。ユーザーが閉じるボタンをクリックしたときに呼び出されます。
ユーザーがポップアップ外部(Dim領域)をクリックしたときに呼び出されます。
ユーザーが「今日は表示しない」を選択したときに呼び出されます。このコールバックで日付を保存して、1日中広告を表示しないように実装できます。
カスタムクリック処理
useCustomClickを使用して広告クリック動作を制御できます。有効にすると、SDKはクリック時に自動的にURLを開かず、手動で処理できます。
useCustomClick
useCustomClickがtrueの場合、SDKは広告クリック時に自動的にURLを開きません。onAdClickedデリゲートコールバックは引き続き呼び出され、open()メソッドを使用するか、独自にナビゲーションを処理できます。
open()
広告の遷移先URLを開きます。カスタムURLを指定することもできます。close()
プログラムでポップアップ広告を閉じます。プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
unitId | String | 広告ユニットID |
isLoaded | Bool | 広告が読み込まれたかどうか |
useCustomClick | Bool | 広告クリックを手動で処理するかどうか |
destinationURL | String? | 現在表示中の広告の遷移先URL |
creativeId | String? | 現在表示中の広告のクリエイティブID |
txId | String | 現在表示中の広告のトランザクションID |
txIds | [String] | 読み込まれたすべての広告のトランザクションID |
campaignId | String | 現在表示中の広告のキャンペーンID |
campaignIds | [String] | 読み込まれたすべての広告のキャンペーンID |
creativeIds | [String] | 読み込まれたすべての広告のクリエイティブID |
browserTarget | BrowserTarget? | 広告クリック時のURL開き方 |
クロージャベースのコールバック
デリゲートに加えて、クロージャベースのコールバックも使用できます。完全なデリゲートパターンを実装したくない場合に便利です。デリゲートコールバックとクロージャベースのコールバックは同時に使用できます。両方とも呼び出されます。
「今日は表示しない」実装
ユーザーが「今日は表示しない」を選択したときに適切に処理する方法です。SDKは「今日は表示しない」状態を自動的に管理します。以下の例は、組み込みの処理に加えてカスタム動作を追加する方法を示しています。
実装
SDKは「今日は表示しない」を選択した場合、load()時に自動的にロードをスキップします。手動チェックなしでload()を呼び出すだけで済みます。
ベストプラクティス
1. 適切な表示タイミング
ポップアップ広告は次のタイミングで表示するのが効果的です:2. 「今日は表示しない」の尊重
ユーザーが「今日は表示しない」を選択した場合は、必ず遵守してください。3. 頻度制限
ポップアップ広告を頻繁に表示しすぎないようにしてください。テストユニットID
開発およびテスト時には次のテストユニットIDを使用してください。| 広告タイプ | テストユニットID |
|---|---|
| ポップアップ (下部画像) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM |
| ポップアップ (中央画像) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER |
| ポップアップビデオ (下部16:9) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_16_9 |
| ポップアップビデオ (下部9:16) | PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_9_16 |
| ポップアップビデオ (中央16:9) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_16_9 |
| ポップアップビデオ (中央9:16) | PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_9_16 |
関連ドキュメント
はじめに
SDKのインストールと初期化
インタースティシャル広告
インタースティシャル広告の実装
リワード広告
リワード広告の実装
バナー広告
バナー広告の実装