アウトバウンド マーケティングのイベント管理 Web アプリケーションの概要
注意
Dynamics 365 Marketing と Dynamics 365 Customer Insights は Customer Insights - Journeys と Customer Insights - Data になりました。 詳細については、Dynamics 365 Customer Insights のよくあるご質問 をご覧ください
Customer Insights - Journeys の新しい顧客には、リアルタイム体験機能のみが提供されます。 詳細については、既定のリアルタイム体験のインストールを参照してください。
注意
現在 Azure Active Directory は Microsoft Entra ID になりました。 詳細
重要
この記事は、2025年6月30日に製品から削除される予定の アウトバウンド マーケティング にのみ適用されます。 中断を避けるため、この日付より前にリアルタイムの旅程に移行してください。 詳細情報: 移行の概要
イベント管理機能は、イベントの整理、管理、処理に役立ちます。 イベント管理ソリューションをインストールすると、Web アプリケーションをユーザーに提供するイベント ポータルを使用できます。イベント ポータルで、イベント詳細について詳しく知ることができます。 詳細: イベント ポータル。
イベント ポータルは次の 2 つの部分から構成されます:
- フロントエンド
- REST API バックエンド
利用可能なフレームワークのいずれかを使用してフロントエンドを実装できます。 フロントエンドは単一ページのアプリケーションで、完全にカスタマイズ可能です。 バックエンドとバックエンドのカスタマイズはホスティングの種類によって異なります。
2 つの方法でカスタム イベント Web サイトをホストできます:
警告
サンプル Angular Web サイトのカスタマイズは、自己責任で行ってください。 Microsoft Dynamics 365 テクニカルサポートでは、サンプルサイトのカスタマイズに関する問題やご質問にはお答えできません。
前提条件
フロントエンドを構築することも、提供されているデモ イベント Web サイトをカスタマイズすることもできます。
チップ
アウトバウンド マーケティング イベント Web サイトは、Power Pages スタジオを使用してカスタマイズすることはできません。
注意
提供されているデモ イベント のWebサイトは、 Angular フレームワーク を使用したwebサイトです。 ただし、バックエンドはフロントエンドに依存しないので、任意のフレームワークを使用できます。
デモ イベント Web サイトのカスタマイズを始めるには、次の手順に従います。
サンプル イベント Web サイトのソース コードをダウンロードします。
バージョン 10.x とバージョン 16.x の間に Node.js をインストールします。 新しいバージョンでは展開は機能しません。
コマンド プロンプトもしくは Windows PowerShell を開いてコマンドを実行し、インストールが成功したことを確認してください。
node -v
Note
ターミナルやシェルがすでに開いている場合は、コマンドを入力する前に再起動してください。
コマンドを実行して Angular アプリケーションの構築と実行に必要な Angular CLI (コマンド ライン インターフェイス) をインストールします。 詳細: Angular CLI。
npm install -g @angular/cli
ソース コード をダウンロードしたディレクトリに移動して、コマンドを実行して Web サイトの実行に必要な必要なパッケージをすべて取得します。
npm install
Note
package.json
ファイルが格納されているフォルダと同じフォルダで、コマンドを実行する必要があります。バックエンド サービスと対話するには 公開 API のドキュメント を参照してください。
イベント管理とポータルのソリューションがインストールされた Dynamics 365 Customer Insights - Journeys インスタンスも必要です。 インスト-ルについては、無料の Dynamics 365 Customer Insights - Journeys 試用版にサインアップする を参照してください。
サンプル イベント Web サイトのダウンロード
メモ
新しい機能およびバグ修正がリリースされると、サンプル イベント Web サイトの新しいバージョンが利用可能になります。
以下の表からダウンロードするバージョンを選択します。
件名 | リリース | Changes | アップロード済み |
---|---|---|---|
サンプル イベント Web サイト | 1.60.0 (5 月リリース) | - イベント ポータル Web サイトのパフォーマンスが向上しました。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.56.0 (12 月リリース) | - 待機リストの問題を修正しました。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.46.0 (9 月リリース) | - アクセシビリティの問題を修正。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.34.0 (4月 リリース) | - 小規模な改良とバグ修正。 | ダウンロード |
サンプル イベント Web サイト | 1.30.0 (12 月リリース) | - 小規模な改良とバグ修正。 | ダウンロード |
サンプル イベント Web サイト | 1.28.0 (10 月リリース) | - ローカル日付変換をオプトインできるように追加されました。 - 追加の Web サイト言語構成を追加しました。 |
ダウンロード |
サンプル イベント Web サイト | 1.27.0 (9 月リリース) | - 日付表示を構成できるように追加されました。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.24.0 (6月 リリース) | - ポータルに対して単一ファイルの展開ができるように、展開スクリプトを更新しました。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.23.0 (5 月リリース) | - アクセシビリティの問題を修正。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.22.0 (4月 リリース) | - アクセシビリティの問題を修正。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.21.0 (3月 リリース) | - イベントの停止登録を追加。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.20.0 (2 月 リリース) | - イベント登録に対してマーケティング フォームを統合します。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.19.0 (12 月リリース) | - アクセシビリティの問題を修正。 - Web サイトの言語を更新。 - スピーカーのページを改善。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.18.0 (10 月リリース) | - 小規模な改良とバグ修正。 | ダウンロード |
サンプル イベント Web サイト | 1.17.0 (9 月リリース) | - 有料イベントのワークフローの改善。 - IE11の互換性問題の修正。 - イベント詳細ページの改善。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.16.0 (8 月リリース) | - イベントページの読み込み動作の改善。 - ブール型のカスタム登録フィールドのUI/UXの改善。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.15.0 (7月 リリース) | - セッションがフルの場合は、セッション リスト ビューに情報を追加します。 - カスタム登録フィールドに検証を追加します。 - 翻訳の改善。 - ポータルに展開した後にfont-awesomeアイコンがなくなる事象の修正。 - 小規模な改良とバグ修正。 |
ダウンロード |
サンプル イベント Web サイト | 1.14.0 (6月 リリース) | Angular 7 へのアップグレード、チェックアウト ページの UI と UX の改良、翻訳の更新と改良、DeployToD365Instance.ps1 スクリプトの改良、カスタム登録フィールドの検証の改良、その他バグの修正 | ダウンロード |
サンプル イベント Web サイト | 1.13.0 (4月 リリース) | セッション レベルの待機リスト機能、UI の洗練、バグ修正 | ダウンロード |
サンプル イベント Web サイト | 1.12.2 (3月 リリース) | UI と UX の改善、バグ修正 | ダウンロード |
環境構成パラメーター
src\environments フォルダには、さまざまな環境用 (自己ホスト型、ポータル ホスト型、開発) のサンプル設定ファイルが含まれます。 カスタムイベントWebサイトの設定は、 \src\environments
フォルダ内の environment.ts
ファイルを作成して行います。 構成を変更する手順と方法については、関連するセクション 自己ホストの環境構成 と ポータル ホストの環境構成 をご覧ください。
カスタム イベント Web サイトの構成を開始する前に理解する必要があるパラメーターの一部を次に示します:
パラメーター | 説明 |
---|---|
実稼働 | Angular アプリケーションの運用モードを有効または無効にします。 詳細: Angular ドキュメント。 |
buildVersion | このフィールドは既定で package.json ファイルに指定されたバージョンにリンクします。 このプロパティを変更する必要はありません。 ただし、アプリケーションのバージョンを公開したくない場合は null に設定できます。 |
apiEndpoint | イベント管理 API のエンドポイントを指す URL (イベント情報の取得や登録のために使用されます)。 |
localizationEndpoint | ローカライズ ファイルが保存されている URL を指します (既定ではルート ディレクトリに保存されています)。 |
imagesEndpoint | 画像が保存されている基本 URL を指定します。 この設定により異なる場所からの画像を提供できます。これはコンテンツ配信ネットワークや画像処理サービスを使用する場合に必要となる可能性があります。 |
useRestStack | この設定は使用する API を指定します。 true に設定されている場合は、新しいイベント管理パブリックAPIが使用されます。 false に設定されている場合は、非推奨となっているイベント管理ポータルAPIが使用されます。 このAPIは、ポータルにてカスタムイベントWebサイトをホストしている場合にのみ使用できます。 新しいイベント管理パブリックAPIを使用するには、Webアプリケーションを登録する必要があります。 |
emApplicationtoken | このトークンは、イベント管理の公開 API に対して Web アプリケーションを認証します。 Customer Insights - Journeys インスタンスで新しい Web アプリケーションを登録することでアプリケーション トークンを取得できます。 非推奨のイベント管理 Portal API を使用している場合は、このトークンは必要ありません。 |
isAuthenticationEnabled | このフラグでは、ユーザ認証がサポートされているかどうかを指定します (つまり、ユーザーが登録またはサインインできます)。 falseに設定されている場合は、アプリケーションにサインイン、登録の方法が表示されません。 |
useAadB2C | 認証に Microsoft Entra ID 管理 を使用するかを指定します。 Power Apps ポータル ID 管理を使用する場合は、このフラグを False に設定する必要があります。 Microsoft Entra ID が有効になっている場合は、aadB2CConfig 変数を設定する必要があります。 |
aadB2CConfig | Microsoft Entra ID 管理 が有効になっているときにイベント管理アプリケーションによって使用される構成オブジェクト。 |
useMockData | この設定は、実際の API 呼び出しを行う代わりに模擬オブジェクトを返すために使用できます。 |
dateSettings | この設定を使用して、Web サイトで日付をフォーマットする方法を構成することができます。 convertToLocalDate フラグが true に設定されている場合、すべての日付がエンド ユーザーの現地時間に自動的に変換されます。 |
languageSettings | この設定を使用して、Web サイトで言語を読み込む方法を構成することができます。 forceSingleLanguage フラグが true に設定されている場合、Web サイトは websiteLanguageLcid で指定された言語で読み込まれます。 showLanguageDropdown フラグを使用すると、言語のドロップダウンを表示または非表示にできます。 デフォルトでは、言語ドロップダウンが表示され、Web サイトではエンド ユーザーのブラウザー言語を使用します。 |
バックエンド カスタマイズ
イベント管理アプリケーションのバックエンドをカスタマイズする必要がある場合があります。 システム カスタマイザーが既存のイベント管理エンティティに新しいフィールドを追加し、そのフィールドをイベント Web サイトで表示するとします。 たとえば、custom_new_field フィールドが evtmgmt_pass エンティティに追加される場合です。 イベントのパスは API エンドポイント api/v2.0/events/{readableEventId}/passes
を使用して取得できますが、結果は新しく追加されたフィールドを含みません。
新しいフィールドが API で表示されるよう公開するには、以下の手順に従います:
- Customer Insights - Journeys インスタンスを開きます。
- 高度な検索を開きます。
- ドロップダウンから Webサイト テーブルの構成 エンティティを選択し、 結果を選択します。
- 新規 Web サイトのテーブル構成を選択して新しいレコードを作成します。
- 名前 フィールドに選択した名前を入力してください。
- 追加フィールドを 選択されたエンティティ フィールドに表示するエンティティを選択します。
- 選択されたフィールド の API を通して表示される新規カスタム フィールドを含む JSON 配列を記述します。 これにより、API を通じて新しいカスタム フィールドが公開され、フロントエンドで利用できるようになります。