関数

早期アクセス

メッセージを希望どおりに計画および指示するのに役立つ Journey の要素は、関数と呼ばれます。購入などのイベントが関連するメッセージを送信するのを待機したり、顧客が最初に使用したメッセージのメッセージを確認しない場合に備えてフェイルオーバーチャネルを設定したりできます。

オーディエンスのセグメント化

属性と行動に基づいて視聴者を分割します。たとえば、最近 Web ページをチェックしたさまざまな年齢層の人々に異なるメッセージを送信したい場合、これはまさに セグメントオーディエンス エレメントの目的です。

セグメント化に必要な属性とイベントは、エレメントのサイドパネルで選択します。

使用可能な属性：

Standard (標準) - 事前に定義されている基本的な顧客情報のことです
カスタム - 顧客プロファイルで自分で定義する顧客情報(/customer-profiles/manage-data#custom-attributes)
Contact information (連絡先情報) - メールアドレス、電話番号やこの顧客への連絡に利用できるその他のチャネルのことです
Channel specific (チャネル固有) - 顧客に最後に連絡したのはいつかを示します
計算された属性 - 計算された属性から作成された顧客情報
オブジェクトのリスト 属性 (早期アクセス) - 複数のプロパティを含むリスト。リスト内の一部またはすべての項目が、選択したリストプロパティの特定の値と一致するかどうかに基づいてセグメント化できます。
手記
オブジェクトのリストに基づくセグメンテーションは、クローズドな早期アクセスです。詳細については、NTT CPaaSアカウントマネージャーにお問い合わせください。

属性ごとの演算子：

BOOLEAN (ブーリアン)	TEXT (テキスト)	数	DATE (日付)
is	is	is	is
is not (~ではない)	is not (~ではない)	is not (~ではない)	is not (~ではない)
	contains (~を含む)	less than (~より小さい／少ない)	before (~より前)
	startswith関数	less than or equal (~以下)	until (~迄)
	ends with (~で終わる)	greater than or equal (~以上)	since (~以来)
	is empty (~は空)	greater than (~より大きい／多い)	after (~より後)
	is not empty (~は空でない)	is empty (~は空)	is empty (~は空)
		is not empty (~は空でない)	is not empty (~は空でない)
			will be in (~の時に／の中に)
			will be within (~以内に)
			will be more than (~を上回る)
			was (~であった)
			was within (~以内であった)
			was more than (~を上回った)
			was today (~が今日だった)

属性の仕組みを理解するために、[Segment Audience (オーディエンスのセグメント化)] のサイドパネルで、「age (年齢)」というカスタム属性と「less or equal (以下)」という演算子を選択します。

属性と組み合わせることができるイベントの種類は、以下のとおりです：

External (外部) - ウェブサイトやアプリなど、他のプラットフォームでのアクションに関するイベント
People - プロファイル情報の変更に関するイベント
Channel (チャネル) - メッセージを通じて行うインタラクションに関するイベント
製品イベント - ユーザーがコミュニケーションジャーニーに入退したタイミングに関する情報

People Real-Time Event の記事にアクセスして、各タイプの詳細を確認し、今後のコミュニケーションキャンペーンに含める方法を検討してください。(イベントを待機するトリガーとエレメントは、イベントのみに基づいてコミュニケーションを行う場合に使用され、セグメントオーディエンスエレメントを使用すると、属性とイベントの両方を使用できます。

従って、もしウェブページを閲覧 (外部イベント) した2つの異なる年齢グループ (属性) にメッセージを送信するのであれば、最終的なセットアップは次のようになります：

Wait for an event (イベント待機)

イベントを待機 エレメントは、エンドユーザーがエレメントで構成した特定のアクションを実行するとアクティブになります。これらのアクションは、関連する events を使用して定義できます。エレメントがアクティブ化されると、ジャーニーはエレメントの イベント happened ブランチで指定したアクションを実行します。

例: エンドユーザーが商品ウェブサイトでカートに商品を追加したときにメッセージを送信したいと考えています。イベントを待機するイベントを待機** エレメントに addToCart イベントを追加します。このエレメントの _add からカートhappened_ブランチで、 メッセージSMS送信 エレメントを追加します。エンドユーザーがカートに商品を追加すると、イベントを待機 エレメントがトリガーされ、ジャーニーは SMS メッセージを送信します。

イベントを待機 エレメントは、すでにジャーニーに参加しているエンドユーザーに対してのみトリガーされます。デフォルトでは、このエレメントは、エンドユーザーがジャーニーのこのエレメントに到達したときにのみイベントを考慮します。ジャーニーの早い段階で発生したイベントに対してエレメントをトリガーする場合は、ジャーニーの入り口からのイベントを含める を選択します。

エレメントを通じて追跡されるイベント

このエレメントを通じて追跡できるのは、次のカテゴリのイベントです：

エレメントのユースケース

このエレメントは、エンドユーザーがウェブサイトなどのデジタル資産をどのように操作するか、メッセージにどのように反応するか、プロファイル情報に変更があるかどうかを確認したい時に使用します。

以下にいくつか例を示します。

abandoned cart (カート放置) (opens in a new tab) キャンペーンで、選択した商品がまだカートに入っていることを顧客に知らせたい場合
7日以内に同じアイテムを3回以上表示したエンドユーザーに割引を提供する場合
その他の高度なマルチステップキャンペーンを実施する場合

エレメントの構成

次の手順に従って、エレメントの構成を完了します。

Conditions (条件) セクションで、エレメントをトリガーするイベントを定義します。条件ごとに、関連付けられたブランチがエレメントに追加されます。
(オプション)変数セット セクションで、イベントプロパティをジャーニー変数に保存します。
待機中 セクションで、イベントが発生するまでジャーニーが待機する時間を選択します。
(オプション)旅の入り口からのイベントも含む。

詳細については、次のセクションを参照してください。

条件定義

ジャーニーをトリガーする 1 つ以上の条件を定義します。

各条件で、次の操作を行います。

イベントを選択します。
イベントの演算子と条件を選択します。アクションを実行した顧客またはアクションを実行しなかった顧客のいずれかをターゲットにすることができます。
(任意) イベントにプロパティがある場合は、それらを条件に追加してターゲットにするオーディエンスを絞り込むことができます。

イベントの選択

イベントを選択します。イベントの詳細については、Customer Profiles の Events ドキュメントを参照してください。

選択するイベントを探したい場合、イベント名で検索するか、イベントの種類でフィルタリングすることができます。

手記

カスタムイベントを選択するには、イベントとそのプロパティーを「顧客プロファイル」で定義する必要があります。

演算子の選択

ターゲットとするエンドユーザーを選択します。

発生: アクションを実行したエンドユーザーをターゲットにします。出現回数を設定します。例: イベントが 3 回目に発生したときにジャーニーをトリガーするには、発生回数を 3 回に等しい と指定します。
Not happened (発生しなかった)：アクションを実行しなかったエンドユーザーをターゲットにします。

手記

Not happened 条件を単独で使用しないでください。Happened 条件でのみ使用してください。これは、イベントが発生したときにジャーニーをトリガーすることはできますが、イベントが発生していないときにジャーニーをトリガーできないためです。

例: Event_A が発生し、Event_B が発生しなかった場合のジャーニーをStartします。

条件へのイベントプロパティの追加 (任意)

イベントにプロパティがある場合は、それらを使用して対象ユーザーを絞り込みます。Property (プロパティ) を選択して、1つ以上のプロパティを追加します。

次の図の例では、Item viewed (品目を閲覧) イベントの itemId (品目ID) プロパティがフィルターとして追加されています。

イベントのプロパティをジャーニー変数にマッピングする (オプション)

イベントにプロパティがある場合は、それらをジャーニー変数に保存し、ジャーニーの後半で変数を再利用できます。

例: Appointment booked イベントでは、_Appointment time_や_Appointment name_などのイベントプロパティをジャーニー変数に保存できます。その後、これらの変数を使用して、予定の詳細が記載された確認メッセージをエンドユーザーに送信できます。

マップされた変数の値は、エンドユーザーがジャーニーを移動するにつれて変更される可能性があります。

例： delivery (配信) イベントが次のステージに進むと、_delivery status (配信ステータス)_変数が Pending (保留中) から Dispatched (発送済み) に変わります。

リスト属性をジャーニーに渡すこともできます。詳細については、イベントのリストをジャーニーに渡すドキュメントを参照してください。

変数の作成と使用の詳細については、イベントのプロパティをジャーニー変数にマッピングドキュメントを参照してください。

Waiting (待機中)

ジャーニーがイベントを待機する時間を指定します。

For specific time (特定の時間)：その時間の範囲を指定します。
無期限: 待ち時間は、ジャーニー設定で構成したジャーニースケジュールによって異なります。ジャーニー内のどの要素も 1 年以内にアクティブ化されない場合、ジャーニーは終了します。

ジャーニーの入り口からのイベントを含める(オプション)

デフォルトでは、イベントを待機 エレメントは、エンドユーザーがジャーニーのこのエレメントに到着したときにのみイベントを考慮します。ジャーニーの早い段階で発生したイベントに対してエレメントをトリガーする場合は、ジャーニーの入り口からのイベントを含める を選択します。

このオプションは、ジャーニーがすでに発生したイベントを待機しているためにエンドユーザーがスタックする状況を回避するのに役立ちます。

例: マーケターは、イベントを待つ エレメントを使用して電子メールを追跡するファネルを構築します。このエレメントは、メール送信、メール開封、メールリンククリックの3つのイベントを待機し、それぞれ2日間の待機期間があります。エンドユーザーはメールを開きますが、メールクライアントはプライバシーのために「メールが開封されました」イベントをブロックします。2日後、エンドユーザーは「クリックされたメール」イベントに到達します。しかし、このイベントの待機期間は終わりました。そのため、エンドユーザーはジャーニーを進めることができません。ジャーニーの入り口からのイベントを含める を有効にすると、過去のイベントが考慮され、エンドユーザーは期待どおりにジャーニーを進めます。

手記

条件のすべてのイベントがジャーニーの開始前に既に発生している場合、そのユーザーはジャーニーに参加しません。ただし、ジャーニーが recurrent の場合、ユーザーはこれらのイベントが再び発生した場合にのみジャーニーに参加します。

次のステップ

以下の構成を完了します：

待機期間中にイベントが発生した場合はどうなりますか:ジャーニーの次のステップとして、SMS メッセージなどのエレメントを追加します。
待機期間中にイベントが発生しない場合はどうなりますか:ジャーニーの次のエレメントを追加します。

顧客プロファイルの変更を待つ

イベント発生後にジャーニーに入った人の特定の属性の変更を所定の時間待機する場合は、顧客プロファイルの変更を待機 というエレメントを選択します。

以下を設定します。

ジャーニーが待機する属性の変更
その変更までどれくらいの期間、ジャーニーを待つ必要がありますか
待機期間中に変更が発生した場合はどうするか
待機期間中に変更が起こらなかった場合はどうなるか
このエレメントは、より高度な自動化キャンペーンに役立ちます。

Wait for a Date (日付を待つ)

パーソンのプロファイルから特定の日付／時刻の前、その日時、または後にコミュニケーションを続行するには、Wait for a Date (日付を待つ) エレメントを追加します。

事前に行う必要があるのは、顧客プロファイルプラットフォームを使用して、この「プロファイル情報」をカスタム属性として追加することです。

このエレメント内にはいくつかのオプションがあります：

IS IN: この条件を使用して、ユーザープロファイル内でカスタム属性として設定した日付/時刻の数時間前または数日前に通信を続行します。

たとえば、「TrialExpiryDateTime は 4 時間以内です」とすると、現在の日付/時刻が TrialExpiryDateTime 属性で設定された日付/時刻より 4 時間前の場合、顧客は体験の次のステップに到達します。

WAS: 設定された日付/時刻に達してから経過した時間。たとえば、"TrialExpiryDate was 1 day ago" を設定すると、TrialExpiryDate カスタム属性で設定された日付の 1 日後に顧客を通信の次のステップに移動します。

IS TODAY: カスタム属性で設定されたまさにその日付 (「DueDate is today」) に顧客がコミュニケーションの次のステップに到達したい場合に使用します。

IS TOMORROW: 顧客は、カスタム属性で設定された日付の 1 日前にジャーニーの次のステップに到達します。

WAS YESTERDAY: 顧客は、カスタム属性で設定された日付の 1 日後にジャーニーの次のステップに到達します。

このアクションを毎年実行: このアクションを毎年実行する場合は、このチェックボックスをオンにします (person 属性の年を無視し、定期的なアクションにします)。特定の日付または時刻に基づいて通信を開始することもできます。

Pause (一時停止)

これは、コミュニケーションの旅を特定の時間遅らせるエレメントです。たとえば、ジャーニーから 1 つのメッセージを送信し、別のメッセージを送信する前に待機したいとします。一時停止 を選択し、一時停止の種類とその期間を時間単位 (秒、分、時間、日) とともに選択する必要があります。

一時停止は次の3種類から選択できます：

日や時刻まで一時停止 - 日または時刻のマイルストーンに達するまで一時停止します。たとえば、月曜日の 13:00 まで一時停止します。
一定期間一時停止 - これは、エンドユーザーがジャーニーの一時停止エレメントに接触した後にカウントを開始する一般的な待機期間を設定する場合に便利です。秒、分、時間、日から選択します。たとえば、13:00 まで 3 日間一時停止します。
正確な日時まで一時停止 - これは、既知の時刻に発生したイベントについてエンドユーザーに通知するために、エンドユーザー通信を計画するのに役立ちます。たとえば、休日や予定の前にメッセージを送信します。11月30日13:00まで一時停止など。

一時停止に指定された時間が経過すると、通信ジャーニーの次のエレメント (SMS メッセージなど) がトリガーされます。

一時停止エレメントは、ジャーニーで使用可能なすべての評価要素でも使用できます。

ユーザープロファイルの更新

顧客プロファイルに格納されている顧客標準またはカスタムデータ属性の値を更新および保存するには、更新担当者 プロファイルエレメントを使用します。

Update person profile (パーソンプロファイルを更新) を選択し、右側のパネルで、更新する属性と属性の更新方法を選択します。パーソンプロファイルを値で更新するか、空に設定する (つまり消去する) か、属性に数式を適用するかを選択できます。

値付き を選択した場合、エンドユーザーは静的値を追加するか、顧客プロファイルから別の属性を選択するか、中括弧を使用して変数を選択できます。
数式付きを選択すると、式エディターが開き、式言語を使用して数式を定義できます。
**を空に設定すると、ユーザープロファイル属性のデータは空に設定されます。

プランに関連して顧客が提供するデータは、将来のコミュニケーションキャンペーンに役立つように、顧客プロファイルプラットフォームに保存されます。

タグを追加または削除する

顧客をアクションに基づいてマーキングしたい場合は、タグを使用すると、そうした顧客を、これらのタグに基づいて今後のコミュニケーションに含めることができるようになります。

ジャーニーは、次の 2 つのタグ関連要素をサポートしています。

Add tag (タグの追加)
Remove tag (タグの削除)

この機能の適用方法についてより理解を深めたい場合は、タグをfeedback (フィードバック） (opens in a new tab)にどのように使用できるかについて記述しているドキュメントをご参照ください。

コンタクト停止リストに追加または削除する

エンドユーザーがビジネスからの通信の受信を停止したい場合は、オプトアウトまたは登録を解除できます。連絡先リストに追加 エレメントを使用して、NTT CPaaS アカウントから送信される通信のエンドユーザーの登録を解除します。これらのエンドユーザーは、顧客プロファイルの [連絡先リスト] (/customer-profiles/manage-audience#do-not-contact-list) に追加されます。このリストにある連絡先は、選択した送信者およびチャネルからの通信を受信しません。

これらのエンドユーザーが再びオプトインしたら、Remove from Do not contact list (配信停止リストから削除) エレメントを使用して、配信停止リストから連絡先を削除します。

ジャーニーをデザインする

オプトインまたはオプトアウトが現地の法律や規制、および企業ポリシーに準拠するようにジャーニーを設計します。例: Stop などのインバウンドキーワードを追跡して、連絡先の購読を解除します。

例

Inbound message (インバウンドメッセージ) トリガーまたは Evaluate inbound message (インバウンドメッセージの評価) エレメントを使用して、エンドユーザーのメッセージにオプトインまたはオプトアウトするキーワードが含まれているかどうかを識別します。

次に、ジャーニーの Do not contact listに追加 または Do not contact list から削除 要素を使用して、これらのエンドユーザーを Do not contact リストに追加または削除します。

Add to do not contact list (配信停止リストに追加)

Add to do not contact list (配信停止リストに追加) エレメントを使用すると、他のチャネルや送信者に影響を与えることなく、特定のチャネルの1人以上の送信者からのコミュニケーションをブロックすることができます。

チャネルと、そのチャネルの 1 人以上の送信者を選択します。エンドユーザーがジャーニーのこのエレメントにアクセスすると、エンドユーザーのプロファイルの連絡先情報が、指定したチャネルと送信者の連絡先リストに追加されます。

ブロッキングは次のように機能します：

Channel (チャネル)：メッセージは選択したチャネルでは送信されませんが、他のチャネルでは送信できます。例：エンドユーザーは、メールのみでオファーを受け取り、SMSでは受け取りたくないとします。この場合は、Add to Do not contact list (配信停止リストに追加) エレメントでSMSチャネルを選択します。

Add to Do not contact list (配信停止リストに追加) エレメントで選択できるチャネルは1つだけです。複数のチャネルをブロックするには、チャネルごとに個別のエレメントを使用します。

ブロックするチャネルは、エンドユーザーがお客様への連絡に使用したチャネルと同じである必要はありません。
Senders for the selected channel (選択したチャネルの送信者)：選択した送信者からのメッセージは送信されませんが、同じチャネルの他の送信者からは引き続き送信できます。例：エンドユーザーは、トランザクションに関するメールのみを受信し、プロモーションに関するメールは受信したくないとします。この場合、プロモーションの送信者のみをブロックします。

ブロックは、選択したチャネルの指定された送信者にのみ適用されます。同じ送信者を使用する他のチャネルは影響を受けません。

ジャーニーをデザインする

Add to Do not contact list (配信停止リストに追加) エレメントを使用して追加できるチャネルは1つだけです。複数のチャネルを追加するには、各チャネルに Add to Do not contact list (配信停止リストに追加) エレメントを追加します。

エンドユーザーを配信停止リストに追加するには、次の操作を行います：

連絡先リストに追加 エレメントをジャーニーに追加します。
エレメント内でAdd channel (チャネルを追加) を選択します。
配信停止リストに追加するチャネルを選択します。
選択したチャネルの送信者の中から、配信停止リストに追加したい送信者を選択します。
次のステップを定義します。例：登録解除に成功したことを示すメッセージをエンドユーザーに送信します。

IMPORTANT

連絡先リストに追加 エレメントを使用してオプトアウトを管理したり、メッセージの受信を停止するエンドユーザーを管理したりする場合は、ジャーニーの有効期限が切れないようにします。それ以外の場合、オプトアウトしたエンドユーザーは、ジャーニーの有効期限が切れた後にメッセージを受信します。

ジャーニーの有効期限が切れないように設定するには、[ジャーニー設定 > スケジューリング タブで、ジャーニーの停止 を無効にします。

Remove from do not contact list (配信停止リストから削除)

コミュニケーションのブロックを解除するには、Remove from Do not contact list (配信停止リストから削除) エレメントを使用します。

エンドユーザーをリストから削除するには、次の方法があります。

Simple mode (簡易モード)：このオプションは、他のチャネルや送信者に影響を与えることなく、特定のチャネルで1人以上の送信者からのコミュニケーションのブロックを解除したい時に使用します。

エンドユーザーがジャーニーのこのエレメントにアクセスすると、エンドユーザーの連絡先情報は、指定したチャネルと送信者の Do not contact リストから削除されます。

ブロック解除は次のように機能します：
- Channel (チャネル)。これで、削除したチャネル経由のメッセージを送信できるようになります。リスト内の他のチャネルを通じて送信されるメッセージは引き続きブロックされます。
  
  例：エンドユーザーは、メールのみでオファーを受け取り、SMSでは受け取りたくないとします。この場合、Remove from Do not contact list (配信停止リストから削除) エレメントでメールチャネルを選択します。
  
  Remove from Do not contact list (配信停止リストから削除) エレメントで選択できるチャネルは1つだけです。複数のチャネルのブロックを解除するには、チャネルごとに個別のエレメントを使用します。
  
  削除するチャネルは、エンドユーザーがお客様への連絡に使用したチャネルと同じである必要はありません。
- Senders for the selected channel (選択したチャネルの送信者)：選択した送信者からのメッセージを送信できるようになります。リストにあるこのチャネルの他の送信者からのメッセージは引き続きブロックされます。
  
  例：エンドユーザーは、トランザクションに関するメールのみを受信し、プロモーションに関するメールは受信したくないとします。この場合、トランザクションの送信者のみのブロックを解除します。
  
  ブロック解除は、選択したチャネルの指定された送信者にのみ適用できます。同じ送信者を使用する他のチャネルは影響を受けません。
Advanced mode (詳細モード)：このオプションを使用すると、エンドユーザーの連絡先情報として記録されているすべてのレコード (電話番号および／またはメールアドレス) を配信停止リストから削除します。

IMPORTANT
すべての電話番号ベースのチャネルやメールへのトラフィックのブロックが解除されます。

リストから以下の情報を1つ以上削除できます。
- Phone number (電話番号)。すべての電話番号ベースのチャネルの連絡先情報を一斉に削除します。例：SMS、WhatsApp、Viber。
- Email address (メールアドレス)。メールチャネルの連絡先情報をすべて削除します。
エンドユーザーがジャーニーのこのエレメントにアクセスすると、指定された連絡先情報が [連絡先拒否] リストから削除されます。

IMPORTANT

連絡先リストから削除 エレメントを使用してオプトインを管理したり、メッセージを受信したいエンドユーザーを管理したりする場合は、ジャーニーの有効期限が切れないようにしてください。そうしないと、オプトインしたエンドユーザーは、ジャーニーの有効期限が切れた後、メッセージを受信しません。

ジャーニーの有効期限が切れないように設定するには、[ジャーニー設定 > スケジューリング タブで、ジャーニーの停止 を無効にします。

シンプルモードの体験を設計する

Simple mode (簡易モード) では、Remove from Do not contact list (配信停止リストから削除) エレメントを使用して、1つのチャネルのみを削除できます。複数のチャネルを削除するには、Remove from Do not contact list (配信停止リストから削除) エレメントを削除対象の各チャネルに追加します。

配信停止リストからチャネルを削除するには、次の操作を行います：

連絡先リストから削除 エレメントをジャーニーに追加します。
エレメントで、Simple mode (簡易モード) を有効にします。
Add channel (チャネルを追加) を選択します。
配信停止リストから削除したいチャネルを選択します。
選択したチャネルの送信者の中から、配信停止リストから削除したい送信者を選択します。
(任意) 連絡先情報が配信停止リストから削除された後も、トラフィックの大きな割合がまだブロックされている場合の対処法として、ブランチを追加する方法があります。そうしたい時は、Conditions (条件) を選択します。

このブランチがエレメントに追加されます。
次のステップを定義します。例：エンドユーザーに、正常に登録されたことを知らせるメッセージを送信します。

詳細モードの体験を設計する

エンドユーザーの連絡先情報として記録されているすべてのレコードを配信停止リストから削除するには、次の操作を行います：

連絡先リストから削除 エレメントをジャーニーに追加します。
エレメントで、Simple mode (簡易モード) を無効にします。
次のうち1つ以上を選択します。
- Phone number (電話番号)。すべての電話番号ベースのチャネルの連絡先情報を一斉に削除します。例：SMS、WhatsApp、Viber。
- Email address (メールアドレス)。メールチャネルの連絡先情報をすべて削除します。
次のステップを定義します。例：エンドユーザーに、正常に登録されたことを知らせるメッセージを送信します。

オーディエンスの分割

オーディエンスを分割して、配信したコンテンツに対する反応についてより正確なメトリクスを取得します。Split Audience (オーディエンスの分割) エレメントは特に、次の操作を行う時に有用です。

• 以下の図に示すように、同じメールメッセージの2つのバージョンをテストするなど、簡単な実験を実行します。 • どのチャネル (メール、SMS、プッシュ通知など) が最も効果的かをテストする、より高度な実験を作成します。

社内受信者への通知

ジャーニーの一環として、電子メールまたは SMS 通知を社内のビジネスユニットに送信することが重要な場合があります。たとえば、顧客が商品の返品プロセスを開始したときに、店長、スタッフ、または実店舗に通知したい場合があります。アクションリマインダーを含む確認メールを実店舗に送信したり、特定の操作を行う権限がないことを従業員に通知したりしたい場合があります。これらはすべて、内部受信者に通知するエレメントで行うことができます。

このエレメントは、メッセージの正確な受信者を設定し、ジャーニーの開始のエントリーポイントで定義するのではなく、エレメントでチャネルを選択するため、メールの送信またはSMSチャネルとは異なります。

このエレメントをジャーニーに追加するときに、SMSまたはEメールのどちらを送信するかを選択し、メッセージエディタでメッセージを作成します。電話番号/emailアドレスを手動で入力することで、受信者を定義できます。

電話番号、メールアドレスを手動で入力するか、動的な受信者がいる場合はジャーニー変数を使用して、受信者を定義できます。たとえば、顧客が訪れる店舗によって店長の電話番号が異なる場合などです。

手記

各変数に含めることができる送信先の電話番号またはメールアドレスは1つだけです。

パフォーマンスの追跡

内部受信者に通知エレメントを使用して生成された顧客に関連しないコミュニケーションのパフォーマンスを追跡するには、ジャーニー内のエレメントにカーソルを合わせます。このエレメントの合計エンゲージメントを追跡できます。その他のパフォーマンス指標は近日公開予定です。

変数の更新

変数の更新機能を使用して、事前定義したジャーニー変数の値を更新します。ジャーニーで複数の変数が定義されている場合は、1 つの変数のみを更新するか、複数の変数を同時に更新するかを選択できます。これは、注文ステータスなどのセッション情報を動的にし、ジャーニーの進行(注文から発送、またはキャンセル)に適応させる必要がある場合に特に便利です。

式言語で変数を使用することもできます。変数の更新エレメント内に式を設定するには、変数値フィールドの横にある鉛筆アイコンを選択します。詳細については、「式言語を参照してください。

手記

変数の更新機能は、IVR （自動音声応答）ジャーニー (Voice 通話セッション) では使用できません。

Catalog lookup (カタログ検索)

Catalogs (カタログ) は、カタログを作成できるNTT CPaaSの機能です。例：商品、サービス、ニュースレターや店舗所在地のカタログ

ジャーニーで カタログルックアップ エレメントを使用して、カタログから情報を取得します。このエレメントで、カタログのフィールドをジャーニーの属性と比較します。一致する場合は、カタログから必要な情報を取得します。その後、この情報を使用して、カスタマイズされた情報をエンドユーザーに送信できます。

例: 店舗の場所のリストを含むカタログがあります。エンドユーザーがジャーニーに入ります。カタログルックアップ エレメントを使用して、エンドユーザーのプロファイルの City 属性を Stores カタログの Address フィールドと比較します。都市に一致する店舗を検索し、住所を変数に保存し、その住所をエンドユーザーに送信できます。

エレメントの構成

カタログルックアップ エレメントをジャーニーに追加し、次のフィールドを設定します。

Catalog (カタログ)：Catalogs (カタログ) 内にあるカタログの名前のことです。選択できるのは、既存のアクティブなカタログのみです。

Catalog field (カタログフィールド)：アイテムを確認および取得するために必要なデータテーブル内の列のことです。例： Stores (店舗) 内にあるカタログの Address (住所) フィールド

Operator (演算子)：演算子は、Catalog field (カタログフィールド) の値と Attribute (属性) フィールドを比較します。例： is、is not、starts with、ends with、contains

属性: カタログフィールドでクエリされたアイテムを比較するジャーニーの属性。例:エンドユーザープロファイルのCity属性。

変数 (オプション): 変数を使用して、現在のセッションに関連する情報を一時的に保存します。その後、ジャーニーの後続のステップで変数を使用できます。例: Stores カタログから住所を保存できます。

コールAPI

Call API を使用すると、ジャーニーと外部システム (Web サイトや CRM などの) との間のリアルタイムの対話が可能になります。このエレメントを使用して、サードパーティのシステムまたはデータベースから情報をリクエストし、応答をジャーニー変数に保存します。その後、応答を使用してコミュニケーションをパーソナライズし、コミュニケーションジャーニーをルーティングできます。

エレメントのサイドパネルで、以下のフィールドの構成を完了します。

手記

リスト変数は、Call API (コールAPI) エレメントでは使用できません。

リクエスト

以下のリクエストパラメーターの構成を完了します。

リクエストURL

ジャーニーが通信するサードパーティシステムの URL。サードパーティサービスは、ジャーニーに必要なデータを送受信します。

予約済み文字、安全でない文字や非ASCII文字を含む属性がURLに含まれている場合は、Enable escaping of URL characters (URL文字のエスケープの有効化) を選択します。

Method (メソッド)

APIを呼び出すために使用されるメソッドのことです。各メソッドは、様々なユースケースに使用されます。

以下のいずれかのメソッドを選択します。

POST：呼び出されるAPIは、提出されたリクエストを処理する必要があります。多くの場合、POSTは、サードパーティシステムで新しいエンティティを作成したり、既存のを更新したりするために使用されます。
GET：サードパーティのシステムから情報を取得するために使用されます。
PUT：サードパーティのシステムに情報を保存するために使用されます。
DELETE：サードパーティシステムから情報を削除するために使用します。
PATCH：サードパーティシステムの情報を部分的に変更するために使用されます。

ヘッダ

URLと共に送信する必要があるデータのヘッダーのことです。

データをキーと値の形式で入力します。

例：

ユーザー名：user1
パスワード：password123

デフォルトでは、ヘッダーは空です。但し、ほとんどのウェブフレームワークとサービスでは、リクエストを正しく処理するためにリクエストに content-type ヘッダーが必要です。そのため、ヘッダーを含めることをお勧めします。

例： JSON 形式でデータを送信する場合は、Key (キー) としてContent-type、Value (値) としてapplication/json を含むヘッダーを追加します。

体

URLと共に送信する必要があるデータの本文のことです。

データは、次のいずれかの形式で入力できます。

Key-Value format (キーと値の形式)：例 - 名前：Tom、または外部ユーザーID
JSON format (JSON 形式)：例 - {'name': 'Tom'} この形式は、次の型をサポートしています。
- JSON：デフォルトでは、データはJSONとして送信されます。
- URL encoded form (URLエンコード形式)：この形式でデータを送信するには、Key (キー) としてContent-type を、Value (値) として application/x-www-form-urlencoded を含むヘッダーを追加します。

各APIコールの認証

各コールを認証するには、次の操作を行います。

Header (ヘッダー) に、ユーザー名とパスワードを入力します。
本文で、API 呼び出しに含める各エンドユーザープロファイルの外部 ID を渡します。これにより、サードパーティシステムは、どのエンドユーザーのデータを保存または取得する必要があるかを知ることができます。エンドユーザープロファイルの外部 ID は、顧客プロファイルに保存されます。

Response (応答)

次の応答パラメーターの構成を完了します。

Wait until response is received (応答が受信されるまで待機)

応答を受信した後にのみジャーニーの次のステップをアクティブ化する場合は、このオプションを有効にします。

手記

他の応答パラメーターを構成する時も、このフィールドを有効にする必要があります。

Response header variable (応答ヘッダー変数)

サーバーが、ステータス行に配置できない応答に関する追加情報を渡すことができるようにします。ヘッダーのフィールドでは、サーバーに関する情報やRequest-URI によって識別されたリソースへの更なるアクセスに関する情報が提供されます。

Response body variable (応答本文変数)

外部システムから受信した API データをジャーニー変数に保存し、ジャーニーの残りの部分で使用できます。

次のいずれかの方法でジャーニー変数に保存できます。

JSONパス
応答の本文全体を保存する

JSONパスを保存する

データを変数に保存するには、次の操作を行います：

Body response (本文応答) フィールドで、JSONパス を選択します。
データを変数に保存するには、_$. loyalty_points_などのJSONパス式を入力します。パスは1つの値を指す必要があります。値が配列またはオブジェクトの場合、エラーと見なされ、変数は NULL に設定されます。
変数フィールドで、ジャーニー変数を選択します。

応答の本文全体を保存する

本文全体は、テキストまたはファイルタイプのジャーニー変数にのみ保存できます。

Body response (本文応答) フィールドで、Whole body (本文全体) を選択します。
変数フィールドで、ジャーニー変数を選択します。
ジャーニー変数のタイプが ファイル の場合は、ファイル名 とその拡張子を追加します。

ステータスコードの処理方法

応答が受信されたかどうか、および応答ステータスコードに基づいて、ジャーニーを分岐できます。必要なステータスコードを選択します。ステータスコードごとに、呼び出し API エレメントにブランチが追加されます。各ブランチに対して実行するアクションを指定します。

応答ステータスコードには、次の種類があります。

On success (成功時) - 終了：2XXエラーの場合。アクションは必要ありません。
On error (エラー時) - 終了：エラーが発生した場合。
All client error codes (全クライアントのエラーコード) - 終了： 4XXエラーの場合。
Server error codes (サーバーのエラーコード) - 終了：5XXエラーの場合。

スケジュール設定

スケジュール設定オプションは、データ交換の合理化に役立ちます。スケジュール設定を開始するには、Scheduling (スケジュール設定) タブで以下の機能を1つ以上有効にします。

Delivery time window (配信時間枠)

ジャーニーがサードパーティシステムと通信する期間を設定します。

詳細については、配信時間枠のドキュメントを参照してください。

Define message sending speed (メッセージ送信速度の定義)

特定の期間内に配信したいメッセージの数を指定します。

詳細については、メッセージ送信速度ドキュメントを参照してください。

IVR (音声自動応答)概要