> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/pushly-ja/platform/apurimessji.md). # アプリメッセージアプリメッセージは、ネイティブアプリ内に表示される単位です。これらの単位は、次のような多くの用途に最適です: * 特別オファー * お知らせ * 通知の事前許可プロンプト ## アプリメッセージを使うタイミングユーザーがアプリを利用中にコミュニケーションしたいときにアプリメッセージを使用します。たとえば次のような場合です: * プロモーションや期間限定オファー * 製品発表や機能の案内 * 状況に応じたリマインダーや促し * 教育やオンボーディングの場面 ## 形式アプリメッセージの単位は高度にカスタマイズでき、メッセージの目的に応じていくつかの異なる形式で表示できます。 ### バナーバナー単位はより小さな単位で、デバイスの画面の上部または下部に表示でき、本文テキストと左または右寄せの画像を含みます。

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

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

## メッセージの作成ビルダーは番号付きの4つのステップで構成されています。順番に進めることができ、フォームの横にあるパネルは— **スケジュール準備完了** — 何がまだ不足しているかを随時知らせます。 ### ステップ1 — 基本メッセージに **名前**を付けます。これは内部用で、一覧やレポートでメッセージを識別するためのものであり、購読者には表示されません。選択します **配信チャネル** メッセージを配信できる先を— **ネイティブ Apple**, **ネイティブ Android**、または両方。ドメインでまだ統合されていないチャネルは選択できません。以前に作成したメッセージから始めるには、 **保存済みテンプレートを使用** をオンにして、次から1つ選びます **テンプレートを選択**. ### ステップ2 — メッセージ

#### スタイル選択します **モーダル** （中央配置のカード）、 **バナー** （画面上部または下部のバー）または **フルスクリーン** （画面全体）。スタイルによって利用できるコンテンツ項目が決まり、バナーにはヘッダーやタイトルがなく、ボタンは1つだけサポートされます。スタイルを切り替えても作業内容は保持されます。バナーに切り替えてから元に戻しても、書いたヘッダーとタイトルは復元されます。 #### 色の選択 **背景** でメッセージの背景色を設定し、 **ヘッダー**, **タイトル** およびボタンのブロックにはそれぞれ独自の色の行があります。どれも同じ方法で操作します。スウォッチを1つクリックする、16進値を入力する、または右端の **…** でフルピッカーを開きます。これらのグループ外の色、たとえばブランドカラーが必要な場合は、ピッカー上部のスペクトルを使うか、その行のフィールドに16進値を入力します。 #### コンテンツ各コンテンツ項目 — **画像**, **ヘッダー**, **タイトル**, **本文** — はそれぞれ独自のスイッチを持つブロックです。項目をオフにするとメッセージには含まれませんが、 **書いた内容は保持される**ので、再入力せずにオンに戻せます。ブロック名をクリックしても切り替えられます。 **画像、** **位置、** および **フィット** はサムネイルの横に表示されます。 * 使用 **収める** を使うのは、画像全体を常に表示する必要がある場合です。 * 使用 **カバー** を使うのは、端の切り取りが許容でき、より没入感のある見た目にしたい場合です。参照 [適切な画像の選び方](#choosing-an-image-that-fits) で、各形式がどの形の画像を求めるかを確認してください。 **ヘッダー** および **タイトル。** 各項目のヘッダーにはテキストカラーの行があります。 * タイトルは短くして、小さいスマートフォンで不自然に折り返されないようにしてください。 * メッセージが説明用なら、見やすさのためにタイトルと本文に内容を分けてください。 **本文。** 書式設定の操作はブロックのヘッダーにあります: 太字、斜体、取り消し線、番号付き/箇条書きリスト、インデント、配置、テキスト方向（**LTR** / **RTL**）、テキスト色、そして **絵文字** および **パーソナライズ**。各操作の名称はホバー時に表示されます。 #### 絵文字とパーソナライズ **絵文字** および **パーソナライズ** はヘッダー、タイトル、本文で利用でき、どれも同じように動作します。選択します **絵文字** を押すと、カーソル位置に絵文字を挿入します。を選択すると **パーソナライズ** マクロを挿入します。これは、メッセージ配信時に各購読者自身の値に置き換えられるプレースホルダーで、1つのメッセージで全員を自分の都市名で呼びかけられます。 {% hint style="info" %} また、任意のフィールドで `{{` と入力すると、キーボードから離れずにマクロ一覧を開けます。カーソルがすでにマクロ内にある場合、別のものを選ぶと2つ目を追加するのではなく置き換えます。 {% endhint %} 同じマクロはどこから挿入しても用意され、次のようにグループ化されています **位置情報** および **カスタム**。カスタムマクロは、あなたのドメインで定義されたものです。 #### ボタンモーダルまたはフルスクリーンのメッセージには最大 **2つのボタン**を含められます。バナーは1つです。選択します **主ボタンを追加** を追加して、メッセージの主要アクションを設定します。作成されると、操作は **副ボタンを追加**に変わります。ボタンを削除するには、その行の末尾にある **×** を使います。 **ボタンの配置** — **横並び** は2つのボタンを横に並べます。 **縦並び** はそれらを縦に積みます。選択します **編集** して、ボタンの行で次を設定します: * **ボタンテキスト** — ボタンに表示される文言。 * **アクションタイプ** — **URLを開く**, **通知許可を求める**、または **閉じる**。2つのボタンが重複する場合は、それぞれ異なるものを選ぶ必要があります。 * **URL** — アクションがURLを開く場合に表示されます。トラッキングマクロに対応しています。 * **背景** および **テキスト** — ボタン自体の色。 #### メッセージを閉じるある **モーダル** または **フルスクリーン** メッセージには常に終了手段があります。どのボタンでもメッセージを閉じない場合は、右上に閉じるコントロールが表示されます。ボタンの1つに **閉じる** アクションを設定すると、そのボタンがその役割を担うため、別のコントロールは表示されません。〜では **フルスクリーン** メッセージではさらにオンにできます **閉じるボタン** を表示し、ボタンの動作に関係なくコントロールを出せます。ある **バナー** には専用の閉じるコントロールは表示されないため、閉じられるようにするには **閉じる** アクションのボタンを1つ付けてください。推奨事項: * 可能なら主CTAは1つにしてください。 * CTAテキストは簡潔に保ちます（2〜4語が目安です）。 * 2つ目のボタンを入れる場合は、明確な別案にしてください（例: 「今はしない」「詳細を見る」）。 ### ステップ3 — 誰に表示するかオーディエンスを選択します: * **すべてのアプリユーザー** — プッシュ通知を許可しているかどうかに関係なく、アプリを利用している全員。 * **すべてのプッシュ購読者** — プッシュを購読しているアプリユーザーのみ。 * **特定のセグメント** — 保存済みセグメントの1つ以上。をオンにする **セグメントを除外** を使うと、選択したオーディエンスから選んだセグメントのメンバーを除外できます。そのオーディエンスが何人のアプリユーザーに届くかの推定値がフォームの横に表示され、変更に応じて更新されます。 ### ステップ4 — いつ、どのように動作するかこのステップは3つの設定で構成され、それぞれが1文として表示されます。各行の山形を選ぶと、その場でコントロールを開けます。行は独立して開くため、条件の組み合わせを考えながらトリガーとスケジュールを同時に開けます。

#### トリガートリガーは誰かにメッセージを表示するかどうかを決めるため、意図的に設定する価値があります。 | オプション | 意味 | | -------------- | ------------------------------------------------------------------------------------- | | **すぐに** | すぐに表示され、現在閉じている場合は次回アプリを開いたときに表示されます。 | | **セッション開始時** | 新しいセッションが始まったときに表示されます。つまり、ユーザーがしばらく離れた後にアプリを開いたとき、またはコールドスタート後です。 | | **アプリ内滞在時間の後** | ユーザーが設定した時間だけアプリ内にいたら表示されます。時間を設定して単位を選び、その後で **このセッション** のみを数えるか、ユーザーの **全期間**. | | **カスタムトリガー** | アプリが報告する条件が満たされたときに表示されます。 **キー** アプリが送信する **値** を一致させます — たとえばキー `app_opened`、値 `5`. | カスタムトリガーは、アプリがそのキーを報告した場合にのみ発火します。送信方法は、各プラットフォームのApp Messages SDKページを参照してください。 #### 画面上 | 設定 | 動作 | | ----------------------------- | ------------------------------------------------------------- | | **優先度** — 高、標準、低 | 同じ瞬間に複数のメッセージが対象になる場合、どれを最初に表示するかを決めます。高が最初に表示されます。 | | **自動閉じる** | オフでは、ユーザーが閉じるまでメッセージは画面に残ります。オンでは、表示する秒数を設定します。 | | **再表示を許可** | オフでは、各購読者にメッセージは1回だけ表示されます。オンでは、何時間、何日、または何か月後に再表示できるかを設定します。 | | **入場アニメーション** / **退場アニメーション** | メッセージが現れて消えるときの動作です。オフでは、アニメーションなしで表示・非表示になります。 | 入場と退場では、移動方向にちなんだ同じアニメーションを選べます: **フェード**, **ズームイン** および **ズームアウト** の両方で、次に **左/右/上/下からスライド** 入場時、そして **左/右/上/下へスライド** 退場時。 #### スケジュール * **戦略** — **固定** ドメインのタイムゾーンで、全員に対して同じ瞬間に開始します。 **購読者のタイムゾーン** 各購読者のローカル時刻で開始します。 * **開始日時** — メッセージが対象になる日付と時刻です。どのタイムゾーンで解釈されるかは横に表示されます。新しいメッセージはデフォルトで翌日開始になります。 * **終了日時** — オフの場合、行には *一時停止するまで実行* と表示され、メッセージは一時停止するまで対象のままです。オンにすると停止する日時を設定できます。 ## 適切な画像の選び方各形式では画像に異なる形のフレームが割り当てられ、 **収める**を選ばない限り画像はそのフレームを埋めるように切り抜かれます。入るフレームと同じ形のソース画像を選んでください: | 形式 | フレーム形状 | 推奨ソース | 形が合わない場合の処理 | | ----------- | ------------------------ | ----------- | -------------------------------- | | **モーダル** | 横長で、高さに上限あり | 1200 × 628 | 縦長の画像は約正方形に切り抜かれます。 | | **フルスクリーン** | 縦長 — 画像はコピーのない部分のスペースを使う | 1080 × 1920 | 横長の画像は左右から切り取られます。 | | **バナー** | 48 × 48 の固定正方形 | 144 × 144 | すべて1:1に切り抜かれるため、被写体は中央に配置してください。 | JPGとPNGの両方に対応しています。選択したスタイルに対するガイドは、画像コントロールの下にビルダーが表示するので、どれがどれか覚えておく必要はありません。横向き、またはタブレットでは、フレームの形がさらに変わります。公開前に **アプリメッセージのプレビュー** ウィンドウで確認してください。 ## メッセージの準備完了を知るフォーム横の **スケジュール準備完了** パネルには、メッセージに必要なものがすべて一覧表示され、各項目が満たされているか、まだ必要かが件数付きで示されます。フォーム末尾のバーも同じ内容を1行で示し、 **スケジュール** 未完了項目がなくなるまで利用できません。一覧には、名前、少なくとも1つの配信チャネル、オンにした各項目の内容、誰かに届くオーディエンス、トリガー、未来の開始日、そして各ボタンについてはテキストと、URLを開く場合はそのURLが含まれます。もし **いつ、どのように動作するか** の下の設定が不足している場合、その行が自動で開いてマークされるので、探す必要はありません。

## プレビュープレビューはビルダー全体に組み込まれており、公開前にメッセージの見え方を検証できます。間隔、テキストの長さ、画像の動作、ボタンの表示可否を、さまざまな画面サイズやUIモードで確認するのに使ってください。

### インラインプレビューパネルビルダーには、コンテンツや見た目を編集するたびに更新されるプレビューパネルがあります。レイアウトや文面を素早く調整するのに使ってください。パネル自体にも操作があります。切り替えは **Android** および **iOS**の間で、また **ライト** および **ダーク**の間で切り替えます。メッセージが配信されないプラットフォームはグレー表示になり、ホバーで説明が表示されます。プレビューするには、ステップ1の **配信チャネル** でオンにしてください。 ### アプリメッセージのプレビューウィンドウより詳細に検証するには、 **アプリメッセージのプレビュー** ウィンドウを開きます。このウィンドウでは、同じメッセージを複数のデバイスコンテキストでプレビューできます。たとえば: * **デバイス種別:** スマートフォンまたはタブレット * **プラットフォーム:** Apple / iOS または Android * **向き:** 縦向きまたは横向き * **テーマ:** ライトまたはダーク --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://documentation.pushly.com/pushly-ja/platform/apurimessji.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.