エントリーポイントとイグジット
早期アクセスジャーニーのエントリーポイントは、ジャーニーの開始点です。これにより、どのプロファイルがジャーニーにどのように参加するかが決まります。
各エントリーポイントには、独自の設定と基準があります。ユースケースに一致するエントリーポイントを選択し、プロファイルをいつ入力するかの条件を設定します。
事前定義されたオーディエンス
事前定義されたオーディエンスを使用して、選択したタグ、セグメント、または特定のプロファイル/会社に一致するプロファイルのジャーニーを開始します。 ジャーニーを開始する前に、オーディエンスを定義する必要があります。エントリーポイントの種類によっては、起動後にオーディエンスを更新できる場合があります。
定義済みのオーディエンスエントリポイントには、次のものが含まれます。
これらのオプションを比較するには、「関連するエントリーポイントを選択を参照してください。
ジャーニーに追加できる定義済みオーディエンス エントリーポイントは 1 つだけです。他のエントリーポイントタイプは複数回追加できます。
次の図は、使用可能な定義済みのオーディエンス エントリーポイント タイプを示しています。
1回限り
ジャーニーの起動時にオーディエンスが 1 回入力する必要があるキャンペーンには、1 回限り を使用します。
機能
ワンタイム エントリーポイントには、次の機能があります。
- 起動時にオーディエンスが入力:起動時の条件に一致するすべてのプロファイルがジャーニーに入ります。
- オーディエンス条件はローンチ後に固定されます: ローンチ後にオーディエンス条件を変更することはできません。
- プロファイルは一度入力します: プロファイルは、このエントリーポイントから再入力されません。
例:6 月というタグを持つすべてのプロファイルのジャーニーを開始します。起動時にすでに June タグが付いているプロファイルのみが入力されます。後でタグ付けされたプロファイルは入力されません。
エレメントの構成
対象者の指定 をジャーニーに指定します。
連続
継続 は、ジャーニーがアクティブな間に、オーディエンスの条件を満たす新しいプロファイルを入力する必要がある常時オンのジャーニーに使用します。
機能
連続 エントリーポイントには、次の機能があります。
- オーディエンスが起動時および実行時に入力:起動時に一致するプロファイルが入力されます。後で一致するプロファイルも自動的に入力されます。
- オーディエンスの事前定義:ジャーニーを開始する前に、オーディエンスの条件を定義する必要があります。オーディエンス条件は、ジャーニーがアクティブな間、起動後に更新できます。
- オーディエンスの手動追加と削除: ジャーニーの起動後、ジャーニーがアクティブな間、手動で オーディエンスの追加と削除 できます。
- 複数のジャーニーエントリー: プロファイルは、ジャーニー設定 (再入力とフリークエンシー キャップの設定) に応じて、複数回入力できます。
プロファイルが既にジャーニーにある場合、フリークエンシーキャップや再入力設定などの設定により、このプロファイルがジャーニーに再度入らない場合があります。
例:June というタグを持つすべてのプロファイルをオーディエンスに追加し、ジャーニーを開始しました。ジャーニーの起動時に June タグを持つすべてのプロファイルで、ジャーニーを入力します。ジャーニーがアクティブな間、このタグは別のプロファイルに追加されます。このプロファイルもジャーニーに自動的に追加されます。
エレメントの構成
対象者の指定 をジャーニーに指定します。
再発
繰り返し は、スケジュールに従って実行されるジャーニー (たとえば、毎週または毎月) に使用します。
オーディエンス条件に一致するプロファイルは、繰り返しごとにジャーニーに入り、ジャーニーはアクティブなまま、繰り返し設定に基づいて繰り返し実行され続けます。
機能
繰り返し エントリーポイントには、次の機能があります。
- 定期的なジャーニー: ジャーニーは、ジャーニーがアクティブな間、スケジュールに従って実行されます。
- オーディエンスの事前定義:ジャーニーを開始する前に、オーディエンスの条件を定義する必要があります。ジャーニーがアクティブな間は、起動後に条件を更新できます。
- オーディエンスの手動追加と削除: ジャーニーの起動後、ジャーニーがアクティブな間、手動で オーディエンスの追加と削除 できます。
- 複数のジャーニーエントリ: 繰り返し条件によっては、選択したオーディエンスがジャーニーに複数回エントリーする場合があります。例: 同じ人が毎週週のニュースレターを受け取ることができます。
プロファイルが既にジャーニーにある場合、フリークエンシーキャップや再入力設定などの設定により、このプロファイルがジャーニーに再度入らない場合があります。
例:June というタグを持つすべてのプロファイルをオーディエンスに追加し、ジャーニーを開始しました。繰り返し時に、June タグを持つすべてのプロファイルがジャーニーに入ります。ジャーニーがアクティブな間、このタグは別のプロファイルに追加されます。次回ジャーニーが繰り返されると、このプロファイルもジャーニーに自動的に追加されます。
エレメントの構成
このエントリーポイントへのオーディエンスの追加
設定されたオーディエンスがジャーニーに参加する頻度を定義します。繰り返しタイプを選択します。
- Daily (毎日)： 例：日々の予定に関するリマインダー。
- Weekly (毎週)： 例：週刊ニュースレター。
- Monthly (毎月)： 例：毎月の支払いに関するリマインダー。
- Yearly (毎年)： 例：誕生日や記念日のお祝い。
要件に合わせて再発を調整できます。
例：毎月の特定の日付または特定の平日 (毎月第1水曜日など) に対して、毎月の再発を設定できます。
People からオーディエンスを追加
対象者の指定 をジャーニーに指定します。
People からオーディエンスを追加
次の手順は、連続エントリーポイントのプロセスを示しています。同じプロセスが、他の定義済みオーディエンスエントリポイントにも適用されます。
- エントリーポイント構成で、People から対象ユーザーを追加 を選択します。
- 1 つ以上のオーディエンス条件を選択します。タイプごとに複数のオプションを選択できます。選択した項目に一致するすべてのプロファイルが含まれます。
- その他のアイテムを参照するには、[すべて表示] を選択します。
- 特定のアイテムを検索するには、検索フィールド ([すべて表示] を選択すると使用可能になります) を使用します。
関連するエントリーポイントを選択します
次の情報を使用して、ジャーニーに関連するエントリーポイントを選択してください。
| 特徴 | 1回限り | 連続 | 再発 |
|---|---|---|---|
| オーディエンスがジャーニーに入るとき | ジャーニーが起動されたとき。 | ジャーニーが起動されたとき。ジャーニーの起動後、オーディエンスが事前定義された条件を満たすたびに。 | 指定した間隔に基づく。 |
| 複数のジャーニーエントリ | いいえ プロファイルはジャーニーに一度だけ入ります。 | はい | はい |
| ジャーニーの起動後にオーディエンスを手動で追加および削除する | いいえ | はい | はい |
| シナリオ | 1 回限りの短いバーストキャンペーン。 例：季節限定のプロモーション。 | 進行中の自動化されたキャンペーン。 例：予定のリマインダー。 | 再発のキャンペーン。 例：週刊ニュースレターの送信。 |
トリガー
トリガーは、イベントまたは受信インタラクションに基づいてジャーニーにプロファイルを追加します。 ジャーニーへのエントリーが静的なオーディエンスではなく、行動、メッセージ、通話、または時間ベースのルールに依存する必要がある場合は、トリガーを使用します。
People プロファイルの変更
このエントリーポイントは、ユーザープロファイル属性が変更され、構成された条件に一致するとトリガーされます。
例: 通信にオプトインするエンド ユーザーにウェルカム メッセージを送信します。ユーザー プロファイルの変更 トリガーで、OptInStatus プロファイル属性が True でなければならないという条件を指定します。ジャーニーは、エンドユーザーの OptInStatus プロファイル属性が True に変更されるとトリガーされます。
日付ベースの条件を使用することもできます。
例：エンドユーザーの誕生日にグリーティングを送りたいとします。Change in people profile (パーソンプロファイルの変更) トリガーで、BirthDate プロファイル属性が today であるという条件を指定します。
トリガーの構成
トリガーで、属性、演算子、および条件値を選択します。ジャーニー変数を値として使用することもできます。
以下を追加できます。
- 条件内の複数の条件
- 複数の条件
使用可能な演算子は、パーソン属性のデータ型によって異なります。次の表に、各データ型の演算子が一覧表示されています。List (リスト) データ型のパーソンプロファイル属性を使用することもできます。
| ブール値 (True/False) | 本文 | 数値 (10 進数、整数) | 日付 (日付、日付時刻) |
|---|---|---|---|
| は | は | は | は |
| ではない | ではない | ではない | ではない |
| 空 | 含まれています | 未満 | 前 |
| 含まれていません | 以下 | まで | |
| で始まる | 以上 | 以来 | |
| で終わる | より大きい | アフター | |
| 空 | 空 | 空 | |
| 空ではない | 空ではない | 空ではない | |
| 今日は | |||
| で | |||
| 以内になります | |||
| 以上になります | |||
| でした | |||
| 内にあった | |||
| 以上だった |
People リアルタイムイベント
このエントリーポイントを使用して、プロファイルが顧客プロファイルイベントを記録したときにジャーニーをトリガーします。
例: Web サイトで、Web SDK を使用して addToCart イベントを追跡します。イベント addToCart を People リアルタイム イベント エントリーポイントに追加します。エンドユーザーが Web サイトのカートにアイテムを追加すると、イベントがエンドユーザーのプロファイルに割り当てられ、ジャーニーがトリガーされます。
その後、イベントに基づいてジャーニーを分岐できます。例: addToCart イベントが発生した場合は、フォローアップ メッセージを送信します。
このエントリーポイントを使用して、エンドユーザーがWebサイトなどのデジタル資産をどのように操作するか、メッセージにどのように反応するか、およびプロファイル情報に変更があるかどうかを確認します。
イベントの詳細については、「顧客プロファイル」を参照してください。
トリガーのユースケース
次に、このトリガーの使用例をいくつか示します。
- 顧客に対して自ら選択した商品がまだカートに入ったまま放置されている知らせるキャンペーンを実施する場合
- 7日以内に同じアイテムを3回以上表示したエンドユーザーに割引を提供する場合
- その他の高度なマルチステップキャンペーンを実施する場合
トリガーの構成
次の手順に従って、トリガーを構成します。
- イベント条件を定義します。
- (オプション)イベント情報をジャーニー変数にマッピングします。
- (任意) 履歴データを含めます。
複数のオーディエンスセグメントを使用し、顧客属性を追加するには、セグメントオーディエンスエレメントを参照してください。
条件定義
ジャーニーをトリガーする 1 つ以上の条件を定義します。
各条件で、次の操作を行います。
- イベントを選択します。
- イベントの演算子を選択します。アクションを実行した顧客またはアクションを実行しなかった顧客のいずれかをターゲットにすることができます。
- イベントの基準を定義します。
- (任意) イベントにプロパティがある場合は、それらを条件に追加してターゲットにするオーディエンスを絞り込むことができます。
イベントの選択
イベントを選択します。イベントの詳細については、Customer ProfilesのEventsを参照してください。
次のガイドラインに従ってください。
- カスタムイベントを選択するには、イベントとそのプロパティーを「顧客プロファイル」で定義する必要があります。
- チャネル イベントの場合は、通信に関する詳細を選択することもできます。例: 「クリックされたメールリンク」イベントで、リンクがエンドユーザーに送信されたジャーニーの名前を選択します。
- 製品イベントでは、人がジャーニーに入ったイベントとジャーニーを終了した人イベントを使用できます。イベント プロパティ フィールドを使用して、以下を追加します。
- イベントが発生したジャーニーまたはジャーニーバージョン (コミュニケーション) の名前。
- ときは、イベントが発生した時刻と発生回数。
選択するイベントを探したい場合、イベント名で検索するか、イベントの種類でフィルタリングすることができます。
演算子の選択
ターゲットとするエンドユーザーを選択します。
- 発生: アクションを実行したエンド ユーザーをターゲットにします。発生時間と発生回数を設定できます。例: ジャーニーをトリガーし、7 日以内にイベントが 3 回目に発生したときに通信を送信するには、時刻を 過去 7 日以内 として指定し、発生回数を 3 回に等しい と指定します。
- Not happened (起きなかった)：アクションを実行しなかったエンドユーザーをターゲットにします。 例：エンドユーザーが一定期間後にアプリを起動しませんでした。
Not happened 条件を単独で使用しないでください。Happened 条件でのみ使用してください。これは、イベントが発生したときにジャーニーをトリガーすることはできますが、イベントが発生していないときにジャーニーを開始することはできないためです。
例: イベント A が発生し、イベント B が発生しなかったときにジャーニーを Start します。
条件の基準の定義
各イベントには、基準の特定のフィールドがあります。すべてのフィールドに入力します。
条件へのイベントプロパティの追加 (任意)
イベントにプロパティがある場合は、それらを条件に追加してターゲットオーディエンスを絞り込むことができます。Property (プロパティ) を選択します。
プロパティを必要な数だけ追加します。
次の図に示す例では、Item viewed イベントのプロパティである itemId がフィルターとして追加されています。
イベントのプロパティをジャーニー変数にマッピングする (オプション)
イベントにプロパティがある場合は、それらをジャーニー変数にマッピングできます。これらの変数は、ジャーニーの後半で再利用できます。
例: ジャーニーでは、イベントを待つ エレメントを使用して、エンド ユーザーが予定を予約するのを待ちます。イベントには、予定時刻 や 予定名 などのプロパティがあります。これらのプロパティは、ジャーニー変数として保存できます。体験の後の段階で、これらの変数を使用して、予定の詳細を含む確認メッセージをエンド ユーザーに送信できます。
設定によっては、エンドユーザーがジャーニーを移動するにつれて、マッピングされた変数の値が変わる可能性があります。
例: ジャーニーでは、注文の 配送ステータス を変数として使用します。delivery イベントが次のステージに進むと、delivery status 変数が Pending から Dispatched に変わります。
リスト属性をジャーニーに渡すことができます。詳細については、「イベントのリストをジャーニーに渡す](/automation-studio/journeys/using-lists#pass-list-attributes-to-journey-lists-in-journey)を参照してください。
変数の作成と使用の詳細については、「イベントのプロパティをジャーニー変数にマッピングする](/automation-studio/journeys/manage-journeys/journey-settings#フロー変数-settings)を参照してください。
履歴データを含める (任意)
このオプションを選択すると、ジャーニーの開始前に発生したイベントが含まれます。
条件のすべてのイベントがジャーニーの開始前に既に発生している場合、そのユーザーはジャーニーに参加しません。ジャーニーが recurrent の場合、ユーザーはこれらのイベントが再び発生した場合にのみジャーニーに参加します。
受信メッセージ
このエントリーポイントを使用して、エンドユーザーがキーワードなどの設定された条件に一致するメッセージを送信したときにジャーニーをトリガーします。チャネルに応じて、エンドユーザーはキーワードをメッセージ本文、ボタンテキスト、またはボタンペイロードとして送信できます。
チャネルに応じて、条件が一致する可能性があります。
- Message body (メッセージ本文)
- ボタンテキスト(WhatsApp)
- ボタンペイロード(WhatsApp)
- すべて (フォールバック)
複数のインバウンドメッセージエントリポイントをジャーニーに追加できます。
トリガーの構成
次の手順に従って、トリガーを構成します。
- トリガーを作成するチャネルを選択します。
- 受信者を選択します。
- エンドユーザーのメッセージを指定した値と比較する条件を定義します。条件が満たされると、ジャーニーがトリガーされます。
- (任意) インバウンドメッセージの情報を変数に保存します。
チャネルの選択
[チャネルと条件] セクションで、トリガーを作成するチャネルを選択します。エンドユーザーとのコミュニケーションは、選択したチャネルを介して行われます。
デフォルトのチャネルはSMS です。別のチャネルを使用するには、既存のチャネルを削除し、必要なチャネルを選択します。
受信者の選択
チャネル名を選択してカードを開きます。To recipient (受信者へ) セクションで、受信者を選択します。
インバウンドメッセージの条件定義
エンドユーザーのメッセージを指定した値と比較する条件を定義します。条件が満たされると、ジャーニーがトリガーされます。
エントリーポイント内に複数の条件を指定できます。
次の条件を設定できます：
- Message body (メッセージ本文)： メッセージの本文を条件値と比較します。
- すべて: このオプションを使用すると、エンドユーザーのメッセージに条件に含まれていないものが含まれている場合でもジャーニーに参加できます。 完全一致は、Anythingよりも優先されます。例: 同じエンドユーザーからのメッセージを待機している 2 つのジャーニーがあります。あるジャーニーでは、条件は「はい」という単語と完全に一致することです。他のジャーニーでは、条件は Anything です。エンドユーザーは「はい」と答えます。この場合、キーワードと完全に一致するジャーニーがトリガーされます。
- Button text (ボタンテキスト) (WhatsAppのみ)：エンドユーザーが応答するボタンを選択すると、この条件はボタンのテキストを条件値と比較します。
- Button Payload (ボタンペイロード) (WhatsAppのみ)：エンドユーザーが応答するボタンを選択すると、この条件はボタンペイロードを条件値と比較します。
条件には、次の演算子を使用できます。
- Is equal to person attribute (パーソン属性と等しい) - 選択したパーソン属性がメッセージ本文に含まれているかどうかをチェックします。 値を比較する場合、大文字と小文字は無視されます。
- Matches text (テキストに一致) - エンドユーザーの応答が条件値と完全に一致するかどうかを確認します。エンドユーザーの応答に条件値のみが含まれ、他には何も含まれていない場合、条件が満たされます。複数の条件値を指定できます。 例： 条件値： time (時間) エンドユーザーの応答：time (時間)。条件が満たされます。 エンドユーザーの応答：timezone (タイムゾーン)、 time!! (時間!!)、what is the time (何時?) この場合は、応答に条件値の一部ではない追加の文字が含まれているため、条件は満たされません。 値を比較する場合、大文字と小文字は無視されます。
- Matches RegEx (正規表現に一致) - 定義した正規表現パターンがメッセージ本文に含まれているかどうかを確認します。 Ignore case (大文字と小文字を区別しない) (任意) : 条件を評価する時に大文字と小文字を無視するかどうかを指定します。 Multiline (複数行) (任意)：このオプションは、メッセージ本文を複数行のテキストと照合する場合に使用します。いずれかの行が一致する場合、検証は成功します。
- Contains text (テキストを含む) - メッセージ本文に、条件値で指定したキーワードが含まれているかどうかをチェックします。条件値には、記号やキーワードなどの文字のグループを指定できます。複数の条件値を指定できます。 例： 条件値： time (時間) エンドユーザーの応答：time (時間)、timeframe (タイムフレーム)、3 times (3回)、time!! (時間!!)、what is the time (何時?) メッセージにキーワードが含まれているため、条件が満たされます。 値を比較する場合、大文字と小文字は無視されます。
- Contains word (単語を含む) - メッセージ本文に、条件値で指定した正確な単語が含まれているかどうかをチェックします。メッセージ本文の単語には、単語の前後に記号またはスペースを含めることができますが、数字やその他の文字を含めることはできません。 例： 条件値： time (時間) エンドユーザーの応答：time (時間)。メッセージに正確な単語が含まれているため、条件が満たされます。 エンドユーザーの応答：time!! (時間!!)、what is the time (何時?) メッセージには、単語の前後に記号またはスペースを含む正確な単語が含まれているため、条件が満たされます。 エンドユーザーの応答：times (回数)、timeframe (タイムフレーム)、timezone (タイムゾーン)、3times (3回)。メッセージ内の単語に、条件値の一部ではない追加の文字が含まれているため、条件が満たされません。 値を比較する場合、大文字と小文字は無視されます。 複数の条件値を指定できます。
システムは、上記の順序に従ってインバウンドメッセージを処理します。優先度の高い条件が満たされた場合、ジャーニーはその条件に対してアクションを実行し、他の条件は無視します。
複数のアクティブなジャーニーでキーワードを再利用できます。例: 複数のジャーニーで Yes や No などの一般的なキーワードを使用します。2 つ以上のジャーニーがエンドユーザーからの同じインバウンドキーワードを同時に待機している場合、エンドユーザーの入力はこれらのジャーニーの 1 つにランダムに転送されます。
インバウンドメッセージ情報を変数に保存
また、インバウンドメッセージ情報をキャプチャして保存する変数を定義することもできます。
インバウンドメッセージメッセージからキャプチャするデータを定義します。キャプチャできる情報は次のとおりです。
- Message body (メッセージ本文)
- 受信者
- Sender (送信者)
- Message ID (メッセージID)
- Gateway ID (ゲートウェイID)
情報の全部または一部を保存できます。
- Whole text (全文)： 情報全体を保存します。
- RegExp parse variable (正規表現解析変数)： 正規表現を使って、メッセージコンテンツ内の特定のキーワードをキャプチャします。
詳細については、「ジャーニー変数](/automation-studio/journeys/manage-journeys/journey-settings#フロー変数-settings)を参照してください。
インバウンドコールの開始
エンド ユーザーが電話番号に電話をかけると、Start 着信呼び出し エントリーポイントを使用して、エンド ユーザーがジャーニーに追加できます。このエントリーポイントは、着信 IVR （自動音声応答） コール セッションを開始します。詳細については、IVR （自動音声応答）を参照してください。
日付または時刻
日付または時刻 トリガーは、時間に敏感な通信に使用します。トリガーは、顧客プロファイルの 個人プロファイル に保存されている日付または時刻情報を使用します。
このトリガーは UTC タイム ゾーンを使用します。
タイミングが重要なメッセージングキャンペーンでは、日付を待つ ジャーニーエレメントを使用することもできます。
前提条件
トリガーを使用するための前提条件は次のとおりです。
- ユーザー プロファイルは、顧客プロファイル に存在する必要があります。
- プロファイルには、日付または日付と時刻のいずれかを含む カスタム属性 が必要です。この属性をトリガーで使用します。
カスタム属性の作成
顧客プロファイル でカスタム属性を作成します。例: エンド ユーザーに予定について通知したいと考えています。AppointmentDateTime カスタム属性を作成します。
属性を個人プロファイルに追加し、属性値を更新します。これを行うには、NTT CPaaS Web インターフェイスの顧客プロファイルで手動インポートを使用するか、 顧客プロファイル API (opens in a new tab)、Web SDK、またはモバイル SDK を使用します。
これで、この属性をトリガーで使用できるようになります。
トリガーの構成
トリガーで、カスタム属性、演算子、および条件値を選択します。
(任意) 同じアクションは毎年繰り返すことができます。そうしたい場合、Do this action every year (このアクションは毎年繰り返す) を選択します。このオプションは、カスタム属性の年を無視します。
トリガーの演算子
条件では、次の演算子を使用できます。
| オペレーター | 説明 | 例文 |
|---|---|---|
| 含まれています | 属性の日付/時刻の特定の期間 (時間または日) 前にメッセージを送信します。 | AppointmentDateTime is in 4 hours: プロフィールは予定の 4 時間前に入力されます。 |
| だった | 属性の日付/時刻の特定の期間(時間または日)後にメッセージを送信します。 | TrialExpiryDate was 1 day ago: プロファイルは有効期限の 1 日後に入力されます。 |
| 今日は | 属性の日付にメッセージを送信します。 | 「DueDateは今日」 |
| 明日は | 属性の日付の 1 日前にメッセージを送信します。 | — |
| 昨日だった | 属性の日付から 1 日後にメッセージを送信します。 | — |
外部ソース
外部ソースからのコミュニケーションにユーザーを追加します。
フローAPI
フロー API は、Web ページや CRM システムなどの外部システムから、NTT CPaaS Web インターフェイスで作成したジャーニーにデータを送信します。このエントリーポイントを使用して、外部トリガーに基づいてジャーニーにユーザーを自動的に追加します。例: エンドユーザーが Web ページにフォームを送信したか、CRM システムに新しいエントリがあります。したがって、ウェルカムメッセージ、リードナーチャリング、リマインダーなどのプロセスを自動化できます。
フロー API 経由で変数を転送することもできます。Journey で variable を作成すると、フロー API トリガーで使用できるようになります。
フロー API をエントリーポイントとしてジャーニーを作成するには、次の操作を行います。
-
NTT CPaaS Web インターフェイス (opens in a new tab)で、Automation Studio > ジャーニー に移動します。
-
体験の作成 を選択します。
-
Start from scratch (一から開始) を選択します。
-
External source (外部ソース) > Flow API (フローAPI) の順に選択します。 エントリーポイントには、エンドユーザーのデータが送信される一意の URL が含まれています。
-
ジャーニーに参加者を自動的に追加するには、次のいずれかを実行します。
- 参加者をフローに追加 (opens in a new tab) エンドポイントを使用して、1 つのリクエストで最大 1,000 人の参加者をジャーニーに非同期的に追加します。
- フローに人を追加 (opens in a new tab) (非推奨) エンドポイントを使用して、1 つの要求で 1 人の参加者をジャーニーに追加します。
-
必要に応じて、ジャーニーの残りの部分を構成します。
-
打ち上げ ジャーニー。
手記フローにユーザーを追加 エンドポイントは非推奨になりました。新しい体験を作成するときは、代わりに 参加者をフローに追加 エンドポイントを使用します。
ジャーニーが外部システムからデータを受信すると、次の処理が行われます。
- 顧客プロファイルの既存のプロファイルを更新します。
- 顧客プロファイルに新しい個人プロファイルを作成します。
- そうした新規パーソンをコミュニケーションに追加します。
技術情報については、 API Developer Hub (opens in a new tab) を参照してください。
既存のジャーニー
既存のジャーニー エントリーポイントを ジャーニーに追加 と組み合わせて使用して、強力なモジュール式ジャーニーを構築します。このエントリーポイントは、ユーザーが別のアクティブなジャーニーからジャーニーに参加する最初のステップとして機能します。「ジャーニーに追加」エレメントを持つジャーニーは、このエントリーポイントでジャーニーを作成するときに選択できます。
SFTPインポート
SFTP インポートエントリーポイントは、セキュアファイル転送プロトコル(SFTP)を使用してリモート外部サーバーから csv または tsv データをジャーニーにインポートする場合に使用できます。これは、フロー API を介して外部ソースに接続できない場合に便利なアプローチです。
Journeys とサーバー間の接続が確立されると、SFTP コネクタはサーバー上のターゲットフォルダーを 10 分ごとチェックします。前回のチェック以降にフォルダーに追加した新しいファイルはすべて、ターゲットジャーニーに追加されます。コネクタによってすでに処理されているサーバー内の古いファイルまたは既存のファイルは、フォルダーから変更、削除、または移動されません。
NTT CPaaSは、データを変更することはありません。csv または tsv データはサーバーでホストされるため、常にデータを完全に制御できます。
ジャーニーを作成するときに、外部ソース]、[SFTP インポート エントリーポイントの順に選択します。エントリーポイントのサイドバーメニューでファイルの処理方法を定義します。
| オプション | 説明 |
|---|---|
| SFTPサーバー | 既存のサーバーの中からSFTP接続に使用するサーバーを選択するか、アップロードするファイルをホストするサーバーへのSFTP接続を新規作成します。Create New SFTP Connection (SFTP接続の新規作成)を選択する場合、お使いのサーバーのアドレス、ポートと認証情報を指定する必要があります。接続が成功したかどうかテストして確認し、準備ができたらアクティブ化します。 |
| ファイルパス | フェッチするSFTPサーバー上のファイルへのパスを設定します。個別のフォルダーを使用して、ジャーニーまたは部門ごとにファイルを整理します。 絶対パス ( / で始まる) を使用して、ルート ディレクトリからファイルを読み取ります。相対パス(/なしで始まる)を使用して、SFTPユーザーのホームディレクトリからファイルを読み取ります。 |
| ファイル名パターン (任意) | オプションのファイル名パターンを設定して、命名規則またはパターンのみに従うファイルを抽出し、Journey に挿入します。 次の記号を使用します。 - ワイルドカードアスタリスク * は、記号のシーケンスをマスクします。たとえば、 *.csv はすべての.csvファイルをフェッチします - 疑問符 (?) をクリックして 1 つのシンボルをマスクします。たとえば、 J???Data.csv は、 JuneData.csv ファイルと JulyData.csv ファイルの両方をフェッチします |
| 区切り文字 | ファイル内の値を分割するために使用する区切り文字を選択します。選択した区切り文字は、ファイルで使用されている区切り文字と必ず一致していなければなりません。 ; (セミコロン) | (パイプ) タブ カスタム (いずれかの文字、最大1文字) , (コンマ) |
| 列マッピング | ファイル列をジャーニーの正確な属性/変数にマッピングするのは、システムがファイルがどのように構成されているかを自動的に認識しないためです。 ここに入力する値がファイル内の列名と 完全に一致 していることを確認し、データ型も一致することを確認します。システムは、一致しないデータ型を正しく「読み取る」ことができません。たとえば、日付フィールドで日付時刻データ型を使用すると、ファイルのアップロード時にエラーが表示されることがあります。 次のセクションを使用できます。 - 連絡先情報: 連絡先情報 (電話番号/email アドレス) の列を少なくとも 1 つ持つことが 必須 です。 連絡先情報列の上限は 2 つで、1 列は電話番号用、1 列は電子メール アドレス用です。 csvのエントリの連絡先情報が間違っている場合、エントリは無効としてマークされ、処理されません。 エントリに正しい電話番号と電子メール アドレスの両方が指定されている場合、エントリはコネクタによって処理され、SFTP インポート パフォーマンス レポートで 有効 としてマークされます。 連絡先情報の 1 つが有効で、もう 1 つが無効な場合、エントリはシステムによって 無効 としてマークされ、処理されません。 ただし、連絡先情報の 1 つが有効で、もう 1 つの連絡先情報が 空 の場合 (連絡先情報が提供されていない場合)、エントリ全体が 有効 としてカウントされ、システムによって処理されます。 SFTP インポートのパフォーマンス データは、ジャーニーパフォーマンスの表示の SFTP インポートレポートタブで有効および無効なエントリを含むデータを確認できます。 - 人物属性: Standard/Custom attributes は、パーソナライゼーション/セグメント化のために Journey で使用されます。ここで使用するすべての属性は、インポート前に顧客プロファイルで作成する必要があります。 - 変数: この情報を顧客プロファイル (セッションベースのデータ) に保持しない場合に使用されます。変数は、インポート前にジャーニーで作成する必要があります。 |
インポートスケジュールの例
Jane は 12:00 にFile_Aを Folder1 にアップロードします (現時点では、Folder1 にはこのファイルのみが含まれています)。SFTP コネクタは 12:01 にフォルダーをチェックし、File_A からジャーニーのターゲットジャーニーにデータを送信します。12:02 に、Jane はFile_Bを Folder1 にアップロードします (フォルダー 1 には File_A と File_B が含まれています)。SFTP コネクタは 12:03 にフォルダーを再度チェックし、File_B からターゲットジャーニーにデータを送信します(File_A以前の実行ですでに処理されているため)。
SFTP インポートで作成された新しいエンド ユーザーは、顧客プロファイルに一意の識別子でマークされ、システムへの入り方が示されます。このデータをフィルタリングして、システム内のこれらのエンドユーザーを追跡できます。
アカウントユーザーが SFTP インポートエントリーポイントを含むジャーニーを複製した場合、元のジャーニーで最初にアップロードされたすべてのファイルは、アップロードされた最も古いファイルから始めて新しいジャーニーにアップロードされます。
アップロード履歴は複製プロセスでは保持されないため、新しいジャーニーには元のジャーニーで何が起こったかの記録はありません。新しいジャーニーがアクティブ化されると、すべてのファイルデータが再度追加されます。旅の目的によっては、予期しない結果が生じる可能性があります。これは、以下の警告メッセージで説明されているように、リスクです。
データの一貫性を確保するため、複数のジャーニーで SFTP インポートを介して同じファイルを処理しないでください。技術的には、同じファイルを複数回再利用/インポートすることは可能ですが、1 つのファイル、1 つのジャーニー ポリシーに従ってください。
複数のジャーニーで同じファイルを処理する場合、最初に実行されるジャーニーによって異なるデータ出力が表示される場合があります。
SFTPサーバー接続の管理
SFTPインポートエントリーポイントを開き、SFTP Server (SFTPサーバー) フィールドに移動して、SFTPサーバーへの接続を管理します。
そこから、リストからサーバーを選択し、鉛筆アイコンを選択して接続の編集ウィンドウを展開することで、新しい接続を作成したり、既存の接続を編集したりできます。
編集モードでは、接続を使用しているジャーニーの数を確認できます。データの整合性を確保するため、この接続を使用するすべてのジャーニーが完了するまで、サーバーに加えた編集を保存することはできません。n インスタンスを表示 ボタンを選択して、接続を使用するジャーニーを表示します。
特定の接続に接続されているジャーニーがない場合は、必要に応じて接続を編集できます。すべてが正しく機能することを確認するために、接続をテストすることを忘れないでください。
サーバーを使用しなくなり、接続を削除したい場合は、編集モードで削除することもできます。削除できるのは、アクティブなジャーニーに接続されていない接続のみです。
ジャーニーバージョンの管理
SFTP インポート エントリーポイントを使用する既存またはアクティブなジャーニーに変更を加えるには、ジャーニーの 新しいバージョンを作成 できます。
新しいジャーニーバージョンを起動すると、元のジャーニーバージョンの未処理レコードは新しいジャーニーバージョンに転送されます。
イグジット
ジャーニーの準備ができたら、次のステップは検証です。検証 を選択すると、エラーが報告されていない場合は、ジャーニー内の接続されていない各エレメントの後に 終了 エレメントが自動的に表示されます。IVR （自動音声応答） ジャーニーに関しては、終了エレメントはアクティブなコールを終了します。通話の進行中に通信を検証すると、通話は終了します。
Exit は、特定のコミュニケーション ブランチの顧客数が体験を完了した数を計算するのにも役立ちます。
次の図は、ジャーニーの出口エレメントを示しています。