# アプリメッセージ

アプリメッセージは、ネイティブアプリ内に表示される単位です。これらの単位は、次のような多くの用途に適しています:

* 特別オファー
* お知らせ
* 通知の事前許可プロンプト

## アプリメッセージを使うタイミング

アプリ内でユーザーがアクティブなときにコミュニケーションしたい場合は、アプリメッセージを使用します。例えば:

* プロモーションや期間限定オファー
* 製品のお知らせや機能の案内
* 状況に応じたリマインダーや促し
* 教育やオンボーディングの場面

## フォーマット

アプリメッセージの単位は非常に柔軟にカスタマイズでき、メッセージの目的に応じていくつかの異なる形式で表示できます。&#x20;

### バナー

バナー単位は小さめの単位で、デバイス画面の上部または下部に表示でき、本文テキストと左寄せまたは右寄せの画像を含みます。

<div align="left"><figure><img src="/files/b80411fdcd7d11f128998869f0b00c06aa3ed773" alt=""><figcaption></figcaption></figure></div>

### モーダル

モーダル単位はデバイス中央に表示され、大きな画像、ヘッダー、タイトル、本文テキストを含みます。この単位には最大2つのボタンを追加できます。

<div align="left"><figure><img src="/files/a70ec8719fadd54c2a78a91efd962a92a65347f3" alt=""><figcaption></figcaption></figure></div>

### フルスクリーン

フルスクリーン単位はデバイスの画面全体を覆い、大きな画像、ヘッダー、タイトル、本文テキストを含みます。この単位には最大2つのボタンを追加できます。

<div align="left"><figure><img src="/files/c44e5da98bf9ecd3c6af7e8527d4b9c07a6a1f5f" alt=""><figcaption></figcaption></figure></div>

## メッセージを作成する

作成中は、レイアウト、コンテンツ、アクションの3つに注目してください。

#### 1) レイアウトと見た目

選択した形式に応じて、次のような共通の視覚要素を設定できます:

* 背景色
* 画像のオン/オフ
* 画像のフィット設定（例: Cover vs Contain）
* 画像の位置（例: サポートされている場合は上部 vs 下部）

ガイド:

* 使用する **Contain** 画像全体を常に表示する必要がある場合。
* 使用する **Cover** 端のトリミングが許容でき、より没入感のある見た目にしたい場合。

#### 2) コンテンツ

ほとんどの形式は次の組み合わせをサポートしています:

* ヘッダー（任意）
* タイトル（推奨）
* 本文（推奨）

ガイド:

* 小さなスマートフォンで不自然に折り返されないよう、タイトルは短くしてください。
* バナーでは長い本文テキストは避けてください。
* メッセージが説明的な内容である場合は、見やすさのためにタイトルと本文で内容を分けてください。

#### 3) ボタンとCTA

モーダルとフルスクリーンのメッセージは最大 **2つのボタン**.

推奨事項:

* 可能であれば、主要なCTAは1つにしてください。
* CTAテキストは簡潔にしてください（2〜4語が適切な目安です）。
* 2つ目のボタンを含める場合は、明確な代替案にしてください（例: 「今はしない」や「詳細を見る」）。

<figure><img src="/files/75d38338da00532a8f037078a1221081642f4f91" alt=""><figcaption></figcaption></figure>

### プレビュー

プレビューはビルダー全体に統合されているため、公開前にメッセージの見た目を確認できます。これを使って、さまざまな画面サイズやUIモードでの余白、テキストの長さ、画像の挙動、ボタンの表示を確認してください。

#### インラインプレビューパネル

ビルダーには、コンテンツや見た目を編集するたびに更新されるプレビューパネルが含まれています。レイアウトやコピーを素早く調整するために使用してください。

#### アプリメッセージのプレビューウィンドウ

より詳細に確認するには、 **アプリメッセージのプレビュー** ウィンドウを開いてください。このウィンドウでは、次のような複数のデバイス環境で同じメッセージをプレビューできます:

* **デバイスの種類:** スマートフォンまたはタブレット
* **プラットフォーム:** Apple / iOS または Android
* **向き:** 縦向きまたは横向き
* **テーマ:** ライトまたはダーク

<figure><img src="/files/f65556657c96041e7b25fb55599fc0d7e48d4f28" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.pushly.com/pushly-ja/platform/apurimessji.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
