> 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/faq/rirsunto.md).

# リリースノート

{% updates format="full" %}
{% update date="2026-09-29" tags="new-feature" %}

## ドメインレベルの通知下書きの自動アーカイブ

ドメインは「ドメイン通知設定」で自動アーカイブを有効にできるようになり、12時間から90日までの指定した日数または時間が経過すると、古い未送信の通知下書きを自動的にアーカイブへ移動します。 

デフォルトではオフで、元データを破壊せず、「下書き」ステータスの下書きのみが対象です。アクティブな通知やスケジュール済み通知に影響はありません。 

「ドメイン通知設定 > 下書き」で見つけられます。
{% endupdate %}

{% update date="2026-09-28" tags="new-feature" %}

## ジャーニーの一時停止と再開

ジャーニーは終了させずに一時停止・再開できるようになりました。一時停止中は新しい購読者は入らず、何も送信されませんが、すでにジャーニー内にいる全員はその場に保持され、再開するとそこから続行されます。 

新しいジャーニーを最初から一時停止状態で公開することもでき、すぐに本番公開せずに作成を完了したい場合に便利です。 

「一時停止と再開」はジャーニー一覧、ジャーニー詳細ページ、［設定］タブの［アクティブ/一時停止］切り替えで見つけられます。
{% endupdate %}

{% update date="2026-09-24" tags="new-feature" %}

## ASAPフィードの送信遅延

ASAPフィードでは、記事公開後に各通知を2分から最大6時間までの設定可能な遅延で保留できるようになり、通知が届く前に、購読者が開く可能性のあるあらゆる場所で記事が利用可能になる時間を確保できます。デフォルトではオフで、フィードごとに設定します。 

フィードフォームの［送信頻度］のすぐ下にある新しい［送信遅延］コントロールで見つけられます。
{% endupdate %}

{% update date="2026-09-22" tags="improvement" %}

## JSONフィード設定

JSONソースのフィードは、設定が大幅に簡単になりました。フィードタイプとしてJSONを選ぶと、正しい初期フィールド式が自動で入力されるため、標準的なJSONフィードではプレビューにすぐ記事が表示されます。 

エラーメッセージもより明確になりました。フィードのタイプがURLの実際の返却内容と一致しない場合や、必須の式が不足している場合、フィードフォームは一般的な失敗表示ではなく、何が問題かを具体的に示します。 

フィードタイプをJSONに設定すると、フィードフォームの「JSONPath式」セクションで見つけられます。
{% endupdate %}

{% update date="2026-09-21" tags="new-feature" %}

## カタログとアイテムグループのターゲティング強化

商品カタログとアイテムグループのターゲティングの両方が大幅に強化されました。 

**カタログ取り込み:** カタログはGoogle Cloud Storageから直接取り込めるようになり、商品属性、評価とレビュー、フルフィルメントオプション、プロモーション、マーケットプレイスおよびプライベートラベルのフラグ、バリアント詳細、さらに値下げターゲティング用の開始日・終了日付きセール価格など、はるかに幅広い情報を保持できます。 

**検索可能なピッカー:** アイテムグループビルダーの［カテゴリー］と［ブランド］フィールドは、入力するたびに、部分的なアルファベット順リストだけでなくカタログ全体を検索するようになりました。 

**ターゲットにできるフィールドの追加:** アイテムグループは、商品タイプ、フルフィルメントタイプ、評価、レビュー数、プロモーションフラグを含む、ほぼあらゆる商品フィールドを使って作成できるようになりました。既存のアイテムグループとカタログには影響ありません。新しいフィールドと検索は、これまでアイテムグループを作成していた場所で利用できます。
{% endupdate %}

{% update date="2026-09-21" tags="improvement" %}

## ランディングURLとトラッキングパラメータ用のデバイスマクロ 

ランディングURLとトラッキングパラメータに、購読者のデバイスに関する4つの新しい詳細情報、OS、OSバージョン、ベンダー、ネイティブアプリバージョンを含められるようになりました。 

URL、UTMパラメータ、カスタムクエリパラメータ、通知のランディングURL、アクションボタン、ジャーニーやアプリメッセージのCTAを作成するあらゆる場所に追加できるため、デバイス種別ごとに別送信しなくても、1件の通知でクリックをプラットフォーム別に識別できます。 

マクロピッカーの［デバイス］グループで、既存の［デバイスタイプ］マクロの隣にあります。
{% endupdate %}

{% update date="2026-09-17" %}

## フィード記事の並び順と重複排除レベル

フィードフォームの2つの新しい設定により、フィードが何をいつ送信するかをより細かく制御できます。 

**記事の並び順:** フィードが最新の記事を先に扱うか、最古の記事を先に扱うか、あるいはフィード自体に記載された順序を尊重するかを選択します。 

**重複排除レベル:** 送信前にフィードがどの範囲まで重複を確認するかを選択します。このフィード自身の送信だけ、ドメイン内のすべてのフィード、またはドメイン内のすべての通知（既存のデフォルト）です。 

フィードフォームの［送信頻度］と記事制約の横で見つけられます。
{% endupdate %}

{% update date="2026-09-15" tags="improvement" %}

## 通知へのフィード帰属表示

フィードによって作成された通知は、一般的な「自動化によって作成」表示ではなく、通知詳細にどのフィードが作成したかを表示するようになりました。 

1つのドメインで複数のフィードを運用していても、記事から逆算しなくても一目で見分けられるようになりました。 

通知一覧とモバイル表示にも、ソース名を示すフィードバッジが表示されます。 

フィードによって作成された通知ならどれでも表示され、設定は不要です。
{% endupdate %}

{% update date="2026-09-10" tags="new-feature" %}

## ジャーニー内のフィード

フィードは、フィード独自の固定スケジュールだけでなく、ジャーニーのステップから送信できるようになりました。［フィード通知を送信］ステップを追加し、既存のフィードを選ぶと、購読者がそこに到達するたびに、ジャーニーのエントリー、遅延、スプリットテストに基づいて、そのフィードの現在の対象記事を送信します。

これにより、フィード駆動の送信にも、ジャーニーがすでに提供しているのと同じターゲティング、つまりエントリー条件、遅延、スプリットテストが使えるようになり、1日の固定時刻だけに縛られなくなります。

ジャーニービルダーの新しいステップタイプとして見つかります。ジャーニーからのフィード通知送信はドメインごとに有効化されます。まだ表示されない場合は、Pushly担当者までお問い合わせください。
{% endupdate %}

{% update date="2026-09-10" tags="new-feature" %}

## Pushly AIキュレーター

ジャーニーが記事を自動選択できるようになりました。［おすすめ通知を送信］ステップでソースとしてPushly AIキュレーターを選ぶと、指定した期間内に公開したすべての記事を、ターゲットオーディエンスが実際に読む内容に照らしてスコアリングし、最も良い1件を送信します。\
\
**戦略とランキング:** 名前付き戦略（Personalized、Recent、Trending、Balanced）を選ぶか、読書履歴と新しさをどれだけ重視するかを2つのダイヤルで手動調整できます。

**コンテンツ期間:** 対象コンテンツの遡り範囲を、直近6時間から30日、またはカスタム範囲で設定します。

**推奨対象:** キーワード、タイトル、説明の条件で、対象コンテンツをさらに絞り込めます。

**推奨内容の要約:** すべての設定は、送信内容を正確に説明する平易な文章として読み上げられるため、保存前に確認できます。

どの［おすすめ通知を送信］ステップでも見つかります。
{% endupdate %}

{% update date="2026-09-09" tags="new-feature" %}

## 再構築されたセグメントビルダー

セグメントビルダーは、より速く、よりわかりやすいセグメント作成のために再構築されました。既存のセグメントには影響ありません。

**条件は文章として表示されます。** 折りたたまれた行には、保存された生の値ではなく、単位、名前付きジャーニー、読みやすい時間範囲を含めて、何に一致するかが平易な言葉で表示されます。

**任意の条件を複製** 類似ルールを最初から入力し直す代わりに、バリエーションをすばやく作成できます。

**ビルダーで完全に編集できないセグメントは読み取り専用で開くようになりました**そのため、まったく開けないのではなく、対象を確認できるようになりました。

次の場所で見つかります: **セグメント > セグメントを作成** （または既存のセグメントを編集）で、これまでセグメントが置かれていたのと同じ場所です。
{% endupdate %}

{% update date="2026-09-04" tags="new-feature" %}

## WordPressプラグイン 2.4.0: 除外セグメント

Pushly WordPressプラグインでは、WordPress 7.1の正式サポートに加え、投稿エディター内で通知の対象読者からセグメントを除外できるようになりました。

**独立した2つのピッカー:** 対象セグメント（通知を受け取る人）と、新しい除外セグメント（受信対象から外す人）です。どちらか一方を空欄にするか、両方を組み合わせて、たとえば有料購読者を除く全員に送信できます。

これは追加機能です。既存の通知や設定は変更されず、利用にあたって設定や移行作業も不要です。WordPress上で作成するパブリッシャーにとって、単純な包含ターゲティング以外の操作ではこれまでPushlyダッシュボードに移る必要があったギャップを解消します。
{% endupdate %}

{% update date="2026-09-01" tags="improvement" %}

## 重複送信チェック: URL一致モードとドメイン別設定

2つの通知が同じページを指しているかをPushlyがどう判断するかを選べるようになり、Pushly任せではなくドメインごとに設定できます。

**2つの一致モード:** デフォルトの完全一致URLのままにするか、トラッキングパラメータを無視する新しいモードに切り替えます。これにより、キャンペーンタグが異なる再送信でも同じページとして認識されます。\
\
このチェックは引き続き参考情報であり、送信をブロックすることはありません。ランディングURLにキャンペーンパラメータを追加するパブリッシャーにとっては、Pushlyによる追加設定なしで、実際に重複を検知する重複警告が得られるということです。
{% endupdate %}

{% update date="2026-08-31" tags="improvement" %}

## Push購読イベントのWebhook

イベントWebhookで、Push購読のライフサイクルイベントを送れるようになりました。 Push購読と削除を追跡するWebhookを購読しているドメインでは、デバイスのいずれかが到達可能になったり到達不能になったりするたびに、署名付きコールバックを受け取ります。

新しいイベントタイプはWebhookエディターで既存の通知イベントと並んで表示されます。新しい設定や別エンドポイントは不要です。既存のWebhookには変更ありません。
{% endupdate %}

{% update date="2026-08-27" tags="new-feature" %}

## スクロール深度によるプロンプトトリガー

Webのオプトインプロンプト（Slide と Native）は、訪問者が現在のページで指定したスクロール深度に達した後にのみ表示するよう設定できるようになりました。これにより、ページ読み込み直後や一定時間後ではなく、コンテンツへの関心を示した後に促す、エンゲージメントベースのトリガーが利用できます。

既存のプロンプトに変更は不要です。設定した割合はプロンプト要約に表示され、Insightsエクスポートにも含まれます。
{% endupdate %}

{% update date="2026-08-27" tags="improvement" %}
アプリメッセージエディターの再設計<br>
---------------------

アプリメッセージエディターは、［基本］［メッセージ］［表示対象］［いつ、どのように動作するか］の4つの番号付きステップとして再構築され、スケジュール可能になる前に不足している項目を正確に示す準備チェックリストがフォーム横に表示されます。

対応は不要です。保存済みメッセージは新しいエディターと完全互換で、往復保存しても値は同一です。購読者が受け取る通知内容も変わりません。
{% endupdate %}

{% update date="2026-08-26" tags="improvement" %}

## Polygonオーディエンスターゲティングの強化

Polygon地理オーディエンスの解決が大幅に高速化され、天気警報のような時間に敏感な送信でも、地図描画やアラート駆動のターゲティングが実用的になりました。
{% endupdate %}

{% update date="2026-07-08" tags="new-feature" %}

## ジャーニーでのバリアント昇格

パブリッシャーは、ジャーニー内で直接A/Bテストを実行でき、準備が整ったら勝利バリアントを今後のすべての購読者に昇格できます。

**スプリットテストの設定:** 任意のジャーニーに［スプリットテスト］ステップを追加し、各バリアントに名前を付け、トラフィック割合を割り当てます（最大4バリアント、合計は100%である必要があります）。&#x20;

**バリアントのパフォーマンス:** ジャーニーが稼働すると、各バリアントに、経路全体のエントリー数、表示回数、クリック数、CTRを示すキャンバス上のパフォーマンスカードが表示されます。&#x20;

**勝者の昇格:** スプリットテスト結果ドロワーの任意のバリアントで［昇格］をクリックします。新しい購読者は直ちに昇格したパスへ振り分けられ、すでにジャーニー内にいる人は現在のパスを中断なく完了します。負けたバリアントは本番ジャーニーから削除されますが、結果を保持したままリビジョン履歴に保存されます。昇格は元に戻せません。

**リビジョン対応のInsights:** ジャーニーのInsightsタブにはリビジョン範囲コントロールがあり、すべてのリビジョン横断または単一リビジョンに絞ってメトリクスを表示できるため、前後のデータをきれいに分離できます。

既存のジャーニーに対する対応は不要です。
{% endupdate %}

{% update date="2026-06-25" tags="new-feature" %}

## アイテムグループ（カタログ）

パブリッシャーは、カタログモジュール内で動的なアイテムグループを作成・管理できるようになりました。アイテムグループとは、フィルター条件で定義されたカタログアイテムの名前付きコレクションで、たとえば「価格が50より大きく、カテゴリーがelectronicsに等しい」のようなものです。プラットフォームが一致するアイテムをリアルタイムで評価するため、グループは常にカタログの現在の状態を反映します。

**始め方:** 次へ移動: **カタログ** 左側ナビゲーションで、次を選択: **アイテムグループ** タブを開き、「\[商品/イベント/レシピ]グループを作成」をクリックします。

**新しいクエリビルダーで条件を作成:**

* コーディング不要の視覚的な条件エディターでフィルタールールを追加
* ルールをAND/ORロジックで最大2階層まで組み合わせ
* 対応フィールドタイプには、テキスト、整数、日付、配列フィールドが含まれます
* 日付条件は平易な言葉（「過去7日間」「前」「後」）で表現でき、時間単位を設定できます
* 作成中にアイテム数のライブプレビューが更新されるため、保存前に条件を検証できます

複数カテゴリにまたがる大規模カタログを管理するパブリッシャーは、静的リストを維持したり独自クエリを書いたりせずに、再利用可能で自動更新されるアイテムコレクションを定義できるようになりました。グループは完全な後方互換性があり、既存のカタログ設定を変更する必要はありません。
{% endupdate %}

{% update date="2026-06-24" tags="improvement" %}

## ジャーニーのおすすめ通知の更新とInsights

ジャーニーのおすすめ送信では、記事ごと・日ごとに1件の通知が作成されるようになり、Notification Insights でもこれを反映して、各記事の実際に配信されたタイトル、本文、ランディングURL、画像を示す1行が表示されます。これまでは、おすすめ送信は未解決の `{{article.x}}` プレースホルダーとして1行に表示されていたため、どの記事が送信されたのか、またその成果がどうだったのかを評価できませんでした。

パブリッシャーは、ジャーニーのおすすめステップ全体で、記事ごとに分けたエンゲージメントを確認できるようになり、どのコンテンツがクリックを促しているかを実用的に把握できます。

**新しいテンプレート列:** 2つの新しい任意列 -- **タイトル（ジャーニーテンプレート）** および **本文（ジャーニーテンプレート）** -- 各行の元の未レンダリングのテンプレート内容を表示し、配信された通知を元のソーステンプレートまで追跡するのに役立ちます。次の場所でアクセスできます: **Insights > 通知 > 列**.

対応は不要です。既存のジャーニーと通知には影響ありません。
{% endupdate %}

{% update date="2026-06-22" tags="improvement" %}

## AIバリアント選択の追跡

Pushlyは、プラットフォームユーザーがAI生成コンテンツをどのように採用したかを追跡するようになりました。ユーザーがPushly AIのバリアントやPage Analyzerの提案を承認すると、どの生成がそのコンテンツを作成したか、どのバリアントが選択されたか、承認後に内容が編集されたかをシステムが記録します。

**コンテンツソースのラベル表示:** Content Sourceが表示されるあらゆる場所、つまり通知詳細、モバイル詳細、サマリーカード、Insightsレポートで、ラベルの末尾に次が付くようになりました: **（編集済み）** ユーザーがAIの提案を受け入れた後にそのコンテンツを変更した場合（例: *Pushly AI* が *Pushly AI（編集済み）*).

対応は不要です。既存の通知と通知テンプレートAPIは変更されず、帰属列は過去の行ではデフォルトで空欄です。
{% endupdate %}

{% update date="2026-06-22" tags="improvement" %}

## 通知アイコン・画像マクロとLiquidテンプレートエディター

通知のアイコンと画像を、購読者ごとのLiquidマクロで制御できるようになり、1件の通知で、プロフィール属性に基づいて購読者ごとに異なるロゴや画像を表示できます。以前はアイコンはドメインのデフォルトか1つの静的アップロードに限られていました。

**アイコンと画像の新しいソース選択:**

* **アイコン:** デフォルト（ドメインアイコン）· カスタム（アップロード）· マクロ（購読者ごとの動的）· なし
* **画像:** カスタム（アップロード）· カタログアイテムタイプ（該当する場合）· マクロ · なし

**動的なアイコンと画像:** マクロを選ぶと、Liquid式からアイコンや画像を設定できます（例: `{{ profile.custom_icon_url }}`）、埋め込みマクロを含むURL（例: `https://example.com/logos/{{ profile.market }}.png`）、または `remote_fetch` タグ。値は送信時に購読者ごとに解決されます。マクロの解決結果が空の場合、その通知では購読者にアイコンも画像も表示されません。

**Liquidテンプレートエディター:** タイトル、本文、ランディングURL、そして新しいアイコン/画像マクロフィールドには、拡大ボタンが追加され、構文ハイライト、行番号、ワンクリックのマクロ挿入パネル、複数行テンプレート向けの整形アクションを備えた全画面のLiquidエディターを開けるようになりました。単一ドメイン配下で複数のブランド、地域、または業種を管理するパブリッシャーは、通知を複製したり、オーディエンスごとに別送信を管理したりせずに、パーソナライズされた通知ブランディングを大規模に配信できるようになります。

既存の静的アイコンと画像は完全に後方互換で、変更ありません。
{% endupdate %}

{% update date="2026-06-17" tags="improvement" %}

## AIとページ分析のフィールド設定を分離

通知自動化用のドメインフィールド設定は、次の項目ごとに個別に設定できるようになりました: **コンテンツ提案** （ページ分析）および **AI推奨** （Pushly AI）。以前は1つの設定で、両方のソースによってどのフィールド（タイトル、本文、画像、キーワード）が自動入力されるかを制御しており、個別に設定することはできませんでした。

**変更点:**

* **コンテンツ提案フィールド** — ページ分析がランディングURLを分析する際に入力するフィールドを制御します
* **AI推奨フィールド** — Pushly AIが通知バリアントを生成する際に入力するフィールドを制御します
* AI推奨の結果は、許可されたフィールドにサーバー側でフィルタリングされるようになりました（以前はブラウザ側のみでした）

両方の設定は次の場所で管理します: **ドメイン設定 > 通知 > 自動化設定 > 編集**.

**後方互換:** 既存のドメインは自動的に移行され、以前のフィールド設定はコンテンツ提案フィールドに引き継がれ、AI推奨フィールドはすべてのフィールドが有効な状態をデフォルトとします。

{% endupdate %}

{% update date="2026-06-08" tags="improvement" %}

## モバイル体験の刷新

Pushlyプラットフォームのモバイル体験は完全に再設計されました。このリリースでは、従来のモバイル表示を、追加設定不要で全ユーザーが利用できる拡張版の最新実装に置き換えています。

**新機能:**

* **KPIダッシュボード:** 3つのサマリーカード（Push購読者数、クリック数、CTR）とトレンド指標、7日間スパークラインが、単一の「昨日のクリック数」指標に代わります
* **下書きタブ:** モバイルから直接、アーカイブ、編集、複製操作で保存済み下書きを管理できます
* **スワイプ操作:** 任意の通知カードを左にスワイプすると、編集、複製、キャンセル、アーカイブが表示されます。インライン展開のためにタップする必要はもうありません
* **クイックビュー:** 任意のカードをタップすると、完全な通知詳細とアクションボタンを含むボトムシートが開きます
* **通知詳細ページ:** コンテンツ、パフォーマンス統計（表示回数、クリック数、CTR）、配信メタデータを含む全画面表示。モバイル向けには完全に新規です
* **Insights:** 日付プリセット、インタラクティブチャート、上位パフォーマンス通知を備えた専用分析ビュー。モバイル向けには完全に新規です
* **改善されたドメイン切り替え:** ピン留めドメイン、最近使用したもの、組織グループ分けに対応し、デスクトップ体験と一致します

作成と編集は引き続き共有の通知ビルダーを使用し、重要でないパネルは非表示、［下書きとして保存］にも対応してモバイル向けに最適化されています。
{% endupdate %}

{% update date="2026-06-02" tags="improvement" %}

## セッションタイムアウトとリフレッシュトークンの処理

アクティブなユーザーは、予期しないセッション期限切れで作業の途中で中断されなくなります。プラットフォームは、作業中はバックグラウンドで静かにセッションを更新するようになり、クリック、フォーム入力、ナビゲーションなどの実際のユーザー操作だけがセッションを維持します。

**セッションを終了する必要がある場合は、2つのプロンプトで対応します:**

1. **非アクティブ警告（「サインインしたままにしますか？」）:** しばらく操作がなく、セッションが期限切れ直前になったときに表示されます。カウントダウンタイマーと2つの選択肢、［サインインしたままにする］（カウントダウンをリセット）または［サインアウト］が表示されます。カウントダウンが0になっても操作しない場合、自動的にサインアウトされます。
2. **最大継続時間警告（「作業を続けるには再度サインインしてください」）:** セッションの厳格な最大継続時間に近づくと表示されます。このプロンプトには延長オプションはありません。最大継続時間は固定のセキュリティ上限です。作業を保存して再度サインインし、続行してください。

**セッションタイムアウト設定（組織ごとに設定可能）:**

| 設定         | デフォルト値 | 説明                        |
| ---------- | ------ | ------------------------- |
| アイドルタイムアウト | 10時間   | この時間アイドル状態が続くとセッションが終了します |
| 絶対タイムアウト   | 10時間   | ログインからの最大セッション合計時間        |

このリリースは、2026年2月11日に導入されたSession HeartbeatとExpirationのUX改善を基盤に拡張したものです。
{% endupdate %}

{% update date="2026-05-27" tags="improvement" %}

## 通知保存: ランディングURL検証

通知ビルダーで通知を保存またはスケジュールすると、Pushlyは通知が配信キューに入る前にランディングURLのサーバー側ヘルスチェックを自動で実行するようになりました。これにより、壊れたURL、設定ミスのあるURL、形式不正なURLを購読者に届く前に検出できます。

URLが200以外のレスポンスを返した場合、配信確認モーダルに警告ステップが追加され、次を表示します:

* 返された具体的なHTTPステータスコード（例: 404 Not Found、500 Server Error）
* 直接確認できるランディングURLへのクリック可能なリンク
* URLがリダイレクトした場合の最終リダイレクト先

このチェックは **参考情報であり、送信をブロックしません** — ユーザーは警告を確認したうえで続行を選択できます。対応する警告シナリオには、200以外のHTTPレスポンス、DNS失敗、接続タイムアウト、SSLエラー、形式不正なプロトコルが含まれます。

**影響を受けないもの:** フィード送信とAPI送信はこのチェックを完全にバイパスします。

このチェックは **デフォルトでは無効** ドメインごと。次の場所で有効化できます: **ドメイン設定 > 通知 > 一般設定 > 編集 > 配信 > ランディングURL検証**.

**ドキュメント:** [ランディングURL検証](https://documentation.pushly.com/platform/notifications/landing-url-validation)
{% endupdate %}

{% update date="2026-05-21" tags="improvement" %}

## WordPressプラグイン 2.3.0

WordPressプラグイン2.3.0は、安定性、互換性、セキュリティに関するリリースです。ユーザー向けの新機能はなく、設定変更も不要です。パブリッシャーは、WordPress 7.0とプラグインバージョン2.3.0へどちらの順番でも安全にアップグレードできます。

**WordPress 7.0 互換性:** 統合テストスイート全体（66テスト、222アサーション）はWordPress 7.0で問題なく合格しました。「Tested up to」ヘッダーは7.0に更新されています。

**PHP互換性:** PHP 7.4、8.3、8.4でテスト済みで、すべて合格しています。必要な最小PHPバージョンは引き続き7.4です。

WordPress管理画面から更新できます — 手動作業は不要です。

**ドキュメント:** [WordPressプラグイン統合ガイド](https://documentation.pushly.com/integration/web-browser-push/wordpress-plugin)
{% endupdate %}

{% update date="2026-05-13" tags="new-feature" %}

## アイテムカタログブラウザ

Pushlyプラットフォームの左側ナビゲーションに新しい［カタログ］セクションが追加され、プラットフォームを離れることなく、すべてのカタログアイテムを直接検索可能なビューで確認できます。

カタログブラウザは、ページ分割された表でアイテムを表示し、列はドメインに設定されたカタログタイプに自動的に適応します:

* **レシピ:** 画像、名前、カテゴリー、料理、キーワード
* **イベント:** 画像、名前、ジャンル、出演者、場所、公開状況

**主な機能:**

* **カタログ全体の可視化:** サムネイルプレビューとカタログタイプ固有のメタデータ付きで、インデックス済みアイテムをすべて閲覧
* **サーバー側検索:** 名前、URL、その他のプロパティでアイテムを横断検索 — 正確性とパフォーマンスのためにサーバー側で処理されます
* **利用可能状況とステータス表示:** アイテムの状態を一目で分かる明確な表示
* **アイテムへの直接リンク:** アイテム名をクリックすると正規URLが新しいタブで開きます

ナビゲーション内のセクション名は、ドメインのカタログタイプ（例: 「レシピカタログ」または「イベントカタログ」）に応じて変わります。表示はすべてのユーザーに対して読み取り専用です。
{% endupdate %}

{% update date="2026-05-13" tags="new-feature" %}

## イベントWebhook

イベントWebhookは、購読者の操作が発生した瞬間に、構造化された通知エンゲージメントデータを顧客定義のエンドポイントへ送信する新しいリアルタイムデータ配信システムです。購読者が通知を見たりクリックしたりすると、Pushlyは顧客が設定したURLに暗号署名付きのPOSTリクエストを即時送信します。

**対応イベント（v1）:**

* 通知表示: 購読者のデバイスがプッシュ通知を描画したときに発生
* 通知クリック: 購読者がプッシュ通知をタップまたはクリックしたときに発生

**各ペイロードに含まれる内容:**

* 購読者識別情報: Pushly購読者IDと外部ID
* デバイスコンテキスト: プラットフォーム、OS、ブラウザ、デバイスタイプ、タイムゾーン、位置情報
* 通知詳細: タイトル、本文、キーワード、ソース、配信タイプ、関連セグメント、キャンペーン
* イベントメタデータ: 重複排除用の一意なイベントID、正確なタイムスタンプ、ドメインコンテキスト

**主な機能:**

* 正当性検証のための暗号署名付きリクエスト
* 失敗時に遅延を増やしながら自動再試行
* 高スループット処理（毎秒数千イベント）
* 認証ヘッダー用のシークレット管理

**主なユースケース:** リアルタイム分析パイプライン、CDPおよびCRM連携、マーケティング自動化トリガー、アトリビューションとコンバージョントラッキング、内部アラートと監視。

Webhookの設定場所: **ドメイン設定 > イベントWebhook**.

**ドキュメント:** [イベントWebhook](https://documentation.pushly.com/platform/event-webhooks)
{% endupdate %}

{% update date="2026-05-11" tags="improvement" %}

## 置換動作: 詳細とInsights

4月21日にリリースされた通知の置換動作機能を基に、パブリッシャーは作成時点だけでなく、任意の通知について確定済みの置換動作を確認・レポートできるようになりました。

**通知詳細での置換動作:** 配信セクションに、送信済み通知ごとに置換動作フィールド（Stack、Replace All、または Replacement Group: \[key]）が表示され、ソースを問いません。

**A/Bテスト詳細での置換動作:** 通知タブの各バリアントのプレビューカードに、それぞれの置換動作値が表示されるようになり、バリアント間の戦略比較が容易になりました。

**Insightsレポートでの置換動作:** 通知レベルのレポートで、選択可能なディメンション列およびフィルターとして利用できます。選択するとCSVおよびXLSXエクスポートに含まれます。

{% endupdate %}

{% update date="2026-04-25" tags="improvement" %}

## プラットフォームUIの刷新

プラットフォーム全体の見た目と操作感が最新化されました。既存のワークフロー、レイアウト、ナビゲーション、機能はすべてこれまでどおりです。

#### 再設計されたサイドバーとドメイン切り替え

* **検索:** 入力すると任意のドメインを即座に検索できます
* **お気に入り:** よく使うドメインにスターを付けると、常に上部に表示されます
* **最近使用したもの:** 最近アクセスしたドメインが自動で表示されます
* **キーボード操作:** 矢印キーで移動、Enterで選択、Pでお気に入りの切り替え
* 大規模なドメイン一覧でも滑らかに動作する仮想化レンダリング

#### 標準化されたフィルターバー

すべてのリストビュー — 通知、アプリメッセージ、セグメント、キャンペーン、レポート — で、日付、日付範囲、数値、単一選択/複数選択のドロップダウンフィルターに対応した、一貫性のあるインラインタグベースのフィルターバーを共有するようになりました。

#### その他の改善

* **統一されたステータスバッジ:** すべてのエンティティタイプでステータスのアイコンと色表現を統一
* **改善されたカードとパネル:** 折りたたみ可能なセクション、区切り線、より滑らかな読み込み状態、一貫した余白
* **簡潔になったテーブル:** 全体を通して一貫した最新のテーブルレイアウト。ジャーニーは新しいテーブルスタイルに移行しました
* **ジャーニーとキャンペーンのビュー:** 設定、要約、通知の間を移動しやすいタブ付きレイアウト
* **アクセシビリティ:** スクリーンリーダー対応の改善、キーボード操作の改善、42ルートにわたるWCAG 2.0 AAスキャン
* **ダークモード（社内プレビュー）:** サイドバー設定のテーマ切り替えから社内メンバーが利用できます
  {% endupdate %}

{% update date="2026-04-21" tags="new-feature" %}

## 通知の新しい置換動作

パブリッシャーは、手動通知の作成時やジャーニーステップの作成時に、通知ごとに置換動作を設定できるようになりました。これにより、複数の通知が配信されたときに、購読者のデバイスの通知トレイで通知がどのように振る舞うかを制御できます。

次の3つのオプションがあります:

* **スタック** （既定）：各通知はトレイに個別に表示されます。通知は、購読者が閉じるまで蓄積されます。これは従来の動作であり、完全な後方互換性があります。
* **すべて置き換え:** 新しい通知が、トレイ内のすべての以前の通知を置き換えます。購読者には常に最新の通知のみが表示されます。速報ニュース、天気予報、ライブスコアなど、頻繁に更新されるコンテンツに最適です。
* **置換グループ:** 通知はカスタムラベルでグループ化されます。新しい通知は、同じグループラベルを共有する直前の通知のみを置き換え、他のグループには影響しません。各コンテンツカテゴリごとに独立した通知スレッドを維持したい、複数カテゴリの配信者に最適です。

この設定は以下の場所にあります **動作** 通知作成フォームのセクション。

**ドキュメント:** [通知の置換動作](https://documentation.pushly.com/platform/notifications/notification-replacement-behavior)
{% endupdate %}

{% update date="2026-04-02" tags="new-feature" %}

## 通知ビルダーの機能強化：ページアナライザーとA/Bテストフロー、およびアイテムエンゲージメントイベント

#### 通知ビルダー：ページアナライザーとA/Bテストフロー

通知ビルダーでコンテンツ推奨をトリガーすると、ユーザーには次の2つのオプションが表示されます:

* **コンテンツを自動入力:** ランディングページから抽出したコンテンツで、通知のタイトルと本文フィールドを自動的に埋めます
* **コンテンツ候補を確認:** サイドパネルの確認フローを開き、候補を評価して、希望するオプションを手動で適用します

A/Bテストの設定フローが刷新され、通知ビルダー内でバリアント作成がより簡潔になりました。通知ビューの概要セクションも更新され、配信ステータス、チャネル、ターゲティング、エンゲージメント指標（表示回数、クリック数、CTR）、チャネル別パフォーマンス内訳の可視化、レンダリングされたデバイスプレビューを、より整理されたレイアウトで表示します。

#### アイテムエンゲージメントイベント：完了と評価のサポート

Pushlyは、新たに2つのカタログアイテム操作イベントをサポートしました:

* **アイテム完了:** 購読者がカタログアイテムを完了した、または作成したタイミング（例：レシピを調理した）を追跡します。Journeys、Segments、SDKイベント収集で利用できます。既存のアイテムアクションに加えて、新しい「アイテムを作成または完了」Journeyアクションが利用可能です。
* **アイテムを評価:** 購読者がカタログアイテムを0〜100の尺度で評価したタイミングを追跡します。

以下で、新しいセグメンテーション属性が2つ利用可能になりました **Eコマース / カタログ:**

* **作成 / 完了アイテム数:** 購読者が作成または完了したアイテム数に基づいてセグメントを作成します
* **評価済みアイテム数:** 購読者が評価したアイテム数に基づいてセグメントを作成します

どちらも、設定可能な期間（1、7、14、30、60、90日）と、既存のセグメント条件との完全なAND/ORロジックをサポートします。
{% endupdate %}

{% update date="2026-04-02" tags="new-feature" %}

## Journeys：キャンペーン体験の完全な再構築

Campaignsは全面的に再構築され、Journeysに名称変更されました。journeyビルダーには新しいビジュアルキャンバス、適切なマルチパスA/B/n分岐モデル、大幅に改善されたレポート、近代化されたリストおよび概要体験が備わっています。既存のすべてのキャンペーンデータ、設定、権限は完全に保持されています。既存の `/campaigns` URLは自動的に次へリダイレクトされます `/journeys`.

#### A/B/nスプリットテスト

Journey内の任意の場所にスプリットテストステップを追加し、流入する購読者オーディエンスを2〜4の名前付きバリアントブランチに分割できます。各ブランチは完全に独立しており、独自の遅延、通知、ネストされたスプリットテストのシーケンスを含められます。すべてのバリアントブランチは、下流の結合ポイントで自動的に合流します。

#### 新しいビジュアルキャンバス

journeyキャンバスは、きれいな直交エッジルーティング、対称的なブランチレイアウト、動的なビューポートサイズ調整を備えたプロ仕様の自動レイアウトエンジンで再構築されました。

#### プレースホルダーステップとステップ追加パネル

新しいjourneyは、最初のステップ追加を案内する表示可能なプレースホルダーステップから始まります。ステップ挿入UIは、ステップ名、説明、論理カテゴリを備えた説明的なフローティングパネルとして再設計されました。

#### 未保存の変更の保護

変更が保留中のまま離脱すると、ブラウザの確認ダイアログが表示されます。未保存の編集がある場合、保存ボタンのラベルは動的に「変更を保存」に更新されます。

#### Journeys一覧と概要の改善

Journeys一覧はページネーション対応となり、固定フィルター、インラインのオーディエンスセグメント情報、インラインのパフォーマンス指標が表示されます。journey概要ページには、折りたたみ可能なモダンヘッダー、カスタム日付範囲選択とグルーピングを備えたパフォーマンスグラフ、Notification、Step、Split Test Variantのパフォーマンス内訳を表示する新しいInsightsタブが含まれます。

#### 自動生成されるステップ名とレポート

Journeyステップには、人間が読める自動生成名（例：「Variant A > Notification #1」）が付与されます。Insightsでは、Step、Split Test、Split Test Variantごとの内訳がサポートされます。

ドキュメント: [Journeys](https://documentation.pushly.com/platform/journeys)
{% endupdate %}

{% update date="2026-02-25" tags="improvement" %}

## キャンペーンステップ選択パネル

Campaign Builderに新しいステップ選択パネルが追加されました。ステップは、以前の小さくラベルのないアイコンに代わり、視覚的なアイコンと説明ラベルを備えた論理カテゴリに整理されています。

**利用可能なステップタイプ:**

**タイミング:**

* 待機：次のステップが実行される前に、設定した時間だけキャンペーンを一時停止します

**通知:**

* カスタム通知：完全にカスタマイズされたプッシュ通知を作成して送信します
* カート放棄：購読者のカートに残された商品についてリマインドを送信します
* 保存済みアイテムのリマインダー：購読者が保存したアイテムのリマインダーを送信します
* 最近閲覧したアイテム：購読者が最近閲覧したカタログアイテムのフォローアップを行います
* トレンドアイテム：最近のアクティビティに基づいて、成果の高いカタログアイテムを送信します
* パーソナライズ推薦：AIが選択したパーソナライズアイテムを送信します（現在はBlueConicによって提供）

**ドキュメント:** [Journeys](https://documentation.pushly.com/platform/journeys)
{% endupdate %}

{% update date="2026-02-11" tags="improvement" %}

## セッションハートビートと有効期限切れUX、およびアプリメッセージプレビューウィンドウ

#### セッションハートビートと有効期限切れUX

プラットフォームには、クライアント側で有効期限状態を追跡して先回りして処理する軽量なセッションハートビートが追加され、曖昧な403エラーや突然のログアウトという従来の体験に代わりました。

* **セッション有効期限警告:** セッションの有効期限5分前に目に見える警告通知が表示され、作業を保存して再認証する時間を確保できます。
* **専用のセッション期限切れ画面:** セッションが期限切れになると、［サインイン］ボタン付きの専用画面が表示されます。サインイン後、プラットフォームはユーザーが最後に表示していたページに戻ります。

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

App Message builderから新しいApp Message Previewsウィンドウを利用できるようになり、以下をサポートする実機に近いデバイス枠でメッセージを表示します:

* **デバイスタイプ:** スマートフォンまたはタブレット
* **画面の向き:** 縦向きまたは横向き
* **テーマ:** ライトまたはダーク
* **プラットフォームフィルタリング:** 例：Apple/iOS

これにより、公開前にテキストの切り捨て、ボタンの詰まり、ダークモードのコントラスト問題などのレイアウト問題をより早く見つけられます。

**ドキュメント:** [App Messages](https://documentation.pushly.com/platform/app-messages)
{% endupdate %}

{% update date="2025-12-10" tags="new-feature" %}

## 組織レベルのInsightsレポート

複数ドメインを管理するエンタープライズ顧客は、通知と購読者獲得のパフォーマンスをすべてのプロパティ横断で1つのレポートに集約した統合Insightsビューにアクセスできるようになりました。

組織レベルのアクセス権を持つユーザーには、ナビゲーションに新しいInsightsセクションが表示されます。V1.0には2種類のレポートがあります:

* **通知レポート:** すべてのドメインにおける配信・エンゲージメント指標を表示し、新しいOrganization Notification Groupの概念により、各通知グループは、ドメイン別内訳を適用した際に対応するドメインレベルのパフォーマンスと紐づけられます。
* **獲得レポート:** すべてのドメインにおける購読者獲得傾向とチャネルパフォーマンスを表示します。

ドメインレベルのフィルターにより、任意の組織レベルレポートを1つまたは複数の特定ドメインに絞り込んで比較できます。レポートテーブルコンポーネントも、列幅の変更と大規模データセットでのレイアウト安定性向上に対応しました。

**ドキュメント:** [Insights](https://documentation.pushly.com/platform/insights)
{% endupdate %}

{% update date="2025-11-11" tags="improvement" %}

## Campaign BuilderのUX改善とクリックのルックバック期間拡張

#### Campaign Builder UXの改善

* **未保存の変更の認識:** Campaign Builderで編集すると、未保存の変更があることがインターフェース上で明確に示されます。変更保留中に離脱しようとすると、目に見える警告が表示されます。
* **タブ移動の保護:** 未保存の変更を破棄するタブへの切り替えは、編集保留中はブロックされます。
* **レイアウトと視認性の改善:** Visual Builderキャンバスの高さは900pxに制限され、過度にスクロールしなくてもほとんどの画面サイズで［保存］ボタンが表示されたままになります。
* **Campaign TTL保持の修正:** 通知の寿命（TTL）の値が、すべてのキャンペーンアクションステップで正しく保存されるようになりました。
* **通知フォームデータ整合性の修正:** フォームを再読み込みまたは再訪問した際も、スケジュール、テンプレート、キャンペーンアクション全体で通知フォームの値が安定して維持されるようになりました。

#### 季節的リターゲティング向けクリックのルックバック期間拡張

* **キーワードクリック** ルックバック期間は最大で次の期間まで拡張されました: **120日** （以前は90日が上限でした）
* **通知クリック** ルックバック期間は最大で次の期間まで拡張されました: **365日** 対象ドメインでは（以前は90日が上限でした）

これにより、11月のブラックフライデーキャンペーンを計画する際に「7月にPrime Day通知をクリックした」ようなオーディエンスを作成できます。より短いルックバック期間も引き続き利用可能です。
{% endupdate %}

{% update date="2025-10-08" tags="improvement" %}

## 通知スケジュール重複確認とリアルタイムオーディエンスサイズ同期

#### 通知スケジュール重複確認

通知を作成またはスケジュールするとき、プラットフォームは設定可能な時間枠内で同じオーディエンスを対象とする他の今後の配信を自動的にチェックします。重複の可能性が検出されると、配信フローに確認ステップが追加され、競合する通知のID、送信時刻、オーディエンス重複の詳細が表示されます。その後、配信者は確認して続行するか、キャンセルするかを選べます。

重複ウィンドウは以下で設定できます **ドメイン設定 > 通知 > 確認ウィンドウ**.

このリリースの一環として、すべての配信確認ステップが1つの統合されたウィザードフローにまとめられました。手順は次の3つです:

1. **オーディエンス競合:** 同じオーディエンスとランディングURLが過去7日以内に最近対象にされていた場合に警告します
2. **通知スケジュール重複:** 設定された期間内で同じオーディエンスに対する重複スケジュール配信を検出します
3. **予定配信 / 即時配信の確認:** 配信確定前の最終確認

#### セグメントのリアルタイムオーディエンスサイズ同期

セグメントのオーディエンスサイズはリアルタイムで更新され、Segment List ViewとEdit Segment Viewの間で一貫性が保たれるようになりました。以前は一覧表示の件数は1日1回しか更新されませんでした。セグメント一覧はすぐに読み込まれ、サイズはバックグラウンドで更新されるため、キャンペーンのターゲティングに依存する数値は両方のビューで常に最新かつ正確です。
{% endupdate %}

{% update date="2025-09-22" tags="new-feature" %}

## 通知のセグメントフィルタリング、購読者送信でのセグメントデータ、Eコマース設定

#### 通知のセグメントフィルタリング

編集チームは、ツールバーから直接、1つまたは複数のオーディエンスセグメントでNotification Listページを絞り込めるようになりました。これにより、別の送信を追加する前に、特定セグメントを対象とする今後および予約済みの通知をすべて簡単に確認でき、同じオーディエンスへの過剰配信を避け、スケジュール競合を減らすのに役立ちます。

複数のセグメントを選択するとORフィルターが適用され、選択したセグメントの少なくとも1つを対象とする通知が表示されます。フィルター選択は、解除するまでセッションをまたいでユーザープロファイルごとに保持されます。

#### 購読者送信でのセグメントデータ

この `segment_names` マクロが、キャンペーンの一部である購読者送信で現在展開されるようになり、Standard送信と同等になりました。セグメントコンテキストに依存する下流サービスや通知のパーソナライズは、送信タイプに関係なく一貫して動作するようになります。
{% endupdate %}

{% update date="2025-09-05" tags="new-feature,improvement" %}

## BlueConic連携とワークフローの強化、セグメント選択の改善、動的コンテンツ向けremote\_fetch

#### BlueConic連携とワークフローの強化

Journey builder内のキャンペーンステップは、既定で閲覧専用形式で開くようになり、すでに設定済みのステップを確認する際の誤編集を防ぎます。編集モードに入るには明示的な［編集］ボタンが必要です。［キャンペーンを編集］アクションがCampaign Detailsページに直接追加され、変更のためにbuilderへ戻る必要がなくなりました。すべてのJourney Stepドロワーヘッダーに、現在の状態（編集、表示、作成）が明確に表示されます。

#### セグメント選択の改善

セグメント選択ドロップダウンの最上部に「最近対象にした」グループが表示され、ドメインで最近使用した5つのセグメント（最終ターゲット日順）が一覧表示されます。下には、すべてのセグメントが明確なラベル付きグループに整理され、適切なオーディエンスを見つけやすくなっています。また、System Segmentsがドメインのアクティブチャネルを不正確に反映していた不具合も解消されました。

#### 新機能：動的コンテンツ向けremote\_fetch

新しい `remote_fetch` コンテンツソースタイプが、真にリアルタイムのパーソナライズされた通知コンテンツを必要とする技術系配信者向けに利用可能になりました。通知の配信準備中に、 `remote_fetch` パブリッシャー定義のURLに安全なサーバーサイドリクエストを行い、その応答を使って送信時に通知フィールドを埋めます。これにより、各受信者は通知が送信されるその瞬間の固有の状況を反映したコンテンツを受け取れます。

使用例には、現在の天気、購読者のロイヤルティポイント残高、ライブスポーツスコア、パーソナライズされた商品おすすめ、または頻繁に変化し、作成時に事前入力すべきでないあらゆるデータが含まれます。外部データソースが配信時に利用できない場合でも、通知は設定されたデフォルトのフォールバックメッセージで送信されます。
{% endupdate %}

{% update date="2025-08-25" tags="new-feature" %}

## BlueConicコンテンツ推薦連携

PushlyはBlueConic Customer Data Platform（CDP）と連携し、Webプッシュ通知内でパーソナライズされたコンテンツ推薦を実現します。この連携により、配信者はBlueConicインスタンスを一度接続するだけで、今後すべてのキャンペーンの動的コンテンツソースとして利用できます。

連携を設定すると、Pushlyの通知ビルダーは購読者の個別BlueConicプロフィールから推奨記事や商品アイテムを取得できます。これらの推奨は通知内の動的コンテンツブロックとして挿入され、各購読者は自分の興味や過去の行動に基づいて特別に選ばれたコンテンツを受け取ります。

**主な機能:**

* **初回設定:** Platform Integrations > BlueConic から連携を1回設定します。データ接続を確立するために、BlueConic listenerプロファイルをPushlyの購読者セグメントにマッピングします。
* **インテリジェントな推薦:** Pushly内からBlueConicの推薦アルゴリズムを直接活用し、個々の購読者のアクティビティに基づいてパーソナライズされた通知コンテンツを自動生成します。
* **高度なフィルタリング:** 含めるアイテム、除外するアイテム、商品フィルターを使って推薦を細かく調整し、最も関連性の高いコンテンツを適切なオーディエンスに届けます。
* **複数の設定:** 組織ごとに複数の推薦アルゴリズム設定を作成・管理でき、異なる戦略を異なるキャンペーンやオーディエンスセグメントに適用できます。

**ドキュメント:**

* [BlueConic連携](https://documentation.pushly.com/platform/platform-integrations/blueconic)
* [CampaignsでBlueConicを使用する](https://documentation.pushly.com/platform/platform-integrations/blueconic/using-blueconic-in-campaigns)
  {% endupdate %}

{% update date="2025-07-29" tags="improvement" %}

## フィードの一括操作とPrompts Editorの刷新

#### フィードの一括操作

配信者はPlatformとHaloの両方のFeeds一覧から、複数のフィードを一度に選択して一括操作できるようになりました。表の左側に新しい行選択列が表示され、1つ以上のフィードが選択されると、表ヘッダーに「Bulk Actions」ドロップダウンが表示されます。

メニューはコンテキストを認識します。選択したフィードがすべて同じステータス（すべてEnabledまたはすべてDisabled）の場合は、反対の操作のみが表示されます。混在したステータスのフィードが選択されている場合は、EnableとDisableの両方の操作が表示され、選択したすべてのフィードに同時に適用されます。Archiveは、現在のフィードステータスに関係なく常に利用できます。この変更により、PlatformとHalo間でFeeds一覧コードが統一され、今後の改善が両方のインターフェースに一貫して展開されます。Haloでは、Create FeedボタンがPlatformのUXに合わせるため、右上隅に移動されました。

#### Prompts Editorの更新

Platform Prompts Editorは、NotificationsとApp Messagesで使用されているデザイン言語に合わせて視覚的に刷新されました。Bell Promptオプションは、以前に非推奨でサポート対象外となっていたため削除されました。Prompt Previewは、ライブ環境でプロンプトがどのように表示されるかをより正確に反映するよう全面的に再設計され、新しいSafari専用プレビューにより、配信者は異なるブラウザ間で購読者が実際に見る内容を正確に確認できます。
{% endupdate %}
{% endupdates %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.pushly.com/pushly-ja/faq/rirsunto.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.