イベント

イベントとは、エンドユーザーがブランドとやり取りする時に実行するアクティビティのことです。

例：

メール内のリンクを開く
アプリでカートに品目を追加する
ウェブサイト上のフォームで電話番号を更新する。

エンドユーザーがアクションを実行すると、そのアクションに関する情報がイベントとして People に保存されます。

例：エンドユーザーがリンクを通じてやり取りする際に、次の情報を People に保存できます。

アクションの種類 (クリックまたは開く)
アクションのソース (ウェブページまたはアプリ)
アクションを実行した時刻
リンクがクリックされたウェブページ

その後、この情報を様々な方法で使用できます。例：イベントが発生した時にエンドユーザーにメッセージを送信、ウェブにアクセスしたエンドユーザーの数を分析など。

イベントを表示するには、エンドユーザーのプロファイルページのAttributes, Tags and Events (属性、タグ、イベント) タブに移動します。

イベントの使用方法

次に、イベントの使用方法の例を示します。

イベントデータを使用してエンドユーザーをフォローアップします。例：エンドユーザーがカート内の品目を放棄すると、放棄されたカートイベントがログに記録されます。サポートが必要かどうかを尋ねるフォローアップメールを送信します。
イベントデータの分析を通じて、エンドユーザーの行動パターンを理解します。
イベントデータを使用して、エンドユーザーに関連商品を推奨します。例：エンドユーザーが携帯電話を購入した場合、品目購入イベントがログに記録されます。モバイルバッテリーやイヤホンなどのアクセサリーをエンドユーザーに勧めす。
イベントデータを使用してオーディエンスをセグメント化します。例：ウェブサイトで特定の商品を閲覧するエンドユーザーにのみフォローアップメールを送信します。
イベントを使用して、エンドユーザーにメッセージをパーソナライズします。
計算属性にイベントを使用します。イベント集計というイベントデータで計算を行うと、プロファイルスコアリングを実行する時にプロファイルを評価できます。

イベントの種類

イベントには次の種類があります。

Custom events (カスタムイベント)：これらは、ウェブサイト、モバイルアプリ、その他のプラットフォームやアプリケーションなどのデジタルアセットのユーザーアクティビティを追跡するためにPeopleで作成するイベントです。カスタムイベントは、お客様のビジネスにだけ適用する固有のイベントです。
Template events (テンプレートイベント)：これらは、イベントプロパティが事前に入力されているイベント用テンプレートのことで、e コマースなどの一般的なユースケースに合わせてカスタマイズして使用できます。
Standard events (標準イベント)：これらは、次のような状況が発生する際に起きる事前定義されたイベントのことです。
- Moments、Conversations、Answersなどの NTTCPaaS 製品を通じてエンドユーザーと通信する際。
- パーソンプロファイル (属性、宛先またはタグ) を更新する際。
標準イベントには、Peopleイベント、チャネルイベント、製品イベント が含まれます。

カスタムイベント

これらは、ウェブサイト、モバイルアプリ、その他のプラットフォームやアプリケーションなどのデジタルアセットのユーザーアクティビティを追跡するためにPeopleで作成するイベントです。カスタムイベントは、お客様のビジネスにだけ適用する固有のイベントです。

カスタムイベントの作成

NTT CPaaSのWebインターフェース (opens in a new tab) で、People > Events (イベント) > Custom events (カスタムイベント) タブに移動します。
Create event (イベントの作成) を選択します。
Event name (イベント名) フィールドに、イベントの名前を入力します。例：AddedToCart。
Event ID (イベントID) が一意であることを確認します。このフィールドはイベント名に基づいて自動的に入力されます。このIDは、NTT CPaaS APIやSDKを通じてイベントを追跡する時に使用します。
(任意) Description (説明) フィールドに、イベントの説明を入力します。
(任意) プロパティを必要な数だけ作成します。

イベントにプロパティを追加するには、次の操作を行います。
1. Add event property (イベントプロパティの追加) を選択します。
2. Name (名前) フィールドで、プロパティの名前を指定します。名前は、次の基準に従う必要があります：
  - 英数字
  - 小文字のアルファベットで始まる必要があります。
  - 最大128文字まで入力できます。
3. Type (タイプ) フィールドで、プロパティのデータ型を選択します。
プロパティのデータ型とイベントプロパティの詳細については、イベントプロパティのドキュメントをご参照ください。

イベントプロパティ

イベントプロパティを使用すると、イベントに新たな情報を追加できます。

次の表に、いくつかの例を示します。

Event (イベント)	Properties (プロパティ)
Item Added to Cart (カートに追加された品目)	Item Name (品目名) Item Price (品目価格)
Form Filled Out (記入されたフォーム)	Fields Filled (入力されたフィールド)
Flight Tickets Purchased (購入した航空券)	Travel Type (旅行の種類)
サポートチケットのクローズ	Ticket Id (チケットID) Closure Date (クローズ日)

プロパティのデータ型

イベントプロパティには、次のデータ型を指定できます。

データ型	Description (説明)	仕様
Text (テキスト)	テキスト形式のプロパティに使用します。例：productName (商品名) と productDescription (商品説明)。	プロパティ値には、最大1,500文字を含めることができます。
True/False (真／偽)	True (真)またはFalse (偽)値を含むブール型プロパティに使用します。
Date (日付)	日付値を含むプロパティに使用します。
Number (番号)	数値形式のプロパティに使用します。例：productPrice (商品価格)
List (リスト)	リストをプロパティとして追加します。例：エンドユーザーのショッピングカートに関する情報をウェブサイトからMomentsのフローに渡すには、List (リスト) 型のcartItems (カート内の品目)プロパティを作成します。このプロパティに、item name (品目名)、item ID (品目ID)、quantity (数量)、price (価格)などのフィールドを追加します。	イベントには、最大1つのList (リスト) プロパティを追加できます。 List (リスト) プロパティには、最大128個のフィールドを追加できます。

プロパティの例

次の表に、プロパティの例を示します。

Test send an event (イベントのテスト送信)

NTT CPaaSのWebインターフェース (opens in a new tab) で、People > Events (イベント) > Web SDK タブに移動します。
Try it out (トライアウト) セクションで、イベントとそれに関連するパーソンプロファイルを選択します。
Send event (イベントの送信) を選択します。

イベントがユーザーのプロファイルページに追加されます。

現在、テストイベントでリストプロパティの値を設定することはできません。

プラットフォーム上のカスタムイベントのトラッキング

カスタムイベントは、次の方法で追跡できます。

ウェブSDK
API
モバイルSDK

ウェブSDK

Web SDKを使用すると、ウェブサイトからイベントをキャプチャできます。Web SDKコードをウェブサイトに追加し、それを使用してカスタムイベントをトラッキングする方法については、ガイドラインおよびWeb SDKドキュメントをご参照ください。

イベントAPI

APIは、他のシステムからNTT CPaaSにイベントを送信する安全な方法と考えられています。

APIを使用すると、Peopleに既に存在するユーザーIDのイベントのみを送信できます。Peopleに存在しないユーザー識別子のイベントを送信すると、エラーが発生します。

実装の詳細については、ガイドラインおよび開発者ガイド (opens in a new tab)をご参照ください。

モバイルSDK

モバイルアプリからイベントをキャプチャするにはモバイルSDKを使用します。

次のタイプのイベントをキャプチャできます。

Standard app events (標準アプリイベント) は、モバイルアプリにモバイルSDKが実装されているすべてのMomentsユーザーに対して有効になります。これらのイベントを追跡するために追加のアクションを実行する必要はありません。例：アプリケーションがインストールされました。

利用可能なモバイルアプリイベントの一覧については、Channel Events (チャネルイベント) セクションをご参照ください。
Custom events (カスタムイベント) は、エンドユーザーのアクティビティを追跡するために作成および構成するイベントです。モバイルSDKを使用してカスタムイベントを追跡できます。例：エンドユーザーがショッピングカートに品目を追加したり、購入したり、オンボーディングプロセスのステップを完了したりする時に、モバイルSDKを使ってカスタムイベントを送信します。

モバイルイベントトラッキングのセットアップ方法については、以下をご参照ください。

Note

モバイルSDKでは、イベントのトラッキングリストプロパティはサポートされていません。詳細については、NTT CPaaS アカウントマネージャーにお問い合わせください。

ガイドライン

カスタムイベントがWeb SDKまたはイベントAPIへのコールを介して送信される場合、イベントとイベントスキーマの間に1対1のマッピングが必要です。

以下のガイドラインが適用されます。

コールにスキーマで定義されているよりも多くのプロパティが含まれている場合、そのコールは拒否されます。
コールに含まれるプロパティがスキーマで定義されている数よりも少ない場合、コールに含まれていないプロパティのイベントの値はNULLになります。
スキーマと一致しないプロパティがコールに含まれている場合、そのコールは拒否されます。例：イベントスキーマのプロパティは大文字ですが、イベントコールのプロパティは小文字です。
プロパティ値が文字列の場合は、引用符で囲んで追加します。そうでない場合は、引用符を使用しないでください。
イベントにプロパティがない場合でも、JSON 本文を送信する必要があります。この場合、空のJSON本文を送信します。例：{{}}

Template Events (テンプレートイベント)

イベントテンプレートにはイベントプロパティが予め入力されており、カスタマイズしてeコマースなどの一般的なユースケースで使用できます。

テンプレートには、必須フィールドと省略可能なプロパティの両方が含まれています。

次の表に、テンプレートイベントの一覧を示します。このイベントテンプレートの一覧をWebインターフェイスで表示するには、People > Events (イベント) > Template events (テンプレートイベント) タブに移動します。

Template name (テンプレート名)	Purpose (目的)	Properties (プロパティ)
itemViewed (閲覧した品目)	このイベントには、プロファイルによって閲覧された品目の詳細が表示されます。	itemID (品目ID)：数値。必須 duration (期間)：数値。任意
itemPurchased (購入した品目)	このイベントには、プロファイルによって行われた購入の詳細が表示されます。	itemID (品目ID)：数値。必須 amount (金額)：数値。任意 price (価格)：数値。任意 profit (利益)：：数値。任意
ratingAdded (追加された評価)	このイベントは、プロファイルが品目に与えた評価を示します。	itemID (品目ID)：数値。必須 rating (評価)： 10進数。任意
addedToCart (カートに追加)	このイベントには、プロファイルがカートに追加した品目の詳細が表示されます。	itemID (品目ID)：数値。必須 amount (金額)：数値。任意 price (価格)：数値。任意
addedToFavourites (お気に入りに追加)	このイベントは、特定の品目がプロファイルによってブックマークされたことを示します。	itemID (品目ID)：数値。必須
viewPortionSet (一部分の閲覧)	このイベントは、セッション中にプロファイルがビデオや記事など、品目を部分的に閲覧したことを示します。	itemID (品目ID)：数値。必須 portion (一部分)： 10進数。任意* sessionID (セッションID)：文字列。任意** * Portion (一部分)は、品目を部分的に閲覧したことを示します。これは、0.0 (品目を全く閲覧していない) から 1.0 (品目をすべて閲覧した) までの数値で示されます。閲覧した部分は、品目が表示された位置によって異なります。例：エンドユーザーが50％の段階でビデオを開いたものの、10%しか視聴しなかった場合、Portion (一部分) として示される数値は0.6ではなく 0.1になります。エンドユーザーが品目を閲覧したセッションID。デフォルト値は null** です。

Standard Events (標準イベント)

標準イベントは、エンドユーザーが Moments、Conversations、Answers などの NTTCPaaS 製品を介してお客様のサービスとやりとりする際に生成されます。

これらのイベントは、これらの商品のイベントをサポートするすべてのエレメントで使用できます。例：Momentsでは、トリガーなどのエレメントでイベントを使用できます。

標準イベントを有効または無効にする

NTT CPaaS 製品でイベントを使用するには、People でイベントを有効にする必要があります。

イベントを有効または無効にするには、次の操作を行います。

NTT CPaaSのWebインターフェース (opens in a new tab) で、People > Events (イベント) に移動します。
必要なイベントカテゴリー (People events (Peopleイベント) または Product events (製品イベント)) に移動します。
イベントを追跡するには、イベントの横にあるチェックボックスをオンにします。
イベントの追跡を停止するには、イベントの横にあるチェックボックスの選択を解除します。
変更を保存するには、[イベントのアクティブ化] を選択します。

製品イベント を有効にすると、イベントに基づいてプロファイルが自動的に作成されます。これらのイベントは、このオプションに同意した場合にのみアクティブ化できます。

標準イベントの種類

標準イベントには、次の種類のイベントが含まれます：

People Events (Peopleイベント)

Peopleイベントは、パーソンプロファイルに変更があった時にトリガーされます。変更は次のいずれかになります。

Person activity (パーソンアクティビティ)：エンドユーザーによって実行されるアクティビティのことです。例：ログイン。
Standard attributes (標準属性)：標準属性への変更。
カスタム属性：カスタム属性への変更。

これらのプロファイルの更新に基づいてパーソナライズされたメッセージを作成できます。

Person activity (パーソンアクティビティ)

パーソンアクティビティイベントのユースケース

Track anonymous visitor website visits (ウェブサイトを訪れた匿名ビジターの追跡)：匿名ビジターからリードや顧客へのコンバージョンに至るまでのエンドユーザーのジャーニーを追跡します。
Targeted offering (ターゲットを絞ったオファリング)：あるパーソンが月に5回、お客様の*mortgage (住宅ローン)*ページを訪れた場合、提供している住宅ローンに関する詳細情報やアドバイスを記したメールをそのパーソンに送信します。
Promotional code for a specific category (特定カテゴリーのプロモーションコード)：エンドユーザーが1週間以内に*Shoes (靴)*ページを3回閲覧した場合、靴のプロモーションコードを記載したメッセージを送信します。
Reactivation (再アクティブ化)：過去45日間にウェブページにアクセスしていないエンドユーザーを対象に含む再アクティブ化キャンペーンを開始します。
Abandoned cart (放棄されたカート)：エンドユーザーが*Search tickets (チケットの検索)ページにアクセスし、そこからSelect ticket (チケットの選択)*ページに移動した後、*Checkout (チェックアウト)*ページには移動していない場合にコミュニケーションを送信します。
Survey for active customers (アクティブな顧客向けのアンケート)： 30日間で100ページビューを超えたエンドユーザーに対して、アンケートを送信します。

ウェブサイトでのパーソンアクティビティイベントのトラッキング

ウェブサイトでの Person activity (パーソンアクティビティ) イベントを追跡するには、JavaScript ベースの Web SDKをウェブサイトに追加します。詳細については、Web SDKをご参照ください。

パーソンアクティビティイベントの種類

Session started (セッション開始)
Page view (ページビュー)
Session ended (セッション終了)
Person created (作成されたパーソン)
Person merged (マージされたパーソン)

Session started (セッション開始)

このイベントは、エンドユーザーがウェブサイトにアクセスした時にログに記録されます。

各Session started (セッション開始) イベントには、Web SDK によって自動的に入力される次のプロパティが含まれています。

Property (プロパティ)	説明
Session ID (セッションID)	Unique session identifier (一意のセッション識別子)
Session start (セッション開始)	セッションが開始された時刻を表示します。形式は DD/MM/YYYY HH:MM:ssです。
Session type (セッションの種類)	Web
UTMパラメーター	utm_source utm_medium utm_campaign utm_term utm_content もしセッションの種類がWebで、ページリクエストに UTMタグが設定されていない場合、utm_sourceはdirectに設定されます。

Page view (ページビュー)

このイベントは、エンドユーザーがウェブページを表示した時にログに記録されます。このイベントを使用して、これらのビューに基づいてエンドユーザーを引き付けます。例：お客様の靴ページを週に3 回閲覧したエンドユーザーに対して、靴のプロモーションコードを記載したメッセージを送信します。

各Page view (ページビュー) イベントには、Web SDK によって自動的に入力される次のプロパティが含まれています。

Property (プロパティ)	種類	説明
pageTitle (ページタイトル)	文字列	現在のページのタイトルを表示します。
URL	文字列	ページビュー用に読み込まれたページのURLです。このプロパティ値には、最大 1,500 文字を含めることができます。URL がこの制限を超えると、プロパティ値は 1,500 文字に切り捨てられます。
ドメイン	文字列	リクエストURLのドメイン部分を表示します。
パス	文字列	URLのパス部分を表示します。この値の先頭文字は、スラッシュ (/) にする必要があります。
deviceType (デバイスの種類)	文字列	ページの読み込みに使用されるデバイスの種類を表示します。このプロパティには、次の値を指定できます。 unknown (不明) mobile (モバイル) tablet ()錠剤 desktop (デスクトップ) spider (スパイダー) TV (テレビ) console (コンソール)
timestamp (タイムスタンプ)	DateTime (日時)	インタラクションが発生した時刻 (日、時、分、秒) を表示します。
browserName (ブラウザ名)	文字列	ブラウザ名 (Chrome、Firefoxなど) を表示します。この情報は、HTTPリクエストのUser-Agentヘッダーから取得されます。
browserVersion (ブラウザバージョン)	文字列	報告されたブラウザのソフトウェアバージョンを表示します。この情報は、HTTPリクエストのUser-Agentヘッダーから取得されます。
browserOS (ブラウザOS)	文字列	ブラウザが実行されているオペレーティングシステムを表示します。例：Windows または Linux。この情報は、HTTPリクエストのUser-Agentヘッダーから取得されます。
referrer (リファラー)	文字列	リファラーHTTPリクエストヘッダーには、リクエストを行うページの絶対アドレスまたは部分アドレスが含まれています。
browserLanguage (ブラウザ言語)	文字列	ブラウザの言語を表示します。
websiteLanguage (ウェブサイト言語)	文字列	ウェブサイトの言語を表示します。

Session ended (セッション終了)

このイベントは、エンドユーザーがウェブサイトでアクティブでなくなった時にログに記録されます。

各セッション終了イベントには、Web SDK によって自動的に入力される次のプロパティが含まれています。

Property (プロパティ)	説明
Session ID (セッションID)	Unique session identifier (一意のセッション識別子)
Session End (セッション終了)	セッションが終了した時刻を表示します。形式は DD/MM/YYYY HH:MM:ss です。
Session Length (セッションの長さ)	セッションの長さをセッション終了 - セッション開始で表示します。秒数で表示されます。
Session Type (セッションの種類)	Web
UTMパラメーター	utm_source utm_medium utm_campaign utm_term utm_content もしセッションの種類がWebで、ページリクエストに UTMタグが設定されていない場合、utm_sourceはdirectに設定されます。

Person created (作成されたパーソン)

このイベントは、パーソンプロファイルが作成された時にログに記録されます。

Person Merged (マージされたパーソン)

このイベントは、パーソンプロファイルがマージされた時にログに記録されます。

Standard Attributes (標準属性)

プロファイルの標準属性への変更を追跡します。

次の標準属性を追跡できます。

Name changes in person profile (パーソンプロファイルの名前の変更)：変更されたパーソンのファーストネーム、ミドルネーム、ラストネームを追跡できます。
Location changes in person profile (パーソンプロファイルの場所の変更)：変更された住所、市区町村、国を追跡できます。
Other changes in person profile (パーソンプロファイルのその他の変更)：例：生年月日。
Tag changes (タグの変更)：プロファイルに追加、またはプロファイルから削除されたタグを追跡できます。
Contact information (連絡先情報)：その人と連絡を取ることができるチャネルの追加または削除。

Contact information (連絡先情報)

パーソンプロファイルでは、次の連絡先情報イベントを使用できます。

Contact information (連絡先情報) の種類	イベント
メール	メールアドレスの追加メールアドレスの変更メールアドレスの削除
プッシュ通知	プッシュ通知連絡先の追加プッシュ通知連絡先の変更プッシュ通知連絡先の削除これらのプッシュ通知先イベントは、モバイルアプリでのエンドユーザーのアクティビティに関する情報を提供します。これらのイベントはモバイルSDKによって生成され、Peopleのパーソンプロファイルに表示されます。
Facebook	Facebookの連絡先の追加 Facebookの連絡先の変更 Facebookの連絡先の削除
SMS/Voice/MMS	電話番号の追加電話番号の変更電話番号の削除
その他の連絡先情報	連絡先情報の変更

Custom Attributes (カスタム属性)

プロファイルのカスタム属性への変更を追跡します。

備考

People のユーザーインターフェイスの煩雑さを最小限に抑えるには、使用する予定のない属性を含めないようにします。

Channel Events (チャネルイベント)

これらは、エンドユーザーとのコミュニケーションに使用されるチャネル固有のイベントです。チャネルイベントは、メッセージのステータスやメッセージに対する顧客の反応を追跡したい時などに使用します。

デフォルトでは、すべてのチャネルイベントがアクティブです。そのため、構成中に変更を加える必要はありません。

次の表は、チャネルでサポートされるイベントを示しています。

チャネル	Event name (イベント名)
メール	Sent (送信) Delivered (配信) Opened (開封) Clicked (クリック) Unsubscribed (登録解除) Complained (苦情)
Mobile push (モバイルプッシュ通知)	Sent (送信) Delivered (配信) Opened (開封)
In-app message (アプリ内メッセージ)	Sent (送信) Delivered (配信) Seen (既読) Clicked (クリック)
SMS	Sent (送信) Delivered (配信) Clicked (クリック)
WhatsApp	Sent (送信) Delivered (配信) Opened (開封) Clicked (クリック)
Viber	Sent (送信) Delivered (配信) Opened (開封) Clicked (クリック)
Messenger	Sent (送信) Delivered (配信) Opened (開封) Clicked (クリック)
モバイルアプリ	Personalize (パーソナライズ) Depersonalize (非パーソナライズ) Install (インストール) Uninstall (アンインストール) App Launch (アプリの起動)
Voice	Voice Call Initiated (Voiceコール開始) Voice Call Answered (Voiceコール応答) Voice Call Not Answered (Voiceコール未応答) Voice Busy (Voiceビジー) Voice Call Answered By Machine (Voiceコール留守電応答) Voice Inbound Call Answered (Voiceインバウンドコール応答) Call Forwarded Busy (転送コールビジー) Call Forwarded Not Answered (転送コール未応答) Voice IVR Played (Voice IVR再生） Voice IVR Information collected (Voice IVR情報収集) Voice User Hang Up (Voiceユーザー通話終了)
LINE	Sent (送信) Link Clicked (リンクをクリック)
MMS	Sent (送信) Delivered (配信)

Product Events (製品イベント)

これらのイベントは特定の Infobip 製品用であり、People でエンドユーザーのユーザープロファイルに追加されます。

瞬間

次の表は、Moments の製品イベントを示しています。これらのイベントは、顧客の属性とアクティビティに基づいて、設定に従って発生します。

出来事	説明
入力されたフロー	人がフローに入りました。
フローが終了しました	人がフローを出ました。
フローエントリが拒否されました	ネットワークの問題など、さまざまな理由でフローに入ることができませんでした。

答え

次の表は、Answers の製品イベントを示しています。

出来事	説明
Answers セッションが開始しました	チャットボットとのセッションが開始されました。
Answers セッションが終了しました	チャットボットとのセッションが終了しました。
Answers セッション Start が失敗しました	ネットワークの問題など、さまざまな理由により、Answersセッションが開始されませんでした。

会話

次の表は、Conversations の製品イベントを示しています。

出来事	説明
作成された会話	会話が始まりました。
会話終了	会話が終わった。

フォーム

フォームに対して処理ルールが有効になっている場合は、フォーム送信 イベントを追跡できます。その後、この情報を使用して、要求された情報をフォーム送信者に送信できます。

イベントによるメッセージのパーソナライズ化

アプリのイベントを使用してエンドユーザーへのメッセージをパーソナライズする方法の例を次に示します。

Peopleで、使用する既存のイベントを特定するか、カスタムイベントの作成のいずれかを行います。
アプリにイベントを統合します。これで、アプリからNTT CPaaSプラットフォームにイベントを送信できるようになります。
Momentsで、イベントによってトリガーされるフローを作成します。
フロー変数にイベントのデータをマッピングします。
フロー変数を使用して、エンドユーザーに送信するメッセージをパーソナライズします。

イベントによるオーディエンスのセグメント化

イベントを使用して、エンドユーザーの行動に基づいてオーディエンスのセグメントを作成します。その後、セグメントに基づいてコミュニケーションを整理できるようになります。例：イベントに基づいてメッセージを送信するか、エンドユーザーがコンタクトセンターに電話した回数を確認するかを決定できます。

セグメントは、PeopleのSegments (セグメント) ページで作成できます。セグメントを作成する際、イベントと属性を組み合わせると、より関連性の高いセグメント化が可能になります。

備考

現在、List (リスト) を使ったイベントプロパティのセグメント化はサポートされていません。

次の例では、属性として Country (国)、イベントとしてタグ追加が選択されています。

Momentsでのイベントの活用法

Momentsでは、イベントをPeopleリアルタイムイベントトリガーとイベント待機エレメントで使用できます。

備考

標準イベントを追跡するには、Peopleでイベントを有効にする必要があります。

現在、List (リスト) を使ったイベントプロパティのセグメント化はサポートされていません。

Peopleリアルタイムイベントトリガー

People で以前に定義したカスタムイベント、または事前定義された (標準) イベントに基づいて、フローキャンペーンをトリガーします。

例：カートに品目を追加するすべてのエンドユーザーにメッセージを送信するには、コミュニケーションフローで、People real-time event (People リアルタイムイベント) トリガーと品目を*Added to Cart (カートに追加)*するカスタムイベントを使用します。

Use events in People real-time event trigger

イベント待機エレメント

コミュニケーションフローの後の段階でイベントを使用する場合は、Wait for event (イベント待機] エレメントを使用します。

例：Wait for event (イベント待機) エレメントで、Checkout Finished (チェックアウト完了) を待機イベントとして選択します。このエレメントがこのイベントの発生まで待機する時間を入力します。

Peopleアナリティクスでのイベントの活用法

イベントは、以下の分析に使用できます。

[Events Segmentation (イベントのセグメント化)(./analytics#events-segmentation-analytics)：イベントを使用して、分析したいオーディエンスのセグメントを作成します。
[Funnel Analytics (ファネルアナリティクス)(./analytics#funnel-analytics)：ファネルのステップとして使用するイベントを選択します。

例：ファネルアナリティクスを選択し、使用する標準イベントを選択します。

外部システムでのイベントの活用法

外部システムでイベントデータを使用するには、 People API (opens in a new tab)を通じてイベントをAmazon Web Services (AWS) S3バケットに圧縮ファイルとしてエクスポートします。

イベントエクスポートAPI (opens in a new tab) を使用して、次の操作を行います。

プロセス

AWS S3バケットのセットアップ

AWS S3バケットのセットアップ方法については、Amazon AWSドキュメント (opens in a new tab) をご参照ください。

S3 バケットのアクセスパーミッションのセットアップ

AWS Identity and Access Management (IAM) を使って、イベントエクスポートアプリケーションが S3バケットにアクセスするために使用するロールを作成します。

このロールには、以下のポリシーが必要です：

S3 バケットへのアクセスを許可する S3 アクセスポリシー。
イベントエクスポートアプリケーションのユーザーがAWS Security Token Service (AWSセキュリティトークンサービス)を使用して一時セッションを取得できるようにする信頼ポリシー。このコードは、NTT CPaaSのWebインターフェースのEvents Export (イベントエクスポート) (opens in a new tab)ページから取得できます。

必要なパーミッションを設定すると、S3バケットはNTT CPaaSからエクスポートされたファイルを受け入れる準備が整います。

イベントのエクスポート

エクスポートイベントリクエストの送信 (opens in a new tab)で定義されているスキーマに従って、エクスポートイベントリクエストを送信します。

リクエストが完了すると、イベントを含むファイルが指定されたS3バケットにエクスポートされます。ファイルを保存するS3バケットのディレクトリパスを指定できます。

各ファイルは .gzip 形式に圧縮されます。ファイル名の形式は
<requestid>-events-<starttime(yyyymmddhhmmsssss)>-<endtime(yyyymmddhhmmsssss)>.json.gz</endtime(yyyymmddhhmmsss)></starttime(yyyymmddhhmmsssss)></requestid>.

ファイルが圧縮解除されると、最大 50,000 行が含まれます。各行には、JSON 形式のイベントが1つ含まれています。

イベントスキーマ

各イベントには、次のフィールドがあります。

すべてのイベントに存在する必須フィールド。
各イベントに固有の追加プロパティ。

必須フィールド

フィールド名	値の形式	例	備考
definitionId (定義ID)	文字列	personEnteredFlow (フローに入ったパーソン)	イベントの定義 (種類) を表示します。詳細については、イベント定義の一覧取得 (opens in a new tab)エンドポイントをご参照ください。
eventId (イベント ID)	文字列	fent_100000000270199_1_1647967373262	イベントの一意のIDを表示します。
sessionId (セッションID)	文字列	61bc52b9ba3ae43407dbb246	People Web SDK を使用して追跡されるイベント用ウェブセッションの一意のIDです。それ以外の場合、この値はNULLです。
personId (パーソンID)	文字列	2342	イベントが登録されているプロファイルの一意の内部IDです。
externalPersonId (外部パーソンID)	文字列	CS26_342	イベントが登録されているプロファイルの外部IDです。プロファイルが存在しない場合、この値はNULLです。
occuredTime (発生時刻)	文字列	2022-09-14T15:00:35.495+0000	システムがイベントを受信した時のタイムスタンプ (ISO-8601 形式) です。

イベント固有のフィールド

各イベントには、アクティビティに関する追加情報を含む1つ以上のプロパティが含まれる場合があります。プロパティは、イベントの種類によって異なります。

標準イベントのプロパティを表示するには、イベントIDを以下の基本URLに追加します：https://portal.infobip.com/people/events/definitions/ (opens in a new tab) (opens in a new tab)

例：https://portal.infobip.com/people/events/definitions/emailLinkClicked (opens in a new tab) (opens in a new tab)と入力すると、標準イベント*Email Link Clicked (メールのリンクをクリック)*のプロパティのリストが表示されます。

備考

アカウントで使用可能なイベントIDの一覧については、イベント定義一覧の取得 (opens in a new tab)を使用します

カスタムイベントのプロパティ名が必須フィールドの名前と同じ場合、エクスポートファイルでは、プロパティ名の先頭にイベントIDが付きます。

例：カスタムイベントの場合、プロパティは externalPersonIdです。但し、externalPersonIdは必須フィールドの名前です。そのため、エクスポートファイルでは、プロパティ名の先頭にイベントID myCustomDefinitionIDが付きます。その結果、ファイル内のプロパティ名は myCustomDefinitionID_externalPersonIdとなります。

イベントをエクスポートすると、Momentsによって生成されたイベントの追加プロパティを提供できます。例：campaignName (キャンペーン名)。この情報をエクスポートして、外部システムで使用できます。次の表に、これらのプロパティの一覧を示します。

フィールド名	値の形式	例	備考
campaignName (キャンペーン名)	文字列	コミュニケーション名 56	キャンペーンの名前です (このデータが存在する場合)
elementName (エレメント名)	文字列	メール送信	フローエレメントの名前です (このデータが存在する場合)
campaignStart (キャンペーン開始)	文字列	2022-06-14T10:54:30.033+0000	キャンペーンの開始日時です (このデータが存在する場合)
flowElementId (フローエレメントID)	文字列	10000005271386-12	フローエレメントのIDです (このデータが存在する場合)

この機能を有効にするには、エクスポートイベントリクエスト (opens in a new tab)を送信する時に enrichWithMomentsInfo パラメーターをTrue に設定します。

イベントのデータ保持

Peopleイベントは、NTTCPaaSの製品およびサービスに適用されるデータ保持ポリシーに従います。イベントは限られた期間のみ保存されます。カスタム保持オプションは、ご要望に応じてご利用いただけます。保持ポリシーは、すべてのイベントの種類に適用されます。

備考

イベントのデータ保持ポリシーは、2025年4月15日から有効になります。

備考

新しい保持ポリシーは、円滑な移行を確実にするために、2025年5月15日から段階的に適用されます。

猶予期間の保護：猶予期間は 2025年5月15日までです。この期間中は、保持期間を過ぎた予定は削除されないため、確認と調整を行う時間が与えられます。

段階的な施行：このポリシーは、5月15日から一斉にではなく、段階的に施行されます。

施行後の完全準拠要件：ポリシーが完全に施行されると、データ保持設定が自動的に適用されます。

このセクションでは、データ保持ポリシーがセグメント、レポート、フロートリガー、および計算属性におけるPeopleイベントの使用方法にどのように影響するかを説明します。

詳細については、データ保持ポリシーをご参照ください。

データ保持の仕組み

イベント条件を使用して検索結果をフィルタリングしたり、セグメントをクエリしたり、計算属性を計算したりする場合、システムはNTT CPaaSアカウントのイベントデータ保持期間内にあるイベントにのみアクセス可能です。イベント条件がこの期間を超えると、警告メッセージが表示されます。この場合、保持期間内に収まるように条件を調整することをご検討ください。

備考

時には、イベント条件の期間を通常より長くするのは意図的な場合があります。詳細については、例外セクションをご参照ください。

例外

アクティブなフローおよびイベントベースの計算属性 (プロファイルスコアとイベント集計) のセグメントまたはトリガーで使用されるイベントフィルターと条件は、データ保持の影響を受けません。システムは、一致するイベントに関する必要な情報を一時的に保存し、元のイベントが保持ポリシーに従って削除された場合でも、これらのフィルターの機能を継続させます。

例：フローは9カ月間に3つの商品の注文を待機しているとします。3番目の注文が到着するまでに、データ保持のために一部のイベントが削除されている可能性があります。但し、必要なイベント情報が一時的に保存されるため、トリガーは引き続き機能します。

保存されているイベントデータは、フローが停止するか、計算属性が非アクティブ化されると失われます。

備考

この例外は、セグメントオーディエンス エレメントには適用されません。このエレメントでは、計算時に利用可能なイベントに基づいてオーディエンスがリアルタイムで計算されるため、イベント情報は保存されません。

オーディエンスを管理するおすすめの方法