イベント

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

例：

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

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

例: エンド ユーザーがリンクを操作するときに、次の情報を People に保存できます。

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

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

イベントを表示するには、終了ユーザーのプロファイルページの属性、タグ、Eventsタブに移動します。

イベントの使用方法

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

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

イベントの種類

Events には次の種類があります。

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

• テンプレート events: イベント properties が事前に入力されたイベントテンプレートで、e コマースなどの一般的なユースケースに合わせてカスタマイズして使用できます。

• 標準イベント: 次の場合に発生する定義済みのイベント。

  • Moments、Conversations、Answersなどの NTTCPaaS 製品を通じてエンドユーザーと通信する際。
  • 個人プロファイル(属性、宛先またはタグ)が更新されたとき。

  標準イベントには、People events、チャネル events、Product events が含まれます。

カスタム Events [#events-custom-events]

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

カスタムイベントを作成する

1. NTT CPaaSのWebインターフェース で、People > Events (イベント) > Custom events (カスタムイベント) タブに移動します。

2. [イベントの作成] を選択します。

   

3. イベント名 フィールドに、イベントの名前を入力します。例: AddedToCart。

4. Event ID (イベントID) が一意であることを確認します。このフィールドはイベント名に基づいて自動的に入力されます。このIDは、NTT CPaaS APIやSDKを通じてイベントを追跡する時に使用します。

5. (オプション)説明 フィールドに、イベントの説明を入力します。

   

6. (オプション)プロパティを必要な数だけ作成します。

   イベントにプロパティを追加するには、次の操作を行います。

   1. [イベント プロパティの追加] を選択します。

      

   2. 名前 フィールドで、プロパティの名前を指定します。名前は、次の基準に従う必要があります。

      • 英数字
      • 小文字のアルファベットで始まる必要があります
      • 最大 128 文字まで入力できます。

   3. タイプ フィールドで、プロパティのデータ型を選択します。

   プロパティのデータ型とイベントプロパティの詳細については、イベントプロパティ のドキュメントを参照してください。

   

イベントのプロパティ [#properties-custom-events]

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

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

プロパティのデータ型

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

イベントのテスト送信

1. NTT CPaaSのWebインターフェース で、People > Events (イベント) > Web SDK タブに移動します。

2. 試してみる セクションで、イベントとそれに関連するユーザープロファイルを選択します。

3. [イベントの送信] を選択します。

   

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

プラットフォーム上のカスタムイベントをトラッキングする [#events-custom-events-track]

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

• Web SDK
• API
• モバイルSDK

Web SDK [#web-sdk-custom-events]

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

Events API [#events-api-custom-events]

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

既定では、イベントは既存の People プロファイルにのみ送信できます。API 呼び出しでオプションのパラメーターを設定して、指定したユーザー ID のプロファイルが存在しない場合に新しいプロファイルを自動的に作成できます。

実装の詳細については、guidelinesおよび 開発者ガイドを参照してください。

モバイルSDK [#mobile-sdk-custom-events]

モバイル SDK を使用して、モバイルアプリケーションからイベントをキャプチャします。

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

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

  利用可能なモバイルアプリイベントのリストについては、チャネル Eventsセクションを参照してください。

• カスタム イベント は、エンド ユーザーのアクティビティを追跡するために作成および構成するイベントです。Mobile SDK を使用してカスタムイベントを追跡できます。例: エンドユーザーがショッピングカートにアイテムを追加したり、アイテムを購入したり、オンボーディングプロセスのステップを完了したりするときに、Mobile SDK を使用してカスタムイベントを送信します。

モバイルイベントトラッキングの設定方法については、以下をご覧ください。

• iOSの場合
• AndroidとHuaweiSDK
• リアクトネイティブプラグイン
• コルドバプラグイン
• フラッタープラグイン

ガイドライン [#guidelines-custom-events]

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

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

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

テンプレート Events [#events-template-events]

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

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

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

標準 Events [#events-standard-events]

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

これらのイベントは、これらの製品のイベントをサポートするすべての要素で使用できます。例: Momentsでは、トリガーなどの要素でイベントを使用できます。

標準イベントを有効または無効にする [#enable-disable-standard-events]

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

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

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

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

標準イベントの種類

標準イベントには、次のものが含まれます。

• People Events
• チャネル Events
• 製品Events

People Events [#people-events-standard-events]

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

• ユーザー アクティビティ: エンド ユーザーによって実行されるアクティビティ。例: ログインしています。
• 標準属性: 標準属性への変更。
• カスタム属性: カスタム属性への変更。

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

人物活動

人物アクティビティイベントのユースケース

• 匿名訪問者のWebサイト訪問を追跡する:匿名訪問者からリードとコンバージョンに至るまでのエンドユーザーのジャーニーを追跡します。
• ターゲットを絞ったオファリング:人が月に5回あなたの 住宅ローン ページを訪問した場合、住宅ローンのオファーとアドバイスについてメールを送信します。
• 特定のカテゴリのプロモーション コード: エンド ユーザーが 1 週間以内に 靴 ページを 3 回閲覧した場合、靴のプロモーション コードを記載したメッセージを送信します。
• 再アクティブ化: 過去 45 日間にウェブページにアクセスしていないエンドユーザーを含む再アクティブ化キャンペーンStart。
• 放棄されたカート:エンドユーザーが チケットの検索 ページにアクセスし、チケットの選択 ページに移動しますが、チェックアウト ページには移動しません。
• アクティブな顧客向けのアンケート: エンド ユーザーが 30 日間で 100 ページ ビューを超える場合は、アンケートを送信します。

Web サイトでの人物アクティビティ イベントの追跡

Web サイトでの 人物アクティビティ イベントをトラッキングするには、JavaScript ベースの Web SDK を Web サイトに追加します。詳細については、Web SDKを参照してください。

Person アクティビティ イベントの種類

• セッションが開始されました
• ページビュー
• セッション終了
• 作成されたユーザー
• マージされたユーザー

セッションが開始されました

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

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

ページビュー

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

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

セッション終了

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

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

作成されたユーザー

このイベントは、ユーザープロファイルが作成されたときにログに記録されます。

マージされた人

このイベントは、個人プロファイルがマージされたときにログに記録されます。

標準属性 [#standard-attributes-standard-events]

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

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

• ユーザープロファイルの名前の変更: 個人の名、ミドルネーム、姓の変更。
• ユーザープロファイルの場所の変更: 住所、市区町村、国の変更。
• ユーザープロファイルのその他の変更: 例: 生年月日。
• タグの変更: タグがプロファイルに追加されたり、プロファイルから削除されたりします。
• 連絡先情報: その人と連絡を取ることができるチャネルの追加または削除。

連絡先 [#contact-information-standard-events]

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

カスタム属性 [#custom-attributes-standard-events]

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

チャネル Events [#channel-events-standard-events]

これらのイベントは、エンド ユーザーとの通信に使用されるチャネルに固有です。チャネルイベントを使用して、メッセージのステータスと、メッセージに対する顧客の反応を追跡します。

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

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

製品Events [#product-events-standard-events]

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

瞬間

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

答え

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

会話

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

フォーム

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

イベントを使用してメッセージをパーソナライズする

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

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

イベントを使用してオーディエンスをセグメント化する

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

セグメントは、People の セグメント ページで作成できます。セグメントを作成するときは、イベントと属性を組み合わせて、より関連性の高いセグメンテーションを行います。

次の例では、選択された属性は 国 で、イベントは タグ追加 です。

Momentsでイベントを使用する

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

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

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

例: カートにアイテムを追加するすべてのエンド ユーザーにメッセージを送信するには、コミュニケーション フローで、People リアルタイム イベント トリガーとカスタム イベント アイテム カートに追加されました を使用します。

イベント エレメントを待つ

通信フローの後の段階でイベントを使用する場合は、[イベントを待つ] エレメントを使用します。

例: イベントを待つ エレメントで、待機するイベントとして チェックアウトが完了しました を選択します。このエレメントがこのイベントが発生するまで待機する必要がある時間を入力します。

People 分析でイベントを使用する

イベントは以下で使用します。

• Eventsセグメンテーション:イベントを使用して、分析するオーディエンスセグメントを作成します。
• ファネルAnalytics: ファネルのステップとして使用するイベントを選択します。

例: ファネル分析 を選択し、使用する標準イベントを選択します。

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

外部システムでイベントデータを使用するには、 People API を使用して、イベントを圧縮ファイルとしてアマゾン ウェブ サービス (AWS) S3 バケットにエクスポートします。

Events エクスポート API を使用して、次の操作を行います。

• エクスポート イベント要求を送信する (投稿)
• エクスポート要求の状態を確認する (Get)
• エクスポート要求の非同期取り消し (Del)
• イベント定義の一覧を取得する (Get)

過程 [#export-events]

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

AWS S3バケットの設定方法については、Amazon AWSドキュメントを参照してください。

S3 バケットのアクセス許可を設定する

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

このロールには、次のポリシーが必要です。

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

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

イベントをエクスポートする [#export-files-events-in-external-systems]

「 エクスポートイベント要求の送信」で定義されているスキーマに従って、エクスポートイベント要求を送信します。

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

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

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

イベントスキーマ [#event-schema-events-in-external-systems]

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

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

必須フィールド

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

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

標準イベントのプロパティを表示するには、イベント ID を基本URL https://portal.infobip.com/people/events/definitions/ に追加します。

例: 「https://portal.infobip.com/people/events/definitions/emailLinkClicked 」と入力すると、標準イベント「Email Link Clicked」のプロパティのリストが表示されます。

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

この機能を有効にするには、 エクスポート イベント要求を送信するときに enrichWithMomentsInfo パラメーターを True に設定します。

イベントのデータ保持 [#data-retention-events]

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

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

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

データ保持のしくみ [#data-retention-how-it-works]

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

例外

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

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

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