> 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/journeys/ibentotorig.md).

# 外部イベントトリガー

自社システムが重要な出来事を報告したその瞬間に行動を開始しましょう。たとえば、悪天候警報、フライトの遅延、試合の最終スコアなどです。イベントの詳細をメッセージに含めてください

## 外部イベントトリガー

1つの **外部イベント** トリガーは、あなた自身のシステムが Pushly に「何かが起きた」と伝えたときにジャーニーを開始します。たとえば、深刻な気象警報が発令された、フライトが遅延した、チームが勝利した、などです。ジャーニーが監視するイベントの種類を選び、必要なイベントだけに絞り込み、どの購読者に届くかを決め、イベントの詳細をそのまま通知に入れることができます。

他のトリガーがサイト上で購読者の行動に反応するのに対し、外部イベントトリガーは、ビジネスがすでに把握している世界で起こる出来事に反応します。そのため、メッセージには後から一般的なリマインダーを送るのではなく、「お住まいの地域に対する雷雨警報は午後9時まで有効です」といった内容を入れられます。

### 始める前に: システムを接続する

外部イベントは、あなた自身のシステムから Pushly に送信されます。そのため、チーム内の開発者がまずそれらを接続し、あなたのドメインにイベントを送信できるようにする必要があります。技術的な詳細は、 [Pushly の開発者向けドキュメント](https://developers.pushly.com/reference/using-the-external-events-api).

システムが送信する各イベントには名前（その **イベントタイプ**。たとえば `weather_alert` や `flight_delayed`）があり、 **プロパティ** — 見出し、重要度、便名、影響を受けるエリアなど、そのイベント固有の詳細を含めることができます。各イベントは、それが誰向けかも示します。つまり、名前が指定された特定の購読者向けか、そのイベントを監視するジャーニーの対象となるすべての購読者向けか、のいずれかです。

事前にプラットフォーム側で設定することはありません。 **イベントタイプは、システムがそのイベントを初めて送信したときに、自動的にイベントタイプピッカーに表示されます**。その際、含まれていたプロパティもあわせて表示されます。後から追加されたプロパティも同じように取得されます。最初のイベントが届くまでは、ピッカーは空です。

### 仕組み

#### 1. トリガーとイベントタイプを選択する

トリガー付きジャーニーを作成するときは、 **設定** タブで:

1. 「 **トリガー** 」セクションを開き、 **購読者は次の後にこのジャーニーに入ります** を選びます **その購読者に対して外部イベントが受信される**.
2. 「 **外部イベント** 表示されたセクションで、 **イベントタイプ** ジャーニーが監視するものを選びます。

まだイベントタイプが一覧にない場合は、システムが最初のイベントをまだ送信していません。参照: [始める前に](#before-you-start-connecting-your-system).

#### 2. ジャーニーを開始するイベントを制限する（任意）

デフォルトでは、選択したタイプのすべてのイベントでジャーニーが開始されます。一部のイベントだけに反応するには、 **イベントのプロパティに基づいて、このジャーニーを開始するイベントを制限する** をオンにして、イベントのプロパティに条件を追加します。たとえば、 `重大度` が *深刻*.

* このチェックは、対象者が決まる前にイベント自体に対して実行されます。一致しないイベントは完全に無視されます。
* **イベントが持たない、または空として送られたプロパティに対する条件は、満たされていないものとして扱われます。** 残りの制限条件も引き続き判定されます: カテゴリを持たないイベントは単独では「 `カテゴリ`  が test ではない」は満たしませんが、 *test*」に加えて「 *test*、または優先度が *高い*」は、優先度が高い場合に満たします。
* この制限をオンにしたら、少なくとも1つの条件を追加するか、もう一度オフにしてください。条件がないままオンの状態では、ジャーニーを保存できません。

#### 3. 参加する人を選ぶ: 参加条件

参加する購読者を制限するには、 **参加条件** の **オーディエンス** セクションで **購読者属性に基づいてこのジャーニーへの参加を制限します。これらはトリガーイベントと比較できます。** セグメント画面と同じ条件ビルダーを使い、カスタムプロフィール属性を含む同じフィールド、演算子、コントロールが利用できます。

フィールドに値を入れる場所では、値の取得元を選べます:

* **値** — セグメント画面と同様に入力する固定値です。
* **イベントプロパティ** — ジャーニーを開始したイベントのプロパティです。たとえば、購読者の都市とイベントの `city`を比較したり、位置がイベントに含まれるエリア内にある購読者を対象にしたりできます。

イベントが指定するエリアは、少なくとも3点（経度と緯度のペア）のリストでなければなりません。それ以外の形式のエリアを含むイベントは、そのジャーニーにはルーティングされません。形式は開発者が確認できます。

ジャーニーの参加条件が、特定のイベントに含まれていなかったプロパティを使っている場合、そのジャーニーはそのイベントを受け取りません。同じイベントタイプを監視している他のジャーニーには影響しません。

#### 4. メッセージでイベントを使う

イベントプロパティは、ジャーニーの通知でマクロとして利用でき、マクロピッカーでは独自のグループとして表示されます。たとえば:

* `{{event.properties.headline}}` — イベントが持つ任意のプロパティ
* `{{event.name}}` — イベントタイプ名
* `{{event.occurred_at}}` — イベントが発生した時刻

**個々のイベントが持たなかった、または空として送られたプロパティを必要とする通知は送信されません** 。空欄のまま送るのではなく、そのイベントでは送信されません。メッセージが、まだそのイベントタイプで確認されていないプロパティを使っている場合、ビルダーが警告します。

### 想定される動作

* **配信頻度の上限と参加ルールは引き続き適用されます。** イベントは、その対象となる購読者に対してのみジャーニーを開始できます。他のトリガーとまったく同様です — ジャーニーの **購読者参加上限** およびオーディエンス設定を含みます。
* **ジャーニーがイベントを受け取るのは実行期間中のみです。** ジャーニーの開始日より前、または終了日や完了後に届いたイベントでは開始されません。
* **イベントには有効期間があります。** デフォルトでは、Pushly が受信してから24時間、そのイベントは有効です。ドメインに別の有効期間が設定されている場合、またはイベント自体に独自の有効期限が含まれている場合は除きます。有効期間はイベントタイプごとには設定できません。間に合わないイベントは無視されます。
* **遅延中に期限切れになったイベントは、ジャーニーを終了させます。** 購読者が遅延ステップで待機している間に有効期間が切れると、その時点で送信されずにジャーニーは終了するため、後からのイベントで再参加できます。
* **変更がライブのルーティングに反映されるまで数分かかります。** ジャーニーを保存、または有効化・一時停止・変更した後は、新しいイベントが変更内容に従ってルーティングされるまで約10分お待ちください。

### シナリオ

#### ある地域への悪天候

気象サービスが `weather_alert` 発令する各警報ごとに `重大度`、 `見出し`、 `期限切れ` 時刻と影響を受ける `エリア`.

* **トリガー:** **その購読者に対して外部イベントが受信される**, **イベントタイプ** `weather_alert`.
* **イベントを制限:** `重大度` が *深刻*.
* **参加条件:** 購読者の位置が **イベントプロパティ** `エリア`.
* **メッセージ:** `{{event.properties.headline}} — {{event.properties.expires}} まで有効です。`

警報対象エリア内の購読者のみが受け取り、さらに深刻な警報の場合に限られます。

#### 指名された乗客へのフライト遅延

航空会社が `flight_delayed` 便の乗客を指定したイベントを送信し、 `flight_number`, `new_departure` と `gate` のプロパティを含みます。

* **トリガー:** **イベントタイプ** `flight_delayed`、制限なしで。
* **参加条件:** は省略されています — イベント自体がすでに乗客を指定しています。
* **メッセージ:** `フライト {{event.properties.flight_number}} は現在、ゲート {{event.properties.gate}} から {{event.properties.new_departure}} に出発します。`

イベントが `gate`を含まずに届いた場合、

#### スポーツチームのフォロワー

スポーツ配信者が `game_final` 終了した各試合ごとのイベントを送信し、 `team`, `opponent` と `score` のプロパティを含みます。

* **トリガー:** **イベントタイプ** `game_final`.
* **イベントを制限:** `team` が *ワイルドキャッツ*にして、このジャーニーを1チームに絞ります。
* **参加条件:** 購読者の「お気に入りチーム」プロフィール属性が **イベントプロパティ** `team`.
* **メッセージ:** `最終: {{event.properties.team}} {{event.properties.score}} 対 {{event.properties.opponent}}。`

### メリット

* 次回の予定配信ではなく、何かが起こったその瞬間に購読者へ届ける
* イベント自身の詳細 — 見出し、便名、スコア — を通知に入れられる
* 各イベントを、指定された購読者、またはその地域やグループに関係する全員に向けて届けられる
* 送信元システムを変更せずに、重要でないイベントを無視できる
* 最初のイベント前のプラットフォーム設定は不要: イベントタイプとそのプロパティが自動で登録されます

トリガー付きジャーニーとその他のジャーニー設定の概要については、 [ジャーニー](https://documentation.pushly.com/platform/journeys) と [ジャーニービルダー](https://documentation.pushly.com/pushly-ja/platform/journeys/jnbirud.md).


---

# 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/platform/journeys/ibentotorig.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.
