
前提条件
- アプリにOneSignal SDKがインストールされ、初期化されている。
- 最新のエディター機能に推奨されるSDKを使用している:
- iOS 5.1.5+
- Android 5.1.9+
- OneSignalに画像をアップロードしない場合、画像は高速で一般公開されたURL(CDN推奨)にホストされ、モバイル画面に適切なサイズに調整されている必要があります。
プリビルトテンプレートから始める
プリビルトテンプレートは、コンバージョン向けに設計されたレイアウト(権限プロンプトを含む)で素早くローンチするのに役立ちます。テンプレートを選択し、コピー、色、アクションをブランドに合わせて更新してください。**デバイステスト:**プリビルトデザインはPixel 6+、iPhone(iOS 14+)、Huawei Nova 9、Huawei P50 Foldable、iPad(第10世代+)でテスト済みです。これらのテンプレートはポートレート向けに最適化されており、ランドスケープモードでは意図した通りに表示されない場合があります。
メッセージレイアウトを選択する
メッセージレイアウトは、アプリ内メッセージが画面にどのように表示されるかを制御します。| メッセージタイプ | 最適な用途 | 動作 |
|---|---|---|
| Top(上部) | スリムなお知らせと確認 | 上部からスライドダウン |
| Center(中央) | ほとんどのマーケティングおよびプロダクトプロンプト | 中央から展開し、画面を部分的に埋める |
| Bottom(下部) | スナックバー、同意プロンプト | 下部からスライドアップ |
| Full(フル) | オンボーディングフロー、マルチステップオファー、カルーセル | 画面を埋めるように展開(オプションのマージン付き) |

カルーセルでマルチスクリーンフローを構築する
カルーセルを使用すると、オンボーディング、機能ツアー、マルチステップオファーなどのマルチスクリーンアプリ内体験を作成できます。- Fullメッセージタイプを選択します。
- Create Carouselをクリックします。
- 最大10枚のカード(画面)を追加します。
- 任意のブロックの組み合わせで各カードをカスタマイズします。

向きのサポート
アプリ内メッセージはポートレートとランドスケープの両方をサポートしていますが、レイアウト(特にテンプレート)は両方で美しく表示するために調整が必要な場合があります。
ランドスケープの使用が多い場合(タブレット、ゲーム、動画アプリ)、公開前にランドスケープでメッセージをテストしてください。ワイドレイアウトでは、より小さいテキストサイズ、タイトなスペーシング、またはより少ないスタックブロックが必要になることがよくあります。
ブロックとスペーシングで整ったレイアウトを作成する
すべてがBackgroundブロック(キャンバス)上に配置されます。以下を使用してください:- BackgroundのPaddingでコンテンツとメッセージの端の間のスペースを制御。
- 個々のブロックのMarginで要素間のスペースを制御(見出し → 画像 → ボタン)。
- Paddingを使用してメッセージの端からの距離を制御します。
- Marginを使用してブロックを垂直に分離します。
- 同じ側に大きなパディングとマージンを積み重ねないでください。
- タイト/エッジ揃えのデザインよりも中央揃えのフローベースのレイアウトを優先します。
- 公開前に常に複数のデバイスサイズでプレビューを使用してください。

ブロックリファレンス
これらのブロックを使用してメッセージを構築します。各ブロックはスタイリングと(ほとんどの場合)オプションのクリックアクションをサポートしています。テキストブロック
見出し、説明、免責事項、またはパーソナライズされたコピーに使用します。 カスタマイズ可能な項目- レスポンシブサイジング:パーセンテージでの幅/高さ。
- フォント:Google Fonts。
- 書式設定:太字、斜体、下線。
- 色:HexまたはRGBA(透明度をサポート)。
- 配置:左、中央、右。
- サイズ:調整可能なフォントサイズ。
- マージン:ブロックの周囲のスペース。
- 言語ベースのセグメントまたはLiquid構文の使用でローカライズします。
- データタグでパーソナライズします。

画像ブロック
画像を使用してオファーを強調したり、機能を紹介したり、ブランディングを追加したりします。 サポートされるフォーマットと制限.jpg、.png、.gif- 最大ファイルサイズ:5MB
16:9、4:3、3:2などの一般的なアスペクト比を使用してください。- サーバーホストされたパスを使用して、リンクと画像URLを動的に入れ替えることができます。ダイナミックURLを参照してください。
- 例:
https://example.com/images/{{ tag_key }}.png
- 例:
- 画像URL:パフォーマンスのためにホストされたURLを推奨。
- クリックアクション:オプション(リンク、ディープリンク、タグ、アウトカム、プロンプト)。
- クリック時に閉じる
- マージン:ブロックの周囲のスペース。

ボタンブロック
ナビゲーション、フィードバック収集、権限プロンプトなどの主要アクションにボタンを使用します。 カスタマイズ可能な項目- ボタンテキストとフォントスタイリング
- 背景色、サイズ、角の半径
- オプションのアイコン/画像
- クリックアクション(タグ付け、アウトカム、プロンプト、ディープリンク)
- クリック時に閉じる
- マージン
- 境界線と影
- タグを使用してボタンテキストまたはリンク先をパーソナライズします。
- 背景の不透明度を0に設定して、画像のみのボタンを作成できます。
- 微妙な影(低い不透明度、高いぼかし)を使用して、プライマリCTAを目立たせます。

閉じるボタンブロック
閉じるボタンは、ユーザーが「X」アイコンを使用してメッセージを閉じることができるかどうかを制御します。 カスタマイズ可能な項目- 表示の有効化/無効化
- カスタムアイコン(
.jpg、.png、.svg、.gif) - 推奨サイズ:
10x10px - オプションのクリックアクション
- マージン

背景ブロック
背景は、レイアウトを保持するキャンバスです。 カスタマイズ可能な項目- 背景色(RGBAをサポート)
- 背景画像(
.jpg、.png、.gif) - オプションのクリックアクション
- パディング(デフォルト
24px) - クリック時に閉じる

パーソナライゼーションとローカライゼーション
データタグを使用して、テキスト、ボタンラベル、URLを含むアプリ内メッセージをパーソナライズできます。 ローカライゼーションについては、多言語メッセージを参照してください。パーソナライゼーションの良いテストは、既知のタグ値を持つ小さな内部セグメントにメッセージを送信し、以下を確認することです:
- テキストと画像が期待される置換で表示される
- リンクが正しく解決される
- ボタンが期待されるクリックアウトカム/タグを発火する
FAQ
上部/下部バナーのアプリ内メッセージからグレーのオーバーレイやドロップシャドウを削除できますか?
はい — SDKを更新し、以下の設定を追加してください。 iOS 5.1.5+iOS Info.plist
Android Manifest.xml
次のステップ
- アプリ内クリックアクションについて学び、ユーザーがメッセージ内の要素をクリックした際の動作をカスタマイズしましょう。
- さまざまなアプリ内メッセージトリガーを試して、メッセージの表示タイミングを制御しましょう。
- さらにカスタマイズが必要ですか?HTMLでアプリ内メッセージをデザインするを試してみてください。