翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect Customer Profiles の使用
エージェントがより効率的でパーソナライズされたカスタマーサービスを提供できるように、Amazon Connect では、Salesforce、Zendesk、ServiceNow、またはその他の顧客関係管理 (CRM) 製品などの外部アプリケーションからの情報を Amazon Connectの問い合わせ履歴と組み合わせることができます。これにより、顧客とのやり取り中にエージェントが必要とするすべての情報を含むお客様プロファイルが 1 か所に作成されます。
製品、ケース、問い合わせ履歴を含む顧客情報を一元表示することで、エージェントは顧客のアイデンティティをすばやく確認し、電話やチャットの理由を判断できます。
現在、Amazon Connect Customer Profiles は、[GDPR](https://aws.amazon.com/compliance/gdpr-center) 準拠の使用が可能であり、Amazon Connectが保有する追加の認定が保留中です。
次のイメージは、エージェントのワークスペースを示しています。このドキュメントでは、 Amazon Connect Customer Profiles のイメージが紹介されています。エージェントワークスペースは効率的なマルチタスクに対応するように設計されており、すべて同じブラウザウィンドウ内で、通話、チャット、タスクを同時に処理できると同時に、お客様プロファイル情報にすばやくアクセスできます。
![\[エージェントアプリケーションの [顧客プロファイル] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-concepts-intro3.png)
1. **ケース**: Zendesk や ServiceNow などの 3P アプリケーションから取り込んだケースに関連する、ステータス、参照 ID、タイトル、ソース、更新日などの情報、および Amazon Connect ケースを使用して作成および管理されるケース。
1. **詳細**: [プロファイル](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)の顧客定義*属性*フィールドに含まれる追加情報、および携帯電話番号や配送先住所などの詳細なプロファイル情報。この情報は、エージェントが必要な情報をすばやく見つけられるように、アルファベット順に並べ替えます。
1. [**Contact history**] (問い合わせ履歴): この顧客が過去にコンタクトセンターに連絡した日付、時刻、およびその長さを示します。
1. [**Product purchase history**] (製品購入履歴): 顧客が購入したすべてのアセットはここに表示されます。このデータは、Salesforce や Zendesk など、Customer Profiles に[統合された](integrate-external-apps-customer-profiles.md)外部アプリケーションから取り込まれます。
# Amazon Connect の顧客プロファイルとは何か
*顧客プロファイル*は、アカウント番号、追加情報、生年月日、メールアドレス、複数の住所、名前、パーティーのタイプなど、顧客に関する情報と組み合わせたコンタクト履歴を保存するレコードです。*アカウントベースのプロファイル*には、基盤となるサブプロファイルがあることが想定されます。
Amazon Connect Customer Profiles を有効にすると、問い合わせごとに一意のお客様プロファイルが作成されます。これにより、お客様との対話中にエージェントが必要とするすべての情報を含むお客様プロファイルを 1 か所に作成できます。
フロー内のお客様プロファイルにアクセスするには、[Customer Profiles](customer-profiles-block.md) ブロックを使用します。エージェントワークスペースで[エージェントはお客様プロファイルにアクセスします。](customer-profile-access.md)
Customer Profiles の有料機能を使用すると、[外部アプリケーションからデータを取り込む](integrate-external-apps-customer-profiles.md)ことで、お客様プロファイルを強化できます。詳細については、[料金](https://aws.amazon.com/connect/pricing/)を参照してください。
また、カスタムフィールドとオブジェクトをお客様プロファイルに追加するには、[Amazon Connect Customer Profiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html) を使用します。
## 顧客プロファイルデータはどのように保存されていますか?
Amazon Connect では、問い合わせ履歴を一意のお客様プロファイルに保存します。外部アプリケーションから取り込んだデータを解析し、お客様プロファイル属性として保存します。
Amazon Connect は、外部アプリケーションのデータを置き換えたり更新したりしません。データソースを削除すると、外部アプリケーションのデータは顧客プロファイルの各音声問い合わせで使用できなくなります。
お客様プロファイルデータのセキュリティ保護方法の詳細については、「[Amazon Connect におけるデータ保護](data-protection.md)」を参照してください。
顧客プロファイルに保存されているデータにアクセスする方法の詳細については、「[エージェントアプリケーションで Customer Profiles にアクセスする](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profile-access.html)」または「[Customer Profiles API を使用する](https://docs.aws.amazon.com/connect/latest/adminguide/use-customerprofiles-api.html)」を参照してください。
# Amazon Connect インスタンスで Customer Profiles を有効にする
Amazon Connect は、事前に構築された統合機能を備えているため、複数の外部アプリケーションからの顧客情報と、Amazon Connectからの問い合わせ履歴をすばやく組み合わせることができます。これにより、顧客との対話中にエージェントが必要とするすべての情報を含むお客様プロファイルを 1 か所に作成できます。
## [開始する前に]
次に、主要な概念の概要と、セットアッププロセス中に入力を求められる情報を示します。
### お客様プロファイルのドメインについて
Amazon Connect Customer Profiles を有効にすると、お客様プロファイルドメインが作成されます。これは、お客様プロファイル、オブジェクトタイプ、プロファイルキー、暗号化キーなど、すべてのデータのコンテナです。Customer Profile ドメインを作成するためのガイドラインを次に示します。
+ 各 Amazon Connect インスタンスは、1 つのドメインにのみ関連付けることができます。
+ 複数のドメインを作成できますが、外部アプリケーション統合や顧客データを相互に共有することはできません。
+ 作成する外部アプリケーション統合はすべて、ドメインレベルです。ドメインに関連付けられたすべての Amazon Connect インスタンスは、ドメインの統合を継承します。
+ 別のドメインを選択することで、Amazon Connect インスタンスの関連付けを現在のドメインから新しいドメインにいつでも変更できます。ただし、以前のドメインのお客様プロファイルが新しいドメインに移動されないため、この方法はお勧めしません。
### データストア
データストアは、Customer Profiles データの長期データストアです。過去 10 年間に更新された Customer Profiles データを保存します。これは、Spark SQL と予測インサイトを活用したセグメンテーションに使用されるデータであり、これらの機能を使用するには有効にする必要があります。計算された属性の計算やエージェントワークスペースの入力には使用されません。
### お客様プロファイルのドメインにどのように名前を付けるのですか。
Customer Profiles を有効にすると、組織名など、わかりやすいドメインのフレンドリ名を入力するように求められます。例えば、*CustomerProfiles-ExampleCorp* のような名前です。フレンドリ名は、API を使用していつでも変更できます。
### データストア
データストアは、Spark SQL と予測インサイトを活用したセグメンテーションに必要なサービスマネージドデータストアであり、これらの機能を使用するには有効にする必要があります。計算された属性の計算やエージェントワークスペースの入力には使用されません。
データストアを有効にすると、取り込みは自動的に Customer Profiles に保存されます。データストアを有効にした後は、この機能を無効にすることはできません。データストアからデータを削除するには、DeleteProfile API を使用するか、オブジェクトタイプまたは Customer Profile ドメインを削除します。
### デッドレターキューを使用しますか。
デッドレターキューは、外部アプリケーションからのデータの処理に関連するエラーを報告するために使用されます。
Amazon AppFlow は、外部アプリケーションへの接続と、そこからAmazon Connect Customer Profiles へのデータの移動を処理します。その後、Amazon Connect がファイルを処理します。
+ 接続中またはデータを Amazon Connect に転送中にエラーが発生した場合、Amazon AppFlow はエラーを表示しますが、エラーはデッドレターキューに書き込まれません。
例えば、外部データが指定されたスキーマと一致しなかったり、外部データ形式が正しくない形式 (現時点では JSON のみがサポートされています) だったりするなどの処理エラーがあります。
+ ファイルの処理中に Amazon Connect でエラーが発生すると、そのエラーがデッドレターキューに書き込まれます。後でキューを見て、エラーを再処理しようとすることができます。
+ ドメインで定義されたデッドレターキューに、オブジェクトとともにエラーメッセージを含む SQS メッセージが表示される場合があります。
| **エラーメッセージ** | **レコメンデーション** |
| --- | --- |
| UNIQUE キーまたは PROFILE キーがプロファイルオブジェクトに存在しません | データマッピングまたはオブジェクトを変更し、データマッピングで UNIQUE および PROFILE とマークされたキーがオブジェクトに存在することを確認します。設定方法については、「[**データマッピング**](customer-profiles-object-type-mapping.md)」ページを参照してください。 |
| 1 秒あたりにプロファイルに取り込まれたオブジェクトが多すぎます | 短時間で同じプロファイルに割り当てられたオブジェクトが多すぎます。オブジェクトを再び取り込むか、PutProfileObject API の呼び出しの間の待機時間を増やすことができます。 |
| EncryptionKey がリージョンに存在しない、EncryptionKey に Customer Profiles が使用するための権限がない、または EncryptionKey に GenerateDataKey アクセス許可がないため、Customer Profiles はオブジェクトを取り込むことができません | KMS のアクセス許可を確認し、Customer Profiles に必要なアクセス権限があることを確認します。「[**Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する**](#enable-customer-profiles-step1)」セクションに従います。 |
| KMS キーは無効です | KMS のアクセス許可を確認し、Customer Profiles に必要なアクセス権限があることを確認します。「[**Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する**](#enable-customer-profiles-step1)」セクションに従います。 |
| KMS キーが無効であるため、Customer Profiles はオブジェクトを取り込むことができません | KMS のアクセス許可を確認し、Customer Profiles に必要なアクセス権限があることを確認します。「[**Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する**](#enable-customer-profiles-step1)」セクションに従います。 |
| データに \$1 バイトを超えるプロファイルオブジェクトが含まれています | 不要なフィールドを削除し、エラーメッセージに記載されている所定の制限を下回るまでデータサイズを小さくします。 |
| このオブジェクトのすべてのキーは複数のプロファイルにバインドされています | データマッピングまたはオブジェクトを変更し、オブジェクト内の少なくとも 1 つの PROFILE キーが 1 つ以下の既存のプロファイルにバインドされていることを確認します。 |
Customer Profiles を有効にすると、デッドレターキューとして Amazon SQS キューを指定することもできます。このオプションを選択した場合は、次のリソースポリシーを Amazon SQS に追加して、Customer Profiles にそのキューにメッセージを送信するアクセス許可を付与します。
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
混乱した代理処理のセキュリティ問題を防ぐには、適用するポリシー例について「[Amazon Connect Customer Profiles サービス間の混乱した代理問題の防止](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service)」を参照してください。
デッドレターキューを作成するステップバイステップの手順については、このトピックの後半の「[Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する](#enable-customer-profiles-step1)」で説明します。
### Customer Profiles によってデータの暗号化に使用される KMS キーを作成する (必須)
**注記**
Customer Profiles API へのアクセスを維持するには、Customer Profiles `profile` API を使用するエンティティの IAM ポリシーに明示的な `kms:GenerateDataKey` および `kms:Decrypt` のアクセス許可が必要です。これにより、Customer Profiles に関連する API から取得したリソースに関連付けられた KMS キーの `kms:Decrypt` および `kms:GenerateDataKey` を利用できるようになります。
Customer Profiles を有効にすると、 AWS Key Management Service [KMS キー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#kms_keys)を作成または指定するように求められます。KMS キーを作成するステップバイステップの手順については、このトピックの「[Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する](#enable-customer-profiles-step1)」で説明します。
Customer Profiles のすべての保管中のデータは、選択した KMS キーで暗号化されます。カスタマー管理 キーは、ユーザーによって作成、所有、管理されます。KMS キーを完全に制御できます (AWS KMS 料金が適用されます）。
他のユーザーが管理者である KMS キーをセットアップする場合は、アクセス許可 `kms:GenerateDataKey`、`kms:CreateGrant`、および `kms:Decrypt` を Customer Profiles サービスプリンシパルに付与するポリシーが必要です。キーポリシーを変更する方法については、「 AWS Key Management Service デベロッパーガイド[」の「キーポリシーの変更](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html)」を参照してください。また、クロスサービスのなりすましを防ぐには、「[でのサービス間の混乱した代理の防止 AWS](cross-service-confused-deputy-prevention.md)」で適用すべきサンプルポリシーを参照してください。
## Customer Profiles を有効にして、デッドレターキューと KMS キーを指定する
**データストア**
データストアを有効にするかどうかを選択します。Spark SQL と予測インサイトを活用したセグメンテーションを使用する必要があります。ドメインの作成時にデータストアを有効にしない場合は、ドメインを作成して使用した後に有効にできます。有効にした後でデータストアをオフにすることはできません。
データストアを有効にするには、Customer Profiles ページの青いバナーの有効化ボタンをクリックします (左側のパネル > **Customer Profiles**)。ドメインを作成すると、この青いバナーが表示されます。
データストアにはカスタマーマネージドキー (CMK) が必要であり、ドメインに対してカスタマーマネージドキー (CMK) をまだ有効にしていない場合は、作成するよう求められます。
**重要**
Data Vault を使用する場合、Customer Profiles はオブジェクトタイプ別にデータを保存し、AWS KMS キーを使用して暗号化します。Customer Profiles は、オブジェクトタイプ名を次のように正規化します。
名前を小文字に変換する
ハイフン - をアンダースコア \$1 に変換する
Customer Profiles 標準オブジェクトタイプに「標準」を追加する
Customer Profiles ドメインオブジェクトタイプに「ドメイン」を追加する
Customer Profiles 標準ドメインオブジェクトタイプに「domain\$1standard」を追加する
Customer Profiles が命名競合を検出した場合、Data Store を有効にすることはできません。Data Store を有効にすると、これらの正規化ルールで既存のオブジェクトタイプ名と競合するオブジェクトタイプを作成することはできません。
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、**[Customer profiles]** (お客様プロファイル) を選択します。
[**お客様プロファイルドメイン**] ページには、統合に使用できるアプリケーションが一覧表示されます。次の画像では、ページは顧客プロファイルドメインが有効になっていないことが示されています。
![\[[顧客プロファイル] ページ、[顧客プロフィールを有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-domains-page.png)
1. [**お客様プロファイルの有効化**] を選択して、開始します。
1. [**お客様プロファイル有効**] ページで [**新しいドメインの作成**] を選択します。[**ドメインの指定**] で、わかりやすいフレンドリ名 (組織名など) を入力します。例えば、*CustomerProfiles-ExampleCorp* などです。
![\[[顧客プロフィール有効化] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-domain.png)
1. [**デッドレターキューを指定する**] で、失敗したイベントをデッドレターキューに送信するかどうかを選択します。これは、取り込みに失敗したデータを可視化する場合に役立ちます。これによって、これらの失敗したデータの取り込みを後で再試行することもできるようになります。
デッドレターキューを作成する手順は、次のとおりです。
+ [**お客様プロファイル有効**] ページで、[**新しい SQS キューを作成または既存の SQS キューを選択**]、[**新しいデッドレターキューの作成**] の順に選択します。
![\[[新規作成] または [既存の SQS キューを選択] のオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-dlq-choose.png)
+ Amazon SQS コンソール用のブラウザの新しいタブが開きます。[**キューの作成**] を選択します。
+ [**キューの作成**] ページで [**スタンダード**] を選択し、キューに名前を割り当てます。
![\[[キューの作成] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-dlq-name.png)
+ [**アクセスポリシー**] セクションで、[**アドバンスト**] を選択します。
バージョン名、ポリシー ID、ステートメントが表示されます。必要に応じて、このセクションを更新して、適切なロールのみがアクセスできるようにします。
+ [ステートメント] セクションの終わり (次の図の 15 行目) で、\$1 の後にコンマを追加し、`Enter` を押します。
![\[[アクセスポリシー] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-dlq-statement.png)
+ 次に、以下のコードをコピー、ペーストします。
```
{
"Sid": "Customer Profiles SQS policy",
"Effect": "Allow",
"Principal": {
"Service": "profile.amazonaws.com"
},
"Action": "SQS:SendMessage",
"Resource": "arn:aws:sqs:region:accountID:YourQueueName"
}
```
+ *region*、*accountID*、および *YourQueueName* を独自の情報に置き換えるには、`Resource` 情報を 14 行目からコピーし、貼り付けます。
![\[[アクセスポリシー] セクション、[リソース情報]。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-dlq-copyandpaste.png)
+ [**キューの作成**] を選択します。
+ Amazon Connect コンソール [**お客様プロファイル有効**] ページのブラウザのタブに戻ります。[**既存の SQS キューを選択**] ボックスでクリックまたはタップして、ドロップダウンリストから先ほど作成したキューを選択します。
![\[ドロップダウンリストの SQS キュー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-dlq-final.png)
1. **[KMS キーの指定]** で、暗号化用の独自の AWS KMS key キーを作成または入力します。以下は、 AWS KMS keyを作成するための手順です。
+ **[顧客プロファイル有効**] ページで **[ AWS KMS keyの作成]** を選択します。
![\[[顧客プロファイル有効化] ページ、[ AWS KMS key の作成] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key.png)
+ ブラウザの新しいタブで、キー管理サービス (KMS) コンソールが開きます。[**キーの設定**] ページで、 [**対称**] を選択してから、[**次へ**] をクリックします。
![\[[キーの設定] ページ、[対称] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key-configure-key.png)
+ [**ラベルの追加**] ページで、キーの名前と説明を入力し、[**次へ**] をクリックします。
![\[[ラベルの追加] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key-add-labels.png)
+ [**キー管理アクセス許可の定義**] ページで、[**次へ**] をクリックします。
+ [**キー使用アクセス許可の定義**] ページで、[**次へ**] をクリックします。
+ [**キーポリシーの確認と編集**] ページで、[**終了**] をクリックします。
次の例では、キーの名前は「**bcb6fdd**」から始まります。
![\[[顧客管理キー] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key-note-key.png)
+ Amazon Connect コンソール [**お客様プロファイル有効**] ページのブラウザのタブに戻ります。**KMS キーの指定ボックス** の中でクリックまたはタップすると、作成したキーがドロップダウンリストに表示されます。作成したキーを選択します。
![\[[KMS キーの指定] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-create-kms-key-choose-key.png)
1. **データストア**で、データストアを有効にするかどうかを選択します。Spark SQL と予測インサイトを活用したセグメンテーションを使用する必要があります。ドメインの作成時にデータストアを有効にしない場合は、ドメインを作成して使用した後に有効にできます。有効にした後でデータストアをオフにすることはできません。
データストアのない既存のドメインがある場合は、Customer Profiles ページの青いバナーの有効化ボタンをクリックすることで有効にできます (左側のパネル > Customer Profiles)。
データストアにはカスタマーマネージドキー (CMK) が必要であり、ドメインに対してカスタマーマネージドキー (CMK) をまだ有効にしていない場合は、作成するよう求められます。
1. [**Submit**] を選択してください。完了したページは、次の図のようになります。顧客プロファイルドメインの名前、デッドレターキュー、KMS キーが表示されます。
![\[完成した [顧客プロファイルドメイン] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-final.png)
完了しました。Amazon Connect Customer Profiles が有効化されています。Amazon Connect では、新しい問い合わせが入るたびに、お客様プロファイルレコードが作成されます。次に、その電話番号 (音声) または電子メールアドレス (チャット) の問い合わせ履歴を追跡します。
エージェントは、[新しい顧客プロファイルを作成](ag-cp-create.md)して、顧客に関する問い合わせレコードを表示できます。
## 次の手順
1. [エージェントアプリケーションを通じて Customer Profiles を利用できるようにします](customer-profile-access.md)。
1. [エージェントアプリケーションで Customer Profiles にアクセスする許可をエージェントに割り当てます](assign-security-profile-customer-profile.md)。
1. [お客様プロファイルデータを提供する外部アプリケーションと統合します (任意)](integrate-external-apps-customer-profiles.md)。
1. [アイデンティティ解決を有効にして 2 つ以上の類似プロファイルを特定し、それらを統合します](use-identity-resolution.md)。
# 業界リソーステンプレートの使用開始
Amazon Connect Customer Profiles は、特定の業界に合わせた計算属性、セグメント、プロファイルエクスプローラーレイアウトを使用してドメインをすばやくセットアップするのに役立つ業界リソーステンプレートを提供します。
## [開始する前に]
業界リソーステンプレートを有効にする前に、以下を確認してください。
+ Amazon Connect インスタンスで Customer Profiles が有効化されている
+ Customer Profiles ドメインにリソースを作成するための適切なアクセス許可がある
## 業界リソーステンプレートについて
業界テンプレートを有効にすると、Customer Profiles はドメインに次のリソースを自動的に作成します。
+ 計算属性の定義 - 顧客データから派生した事前定義された属性
+ セグメント定義 - 一般的な特性に基づく顧客のグループ化
+ プロファイルエクスプローラーのレイアウト - 顧客情報を視覚化するためのカスタマイズされたダッシュボードビュー
これらのリソースは、各リソースを手動で作成することなく、顧客データから迅速に価値を引き出すことができるように設計されています。
## 業界リソーステンプレートを有効化する
1. Customer Profiles のホームページで、[業界テンプレート] セクションを見つけます。
+ Customer Profiles を初めて設定する場合は、ページの上部に通知が表示されます。
![\[テンプレートを有効にするバナーは、顧客プロファイルを初めて使用する場合に表示されます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-industry-resource-templates-1.png)
+ ドメインに既にリソースがある場合は、有効なテンプレートのリストが [業界テンプレート] セクションに表示されます。
![\[以前に顧客プロファイルを使用したことがある場合は、有効なテンプレートのリストが [業界テンプレート] セクションに表示されます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-industry-resource-templates-2.png)
1. テンプレートを有効にするには、**[テンプレートを有効にする]** を選択します。
1. **[テンプレートの選択]** ドロップダウンで、ビジネスに最も適した業界を選択します。
+ **[航空会社]** - 航空旅行企業向け
+ **[ホテル]** - ホスピタリティ企業向け
1. **[リソースの確認]** セクションで作成されるリソースを確認します。
![\[作成されるリソースを確認します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-industry-resource-templates-3.png)
1. **[テンプレートを有効にする]** を選択します。
1. リソースが作成されるまで待ちます。リソースの作成中は、ブラウザタブを開いたままにしてください。
1. 完了すると、確認メッセージが表示され、作成されたリソースの数を含むテンプレートが [業界テンプレート] セクションに表示されます。
![\[正常に作成されたことを示すバナーが表示されます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-industry-resource-templates-4.png)
## 業界テンプレートによって作成されたリソース
### 航空会社業界テンプレート
#### 計算属性
航空会社テンプレートは、いくつかのカテゴリにわたって計算された属性を作成します。
**航空会社の計算属性**
| 計算属性名 | [Display Name] (表示名) | 説明 | オブジェクトの種類 |
| --- | --- | --- | --- |
| air\$1airPreference\$1departure\$1airport\$1last\$1occurrence | 優先出発空港 | 顧客が最近設定した優先出発空港を返します。 | \$1airPreference |
| air\$1airPreference\$1arrival\$1airport\$1last\$1occurrence | 優先到着空港 | 顧客が最近設定した優先到着空港を返します。 | \$1airPreference |
| air\$1airPreference\$1travel\$1type\$1last\$1occurrence | 優先する旅行タイプ | 顧客が最近設定した優先する旅行タイプを返します。 | \$1airPreference |
| air\$1airPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | マーケティングオプトイン設定 | 顧客が最近設定したマーケティングオプトイン設定を返します。 | \$1airPreference |
| air\$1airPreference\$1language\$1in\$1person\$1language\$1last\$1occurrence | 希望する対面言語 | 顧客が最近設定した対面でのやり取りで使用する言語を返します。 | \$1airPreference |
| air\$1airPreference\$1seat\$1location\$1last\$1occurrence | 優先座席の場所 | 顧客が最近選択した座席の場所の設定を返します。 | \$1airPreference |
| air\$1airPreference\$1home\$1airport\$1last\$1occurrence | 優先ホーム空港 | 顧客が最近指定したホーム空港を返します。 | \$1airPreference |
| air\$1airPreference\$1dining\$1dietary\$1restriction\$1last\$1occurrence | 優先する食事制限 | 顧客が最近指定した食事制限を返します。 | \$1airPreference |
| air\$1airBookings\$1number\$1of\$1passengers\$1average | 予約あたりの平均乗客数 | 顧客の予約全体での平均乗客数を返します。 | \$1airBooking |
| air\$1airBookings\$1price\$1total\$1price\$1average | 平均予約価格 | 顧客のすべての予約の平均コストを返します。 | \$1airBooking |
| air\$1airBookings\$1count | 予約数 | 顧客が行った予約の数を返します。 | \$1airBooking |
| air\$1airSegments\$1flight\$1delay\$1time\$1sum | フライト遅延の合計時間 | 顧客が経験したフライト遅延の合計時間を返します。 | \$1airSegment |
| air\$1airSegments\$1cancelled\$1flights\$1count\$130\$1days | 過去 30 日間にキャンセルされたフライト | 過去 30 日以内にキャンセルされた顧客のフライトの数を返します。 | \$1airSegment |
| air\$1airSegments\$1delayed\$1flights\$1count\$130\$1days | 過去 30 日間の遅延フライト | 過去 30 日以内に遅延した顧客のフライトの数を返します。 | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$130\$1days | 過去 30 日間に完了したフライト | 過去 30 日以内に完了した顧客のフライトの数を返します。 | \$1airSegment |
| air\$1airSegments\$1completed\$1flights\$1count\$11\$1year | 過去 1 年間に完了したフライト | 過去 1 年間に完了した顧客のフライトの数を返します。 | \$1airSegment |
| air\$1airSegment\$1departure\$1date\$1last\$1occurrence | 最後の出発便の日付 | 顧客の最後のフライトの出発日を返します。 | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum | 合計飛行マイル | 顧客のすべての飛行距離の合計をマイル単位で返します。 | \$1airSegment |
| air\$1airSegments\$1miles\$1to\$1earn\$1sum\$11\$1year | 過去 1 年間の飛行マイル | 過去 1 年間に顧客が利用した飛行マイルの合計を返します。 | \$1airSegment |
| air\$1airSegments\$1business\$1first\$1class\$1count | プレミアムクラスのフライト数 | ビジネスクラスまたはファーストクラスとして予約された顧客のフライトセグメントの数を返します。 | \$1airSegment |
| air\$1loyalties\$1points\$1redeemed\$1sum | 交換されたロイヤルティポイントの合計 | すべてのカスタマーロイヤルティプログラムで交換されたポイントの合計を返します。 | \$1loyalty |
| air\$1loyalties\$1count | ロイヤルティメンバーシップの数 | 顧客が所有するロイヤルティプログラムメンバーシップの数を返します。 | \$1loyalty |
| air\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 次のティアまでのポイント | 顧客が次のロイヤルティティアに到達するために必要なポイントを返します。 | \$1loyalty |
| air\$1loyalty\$1points\$1balance\$1last\$1occurrence | 現在のロイヤルティポイント残高 | 顧客の最新のロイヤルティポイント残高を返します。 | \$1loyalty |
| air\$1loyalty\$1membership\$1id\$1last\$1occurrence | 現在のロイヤルティメンバーシップ ID | 顧客の最新のロイヤルティメンバーシップ ID を返します。 | \$1loyalty |
| air\$1loyalty\$1program\$1name\$1last\$1occurrence | 現在のロイヤルティプログラム名 | 顧客の最新のロイヤルティプログラム名を返します。 | \$1loyalty |
| air\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 最新のロイヤルティ登録日 | 顧客の最新のロイヤルティプログラム登録日を返します。 | \$1loyalty |
| air\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 現在のロイヤルティティア | 顧客の最新のロイヤルティプログラムティアステータスを返します。 | \$1loyalty |
| air\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | プレミアムティアメンバーシップの数 | シルバーのカスタマーロイヤルティプログラムの数を返します | \$1loyalty |
| air\$1loyaltyPromotions\$1count | ロイヤルティプロモーションの数 | 顧客が受け取ったロイヤルティプロモーションの総数を返します。 | \$1loyaltyPromotion |
#### セグメント
航空会社テンプレートは以下のセグメントを作成します。
+ [航空会社] マーケティングサブスクライバー
+ [航空会社] 過去 30 日間にフライトがキャンセルされた顧客
+ [航空会社] 過去 30 日間にフライトの遅延があった顧客
+ [航空会社] 過去 30 日以内にフライトを完了した顧客
+ [航空会社] 休止中のメンバー
#### プロファイルエクスプローラーのレイアウト
デモプロファイルエクスプローラーのレイアウト (レイアウト名: `DEMO-Airline-Layout`) は、次のウィジェットで構成されます。
+ 顧客の詳細と連絡先情報
+ ロイヤルティプログラムのステータスとポイント
+ 最近の予約とフライト
+ 顧客の設定
+ 顧客価値メトリクス
+ 顧客満足度指標
### ホテルの業界テンプレート
#### 計算属性
ホテルテンプレートは、いくつかのカテゴリにわたって計算された属性を作成します。
**ホテル計算属性**
| 計算属性名 | [Display Name] (表示名) | 説明 | オブジェクトの種類 |
| --- | --- | --- | --- |
| hotel\$1hotelPreference\$1location\$1room\$1type\$1last\$1occurrence | 優先するルームタイプ | 顧客が最近設定した優先するルームタイプを返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1cleaning\$1time\$1last\$1occurrence | 優先するクリーニング時間 | 顧客が最近設定したルームのクリーニング時間を返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1location\$1view\$1last\$1occurrence | 優先ルームビュー | 顧客が最近設定したルームビューを返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1in\$1type\$1last\$1occurrence | 優先チェックイン方法 | 顧客が最近設定したチェックイン方法を返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1check\$1out\$1type\$1last\$1occurrence | 優先チェックアウト方法 | 顧客が最近設定したチェックアウト方法を返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1special\$1request\$1last\$1occurrence | 最後の特別なリクエストタイプ | 顧客が最近リクエストした特別な宿泊施設タイプを返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1interest\$1name\$1of\$1interest\$1max\$1occurrence | 最も頻繁な関心 | 顧客から最も頻繁にリクエストされる関心または設備設定を返します。 | \$1hotelPreference |
| hotel\$1hotelPreference\$1marketing\$1opt\$1in\$1last\$1occurrence | マーケティングオプトイン設定 | 顧客が最近設定したマーケティングオプトイン設定を返します。 | \$1hotelPreference |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1average | 平均滞在期間 | 顧客のすべてのホテル予約の平均滞在期間を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum\$11\$1year | 過去 1 年間の合計宿泊日数 | 顧客のすべての予約の過去 1 年間の合計宿泊日数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1number\$1of\$1nights\$1completed\$1sum | 合計滞在日数 | 顧客のすべてのホテル予約の合計滞在日数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1room\$1type\$1name\$1last\$1occurrence | 最後に予約したルームタイプ | 顧客が最近予約したルームタイプを返します。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1channel\$1method\$1last\$1occurrence | 最後に使用された予約チャンネル | 顧客が最近のホテルの予約に使用したチャンネルを返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1count | 予約の数 | 顧客が行ったホテル予約の数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1average | 予約の平均支出 | ホテル予約 1 件あたりの平均支出額 (税引き後) を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1total\$1amount\$1after\$1tax\$1sum | 合計ホテル支出 | 顧客のすべてのホテル予約で消費された合計金額 (税引き後) を返します。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1number\$1of\$1guests\$1max\$1occurrence | 最も一般的なグループサイズ | 顧客のすべての滞在で最も頻繁に予約されたゲスト数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1business\$1travel\$1count | 出張の数 | 出張としてマークされた顧客の予約の数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservations\$1missed\$1checkin\$1count | 未チェックインの数 | 顧客がチェックインしなかった予約の数を返します。 | \$1hotelReservation |
| hotel\$1hotelReservation\$1cancelled\$1count | キャンセルされた予約の数 | 顧客がキャンセルしたホテル予約の数を返します。 | \$1hotelReservation |
| hotel\$1hotelStayRevenues\$1amount\$1sum | 生み出された総収益 | 顧客のすべてのホテルの滞在からの総収益を返します。 | \$1hotelStayRevenue |
| hotel\$1hotelStayRevenues\$1amount\$1average | 1 滞在あたりの平均収益 | 顧客のすべての滞在で計算された平均収益額を返します。 | \$1hotelStayRevenue |
| hotel\$1hotelStayRevenues\$1amount\$1maximum | 最高収益額 | 顧客の単一の滞在からの最高収益額を返します。 | \$1hotelStayRevenue |
| hotel\$1hotelStayRevenue\$1revenue\$1type\$1max\$1occurrence | 最も一般的な収益源 | 顧客のホテル滞在全体で最も頻繁に発生する収益タイプを返します。 | \$1hotelStayRevenue |
| hotel\$1loyalties\$1points\$1redeemed\$1sum | 交換されたロイヤルティポイントの合計 | すべてのカスタマーロイヤルティプログラムで交換されたポイントの合計を返します。 | \$1loyalty |
| hotel\$1loyalties\$1count | ロイヤルティメンバーシップの数 | 顧客が所有するロイヤルティプログラムメンバーシップの数を返します。 | \$1loyalty |
| hotel\$1loyalty\$1tier\$1points\$1to\$1next\$1tier\$1last\$1occurrence | 次のティアまでのポイント | 顧客が次のロイヤルティティアに到達するために必要なポイントを返します。 | \$1loyalty |
| hotel\$1loyalty\$1points\$1balance\$1last\$1occurrence | 現在のロイヤルティポイント残高 | 顧客の最新のロイヤルティポイント残高を返します。 | \$1loyalty |
| hotel\$1loyalty\$1membership\$1id\$1last\$1occurrence | 現在のロイヤルティメンバーシップ ID | 顧客の最新のロイヤルティメンバーシップ ID を返します。 | \$1loyalty |
| hotel\$1loyalty\$1program\$1name\$1last\$1occurrence | 現在のロイヤルティプログラム名 | 顧客の最新のロイヤルティプログラム名を返します。 | \$1loyalty |
| hotel\$1loyalty\$1enrollment\$1date\$1last\$1occurrence | 最新のロイヤルティ登録日 | 顧客の最新のロイヤルティプログラム登録日を返します。 | \$1loyalty |
| hotel\$1loyalty\$1tier\$1current\$1tier\$1last\$1occurrence | 現在のロイヤルティティア | 顧客の最新のロイヤルティプログラムティアステータスを返します。 | \$1loyalty |
| hotel\$1loyalties\$1silver\$1gold\$1platinum\$1tier\$1count | プレミアムティアメンバーシップの数 | シルバーのカスタマーロイヤルティプログラムの数を返します | \$1loyalty |
| hotel\$1loyaltyPromotions\$1count | ロイヤルティプロモーションの数 | 顧客が受け取ったロイヤルティプロモーションの総数を返します。 | \$1loyaltyPromotion |
#### セグメント
ホテルテンプレートは、以下のようなセグメントを作成します。
+ [ホテル] 優先マーケティングサブスクライバー
+ [ホテル] 単身旅行
+ [ホテル] カップルまたはペアの旅行者
+ [ホテル] 家族またはグループの旅行者
+ [ホテル] 30 日以内に予約が予定されている顧客
#### プロファイルエクスプローラーのレイアウト
以下を表示するカスタマイズされたレイアウト。
+ 顧客の詳細と連絡先情報
+ 優先する部屋
+ 滞在履歴
+ 収益情報
+ ロイヤルティステータス
## 業界テンプレートを無効にする
業界テンプレートを無効にして、ドメインから作成したリソースを削除できます。テンプレートを無効にするには、次の手順を実行します。
1. Customer Profiles のホームページで、[業界テンプレート] セクションを見つけます。
1. 無効にするテンプレートを見つけ、**[無効化]** アクションを選択します。
1. 確認メッセージをレビューし、**[確認]** を選択してテンプレートを無効にします。
**重要**
テンプレートを無効にすると、そのテンプレートによって作成されたすべてのリソースがドメインから削除されます。これらのリソースのいずれかが顧客セグメント、アウトバウンドキャンペーン、またはコンタクトフローで使用されている場合、テンプレートを無効にすると影響を受ける可能性があります。
テンプレートを無効にする前に、使用中のリソースを確認して、潜在的な影響を確認してください。
## トラブルシューティング
**業界テンプレートのトラブルシューティング**
| エラー | 推奨事項 |
| --- | --- |
| テンプレートリソースの作成に失敗しました | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| 作成されたリソースがプロファイルエクスプローラーに表示されない | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/getting-started-industry-resource-templates.html) |
| 複数のテンプレートを有効化できない | 各ドメインでは、複数の業界テンプレートを有効にできます。問題が発生した場合は、ドメインのリソース制限に達していないことを確認してください。 |
| テンプレートリソースを削除する必要があります | 現在、使用の開始機能では、テンプレートによって作成されたすべてのリソースを自動的に削除することはできません。個々のリソースは、それぞれの管理ページから手動で削除できます。 |
## 次の手順
業界テンプレートを有効にすると、以下を行うことができます。
+ プロファイルエクスプローラーに移動して、新しいレイアウトを実際に確認する
+ 特定のニーズに合わせて計算属性を表示および編集する
+ Amazon Connect で顧客セグメントを管理する
+ ビジネス要件に基づいてプロファイルエクスプローラーレイアウトを編集する
+ 外部アプリケーションと Amazon Connect Customer Profiles を統合してプロファイルの入力を開始する
# エージェントワークスペースで Amazon Connect Customer Profiles にアクセスする
Amazon Connect Customer Profiles を有効にすると、エージェントは顧客とのやり取りを開始し、[顧客情報](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles.html)にアクセスしてパーソナライズされたサービスを提供できます。このトピックでは、 Amazon Connect エージェントワークスペースにアクセスする方法について説明します。
**ヒント**
エージェントのセキュリティプロファイルに、**顧客プロファイル**へのアクセス許可が割り当てられており、エージェントから Customer Profiles へのアクセスが可能なことを確認します。詳細については、「[Amazon Connect Customer Profiles のセキュリティプロファイルのアクセス許可](assign-security-profile-customer-profile.md)」を参照してください。
## オプション 1: CCP に用意されている Customer Profiles を使用する
Customer Profiles は、問い合わせコントロールパネル (CCP) の横に組み込み済みです。エージェントは、 Amazon Connect インスタンスにログインし、次の図に示すように右上隅にある**エージェントワークスペース**ボタンを選択することで、CCP、Customer Profiles、 Amazon Connectおよび Case Management のすべてに同じブラウザウィンドウでアクセスできます。
![\[Customer Profiles ページとエージェントワークスペースを開くハイライト表示されたボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-agent-workspace-open.png)
**注記**
次の URL を使用してエージェントワークスペースにアクセスすることもできます。
**https://*instance name*.my.connect.aws/agent-app-v2/**
**awsapps.com**ドメインを使用してインスタンスにアクセスする場合、次の URL を使用します。
**https://*instance name*.awsapps.com/connect/agent-app-v2/**
インスタンス名の検索については、「[Amazon Connect インスタンス名の検索](find-instance-name.md)」を参照してください。
次に、Customer Profiles がエージェントワークスペースに表示されている様子の例を示します。
![\[エージェントワークスペースの [顧客プロファイル] タブと CCP。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-agent-app.png)
## オプション 2: カスタムエージェントワークスペースに Customer Profiles を組み込む
問い合わせコントロールパネル (CCP) を組み込む場合、事前に作成された CCP ユーザーインタフェースの表示/非表示を切り替えることができます。例えば、通話の受け入れと拒否を行うカスタマイズされたボタンがあるように設計したユーザーインターフェイスを持つカスタムエージェントワークスペースを開発したい場合があります。また、Amazon Connect に含まれている事前構築済みの CCP を別のカスタムアプリに埋め込みたい場合もあります。
事前に構築済みの CCP ユーザーインターフェイスを表示する場合も、それを非表示にして独自のユーザーインターフェイスを作成する場合も、[Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) のライブラリを使用して、CCP と Customer Profiles をエージェントのワークスペースに組み込みます。このようにして、Amazon Connect ストリームが初期化され、エージェントは Amazon Connect と Customer Profiles に接続して認証できます。
Customer Profiles の埋め込みについては、「[Initialization for CCP, Customer Profiles, and Wisdom](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#initialization-for-ccp-customer-profiles-and-wisdom)」を参照してください。
Customer Profiles の未加工データを使用して独自のウィジェットを作成するには、CustomerProfilesJS オープンソースライブラリの使用方法に関する [GitHub](https://github.com/amazon-connect/amazon-connect-customer-profiles) ドキュメントを参照してください。
**ヒント**
エージェントのワークスペースをカスタマイズする場合、そのワークスペースにエージェントがアクセスするために使用する URL を決定します。これは、Amazon Connect で提供される URL とは大きく異なる場合があります。例えば、URL は https://example-corp.com/agent-support-app です。
# 顧客プロファイルを自動的に入力する
デフォルトでは、Amazon Connect Customer Profiles は次の値を使用して、ユーザーインターフェイス内の顧客プロファイルを検索し、自動入力します。
+ 音声による問い合わせの場合: 電話番号
+ チャットによる問い合わせの場合: E メール
顧客プロファイルフローブロックを使用して顧客プロファイルを自動入力します。この動作をカスタマイズするには、以下のコンタクト属性で [コンタクト属性の設定](set-contact-attributes.md) ブロック (以下を参照) を使用します。
| 属性 | 説明 | タイプ | JSONPath 参照 |
| --- | --- | --- | --- |
| profileSearchKey | プロファイルの検索に使用する属性の名前。 | ユーザー定義 | 該当しない |
| profileSearchValue | 顧客名やアカウント番号など、検索に使用するキーの値。 | ユーザー定義 | 該当しない |
例えば、チャットでの問い合わせを E メールで検索する場合は、`profileSearchKey` 属性を `_email` 検索キーに指定し、`profileSearchValue` として E メールアドレスを指定します。
プロファイルオブジェクトでカスタムキーを定義している場合は、それらの検索キーで検索することもできます。カスタムキーが検索可能であることの確認については、「[キー定義の詳細](object-type-mapping-definition-details.md#key-definition-details)」を参照してください。
次の図は、[コンタクト属性の設定](set-contact-attributes.md) ブロックでのこれらの属性の使用方法を示しています。
![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-attributes1.png)
## お客様プロファイルを問い合わせに自動的に関連付ける
デフォルトでは、エージェントはお客様のアイデンティティを確認した後、お客様プロファイルを問い合わせに手動で関連付ける必要があります。電話番号に基づいて連絡先をプロファイルに自動的に関連付けるようにこの動作を変更するには、[Customer Profiles の \$1phone キーを使用して見つけた 1 つのプロファイルにコンタクトレコードを関連付ける](auto-associate-profile-using-phone-profile-key.md)を参照してください。
複数のプロファイルが問い合わせの電話番号と一致する場合、一致した複数のプロファイルがエージェントに表示されます。エージェントは、問い合わせに関連付けるプロファイルを選択する必要があります。
# Amazon Connect Customer Profiles のセキュリティプロファイルのアクセス許可
エージェントのセキュリティプロファイルのアクセス許可を割り当てて、エージェントがプロファイルの検索や顧客の詳細の表示、コンタクトレコードとプロファイルの関連付け、プロファイルの編集、新しいプロファイルの作成と保存などのタスクを実行できるようにします。このセクションのトピックは、エージェント、フロー、計算属性のアクセス許可を更新することで、アクセス許可を割り当てるのに役立ちます。また、アクセス許可の更新中にエラーが発生した場合のトラブルシューティングに役立つ情報も紹介します。
**Topics**
+ [
# エージェントの Customer Profiles アクセス許可を更新する
](security-profile-customer-profile-agent.md)
+ [
# フローの Customer Profiles アクセス許可を更新する
](security-profile-customer-profile-contact-flows.md)
+ [計算属性のアクセス許可を更新する](security-profile-customer-profile-calc-attribs.md)
+ [顧客セグメントのセキュリティプロファイルのアクセス許可](security-profile-customer-profile-segmentation.md)
+ [
# エラーが発生した場合に新しい Customer Profiles アクセス許可を割り当てる
](security-profile-customer-profile-issues.md)
# エージェントの Customer Profiles アクセス許可を更新する
エージェントのセキュリティプロファイルに必要な**お客様プロファイル**へのアクセス許可を次のように割り当てます。
+ **表示**: エージェントがお客様プロファイルアプリケーションを表示できるようにします。次の操作が可能です。
+ エージェントアプリケーションに自動入力されたプロファイルを表示します。
+ プロファイルを検索します。
+ お客様プロファイルに保存された内容を表示する (例: Name (名前)、Address (住所))。
+ 次の図に示すように、問い合わせレコードをプロファイルに関連付けます。
![\[エージェントワークスペースの Customer Profiles タブ、関連付けボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-associate.png)
+ **編集**: エージェントがお客様プロファイルの内容を編集できるようにします (住所変更など)。デフォルトでは、[**View**] (表示) のアクセス許可が継承されます。
+ **作成**: エージェントが新しいプロファイルを作成して保存できるようにします。デフォルトで、**表示**と同じアクセス許可も付与されますが、**編集**と同じアクセス許可は付与されません。
既存のセキュリティプロファイルにアクセス許可を追加する方法については、「[Amazon Connect でセキュリティプロファイルを更新する](update-security-profiles.md)」を参照してください。
デフォルトでは、**管理者**セキュリティプロファイルに、すべての顧客プロファイルアクティビティを実行する許可が割り当て済みです。
# フローの Customer Profiles アクセス許可を更新する
1. [セキュリティプロファイル] ページに移動し、編集するセキュリティプロファイルを選択するか、 **[新しいセキュリティプロファイルの追加]** を選択します。
![\[セキュリティプロファイルページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. Customer Profiles の **[表示]** アクセス権限を選択します。
![\[[セキュリティプロファイル] ページで [表示] アクセス許可を選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-2.png)
1. **[保存]** を選択します。これで、**[ユーザー管理]** セクションに移動して、このセキュリティプロファイルを任意のユーザーに指定できます。
# Amazon Connect Customer Profiles で計算属性のアクセス許可を更新する
1. [セキュリティプロファイル] ページに移動し、編集するセキュリティプロファイルを選択するか、 **[新しいセキュリティプロファイルの追加]** を選択します。
![\[セキュリティプロファイルページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-contact-flows-1.png)
1. 計算属性のアクセス許可の **[すべて]** を選択するか、**[表示]**、**[編集]**、**[作成]**、**[削除]** を選択します。
![\[[セキュリティプロファイル] コンソールで、アクセス権限の表示、編集、作成、削除を選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-calc-attribs-2.png)
1. **[保存]** を選択します。これで、**[ユーザー管理]** セクションに移動して、このセキュリティプロファイルを任意のユーザーに指定できます。
# 顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる
必要に応じて、ユーザーのセキュリティプロファイルに以下の顧客セグメントのアクセス許可を割り当てます。セキュリティプロファイルの詳細については、「[Amazon Connect および問い合わせコントロールパネル (CCP) のセキュリティプロファイル](connect-security-profiles.md)」を参照してください。
1. [セキュリティプロファイル] ページに移動し、編集するセキュリティプロファイルを選択するか、 **[新しいセキュリティプロファイルの追加]** を選択します。
![\[セキュリティプロファイルページ、顧客プロファイルセクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-1.png)
1. 顧客セグメントの **[すべて]**、または **[表示]**、**[作成]**、**[削除]**、**[エクスポート]** の各アクセス許可を選択します。
![\[顧客セグメントのアクセス許可は [すべて] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/how-to-update-permissions-for-customer-segments-2.png)
1. **[保存]** を選択します。これで、**[ユーザー管理]** セクションに移動して、このセキュリティプロファイルを任意のユーザーに指定できます。
# エラーが発生した場合に新しい Customer Profiles アクセス許可を割り当てる
1. バックエンド APIs のいずれかで 403 の禁止された呼び出しエラーが発生した場合にアクセス許可を更新するには、 Amazon Connect Customer Profiles コンソールのドメインセクションに移動し、**詳細の表示**を選択します。
![\[Amazon Connect Customer Profiles コンソールのドメインセクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-1.png)
1. [ドメインの詳細の表示] セクションで、**[許可を更新]** をクリックします。
![\[未処理のアクセス権限を更新する必要がある場合は、ここに [許可を更新] ボタンが表示されます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-2.png)
1. 更新が完了すると、アクセス権限の更新が正常に完了し、[ドメインの詳細] セクションに **[許可を更新]** ボタンは表示されなくなります。これにより 403 Forbidden call エラーの問題が軽減され、API コールを正常に実行できるようになります。
![\[アクションが正常に完了すると、[許可を更新] ボタンは表示されなくなります。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/security-profile-customer-profile-issues-403-3.png)
# Amazon Connect Customer Profiles データの有効期限
プロファイルが指定された時間内に更新されていない場合、プロファイルは期限切れになります。これにより、プロファイルがクリーンアップされ、Customer Profiles ドメインから削除されます。
Customer Profiles データの有効期限は、次の 2 つの異なるカテゴリに分類できます。
## CreateProfile で作成されたプロファイル
`CreateProfile` API を使用して作成されたプロファイルは、Customer Profiles ドメインの **DefaultExpirationDays** によって割り当てられたタイムスタンプに基づいて期限切れになります。有効期限が設定されていない場合、デフォルトで 365 日に設定されます。
## PutProfileObject で作成または更新されたプロファイル
`PutProfileObject` を使用して作成または更新されたプロファイルは、それらに関連付けられたオブジェクトタイプで定義された **ExpirationDays** を常に参照します。オブジェクトタイプに有効期限が定義されていない場合は、Customer Profiles ドメインの有効期限が使用されます。最後に、どちらも指定されていない場合、プロファイルまたはプロファイルオブジェクトはデフォルトの 365 日で期限切れになります。
## 視覚化されたメンタルモデル
![\[Customer Profiles の有効期限ロジックを示すフローチャート。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-expiration-model.png)
## インポートされたプロファイルの有効期限
セグメントインポートを使用してプロファイルが Customer Profile ドメインにインポートされた場合、有効期限は 2 つの異なるシナリオに分類されます。
1. **CreateUploadJob を呼び出す際の有効期限の明示的な定義**
デフォルトでは、セグメントインポートを使用してインポートされたプロファイルは、更新が実行されていない場合、14 日後に期限切れになります。この数は、 API を使用するか、インポートの作成時に Amazon Connect 管理者ウェブサイト内で[定義できます](customer-segments-imported-files.md#set-profile-expiry)。最大日数は 90 日です。
1. **以前のインポートジョブから Customer Profiles ドメイン内に既に存在するプロファイルをインポートする**
2 つのインポートジョブが実行され、重複するプロファイルが見つかった場合、Customer Profiles は常に最長の有効期限を優先します。
# Amazon Connect でアイデンティティ解決を使用して類似プロファイルを統合する
ある*類似プロファイル*とは、1 件の問い合わせで、複数のプロファイルが同じであると判断された場合を意味します。同じお客様の複数のチャネルおよびアプリケーションでお客様レコードが取得され、共通する一意の識別子を共有しない場合、複数のプロファイルが存在する可能性があります。
アイデンティティ解決により、類似プロファイルが自動的に検出され、統合に役立ちます。アイデンティティ解決ジョブを毎週実行し、次の手順を実行します。
1. [自動プロファイル照合](how-identity-resolution-works.md#auto-profile-matching)
1. 統合条件に基づく[類似プロファイルの自動マージ](how-identity-resolution-works.md#auto-profile-merging)
アイデンティティ解決ジョブが実行されるたびに、**[Customer Profiles]** ページにメトリクスが表示されます。メトリクスには、レビューしたプロファイルの数、見つかった一致グループの数、統合プロファイルの数が表示されます。
アイデンティティ解決を有効にするには、追加料金が適用される場合があります。詳細については、[Amazon Connect の料金](https://aws.amazon.com/connect/pricing/)を参照してください。
![\[Amazon Connect Customer Profiles ページ、[アイデンティティ解決を有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Amazon Connect Customer Profiles ドメインのアイデンティティ解決を有効にする
**重要**
Amazon Connect エージェントワークスペースを使用する場合、ケースは Amazon Connect Customer Profiles Identity Resolution と完全には互換性がありません。プロファイルがマージされると、既存のケースは以下のように処理されます。
マージ後も、ケースは元のプロファイル ID に紐付けられたままになります。
ケースはマージされたプロファイル間で自動的に統合されません。
既存のケースを別のプロファイルに再度関連付けする方法はありません。ケースを手動で統合する必要がある場合は、回避策として [CreateCase](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateCase.html) と [CreateRelatedItem](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-cases_CreateRelatedItem.html) を使用します。
アイデンティティ解決を有効にする場合は、以下の情報を指定します。
+ アイデンティティ解決ジョブを毎週実行する必要がある時期。デフォルトでは、土曜日の午前 12 時 (UTC) に実行されます。
+ アイデンティティ解決ジョブが自動プロファイル照合プロセスの結果を書き込む必要がある Amazon S3 バケット。S3 バケットがない場合は、有効化プロセス中にバケットを作成するオプションがあります。
Amazon S3 バケットにクエリを実行するか、[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API を使用し、[信頼スコア](how-identity-resolution-works.md#confidence-score)に基づいて結果をフィルタリングします。
アイデンティティ解決を有効にすると、オプションの自動マージプロセスに、[統合条件を作成する](create-consolidation-criteria.md)ためのオプションが表示されます。
**アイデンティティ解決を有効にするには**
1. インスタンスの Customer Profiles ドメインを有効にする必要があります。手順については、「[Amazon Connect インスタンスで Customer Profiles を有効にする](enable-customer-profiles.md)」を参照してください。
1. ナビゲーションペインで、**[Customer profiles]** (お客様プロファイル) を選択します。
1. **[Identity Resolution]** (アイデンティティ解決) セクションで、**[Enable Identity Resolution]** (アイデンティティ解決を有効にする) を選択します。
![\[Amazon Connect Customer Profiles ページ、[アイデンティティ解決を有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
1. **[アイデンティティ解決]** ポップアップボックスで、**[アイデンティティ解決を有効にする]** を選択します。
![\[Amazon Connect Customer Profiles ページ、[アイデンティティ解決を有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-ir-2.png)
1. **[Enable Identity Resolution]** (アイデンティティ解決を有効にする) ページで、アイデンティティ解決ジョブを実行する日時を指定します。
1. Amazon S3 バケットから一致するプロファイル ID を確認する場合は、**[Write profile ID matches to Amazon S3]** (Amazon S3 に一致するプロファイル ID を書き込む) を選択します。それ以外の場合は、[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API を使用して、一致するプロファイルをレビューできます。
**注記**
マージを自動有効化すると、一致するプロファイル ID は受信されません。
1. アイデンティティ解決ジョブがプロファイル照合を書き込む必要がある Amazon S3 バケットを指定します。
混乱した代理処理のセキュリティ問題を防ぐために、ポリシーを適用することをお勧めします。詳細とポリシー例については、[Amazon Connect Customer Profiles サービス間の混乱した代理問題の防止](cross-service-confused-deputy-prevention.md#customer-profiles-cross-service) を参照してください。
1. 完了後、**[Enable Identity Resolution]** (アイデンティティ解決を有効にする) を選択します。ID 解決を有効にすると、ルールベースのマッチングと ML ベースのマッチングの両方が有効になります。ID 解決ページからどちらか一方または両方を無効にできます。詳細については、「[Amazon Connect Customer Profiles でアイデンティティ解決を無効にする](disable-identity-resolution.md)」を参照してください。
1. ID 解決のルールベースのマッチング:
1. 新しいドメインとのルールベースのマッチングを有効にした後、統合を設定し、統合が実行中の場合は、すぐにマッチングが開始されます。
1. 既存のドメインとのルールベースのマッチングを有効にすると、1 時間以内にマッチングプロセスが開始されます。
1. ID 解決のルールベースのマッチング:
1. アイデンティティ解決を有効にすると、アイデンティティ解決ジョブは 24 時間以内に 1 回目が実行されます。
**注記**
新しい Customer Profiles ドメインで初めて アイデンティティ解決ジョブを実行する前に、プロファイルメトリクスをチェックして、プロファイルが作成されていることを確認することをお勧めします。作成されていない場合、一致する結果は表示されません。
1. 自動マージ照合プロファイルの統合条件を設定することもできます。その場合は、「[Amazon Connect でのアイデンティティ解決の統合条件を設定する](create-consolidation-criteria.md)」を参照してください。
# Amazon Connect でのアイデンティティ解決の統合条件を設定する
**注記**
Amazon Connect 管理コンソールを使用して統合条件を作成するオプションにアクセスするには、[アイデンティティ解決を有効にする](#create-consolidation-criteria)必要があります。
アイデンティティ解決ジョブで類似プロファイルが検出されると、プロセスは指定した統合条件に基づいて、自動的に統合プロファイルにマージできます。
選択した属性は、完全一致するかを一致グループ内のすべての類似プロファイルで比較されます。例えば、条件で `email` を属性として指定した場合、`email address` の値と完全に一致する値を持つ一致グループ内のすべての類似プロファイルが統合プロファイルへとマージされます。
**ヒント**
独自のマージ用ロジックを設定する場合は、[MergeProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MergeProfiles.html) API を使用します。
## 制限
[標準プロファイル](standard-profile-definition.md)から任意の属性を選択し、類似プロファイルを比較できます。例えば、電話番号、メールアドレス、名前、およびカスタム属性を選択できます。
最大で次の値に指定できます。
+ 統合条件 10 個
+ 条件あたり 20 個の属性
## 強力な条件を作成するためのヒント
一意のプロファイルのターゲット設定を改善し、重複しないプロファイルの統合を回避するには、次の手順を実行することをお勧めします。
+ お客様を一意に識別でき、アカウント番号や政府機関 ID の形式など、お客様間で同じではないと思われる属性を選択します。
+ 単一の属性条件は避けてください。複数の属性を選択して属性の組み合わせを作成し、ターゲット設定を改善します。例:
+ **[Phone number]** (電話番号) と **[First name]** (名)、**[Middle name]** (ミドルネーム)、**[Last name]** (姓) を合わせたより強力な条件
条件は
+ **[Phone number]** (電話番号) のみ、または
+ **[First name, Middle, name, Last name]** (名、ミドルネーム、姓) の組み合わせのみより強力です。
+ 該当する場合は、特定の属性グループ内のすべての属性を選択します。例えば、名前を使用する場合は、関連する名前属性 (**[First name, Middle name, Last name]** (名、ミドルネーム、姓)) をすべて選択します。勤務先住所を使用する場合は、関連するすべての勤務先住所属性を選択します。
+ 以下の属性の 1 つを含めることで、条件の他の属性と組み合わせて、お客様を一意に特定する可能性があります。
+ アカウント番号
+ Phone number (電話番号)
+ E メール
## 自動マージ条件をセットアップする方法
自動マージの統合条件を設定する前に、[自動マージプロセスの仕組み](how-identity-resolution-works.md#consolidation-criteria-how-it-works) をレビューすることをお勧めします。
1. アイデンティティ解決を有効化した後に、**[Identity Resolution]** (アイデンティティ解決) ページに、自動マージ条件を設定するオプションが表示されます。**[Create consolidation criteria]** (統合条件を作成する) を選択します。
1. **[Missing timestamp]** (タイムスタンプがありません) ダイアログボックスが表示された場合、続行する前に、カスタムオブジェクトタイプに新しいタイムスタンプ属性を追加することをお勧めします。「[プロファイルの競合にタイムスタンプがない](#missing-timestamp-for-profile-conflicts)」を参照してください。
1. **[Profile conflicts]** (プロファイルの競合) セクションで、2 つ以上のレコードが競合する場合のプロファイルの競合を解決する方法を選択します。
1. **[Consolidation criteria]** (統合条件) セクションで、1 つ以上の条件を作成します。条件ごとに少なくとも 2 つ以上の属性を含めることをお勧めします。
## プロファイルの競合にタイムスタンプがない
**[Missing timestamp]** (タイムスタンプがありません) メッセージは、カスタムオブジェクトタイプマッピングがある場合に表示されます。
カスタムオブジェクトタイプに次の新しい属性を追加するには、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API を使用します。
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
タイムスタンプ属性が指定されていない場合は、統合条件の作成を続行できますが、レコードが Customer Profiles に取り込まれたときのデフォルトのタイムスタンプが使用されます。統合条件を作成する前に、新しい属性を追加することをお勧めします。
カスタムオブジェクトタイプを既に定義しており、カスタムオブジェクトタイプを更新する場合は、スケジュールされたバックフィルを毎週実行して、既存のプロファイルを `Fields.sourceLastUpdatedTimestamp` で更新します。スケジュールされたバックフィルをオプトインするには:
1. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API を使用して、カスタムプロファイルオブジェクトタイプを更新します。
1. カスタムプロファイルオブジェクトタイプを更新したら、[サポート チケット](https://console.aws.amazon.com/support/home)を開き、バックフィルをスケジュールします。予定されているバックフィルは 2022 年 2 月末まで実行されます。
または、カスタムオブジェクトタイプを使用するドメインの取り込み/コネクタを削除して再作成することもできます。すべてのデータは、更新されたオブジェクトタイプを使用して再度取り込まれ、`Fields.sourceLastUpdatedTimestamp` はそこから解析されます。
## 例: サンプル条件の適用方法
この例では、次の 3 つの条件があります。
+ **[Resolve profile conflicts]** (プロファイル競合を解決) が、**[Use last updated timestamp]** (最後に更新されたタイムスタンプを使用する) に設定されている。つまり、2 つのフィールドに競合する値がある場合、アイデンティティ解決は最後に更新されたタイムスタンプを使用して、使用する値を決定します。
+ 条件 1:
+ 名と姓
+ E メール
+ 条件 2:
+ Phone number (電話番号)
これらの条件は、以下のプロファイルに適用されます。
+ プロファイル A
+ John Doe [last updated **05:00**a]
+ doefamily@anyemail.com [last updated **05:00**a]
+ 555-555-5555 [last updated **07:00**a]
+ プロファイル B
+ John Doe [last updated **04:00**a]
+ doefamily@anyemail.com [last updated **06:00**a]
+ 555-555-555**6** [last updated *04:00*a]
+ プロファイル C
+ **Jane** Doe [last updated **06:00**a]
+ doefamily@anyemail.com [last updated **07:00**a]
+ 555-555-5555 [last updated **06:00**a]
条件 1 が適用された場合の結果は次のとおりです。
+ プロファイル A と B がマージされた = プロファイル AB
この結果 ProfileAB は次のようになります。
+ John Doe [last updated **05:00**a]
+ doefamily@anyemail.com [last updated **07:00**a]
+ 555-555-555**5** [last updated **06:00**a]
電話番号間に競合があるため、アイデンティティ解決は最後のタイムスタンプを使用して 555-555-555 番号を選択します。
次に、条件 2 が適用されます。結果は、以下のとおりです。
+ プロファイル AB と C がマージされた = プロファイル ABC
この結果、Profile ABC は次のようになります。
+ **Jane** Doe [last updated **06:00**a]
+ doefamily@anyemail.com [last updated **07:00**a]
+ 555-555-555**5** [last updated **07:00**a]
アイデンティティ解決には、最新のタイムスタンプがあるため、プロファイル C の名、姓、電子メールが使用されます。
# Amazon Connect でのアイデンティティ解決のための機械学習
Amazon Connect のアイデンティティ解決は類似プロファイルを自動的に検出し、プロファイルの統合に役立ちます。このセクションのトピックでは、自動マージプロセスの一環として重複プロファイルを統合するための機械学習マッチングを設定する方法を説明します。
**Topics**
+ [ID 解決のための機械学習の仕組み](how-identity-resolution-works.md)
+ [ID 解決のための機械学習のセットアップ](setup-machine-learning-matching.md)
# Amazon Connect でのアイデンティティ解決のための機械学習の仕組み
このトピックでは、アイデンティティ解決が自動プロファイル照合を実行する方法、および設定されている場合、類似プロファイルが自動的にマージされる方法について説明します。
## 自動プロファイル照合
類似プロファイルを識別するために、アイデンティティ解決は機械学習を使用して、各プロファイルの次の個人を特定できる情報 (PII) 属性を確認します。
+ 名前: 名、ミドルネーム、姓を含むすべての名前で類似性についてレビューされます。
+ メール: 個人のメールや勤務先メールなど、すべてのメールアドレスで類似性についてレビューされます。大文字と小文字は区別されません。
+ 電話番号: 自宅の電話、携帯電話、勤務先電話など、すべての電話番号と形式で類似性についてレビューされます。
+ 住所: 勤務先住所、郵送先住所、配送先住所、請求連絡先など、すべての住所タイプと形式で類似性についてレビューされます。
+ 生年月日: すべての生年月日と形式で類似性についてレビューされます。
この情報を使用して、類似プロファイルの一致グループを作成します。
### 一致グループ
一致グループは、お客様を表すすべての類似プロファイルで構成されます。各一致グループには、以下の情報が含まれます。
+ 問い合わせを表す 2 つ以上の類似プロファイルのグループを一意に識別する一致 ID
+ 一致グループ内のプロファイル ID の数
+ 一致グループに関連付けられた信頼スコア
### 信頼スコア
自動照合プロセスの実行後、S3 バケットにクエリを実行するか、[GetMatches](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetMatches.html) API を使用して信頼スコアに基づいて結果をフィルタリングします。例えば、詳細なレビューのために、高い信頼一致をフィルタリングできます。
信頼スコアは 0～1 の間の数値で、プロファイルを一致グループに割り当てる信頼レベルを表します。スコアが 1 の場合は、完全一致を示している可能性があります。
## 類似プロファイルの自動マージ
プロファイルの照合後、アイデンティティ解決ジョブは、必要に応じ、条件に基づいて類似プロファイルをマージできます。条件を削除または更新すると、更新された条件は次の実行時に類似プロファイルへ適用されます。
**重要**
統合プロセスは元に戻すことはできません。アイデンティティ解決ジョブを実行する前に、自動マージプロセスのドライランを実行するために、[GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html) API を使用することを強く推奨します。
**注記**
2 つのプロファイルをマージする際、API コールまたはエージェントワークスペースによって手動で入力されたプロファイルフィールドが、統合またはカスタムオブジェクトタイプマッピングから自動的に取り込まれたプロファイルフィールドによって上書きされることはありません。
例えば、エージェントワークスペースのエージェントが FirstName「John」を使用してプロファイルを手動で作成したとします。FirstName「Peter」を持つ別のプロファイルが S3 統合を使用して作成されます。この 2 つのプロファイルが自動的に統合された場合、FirstName「John」が保持されます。
### 自動マージプロセスの仕組み
+ **統合条件で選択したすべての属性は、マージ前の厳密な値比較の `AND` 条件とひも付けられます**。
+ 例えば、`email address` や `phone number` のように、条件に複数の属性が指定されている場合、`email address` と `phone number` の完全に一致する値を持つ一致グループ内のすべての類似プロファイルがマージされます。
+ 一致グループ内の 1 つ以上の類似プロファイルが、条件内の 1 つ以上の属性に対して異なる値を持っている、または値がない場合は、その類似プロファイルがマージされます。
例えば、1 つの一致グループが 5 つの類似プロファイルからなり、そのうちの 3 つのプロファイルが統合されているとします。これは、これらの 3 つのプロファイルが条件を満たしているためです。他の 2 つのプロファイルは、条件を満たさないため、マージされません。
+ **複数の条件は、条件 1 から始まる優先順で評価されます**。
+ 統合条件の順序が適用されます。条件 1 を最優先とし、条件 10 が最低の優先度となります。
+ アイデンティティ解決ジョブが 1 つの条件に適用されると、統合されたプロファイルと一致グループ内の残りの類似プロファイルに、次の条件が適用されます。
+ 最大 10 個の条件を設定できます。
+ **各条件は独立して実行され、その他の条件で `OR` として操作されます**。
+ 複数の条件がある場合、アイデンティティ解決ジョブが次の条件に移る前に、各条件が個別に、優先順位の順序で適用されます。
+ すべての条件は、リストした順序で適用されます。一致グループ内の類似プロファイルを統合するのに条件が満たされるかどうかは関係ありません。
+ **デフォルトでは、プロファイルの競合は新しさによって管理されます**。
+ 一致グループ内の 2 つ以上の類似プロファイルが統合条件を満たす場合、結果の統合プロファイルは、構成類似プロファイルのプロファイル属性の各値を比較して作成されます。
+ 各属性では、値が完全に一致している場合があります。この場合、その属性には任意の値を選択できます。
+ 類似プロファイルを構成する 2 つ以上のプロファイルの値に競合がある場合は、最後に更新された属性が選択されます。
例えば、Jane Doe が構成類似プロファイルの `Address` 属性に 3 つの異なる値を持つ場合、アイデンティティ解決は、統合プロファイルを作成するために最近使用されたものを選択します。
+ デフォルトでは、**[Last updated timestamp]** (最終更新されたタイムスタンプ) は、最近更新されたレコードを特定するために使用されます。
+ **プロファイルの競合は、ソースのオブジェクトタイプと新しさによって管理されます**。
+ また、競合する解決のデフォルトの動作を変更して、特定のソースから類似の構成プロファイルを正規のソースとして選択して、競合する解決を明示することもできます。
+ プロファイルの競合に使用するデータソースを指定する場合は、**[Source with last updated timestamp]** (タイムスタンプが最後に更新されたソース) を選択すると、いずれかのオブジェクトタイプをデータソースとして選択できます。
+ 指定したオブジェクトタイプから最後に更新されたレコードは、プロファイルの競合を解決するために使用されます。
+ **最終更新タイムスタンプは、最後に更新されたレコードを特定します**。
+ ソースレコードのオブジェクトタイプに関連付けられたタイムスタンプ属性は、最後に更新されたレコードを特定するために使用されます。
+ オブジェクトタイプのタイムスタンプ属性を使用できない場合は、レコードが Customer Profiles ドメインに取り込まれたタイムスタンプが使用されます。
+ カスタムオブジェクトタイプの場合、タイムスタンプを追加する必要があります。詳細については「[プロファイルの競合にタイムスタンプがない](create-consolidation-criteria.md#missing-timestamp-for-profile-conflicts)」を参照してください。
+ **統合は一方向のプロセスであり、元に戻すことはできません**。
+ 統合プロセスを開始する前に、条件を慎重に選択してください。詳細については、「[強力な条件を作成するためのヒント](create-consolidation-criteria.md#tips-for-creating-consolidation-criteria)」を参照してください。
+ データをマージすることなくアイデンティティ解決の自動マージ設定をテストする [GetAutoMergingPreview](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetAutoMergingPreview.html) API を使用します。
条件が適用される方法を示す例については、「[例: サンプル条件の適用方法](create-consolidation-criteria.md#criteria-examples)」を参照してください。
# Amazon Connect でのアイデンティティ解決のための機械学習のセットアップ
## 機械学習マッチング実行スケジュールの編集
![\[機械学習マッチング実行スケジュールを編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/machine-learning-ir-edit-run-schedule.png)
## 機械学習による一致のマージを編集する
![\[機械学習による一致のマージを編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/machine-learning-ir-edit-merge-matches.png)
## 機械学習による一致の場所を編集する
![\[機械学習による一致の場所を編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/machine-learning-ir-edit-match-location.png)
# Amazon Connect でのアイデンティティ解決のルールベースマッチング
AC のアイデンティティ解決は類似プロファイルを自動的に検出し、プロファイルの統合に役立ちます。このセクションのトピックでは、自動マージプロセスの一環として重複プロファイルを統合するためのルールベースのアイデンティティ解決を設定する方法を説明します。
**Topics**
+ [ルールベースの ID 解決の仕組み](how-rule-based-identity-resolution-works.md)
+ [ID 解決のルールベースのマッチングを設定する](setup-rule-based-matching.md)
+ [ルールベースの ID 解決のためのマッチングルールを設定する](setup-matching-rule-examples.md)
# Amazon Connect でのルールベースのアイデンティティ解決の仕組み
このトピックでは、ルールベースの ID 解決が自動プロファイルマッチングを実行する方法と、類似プロファイルを自動的にマージする方法について説明します。
## 自動プロファイル照合
ルールベースの ID 解決では、類似のプロファイルを識別するために、[マッチングルール属性](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html)のリストを使用して、各プロファイルを照合します。[MatchingRules](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html#customerprofiles-Type-RuleBasedMatchingRequest-MatchingRules) では、最大 15 個の MatchingRule 属性がサポートされています。
### マッチングルール
以下は、使用できる [MatchingRule](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_MatchingRule.html) 属性のリストです。最大 15 のマッチングルールレベルを設定できます。各マッチングルールでは、各プロファイルで次の個人を特定できる情報 (PII) 属性を使用できます。
+ **AccountNumber**
+ **Address.Address**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.City**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.Country**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.County**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.PostalCode**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.State**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **Address.Province**: Address、BusinessAddress、MaillingAddress、ShippingAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべての住所の類似性が確認されます。
+ **PhoneNumber**: PhoneNumber、HomePhoneNumber、MobilePhoneNumber など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定された電話番号の類似性が確認されます。
+ **EmailAddress**: EmailAddress、BusinessEmailAddress、PersonalEmailAddress など、[属性タイプセレクター](#rule-based-attribute-type-selector) で指定されたすべてのメールアドレスの類似性が確認されます。
+ **BirthDate**
+ **BusinessName**
+ **FirstName**
+ **LastName**
+ **MiddleName**
+ **[Gender]** (性別)
+ ***Attributes* プレフィックスを持つカスタマイズされた任意のプロファイル属性**
マッチングルールは優先度によって処理されます。例えば、最初のルールは、定義したい最も最適化されたルールにすべきであり、最も正確な結果を得るために使用する必要があります。
### 属性タイプセレクター
属性タイプセレクターには、ルールベースの ID 解決に不可欠な設定情報が格納され、プロファイルの照合が容易になります。これにより、属性タイプ間のプロファイルの比較を微調整し、各タイプ内で照合する主要な属性を選択できます。この機能では、3 つの異なる属性タイプを柔軟に設定できるため、マッチングプロセスを正確に制御できます。
+ **メールタイプ**
+ EmailAddress、BusinessEmailAddress、および PersonalEmailAddress から選択できます。
+ **PhoneNumber タイプ**
+ PhoneNumberNumber、HomePhoneNumber、および MobilePhoneNumber から選択できます。
+ **住所タイプ**
+ Address、BusinessAddress、MaillingAddress、および ShippingAddress から選択できます。
`ONE_TO_ONE` または `MANY_TO_MANY` を AttributeMatchingModel として選択できます。`MANY_TO_MANY` を選ぶと、システムは属性タイプのサブタイプ間で属性を照合できます。例えば、プロファイル A の EmailAddress フィールドの値とプロファイル B の BusinessEmailAddress フィールドの値が一致する場合、2 つのプロファイルは EmailAddress タイプで一致します。`ONE_TO_ONE` を選ぶと、システムはサブタイプが完全に一致する場合にのみ照合できます。例えば、プロファイル A の EmailAddress フィールドの値とプロファイル B の EmailAddress フィールドの値が一致する場合、2 つのプロファイルは EmailAddress タイプで一致します。
**マッチングに許可される最大ルールレベル**
類似のプロファイルの照合に使用する最大ルールレベルを設定できます。例えば、マッチングで許される最大ルールレベルが 5 の場合、システムはルールレベル 6 を使用して類似のプロファイルを検索しません。
### 一致グループ
一致グループは、お客様を表すすべての類似プロファイルで構成されます。各一致グループには、以下の情報が含まれます。
+ 問い合わせを表す 2 つ以上の類似プロファイルのグループを一意に識別する一致 ID
+ 一致グループ内のプロファイル ID の数
### 一致のステータス
+ **保留中**
ルールベースのマッチングルールを設定した後の最初のステータス。既存のドメインの場合、ルールベースの ID 解決は 1 時間待ってからマッチングルールを作成します。新しいドメインの場合、システムは **PENDING** ステージをスキップします。
+ **IN\$1PROGRESS**
システムは、ルールベースのマッチングルールを作成しています。このステータスでは、システムは既存のデータを評価中であり、ルールベースのマッチング設定を変更できなくなります。
+ **ACTIVE**
ルールはすぐに使用できます。ステータスが **ACTIVE** 状態になった翌日にルールを変更できます。
### 自動マッチングプロセスの仕組み
ルールベースのマッチングルールを使用して新しい Amazon Connect Customer Profiles ドメインを作成すると、ルールベースの ID 解決は、プロファイルの取り込み中に指定したルールに基づいて類似のプロファイルを照合します。ルールベースのマッチングの設定を更新した場合、Customer Profiles は 1 時間以内に新しい設定を使用してドメイン内のプロファイルの再評価を開始します。
既存のドメインでルールベースのマッチングを有効にした場合、システムは **PENDING** 状態に移行し、1 時間以内に新しい設定を使用してドメイン内の既存のプロファイルの評価を開始します。プロファイルの評価が完了するまでの時間は、存在するプロファイルの数によって異なります。
+ **デフォルトでは、カスタムルールが指定されていない場合、デフォルトルールが適用されます。**
+ カスタムマッチングルールを指定しない場合、Amazon Connect Customer Profiles にはデフォルトのマッチングルールが用意されています。カスタムマッチングルールはこちらで確認できます。
+ **すべてのレコードはルールベースのマッチングルールを通過します。**
+ システムは、一致が見つかるまで、またはマッチングできる最大ルールレベルに達するまで、各マッチングルールレベルを評価します。評価プロセスはルールレベル 1 から始まり、そこでレコードが分析されます。一致するグループが見つからなかった場合、システムはその後のルールレベルの評価を続け、一致が見つかるか、マッチングできる最大ルールレベルに達するまで、一致グループを検索します。
+ **1 つのマッチングルールレベルのすべての属性が、*AND* 関係を使用して接続されます。**
+ 1 つのルールレベル内に複数の属性が存在する場合、それらは AND 関係によって相互接続されます。プロファイルマッチング中、プロファイルが同じ一致グループに割り当てられるには、すべての属性値が揃っている必要があります。例えば、すべての属性の値が同じ場合にのみ、プロファイルは一致していると見なされ、後で処理するためにグループ化されます。
+ **属性タイプセレクターのすべての属性は、*OR* 関係で接続されます。**
+ 属性タイプセレクター内で属性を指定すると、同じタイプの属性が OR 関係を介してリンクされます。例えば、HomePhoneNumber と BusinessPhoneNumber が利用される PhoneNumber タイプを考えてみます。このシナリオでは、HomePhoneNumber または BusinessPhoneNumber のいずれかが同じ場合、2 つのプロファイルは一致とみなすことができます。そのため、マッチングプロセスでは、自宅または会社の電話番号に基づいて柔軟にマッチングできます。
+ **一致結果は最終的に最適化されます。**
+ システム内のプロファイルマッチングはほぼリアルタイムで行われるため、プロファイルの一致グループが低い (最適化されていない) ルールレベルで見つかる可能性があります。それでも、より高い (より最適化された) ルールレベルで一致するものがあれば、システムはその特定のグループにプロファイルを割り当てます。
**注記**
ID 解決がルールベースのマッチングを実行するとき、設定したルールが処理される順序は、データの取り込み方法によって異なります。例えば、ルール 1 と 2 を設定した場合、ルール 2 がルール 1 の前に処理される可能性があります。処理の順序は変わるかもしれませんが、最終結果は常に同じです。
## 類似プロファイルの自動マージ
プロファイルが一致したら、ID 解決ジョブは、ルールベースのマッチング設定で指定した [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html) に基づいて類似のプロファイルをマージできます。
**重要**
統合プロセスは元に戻すことはできません。ListMatches API と GetSimiliarProfiles API を使用してマッチ結果を評価するには、まずマッチングのみを有効にすることをお勧めします。[UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html) API を使用して [MaxAllowedRuleLevelForMerging](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_RuleBasedMatchingRequest.html) を設定することで、マージを有効にできます。
**注記**
2 つのプロファイルをマージする際、API コールまたはエージェントワークスペースによって手動で入力されたプロファイルフィールドが、統合またはカスタムオブジェクトタイプマッピングから自動的に取り込まれたプロファイルフィールドによって上書きされることはありません。
例えば、エージェントワークスペースのエージェントが FirstName「John」を使用してプロファイルを手動で作成したとします。FirstName「Peter」を持つ別のプロファイルが S3 統合を使用して作成されます。この 2 つのプロファイルが自動的に統合された場合、FirstName「John」が保持されます。
# Amazon Connect でのアイデンティティ解決のためのルールベースマッチングを設定する
このトピックでは、ルールベースマッチングの属性タイプ、ルールベースマッチングのルール、ルールベースマッチングのマージルール、ルールベースマッチングの場所を編集するために使用するステップの詳細な説明を示します。また、ルールベースマッチングのルールをリセットする方法も示します。
## ルールベースのマッチング属性タイプを編集する
![\[ルールベースのマッチング属性タイプを編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/rule-based-edit-attribute-types.png)
## ルールベースのマッチングルールを編集する
![\[ルールベースのマッチングルールを編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/rule-based-edit-matching-rules.png)
## ルールベースのマッチングルールをリセットする
![\[ルールベースのマッチングルールをリセットします。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/rule-based-edit-reset-rules.png)
## ルールベースのマッチングマージルールを編集する
![\[ルールベースのマッチングマージルールを編集する\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/rule-based-edit-merge-rules.png)
## ルールベースのマッチ位置を編集する
![\[ルールベースのマッチ位置を編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/rule-based-match-location.png)
# Amazon Connect でルールベースのアイデンティティ解決のためのマッチングルールを設定する
## 制限
標準プロファイルから任意の属性を選択し、類似プロファイルを比較できます。例えば、電話番号、メールアドレス、名前、およびカスタム属性を選択できます。
ルールベースのマッチングルールを作成できますが、次の制限があります。
+ 15 のルールレベル
+ 各ルールレベルには、最大 15 のプロファイル属性を含めることができます。
## ヒント
一意のプロファイルのターゲット設定を改善し、重複しないプロファイルの統合を回避するには、以下のヒントに従うことをお勧めします。
+ 電話番号、メールアドレス、アカウント番号など、顧客を一意に識別でき、顧客間で同じである可能性が低い高基数属性を少なくとも 1 つ含めてください。
+ 高基数属性がなくても、異なる ID に属する可能性のあるプロファイル属性は使用しないでください。
+ **[電話番号]** と **[名]**、**[姓]** の組み合わせは、**[名]** と **[姓]** のみの組み合わせより強いルールです。
+ あるルールレベルで、そのルールのすべてのプロファイル属性が低基数属性 (500 を超える異なるプロファイルに属する可能性のある属性) である場合、Customer Profiles はそのプロファイルの照合を試みません。ドメインの作成時に設定した場合、DLQ に次の SQS メッセージが表示されます。
+ ルールレベル x のすべての属性が 500 を超えるレコードに関連付けられています。
+ 常に、最初に **[一致のみ]** を有効にして、一致結果を確認し、一致結果に満足した場合にのみ、**[MaxAllowedRuleLevelForMerging]** を設定することによって、マージを有効にします。
## プロファイルマージのためのプロファイル競合の解決
住所レコードが競合しているなど、2 つ以上の類似したプロファイルの属性の値が異なる場合に使用するレコードを定義できます。
**最終更新日タイムスタンプ**
デフォルトでは、プロファイルの競合は新しさによって管理されます。2 つ以上の類似プロファイルの値が競合するときには、最後に更新された属性が選択されます。
**最終更新日タイムスタンプを含むソース**
プロファイルの競合を管理するためのデータソースとして、特定のオブジェクトタイプのレコードに優先順位を付けることができます。2 つ以上の類似プロファイルの値が競合するときには、指定されたオブジェクトタイプの最後に更新された属性が選択されます。
オブジェクトタイプでタイムスタンプが指定されていない場合は、レコードが Customer Profiles に取り込まれた日付が使用されます。統合を設定していない場合、最終更新日のタイムスタンプを含むソースは使用できません。統合を追加すると、オブジェクトタイプをこのオプションのソースとして使用できるようになります。
## プロファイルの競合にタイムスタンプがない
[Missing timestamp] (タイムスタンプがありません) メッセージは、カスタムオブジェクトタイプマッピングがある場合に表示されます。
カスタムオブジェクトタイプに次の新しい属性を追加するには、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API を使用します。
+ `Fields.sourceLastUpdatedTimestamp`
+ `sourceLastUpdatedTimestampFormat`
タイムスタンプ属性が指定されていない場合は、統合条件の作成を続行できますが、レコードが Customer Profiles に取り込まれたときのデフォルトのタイムスタンプが使用されます。統合条件を作成する前に、新しい属性を追加することをお勧めします。
カスタムオブジェクトタイプを既に定義しており、カスタムオブジェクトタイプを更新する場合は、スケジュールされたバックフィルを毎週実行して、既存のプロファイルを `Fields.sourceLastUpdatedTimestamp` で更新します。スケジュールされたバックフィルにオプトインするには、以下の手順に従ってください。
1. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API を使用して、カスタムプロファイルオブジェクトタイプを更新します。
1. カスタムプロファイルオブジェクトタイプを更新した後、[AWS サポートチケット](https://console.aws.amazon.com/support/home)を開きます。
1. AWS はユーザーに代わってバックフィルをスケジュールします。予定されているバックフィルは 2022 年 2 月末まで実行されます。
または、カスタムオブジェクトタイプを使用するドメインの取り込み/コネクタを削除して再作成することもできます。すべてのデータは、更新されたオブジェクトタイプを使用して再度取り込まれ、`Fields.sourceLastUpdatedTimestamp` はそこから解析されます。
## 例:マッチングの仕組み
### ONE\$1TO\$1ONE の例
`ONE_TO_ONE` を `AttributeMatchingModel` として選択できます。`ONE_TO_ONE` を選ぶと、システムはサブタイプが完全に一致する場合にのみ照合できます。
**例**:
`EmailAddress` タイプを表すために、`EmailAddress` と `BusinessEmailAddress` を使用しています。`AttributeMatchingModel` は、`ONE_TO_ONE` です。
**マッチングルールは次のとおりです**。
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
プロファイル A とプロファイル B は、`EmailAddress` タイプ、`LastName`、および `FirstName` が一致するため、ルールレベル 1 で一致します。
### MANY\$1TO\$1MANY の例
`MANY_TO_MANY` を `AttributeMatchingModel` として選択できます。`MANY_TO_MANY` を選ぶと、システムは属性タイプのサブタイプ間で属性を照合できます。
**例**:
`EmailAddress` タイプを表すために、`EmailAddress` と `BusinessEmailAddress` を使用しています。`AttributeMatchingModel` は、`MANY_TO_MANY` です。
**マッチングルールは次のとおりです**。
```
Rule Level 1: EmailAddress, LastName, FirstName
Rule Level 2: AccountNumber
```
```
Profile A:
EmailAddress: 1@email.com (match with Profile B’s BusinessEmailAddress)
BusinessEmailAddress: john@company.com
LastName: Doe
FirstName: John
AccountNumber: account1234
```
```
Profile B:
EmailAddress: 2@email.com
BusinessEmailAddress: 1@email.com (match with Profile A's EmailAddress)
LastName: Doe
FirstName: John
AccountNumber: account1234
```
プロファイル A とプロファイル B は、`EmailAddress` タイプ、`LastName`、および `FirstName` が一致するため、ルールレベル 1 で一致します。
# Amazon Connect Customer Profiles でアイデンティティ解決メトリクスを表示する
ID 解決がプロファイルを照合またはマージするときには、プロセスに関するメトリクスが Customer Profiles ダッシュボードに表示されます。**[アイデンティティ解決]** 概要ページで。パスウィークのメトリクスを確認できます。
アイデンティティ解決ジョブが実行されるたびに、次のメトリクスが生成されます。
+ **Match groups found** (検出された一致グループ): 見つかった一致グループの数。
+ ML ベースとルールベースの両方の ID 解決で使用できます。
+ **[マージされたプロファイル数]**: マージされたプロファイルの数。
+ ML ベースとルールベースの両方の ID 解決で使用できます。
+ **[ルール別の一致グループ]**: 各ルールレベルで作成された一致グループの数。
+ ルールベースの ID 解決でのみ使用できます。
![\[Amazon Connect Customer Profiles ページ、[アイデンティティ解決を有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ir-metrics-example-1.png)
![\[Amazon Connect Customer Profiles ページ、[アイデンティティ解決を有効にする] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-ir.png)
# Amazon Connect Customer Profiles でアイデンティティ解決を無効にする
## 機械学習ベースを無効にする
類似プロファイルを自動的に検出したくない場合は、機械学習ベースのマッチングを無効にできます。統合条件がある場合、すべての条件が削除され、プロファイルは自動的に統合されなくなります。既に統合されているプロファイルは、統合されたままになります。
## ルールベースのマッチングを無効にする
類似プロファイルを自動的に検出したくない場合は、ルールベースのマッチングを無効にできます。カスタムマッチングルールがある場合、マッチングルールは削除され、プロファイルは自動的に統合されなくなります。既に統合されているプロファイルは、統合されたままになります。
# AWS エンティティ解決による解決
Amazon Connect Customer Profiles には、AWS Entity Resolution から一致する結果を直接インポートできる*マネージドコネクタ*が用意されています。この統合により、Amazon Connect で顧客プロファイルを維持しながら、AWS Entity Resolution の強力なマッチング機能を活用できます。
AWS Entity Resolution は、ルール、機械学習、サードパーティーのデータプロバイダーなどの柔軟なマッチング手法を使用して、さまざまなデータソース間で関連レコードを照合およびリンクするのに役立ちます。エンティティ解決結果を Customer Profiles に接続することで、次のことが可能になります。
+ 複数のシステムからの顧客レコードをより正確に統合する
+ 特定のビジネスニーズに基づいて高度なマッチングロジックを適用する
+ さまざまなアプリケーションやチャネルからリンクされたデータを使用して顧客プロファイルを強化する
+ 組織全体で一貫した顧客ビューを維持する
Customer Profiles で AWS エンティティ解決の使用を開始するには、まず AWS エンティティ解決コンソールで一致するワークフローを設定する必要があります。[AWS エンティティ解決の詳細をご覧ください](https://docs.aws.amazon.com/entityresolution/latest/userguide/create-matching-workflow.html)。
これをセットアップするには、次の前提条件が必要です。
+ Customer Profiles が有効になっているアクティブな Amazon Connect インスタンス
+ Amazon S3 に保存されている顧客データ
+ AWS エンティティ解決にアクセスするための適切な IAM アクセス許可
**を設定するには、次の手順に従います。**
1. Customer Profiles ドメインを作成する
+ まだ作成していない場合は、Connect インスタンスに Customer Profiles ドメインを作成します。
+ Amazon Connect コンソールの Customer Profiles セクションに移動します。
+ 注: ドメインの作成後に AWS Entity Resolution の新しいセクションが表示されます。
1. AWS エンティティ解決の設定
+ Customer Profiles ドメインで、AWS エンティティ解決セクションを見つけます。
+ 「AWS エンティティ解決の設定」をクリックします。
+ AWS エンティティ解決コンソールにリダイレクトされます。
+ 一致するワークフローを作成する
+ S3 データソースを設定する
+ 一致する条件を定義する
+ 一致するワークフローを確認してアクティブ化する
1. エンティティ解決結果を Customer Profiles に接続する
+ Customer Profiles ドメインに戻る
+ エンティティ解決ワークフローを選択する
+ 一致したレコードを統合する方法を設定する
+ 統合を有効にする
# 外部アプリケーションと Amazon Connect Customer Profiles との統合
Amazon Connect には、Amazon AppFlow および Amazon EventBridge による一連の組み込み済みの統合が用意されています。Amazon Connect Customer Profiles を有効にすると、これらの統合を使用して、SalesforceやZendeskなどの外部アプリケーションからの情報と、Amazon Connectからの問い合わせ履歴を組み合わせることができます。これにより、顧客とのやり取り中にエージェントが必要とするすべての情報を含むお客様プロファイルが 1 か所に作成されます。
Amazon AppFlow で Customer Profiles を使用することもできます。Amazon AppFlow は送信先として `CustomerProfiles` をサポートします。Amazon AppFlow API を使用して、宛先名として `CustomerProfiles` を使用し、Customer Profiles にデータを送信できます。
作業を開始する前に、カスタマーマネージドキーを使用していることを確認してください。複数値を持つ条件キーの詳細については、[Customer Profiles によってデータの暗号化に使用される KMS キーを作成する (必須)](enable-customer-profiles.md#enable-customer-profiles-awsmanagedkey) を参照してください。
## 統合をセットアップする
以下のユースケースに最も適した方法を選択して、Amazon Connect のおすすめアプリケーションまたは Amazon AppFlow を使用する外部アプリケーションによって統合をセットアップできます。ServiceNow と Slack の統合の詳細については、ブログ記事「[Combine data from multiple sources using Amazon AppFlow and build a unified Amazon Connect Customer profile for contact center agents](https://aws.amazon.com/blogs/contact-center/unified-customer-data/)」(Amazon AppFlow を使用して複数のソースのデータを結合し、コンタクトセンターのエージェント向けに統合した Amazon Connect Customer Profile を構築する) を参照してください。
**Topics**
+ [統合をセットアップする](#setup-integrations-title-menu)
+ [Amazon Connect のおすすめアプリケーションの統合をセットアップする](integrate-customer-profiles-appflow.md)
+ [Amazon AppFlow を使用して外部アプリケーションの統合をセットアップする](integrate-external-applications-appflow.md)
+ [
# Customer Profiles の削除/統合の停止
](delete-customer-profile-connection.md)
# Amazon Connect のおすすめアプリケーションの統合をセットアップする
これらの統合は、Amazon Connect のおすすめアプリケーションを使用して、Amazon Connect Customer Profiles を定期的に更新します。
## [開始する前に]
### データの一括取り込み
統合を設定すると、データの取り込みを開始する日付を入力するように求められます。2 か月以上前の日付を選択した場合、複数のフローを作成することで、Customer Profiles の一括取り込みが自動的に有効になります。これにより、データを取り込むのに必要なフロー数を計算する必要がなくなります。
自動一括取り込みが有効になっている場合、Customer Profiles では次の処理を実行します。
+ バッチサイズを 2 か月に設定します。
+ 一時的な障害に対しては、最大 3 回再試行してから失敗とします。
[CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html) API を使用して、独自のバッチサイズを呼び出すことができます。
### IAM ロールを選択または作成するように求められるのはなぜですか。
Salesforce、Marketo、ServiceNow では、Customer Profiles によって IAM ロールを使用して複数のワークフローを作成し、データを迅速かつ効率的に取り込むことで、これらのソースの履歴取り込みを改善するのに役立ちます。
これらのソースでは、**レコードをインポートする日付**を日付ピッカーで 60 日より前の日付を設定すると、新しい IAM ロールを作成するか、既存のロールを選択するよう求められます。このロールにより、Customer Profiles で統合を管理できます。Customer Profiles には、データを取り込むためのワークフローを更新および作成するために必要な権限が与えられます。ワークフローが完了すると、Customer Profiles によって標準の継続的インテグレーションが作成され、ソースで更新した際に新しいデータを取り込みます。
コンソールで作成されたロールは、作成されたドメインでのみ使用できます。これは、Amazon Connect がロールのアクセスをドメインで使用する KMS キーのみに制限しているためです。
詳細については、「[Customer Profiles 実行ロールへの最小権限アクセスを付与する](#grant-least-privilege-cp)」を参照してください。
## Customer Profiles 実行ロールへの最小権限アクセスを付与する
独自の IAM ロールを作成する場合は、次のコードに示すアクセス権限を使用して、ロールを最低限必要な権限に制限することをお勧めします。以下のスニペットを使用して、手動でロールを作成します。独自の KMS キーを使用して、必要に応じてリージョンを指定します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## Customer Profiles 統合をモニタリングする
接続が確立されてから動作しなくなったら、統合を削除してから再確立します。
## オブジェクトが送信されていない場合の対処方法
オブジェクトの送信に失敗した場合には、[**フローの詳細**] をクリックして不具合の詳細を表示します。
設定を削除して、外部アプリケーションに再接続する必要がある場合があります。
# Amazon Connect Cases の統合を設定する
Amazon Connect Customer Profiles で Amazon Connect Cases データを更新し、計算属性などの機能を使用するには、Amazon AppIntegrations を使用して統合できます。まず、EventBridge バスにシステムフィールドを送信するように Cases イベントストリームを設定してから、Amazon AppIntegrations を使用してこれらのイベントを Customer Profiles に転送します。
## Amazon Connect Cases から Event Bridge にデータをストリーミングする
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. ナビゲーションペインで **[ケース]** を選択し、**[ドメインの詳細]** セクションにある Cases ドメイン ID をメモします。
![\[Cases ページ、ドメインの詳細セクション、ドメイン ID を指す矢印。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. を使用して AWS CLI、Amazon Connect Cases Events を AWS アカウントデフォルトの Event Bridge バスに送信する Case イベント設定を作成します。
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. AWS リージョンの Event Bridge コンソールを開きます。例: [https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. [**イベントバスの作成 (Create event bus)**] を選択します。
![\[Amazon EventBridge コンソールのイベントバスページ、イベントバスの作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. `connect-cases-to-customer-profiles` という名前のイベントバスを作成します。
![\[イベントバスの作成ページ、名前ボックス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. **デフォルトのイベントバス**に戻り、`connect-cases-to-customer-profiles-rule` という名前のルールを作成します。
![\[デフォルトのイベントバス、ルールの作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[イベントパターンの構築手順。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ イベントパターンのスニペット:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[作成方法セクション、カスタムパターン (JSON エディタ) オプション、イベントパターンコード。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ **[スキップして確認および作成]**、**[ルールを作成]** の順に選択します。
![\[スキップして確認および作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## AppIntegrations を使用して Event Bridge ケースデータを Customer Profiles に取り込む
1. を使用して AWS CLI、AppIntegrations とのイベント統合を作成し、ARN 出力を記録します。 これは、Amazon Connect インスタンスが使用できるソースデータを表します。
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. を使用して AWS CLI、put-integration API を使用して Customer Profiles との統合を作成します。これにより、Customer Profiles へのデータフローが開始され、プレースホルダーの値がイベント統合 ARN と Customer Profile のドメイン名に置き換えられます。
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Cases 統合を検証する
1. Amazon Connect Cases でケースを作成します。
1. イベントの配信はほぼ瞬時に行われるはずですが、配信されて顧客プロファイルに関連付けられるまで 1 分ほどかかります。
1. を使用して AWS CLI、プロファイルで Connect-case オブジェクトを見つけ、プレースホルダーを正しい値に置き換えます。
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. 上記の API コールのレスポンスに項目が見つからない場合は、統合に問題があります。トラブルシューティング：
1. Amazon EventBridge コンソールに移動します。
1. EventSource がアクティブで、一致する EventBus が存在し、実行されているかどうかを確認します。
1. Case イベント設定が正しく設定されているかどうかを確認します。
1. これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
# Salesforce、ServiceNow、Marketo、または Zendesk と Amazon Connect の統合を設定する
Amazon Connect Customer Profiles を定期的に更新するには、Amazon AppFlow を使用して Salesforce、ServiceNow、Marketo、または Zendesk と統合できます。最初に Amazon Connect と選択したアプリケーションの接続をセットアップし、次に統合を検証します。
## Amazon Connect と Salesforce、ServiceNow、Marketo、または Zendesk の接続をセットアップする
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、**[Customer profiles]** (お客様プロファイル) を選択します。
1. 次の図に示すように、**[顧客プロファイルの設定]** ページで **[統合を追加]** を選択します。
![\[[顧客プロフィール設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[データソースの選択]** ページで、顧客プロファイルデータを取得する外部アプリケーションを選択します。[[integration requirements]](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) (統合要件) を参照すると、アプリケーションの接続要件を詳しく確認できます。
![\[[データソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続を使用**: これにより、AWS アカウントなどで作成した既存の Amazon AppFlow リソースを再利用できます。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. **[Integration options]** (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。ユーザーが作成したデータマッピングの Salesforce 統合を追加または作成する場合、特定のデータマッピングを指定する必要があります。指定しないと、Salesforce のデフォルトのデータマッピングがオブジェクトタイプとして選択されます。データマッピングを作成し、これを使用しておすすめのデータコネクタを設定できます。
![\[[統合オプション] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. **[Ingestion start date]** (取り込み開始日) の場合、Customer Profiles はこの日付以降に作成されたレコードの取り込みを開始します。デフォルトでは、レコードのインポート日は 30 日前に設定されます。
1. [**確認と統合**] ページで、[**接続ステータス**] が [**接続済み**] であることを確認してから、[**統合の作成**] を選択します。
![\[[確認と統合] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. 統合の設定後、**[Customer profiles configuration]** (お客様プロファイルの設定) ページに戻って **[View objects]** (オブジェクトの表示) を選択して、どのデータがバッチ処理され、送信されているかを確認します。現在、このプロセスは、直近 30 日間に作成または変更されたレコードを取り込みます。
![\[[顧客プロファイル設定] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Amazon Connect Customer Profiles に定期的な更新を提供するためにセグメントの統合を設定する
Amazon Connect Customer Profiles を定期的に更新するために、Amazon AppFlow を使用してセグメントと統合できます。最初に Amazon Connect とセグメントで接続を設定し、次にセグメントの統合を確認します。
## Amazon Connect とセグメントで接続を設定する
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、[**お客様プロファイル**] を選択します。
1. **[お客様プロファイルの設定]** ページで **[統合の追加]** を選択します。
![\[[顧客プロファイル設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[データソースの選択]** ページで、**[セグメント]** を選択します。**[アプリケーションの選択]** ページに記載されているアプリケーションの要件を確認します。
![\[[データソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続**を使用する: これにより、 で作成した既存の Amazon EventBridge リソースを再利用できます AWS アカウント。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **接続名**: 接続の名前を指定します。接続名は、この接続を使用する統合によって参照されます。
+ **接続 URL**: アプリケーション接続 URL を入力します。この URL は、外部アプリケーションで作成されたタスクへのディープリンクに使用されます。接続 URL は、アプリケーションウェブサイトで使用できるセグメントワークスペースの URL です。
ワークスペース URL を検索するには:
1. segment.com アカウントにログインします。
1. **[Settings]** (設定) 、**[General settings]** (全般設定) と移動します。
1. ブラウザから URL をコピーします。
1. Customer Profiles は、セグメントとの統合に Amazon EventBridge を使用します。**ソース設定**ページで、 AWS アカウント ID をクリップボードにコピーし、**セグメントにログイン**して Amazon EventBridge を設定します。
1. 次のステップに従って、セグメントを設定します。
1. セグメントにログインします。
1. アプリケーションで、Amazon EventBridge への送信先を設定するソースを選択します。
1. AWS アカウント ID を貼り付け、 AWS リージョンを選択します。
1. **[ON]** (オン) に切り替え、パートナーイベントソースをアクティブ化します。
1. **[Event Tester]** (イベントテスター) へ移動し、テストイベントを送信して、パートナーイベントソースのアクティブ化を完了します。
1. **クライアント ID**: これは、外部アプリケーションでクライアントを一意に区別する文字列です。このクライアント ID は、アプリケーションウェブサイトで使用できるソース名です。指定した ID を使用して、Customer Profiles でオブジェクトを取り込むクライアントを特定します。
ソース ID を検索するには、次の操作を行います。
1. **[Sources]** (ソース) へ移動し、ソースを選択します。
1. **[Settings]** (設定) 、**[API Keys]** (API キー) と移動します。
1. **[Source ID]** (ソース ID) をコピーします。
イベントソースの送信先を設定したら、Customer Profiles コンソールに戻り、クライアント ID をペーストします。
1. Amazon Connect がセグメントに正常に接続されたことを示すアラートが表示されます。
1. **[Integration options]** (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。
![\[[統合オプション] ページ、[オブジェクトタイプ] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. [**Ingestion start date**] (取り込み開始日) の場合、Customer Profiles は統合が追加された日付以降に作成されたレコードの取り込みを開始します。
**注記**
履歴レコードが必要な場合は、[インポートする統合ソースとして Amazon S3 を使用](customer-profiles-object-type-mappings.md)することができます。
1. **[Review and integrate]** (確認と統合) ページで、**[Connection status]** (接続ステータス) が **[Connected]** (接続済み) であることを確認してから、**[Add integration]** (統合の追加) を選択します。
1. 統合が設定されたら、**[Customer profiles configuration]** (Customer Profiles の設定) ページに戻ります。**[Integrations]** (統合) ページには、現在設定されている統合が表示されます。**[Last run]** (最後の実行) および **[Integration health]** (統合ヘルス) は、このタイプの統合では現在使用できません。
![\[[顧客プロフィール設定] ページ、[統合] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
送信されているデータを確認するには、統合を選択してから、**[View objects]** (オブジェクトの表示) を選択します。
## セグメントの統合を確認する
このステップを実行するには、次の前提条件を満たしている必要があります。
+ セグメントワークスペースにアクセスします。
+ [Amazon Connect お問い合わせコントロールパネルへのアクセス](amazon-connect-contact-control-panel.md)。
**セグメントの統合を確認するには**
1. セグメントワークスペースダッシュボードに移動し、**[Destinations]** (送信先) を選択します。
![\[[セグメント概要] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. セグメントがデータを送信する送信先のリストが表示されます。Customer Profiles の EventBridge 送信先 を選択します。
![\[[送信先一覧] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. **[Event Tester]** (イベントテスター) タブを選択します。このページから、Customer Profiles にテストイベントを送信します。イベントが取り込まれ、Amazon Connect エージェントアプリケーションで表示できる Customer Profiles に変換されます。
![\[[イベントテスター] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. イベントタイプとして **[Identify]** (識別) を選択し、入力方法として **[Event Builder]** を選択します。
1. **ユーザー ID** といくつかの特性を指定できます。エージェントは、エージェントアプリケーションでこれらの特性を検索できます。
1. **[Send Event]** (イベントの送信) を選択します。
1. イベントの配信はほぼ瞬時に行う必要がありますが、配信して顧客プロファイルを作成するには 1 分ほどかかります。
1. Amazon Connect エージェントアプリケーションを開きます。[**Event Builder**] で入力したユーザ ID を検索します。ユーザー ID と入力した特性を持つ顧客プロファイルが表示されます。
1. 顧客プロファイルが表示されない場合は、統合に問題があります。トラブルシューティング：
1. Amazon EventBridge コンソールに移動します。
1. EventSource がアクティブで、一致する EventBus が存在し、実行されているかどうかを確認します。
これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
## Customer Profiles 統合をモニタリングする
接続が確立されてから動作しなくなったら、統合を削除してから再確立します。
## オブジェクトが送信されていない場合の対処方法
オブジェクトの送信に失敗した場合には、[**フローの詳細**] をクリックして不具合の詳細を表示します。
設定を削除して、外部アプリケーションに再接続する必要がある場合があります。
# Amazon Connect Customer Profiles に定期的な更新を提供するために Shopify の統合を設定する
Amazon Connect Customer Profiles を定期的に更新するために、Amazon AppIntegrations を使用して Shopify と統合できます。最初に Amazon Connect と Shopify で接続を設定してから、Shopify の統合を確認します。
## Amazon Connect と Shopify で接続を設定する
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、[**お客様プロファイル**] を選択します。
1. **[お客様プロファイルの設定]** ページで **[統合の追加]** を選択します。
![\[[顧客プロフィール設定] ページ、[統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. **[Select source]** (ソースの選択) ページで、**[Shopify]** を選択します。**[アプリケーションの選択]** ページに記載されているアプリケーションの要件を確認します。
![\[[ソースの選択] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. **[接続の確立]** ページで、以下のいずれかを選択します。
+ **既存の接続**を使用する: これにより、 で作成した既存の Amazon EventBridge リソースを再利用できます AWS アカウント。
+ **新しい接続を作成**: 外部アプリケーションで必要な情報を入力します。
![\[[接続の確立] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **接続名**: 接続の名前を指定します。接続名は、この接続を使用する統合によって参照されます。
+ **接続 URL**: アプリケーション接続 URL を入力します。この URL は、外部アプリケーションで作成されたタスクへのディープリンクに使用されます。接続 URL は、アプリケーションウェブサイトで使用できる Shopify パートナーアプリの URL です。
Shopify パートナーアプリの URL を見つけるには:
+ partners.shopify.com アカウントにログインします。
+ アプリに移動します。
+ ブラウザから URL をコピーします。
+ **クライアント ID**: アプリケーションクライアント ID を入力します。これは、外部アプリケーションでクライアントを一意に区別する文字列です。このクライアント ID は、アプリケーションウェブサイトで使用できるソース名です。ここで指定した ID を使用して、Customer Profiles でオブジェクトを取り込むクライアントを特定します。クライアント ID は、ソースの設定ステップを実行した後に利用可能になる場合があります。
ソース名を見つけるには:
+ partners.shopify.com アカウントにログインします。
+ アプリに移動します。
+ Amazon EventBridge イベントソースからソース名をコピーします。
1. **ソース設定**ページで、 AWS アカウント ID をクリップボードにコピーし、「Log **in to Shopify**」を選択します。
1. 次のステップに従って、Shopify を設定します。
1. partners.shopify.com にログインします。
1. Amazon EventBridge で、**[Create source]** (ソースの作成) を選択します。
1. AWS アカウント ID を貼り付け、 AWS リージョンを選択します。
1. イベントソースの送信先を設定したら、Customer Profiles に戻ります。Amazon Connect が Shopify に正常に接続されたことを示すアラートが表示されます。
1. [**Integration options**] (統合オプション) ページで、取り込むソースオブジェクトを選択し、そのオブジェクトタイプを選択します。
オブジェクトタイプには、取り込まれたデータが保存されます。また、統合からオブジェクトが取り込まれたときにプロファイルにマッピングされる方法も定義します。Customer Profiles には、ソースオブジェクトの属性が Customer Profiles の標準オブジェクトにどのようにマッピングされるかを定義できる、デフォルトのオブジェクトタイプテンプレートが用意されています。また、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) から作成したオブジェクトマッピングを使用することもできます。
![\[[統合オプション] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. [**Ingestion start date**] (取り込み開始日) の場合、Customer Profiles は統合が追加された日付以降に作成されたレコードの取り込みを開始します。
**注記**
履歴レコードが必要な場合は、[インポートする統合ソースとして Amazon S3 を使用](customer-profiles-object-type-mappings.md)することができます。
1. **[Review and integrate]** (確認と統合) ページで、**[Connection status]** (接続ステータス) が **[Connected]** (接続済み) であることを確認してから、**[Add integration]** (統合の追加) を選択します。
**注記**
この統合を追加したら、次の作業を行う必要があります。[Webhook サブスクリプションを設定](#shopify-webhook-subscriptions)して、イベントがこの統合に流入し始めることを許可します。
![\[[確認と統合] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. 統合が設定されたら、**[顧客プロファイル設定]** ページに戻ります。**[統合]** セクションに、現在設定されている統合が表示されます。**[Last run]** (最後の実行) および **[Integration health]** (統合ヘルス) は、このタイプの統合では現在使用できません。
![\[[統合] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
送信されているデータを確認するには、統合を選択してから、**[View objects]** (オブジェクトの表示) を選択します。
1. 次のステップに進み、API を使用して、**[webhook subscriptions]** (Webhook のサブスクリプション) を設定します。これで、イベントがこの統合に流入し始めることができます。
## Webhook サブスクリプションを設定する
1. 次の URL を使用して、アプリに必要な許可があることを確認します。
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
コードの説明は以下のとおりです。
+ `shop` は、Shopify ストアの名前です。
+ `api_key` は、Shopify アプリの API キーです。これは、Shopify **[App]** 詳細ページ にあります。
+ `scopes` は、値 `read_customers,read_orders,read_draft_orders` が必要です。
+ `redirect_uri` は、アプリの作成時に指定したリダイレクト URI です。私たちの目的では、任意の有効な URL にすることができます。
+ `nonce` は、他の要求からの特定の承認要求を識別するために、任意の一意の値を指定できます。タイムスタンプを使用することをお勧めします。
URL を作成したら、ブラウザに貼り付けます。次のイメージのようなインストール/承認ページが表示され、ストア所有者に定義済みのスコープに対する許可を付与するよう求められます。
![\[アプリをインストールして承認するための Shopify ページの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. **[リストされていないアプリをインストール]** を選択し、ストアに代わってアプリをインストールして承認します。
クエリパラメータとしてリダイレクト URI に認可コードを追加して入力したリダイレクト URI に移動します。例:
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. この URI から `authorization_code` をコピーします。次のステップで永続的なアクセストークンを取得するために使用します。
1. API コールを行うために使用するツールに移動します。例えば、[CURL](https://curl.se/) または [POSTMAN](https://www.postman.com/) です。
1. 永続的なアクセストークンを取得するには、このエンドポイントへの Shopify `Admin` API リクエストを作成します。
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
以下のリクエストボディを使用します。
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
このリクエストは次のレスポンスを返します。
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. `access_token` を書き留めます。これは、前のステップで指定したスコープを持つ永続的なトークンです。これで、Webhook サブスクリプションを作成する準備ができました。
1. 次の API コールでは、必ず HTTP ヘッダーキー `X-Shopify-Access-Token` を、以前の通話の応答から受信した `access_token` に設定します。
1. Webhook サブスクリプションを設定するには、次の手順にリストされている `topic` 値ごとに、次の POST リクエストを実行します。
エンドポイント: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
リクエスト本文:
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. サブスクリプションごとに、`topic` の値を、以下の値に置き換えます。
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
これで、Shopify ストアからイベントを受信する設定が完了しました。次に、Shopify 統合を検証します。
## Shopify 統合を検証します。
1. Shopify ストアに管理者としてサインインします。
1. 左のナビゲーションメニューの **[Customers]** (顧客) を選択します。
1. **[Add Customer]** (顧客の追加) を選択します。
1. 顧客の詳細を入力します。電話番号と E メールアドレスを必ず入力してください。これらは実際の顧客に属している必要はありません。このカスタマーエントリは、統合の検証後に削除されます。
1. 顧客オブジェクトを保存します。
1. イベントの配信はほぼ瞬時に行う必要がありますが、配信して顧客プロファイルを作成するには 1 分ほどかかります。
1. Amazon Connect エージェントエクスペリエンスを開き、Shopify ストアに入力した E メールまたは電話番号でユーザーを検索します。同じ E メールまたは電話番号で顧客プロフィールを表示できます。
1. 顧客プロファイルが表示されない場合は、統合に問題があります。トラブルシューティング：
1. Amazon EventBridge コンソールに移動します。
1. EventSource がアクティブで、一致する EventBus が存在し、実行されているかどうかを確認します。
これらが機能している場合は、問題の調査 サポート について にお問い合わせください。
## Customer Profiles 統合をモニタリングする
接続が確立されてから動作しなくなったら、統合を削除してから再確立します。
## オブジェクトが送信されていない場合の対処方法
オブジェクトの送信に失敗した場合には、[**フローの詳細**] をクリックして不具合の詳細を表示します。
設定を削除して、外部アプリケーションに再接続する必要がある場合があります。
# Amazon AppFlow を使用して外部アプリケーションの統合をセットアップする
これらの統合では Amazon AppFlow を使用して、Amazon Connect の Customer Profiles を定期的に更新します。次の手順では、Amazon AppFlow を使用した任意のコネクタの設定、データマッピングの設定、顧客データを取り込むための統合の設定の方法を示します。
Amazon AppFlow の料金の詳細については、Amazon AppFlow の「[料金](https://aws.amazon.com/appflow/pricing/)」を参照してください。
Amazon AppFlow がサポートするコネクタの詳細については、「[Supported source and destination applications](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)」(サポートされているソースアプリケーションと宛先アプリケーション) を参照してください。
## [開始する前に]
Amazon Connect Customer Profiles を有効にすると、Customer Profiles ドメインが作成されます。これは、顧客プロファイル、オブジェクトタイプ、プロファイルキー、暗号化キーなど、すべてのデータのコンテナとなります。Customer Profile ドメインを作成するためのガイドラインを以下に示します。
+ 各 Amazon Connect インスタンスは、1 つのドメインにのみ関連付けることができます。
+ 複数のドメインを作成できますが、外部アプリケーション統合や顧客データを相互に共有することはできません。
+ 作成する外部アプリケーション統合はすべて、ドメインレベルです。ドメインに関連付けられたすべての Amazon Connect インスタンスは、ドメインの統合を継承します。
**前提条件: Amazon Connect インスタンスで Customer Profiles を有効にする**
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
1. ナビゲーションペインで、**[Customer profiles]** (お客様プロファイル) を選択します。
1. [Customer Profiles を有効化] を選択する
フォームでは、以下の手順に従って、すべての必須フィールドに入力し、Customer Profiels ドメインを作成する必要があります。
1. **[Domain Setup]** (ドメインのセットアップ)。新しいドメインを作成して名前を指定できます。
1. **[Encryption]** (暗号化)。[Specify KMS key] (KMS キーを指定) で、既存の AWS KMS キーを選択するか、新しい AWS KMS キーを作成するか、**[Select existing domain]** (既存のドメインを選択) を選択するかして、暗号化を有効化できます。
1. **[Error Reporting]** (エラーレポート)。顧客プロファイルのエラーを処理する SQS キューであるデッドレターキューを指定できます。
1. **[Submit]** (送信) を選択すると、インスタンスのコンタクト履歴情報を使用して Customer Profiles が作成されます。
### Amazon AppFlow を使用して外部アプリケーションをセットアップする
次の手順に従って、Amazon AppFlow を使用して Amazon Connect Customer Profiles ドメインに外部アプリケーション統合を追加できます。Customer Profiles コンソールで操作を続ける前に、Amazon AppFlow コンソールでデータソースのフローを作成し、Amazon Connect Customer Profiles を宛先として設定する必要があります。14 日より前にフローを作成した場合、そのフローは有効期限が切れているため、統合用に新しいフローを作成する必要があります。
取り込み`AWS::AppFlow::Flow Task`前にリソース`Validate`を使用する場合 CloudFormation 、オプションで `Arithmetic`、`Filter`、`Map`、`Map_all`、`Mask``Merge``Truncate`、、 などのデータ変換を実行できます。
1. AWS マネジメントコンソールにログインし、Amazon AppFlow を選択し、**フローの作成**を選択します。
![\[[Amazon AppFlow] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step1.png)
1. フローの名前とフローの説明 (オプション) を入力します。
![\[[フローの詳細] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step2.png)
1. Amazon Connect Customer Profiles ドメインには、このフローに使用される既存の AWS KMS キーが既にあるため、**データ暗号化**セクションはそのままにしておくことができます。オプションとして、タグを作成し、**[Next]** (次へ) を選択できます。
![\[[データ暗号化] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step3.png)
1. **[Source name]** (ソース名) ドロップダウンで希望する外部アプリケーションを選択し、次の関連フィールドを選択します。例えば、Slack を設定する場合は、**[Source name]** (ソース名) ドロップダウンから [Slack] を選択します。次に、既存の Slack フローを選択するか、新しい接続を作成することができます。
![\[[フローの設定] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step4.png)
1. 新しい接続を作成する場合は、ユーザー名、パスワード、サブドメインなどの外部アプリケーションの詳細を入力できます。データ暗号化の AWS KMS キーを選択し、接続名を入力してこの接続を識別することもできます。
![\[[Slack に接続] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step5.png)
1. 既存の接続を使用する場合は、ドロップダウンから特定の外部アプリケーションオブジェクトを選択できます。例えば、既存の Slack 接続を選択する場合、**[Conversations]** (会話) をオブジェクトとして指定し、使用する特定の Slack チャンネルを選択できます。
![\[[ソースの詳細] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step6.png)
1. **[Destination details]** (宛先の詳細) セクションで、ドロップダウンで宛先名として Amazon Connect を選択し、以前の前提条件ステップで作成した Customer Profiles ドメインを選択します。
![\[[送信先の詳細] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step7.png)
1. **[オンデマンドで実行]** または **[スケジュール通りにフローを実行]** を選択して、フロートリガーを選択します。[**次へ**] を選択します。
+ **[オンデマンドで実行]** は、フローをトリガーしたときだけにフローを実行します。
+ **[スケジュール通りに実行]** は、スケジュールを使用して特定の時間にフローを実行します。スケジュール頻度は 5 分、15 分、または 1 時間に制限されています。
![\[[フロートリガー] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step8.png)
1. **[Mapping method]** (マッピング方法) で **[Manually map fields]** (手動でフィールドをマッピングする) を選択します。外部アプリケーションのソースフィールドを選択し、**[Map fields directly]** (フィールドを直接マッピングする) を選択します。
![\[[マッピング方法] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-create-flow-step9.png)
1. 確認して、**[Create flow]** (フローを作成) を選択します。
Amazon AppFlow コンソールでフローを作成する方法の詳細については、「[Amazon AppFlow でのフローの作成](https://docs.aws.amazon.com/appflow/latest/userguide/create-flow.html)」を参照してください。
Amazon AppFlow での外部アプリケーションや、他の多くのサポートされているアプリケーションのセットアップの詳細については、「[Amazon AppFlow でサポートされているソースおよび宛先アプリケーション](https://docs.aws.amazon.com/appflow/latest/userguide/app-specific.html)」を参照してください。
### データマッピングを設定して、外部アプリケーションデータを顧客プロファイルにマッピングする方法を定義する
Amazon AppFlow 統合をセットアップしたら、Customer Profiles のデータマッピングを設定して、外部アプリケーションのデータを顧客プロファイルにマッピングする方法を定義する必要があります。これにより、統合した顧客プロファイルの構築に使用するデータをカスタマイズできます。統合の作成後は別のマッピングを選択できなくなるため、マッピングは慎重に選択してください。
データマッピングの詳細については、「[オブジェクトタイプのマッピング](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-object-type-mapping.html)」を参照してください。
1. AWS マネジメントコンソールにログインし、**Amazon Connect** を選択し、接続インスタンスエイリアスで Customer Profiles を選択します。
![\[Amazon Connect Customer Profiles ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step1.png)
1. **[Data mappings]** (データマッピング)、**[Create data mapping]** (データマッピングを作成) の順に選択します。データマッピングの名前と説明を入力します。
![\[[データマッピング] タブ、[データマッピングの作成] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2.png)
![\[[データマッピングの設定] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step2_2.png)
1. **[Mapping options]** (マッピングオプション) で、外部アプリケーションとして **[Data source]** (データソース)、前のセクションで作成した**フローの名前**、および **[Mapping destination]** (マッピング先) として *[Data definition method]* (データ定義メソッド) を選択できます。**[Mapping destination]** (マッピング先) で、統合した顧客プロファイル用に定義する顧客データのタイプを選択できます。[**次へ**] を選択します。
![\[[マッピングオプション] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step3.png)
1. 顧客、製品、ケース、注文の属性を、ソース、宛先、コンテンツタイプとともに追加し、**[Next]** (次へ) を選択します。
![\[[マップ順序属性] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step4.png)
1. **[Specify identifiers]** (識別子を指定) で、データを他のデータソースオブジェクトから区別するために役立つデータソースオブジェクトのさまざまな属性を選択できます。固有識別子、顧客識別子、製品識別子、ケース識別子、注文識別子から属性を選択できます。識別子の詳細については、「[Customer Profiles のキーに属性を設定するための標準識別子](standard-identifiers.md)」を参照してください。
![\[[標準識別子] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step5.png)
1. 確認して、**[Create Data Mapping]** (データマッピングを作成) を選択します。データマッピングのステータスは、*[Active]* (アクティブ) と表示されます。
![\[「ステップ 6: 識別子の指定」ページの識別子。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-mapping-step6.png)
### 外部アプリケーションから顧客データを取り込むように統合を設定する
外部アプリケーションのデータマッピングの設定が完了したら、顧客データを取り込むようにデータソース統合を設定します。
1. AWS マネジメントコンソールにログインし、**[Amazon Connect]** を選択して、Connect インスタンスエイリアスの下の [Customer Profiles] を選択します。
1. **[Data source integrations]** (データソースの統合) セクションで、**[Add data source integration]** (データソース統合の追加) を選択します。
![\[[データソース統合] タブ、[データソース統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step2.png)
1. **[Data source]** (データソース) ドロップダウンで、外部アプリケーションを選択し、**[Next]** (次へ) を選択します。また、**[Create new flow]** (新しいフローを作成) を選択し、新しいタブで Amazon AppFlow コンソールを開くこともできます。
![\[[データソース] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step3.png)
1. **[Flow name]** (フロー名) ドロップダウンで、データソースから使用するフローを選択し、**[Next]** (次へ) を選択します。
![\[フロー名を選択して接続を確立します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step4.png)
1. **[Data Mapping]** (データマッピング) ドロップダウンから、オブジェクトの外部アプリケーションデータマッピングを選択し、データソースをプロファイルにマッピングする方法を定義します。[**次へ**] を選択します。
![\[[データマッピングの選択] ページ、[マッピング] ドロップダウンボックス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step5.png)
1. 確認して、**[Add data Source Integration]** (データソース統合の追加) を選択します。外部アプリケーションのデータソース統合は、最初に保留中と表示された後で、アクティブ状態に移行します。
![\[[確認と統合] ページ、[データソース統合を追加] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ea-data-source-integ-step6.png)
### Amazon Connect Customer Profile エージェント CCP で統合された顧客プロファイルを表示する
これで、Amazon Connect エージェント CCP にログインすることで、エージェントは外部アプリケーションからインポートされた顧客データを表示できるようになります。Amazon Connect エージェント CCP への接続の詳細については、「[エージェントアプリケーション: すべてを 1 か所で](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-contact-control-panel.html#use-agent-application)」を参照してください。
エージェントは、Customer Profiles を表示するために適切なセキュリティプロファイルのアクセス許可を必要とします。また、プロファイル検索バーでキー名と値を使用して検索を実行できるようになります。
セキュリティプロファイルのアクセス許可の詳細については、「[セキュリティプロファイル](https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html)」を参照してください。
独自のカスタムエージェントアプリケーションと埋め込み顧客プロファイルを構築したい上級ユーザーは、[StreamsJS](https://github.com/amazon-connect/amazon-connect-customer-profiles) を使用することで、エージェントアプリケーションよりも詳細にカスタマイズできます。
# Customer Profiles の削除/統合の停止
**注記**
マッピングを削除すると、その特定のマッピングに関連付けられているオブジェクトとデータのみが削除されます。プロファイルに複数のオブジェクトが関連付けられている場合、特定のマッピングを削除してもプロファイルデータは消去されないことがあります。特定のデータを削除する場合は、マッピングを削除しますが、プロファイルに他のマッピングからのデータが含まれている場合は、プロファイルが残る可能性があります。これにより、既存のプロファイルに追加料金が発生する場合があります。[Amazon Connect コンソールまたは](delete-customer-profiles-domain.md) [DeleteDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_DeleteDomain.html) API を使用して、すべてのプロファイルを含む、ドメインとすべてのデータを Customer Profiles から削除できます。
**コンソールメソッド**
+ 顧客プロファイルのデータの取り込みを任意の時点で停止する場合は、統合/マッピングを選択し、**[Delete]** (削除) を選択します。
+ 統合、顧客プロファイル、およびすべての顧客プロファイルデータを削除するには、 Amazon Connect コンソールで顧客プロファイルドメインを削除できます。詳細については、「[Amazon Connect Customer Profiles ドメインを削除する](delete-customer-profiles-domain.md)」を参照してください。
**API メソッド**
+ 特定の統合のお客様プロファイルデータを削除するには、`DeleteProfileObjectType` API を使用します。
+ 統合、お客様プロファイル、およびすべてのお客様プロファイルデータを削除するには、`DeleteDomain` API を使用します。
お客様プロファイルデータの取り込みを再度有効にするには、セットアップ手順をもう一度実行します。
# Amazon Connect Customer Profiles のオブジェクトタイプのマッピング
オブジェクトタイプのマッピングは、特定のタイプのデータを取り込む方法を Customer Profiles に指示します。Customer Profiles に、次のような重要な情報が提供されます。
+ オブジェクトからデータを入力し、標準プロファイルオブジェクトに取り込む方法。
+ オブジェクト内でインデックスを付ける必要があるフィールドと、これらのフィールドを使用してこのタイプのオブジェクトを特定のプロファイルに割り当てる方法。
このセクションのトピックでは、オブジェクトタイプマッピングの作成方法、マッピング定義の詳細、主要な概念と用語など、オブジェクトタイプマッピングの設定に役立つ情報と手順について説明します。
**Topics**
+ [
# 顧客オブジェクトタイプマッピングの概念と用語
](customer-profiles-terminology.md)
+ [オブジェクトタイプマッピングを作成する](create-object-type-mapping.md)
+ [
# Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細
](object-type-mapping-definition-details.md)
+ [
# Customer Profiles のオブジェクトタイプの追加プロパティ
](additional-properties-object-types.md)
+ [
# 推定プロファイル
](inferred-profiles.md)
+ [連絡先レコードテンプレート](ctr-contact-record-template.md)
+ [
# Customer Profiles の \$1phone キーを使用して見つけた 1 つのプロファイルにコンタクトレコードを関連付ける
](auto-associate-profile-using-phone-profile-key.md)
+ [
# Amazon Connect Customer Profiles のオブジェクトタイプマッピングの例
](examples-object-type-mappings.md)
+ [
# Amazon Connect Customer Profiles の暗黙的なプロファイルオブジェクトタイプ
](implicit-profile-object-types.md)
+ [生成 AI を活用したデータマッピング](genai-powered-data-mapping.md)
+ [Customer Profiles のデータ制限](customer-profiles-data-limits.md)
# 顧客オブジェクトタイプマッピングの概念と用語
カスタムオブジェクトタイプマッピングを理解するために重要な用語と概念を、以下に示します。
**標準プロファイルオブジェクト**
*標準プロファイルオブジェクト*は、すべてのプロファイルに含まれる定義済みのオブジェクトです。
標準プロファイルオブジェクトには、電話番号、E メールアドレス、名前、その他の標準データなどの標準フィールドが含まれます。このデータは、情報源 (Salesforce、ServiceNow、Marketo など) に関係なく標準形式で取得できます。
**プロファイルオブジェクト**
*プロファイルオブジェクト*は、プロファイルに関する情報の単一のユニットです。例えば、通話、チケット、ケース、ウェブサイトのクリックストリーム記録に関する情報などです。
1 つのプロファイルオブジェクトは、最大 250 KB で、任意の構造化 JSON ドキュメントであることがあります。
+ すべてのプロファイルオブジェクトにはタイプがあります。例えば、プロファイルオブジェクトは、Amazon Connect の問い合わせレコードであることも、ServiceNow Users であることも、Marketo Leads であることもあります。
+ タイプとは、オブジェクトタイプのマッピングのことです。
+ オブジェクトタイプのマッピングで、特定のオブジェクトを Customer Profiles に取り込む方法を定義します。
**プロファイル**
*プロファイル*には、特定の顧客または問い合わせに関する既知のすべての情報が含まれています。これには、単一の標準プロファイルオブジェクトと、任意の数の追加プロファイルオブジェクトが含まれています。
**オブジェクトタイプのマッピング**
*オブジェクトタイプのマッピング*は、特定のタイプのデータを取り込む方法を Customer Profiles に伝えます。Customer Profiles に次の情報を提供します。
+ オブジェクトからデータを入力し、標準プロファイルオブジェクトに取り込む方法。
+ オブジェクト内でインデックスを付ける必要があるフィールドと、これらのフィールドを使用してこのタイプのオブジェクトを特定のプロファイルに割り当てる方法。
**マッピングテンプレート**
*マッピングテンプレート*は、Customer Profile サービスに含まれている事前定義済みのオブジェクトタイプマッピングです。
Customer Profiles には、Amazon Connect の問い合わせレコード、Salesforce Accounts、ServiceNow Users、および Marketo Leads のための、マッピングテンプレートが含まれています。使用可能なマッピングテンプレートの完全なリストについては、[ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API を使用してください。
マッピングテンプレートを使用すると、追加情報を指定することなく、既知の情報源からデータをすばやく取り込むことができます。
# Amazon Connect Customer Profiles でオブジェクトタイプマッピングを作成する
オブジェクトタイプマッピングでは、Salesforce、Zendesk、S3 などのソースアプリケーションから統一された標準プロファイルオブジェクトに特定のタイプのデータを取り込む方法を Customer Profiles に指示します。その後、[Amazon Connect エージェントアプリケーション](customer-profile-access.md)を使用して、そのオブジェクトのデータ (顧客の住所とメールアドレスなど) をエージェントに表示できます。
オブジェクトタイプマッピングにより、Customer Profiles に次の情報を提供します。
+ オブジェクトからデータを入力し、標準プロファイルオブジェクトに取り込む方法。
+ オブジェクト内でインデックスを付ける必要があるフィールドと、これらのフィールドを使用してこのタイプのオブジェクトを特定のプロファイルに割り当てる方法。
オブジェクトタイプマッピングを作成するには、2 つの方法があります。
+ Amazon Connect コンソールを使用する。ユーザーインターフェイスにより、データマッピング機能に簡単にアクセスできます。例えば、カスタム属性を追加することや、連絡先モデルの検索識別子と一意の識別子を定義することができます。コーディングは不要です。
+ Customer Profiles API を使用する 詳細については、[Amazon Connect Customer Profiles API Reference](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html) を参照してください。
このトピックでは、Amazon Connect コンソールを使用してマッピングを作成する方法について説明します。
## Amazon Connect コンソールを使用してデータマッピングを作成する
Amazon Connect では、Amazon S3、Salesforce、ServiceNow、Zendesk、Marketo を使用して、自社開発およびサードパーティー製のアプリケーションの顧客データをマッピングするためのコードなしのエクスペリエンスを提供します。
データマッピングを作成するには、Customer Profiles オブジェクトの表示方法を記述するオブジェクトタイプマッピングを定義する必要があります。このマッピングでは、データのフィールドを使用して、標準プロファイルのフィールドに入力する方法、またはデータを特定のプロファイルに割り当てる方法を定義します。
### ステップ 1: データマッピングを設定する
1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。
1. インスタンスページで、インスタンスエイリアスを選択します。インスタンスエイリアスは、**インスタンス名**として Amazon Connect URL にも表示されます。次の画像は、**[Amazon Connect 仮想コンタクトセンターのインスタンス]** ページを示しています。インスタンスエイリアスがボックスで囲まれています。
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)
1. ナビゲーションペインで、**[Customer profiles]** (カスタマープロファイル)、**[Data mappings]** (データマッピング) を選択します。
1. **[Create data mapping]** (データマッピングの作成) を選択して、開始します。
1. **[Description]** (説明) セクションの **[Set up data mapping]** (データマッピングの設定) ページで、このマッピングのソースまたは目的を特定しやすい名前を追加します。これは、オブジェクトタイプのメタデータです。
1. **[Data source]** (データソース) セクションで以下の操作をします。
1. Salesforce や Zendesk などの、データの送信元を選択します。選択した内容に基づき、Amazon Connect によって事前定義されたテンプレートを基に利用可能な送信先を自動的に選択します。
1. ソースオブジェクトを選択します。これは、統合プロファイルを構築するために使用されます。
1. **[Mapping destination]** (マッピング先) セクションで、統合された顧客プロファイルの作成に使用するデータを選択します。この情報はフローおよびエージェントに表示され、問い合わせとのやり取りをパーソナライズできます。
サポートされるマッピング先の詳細については、「[Amazon Connect のマッピングの送信先について](about-mapping-destinations.md)」を参照してください。
1. **[Additional options]** (追加のオプション) セクションで、新しいプロファイルの作成をオプトアウトするタイミングと、それらのプロファイルを保持する期間を選択できます。これらのオプションによって、コスト管理がしやすくなります。
**注記**
ドメインの保持期間は、デフォルトで 366 日間です。ドメインに設定された保持期間を変更するには、[UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html) API を使用します。
1. S3 以外のソースを選択した場合は、*[application]* (アプリケーション) **[Establish a connection with]** (との接続確立) セクションで、データを接続するために既存の Amazon AppFlow または Amazon EventBridge 接続を選択するか、新しい接続を作成します。このデータソースのアカウントに関する詳細を入力することで、新しい接続を作成できます。
接続が確立されたら、データソースから取り込むオブジェクトを選択します。
1. [**次へ**] を選択します。
### ステップ 2: 属性をマッピングする
**[Map *type* attribute]** (マッピングタイプ属性) ページでは、マッピング先に基づいて、事前定義済みのテンプレートが記載されたフィールドマッピングテーブルが表示されます。例えば、顧客、商品、ケース、注文の属性が記載されています。属性 (AccountNumber など) を選択し、別の宛先を選択するか、または独自のカスタム属性を入力することで、事前定義済みのテンプレートを変更できます。
次のイメージは、テンプレートのカスタマー属性が記載されたページの例を示しています。
![\[Amazon Connect のナビゲーションメニュー、顧客属性のマップページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)
顧客プロファイルに入力したくないものの削除、ソースの変更、カスタム属性の追加が可能です。
このマッピングでは、データソースを使用して顧客プロファイルの電話番号などの顧客の連絡先情報を入力します。これには、標準プロファイルテンプレートの属性を使用します。
**ヒント**
カスタム属性を追加する場合は、宛先には常時 `Attributes.` にプレフィックスが付加されます。これにより、Amazon Connect がカスタム属性であることを認識できます。
![\[送信先フィールドにマッピングされたソースフィールドを示す顧客属性のマッピングインターフェイス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/custom-attribute-cp.png)
エージェントは、Connect エージェントアプリケーションの **[Additional Information]** (追加情報) タブでアルファベット順に並べ替えられたカスタム属性を表示できるようになりました。次の形式を使用して、エージェントに表示される各属性に任意の名前を作成できます。`/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
取り込まれたすべてのカスタム属性が Connect エージェントアプリケーションに表示されます。エージェントに特定の情報を表示しない場合は、現時点ではカスタム属性を取り込まないでください。
### ステップ 3: 識別子の指定
**[Specify identifiers]** (識別子の指定) ページで、以下のセクションに入力します。マッピングするデータによっては、これらのすべてがページに表示されない可能性があります。
**注記**
名前 `_profileId`、`_orderId`、`_caseId`、および `_assetId` は、内部使用のために予約されています。これらの名前を識別子名の 1 つとして使用する場合は、`LOOKUP_ONLY` として宣言する必要があります。つまり、システムは、プロファイル、標準アセット、標準注文、標準ケースと照合するためにそれらを保存したり、プロファイル、アセット、ケース、または注文を検索するために保存したりしません。これらのキーを検索やマッチングに使用できるようにするには、キーの名前を変更する必要があります。`LOOKUP_ONLY` 標準識別子の詳細については、「[Customer Profiles のキーに属性を設定するための標準識別子](standard-identifiers.md)」を参照してください。
+ **一意の識別子**: データ取り込み時にエラーを回避するために、データには一意の識別子が必要です。この識別子は、一意のキーとも呼ばれます。Customer Profiles は、これを使用して、このデータを他のデータソースオブジェクトと区別し、検索やデータ更新用のインデックスを作成します。
一意の識別子は 1 つだけです。
+ **顧客識別子**: データ取り込み時にエラーを回避するために、データには少なくても 1 つの顧客識別子が必要です。この識別子はプロファイルキーとも呼ばれます。
Customer Profiles では、この識別子を使用してデータケースが既存のプロファイルに関連付けられるか、他のプロファイルを検索して新しいプロファイルを作成するのに使用されるかを判断するために使用します。
複数の顧客識別子を持つことができます。
**ヒント**
エージェントは、エージェントワークスペースにあるこれらの顧客識別子のいずれかを使用して、やり取りしているときに顧客が所有するプロファイルを見つけることができます。
+ **製品識別子**: データ取り込み時にエラーを回避するために、データには少なくても 1 つの製品顧客識別子が必要です。この識別子はアセットキーとも呼ばれます。
Customer Profiles では、これを使用して、このデータを他の顧客製品購入データと区別します。また、この識別子を使用して、データが既存のプロファイルに関連付けられるか、他のプロファイルを検索して新しいプロファイルを作成するのに使用されるかを判断するために使用します。
複数の製品識別子を持つことができます。
+ **ケース識別子**: データ取り込み時にエラーを回避するために、データには少なくても 1 つのケース識別子が必要です。この識別子はケースキーとも呼ばれます。
Customer Profiles では、これを使用して、このデータを他のカスタマーケースデータと区別します。また、この識別子を使用して、データが既存のプロファイルに関連付けられるか、他のプロファイルを検索して新しいプロファイルを作成するのに使用されるかを判断するために使用します。
複数のケース識別子を持つことができます。
+ **注文識別子**: データ取り込み時にエラーを回避するために、データには少なくても 1 つの注文識別子が必要です。この識別子は注文キーとも呼ばれます。
Customer Profiles では、これを使用して、このデータを他の顧客注文データと区別します。また、この識別子を使用して、データが既存のプロファイルに関連付けられるか、他のプロファイルを検索して新しいプロファイルを作成するのに使用されるかを判断するために使用します。
複数の注文識別子を持つことができます。
+ **追加の検索属性 (オプション)**: データソースオブジェクトで、インデックスを検索できる属性を選択できます。デフォルトでは、すべての識別子にインデックスが付けられます。
**ヒント**
データソースオブジェクトの検索属性にほぼ同じ値が含まれている場合、データインジェストが遅くなる可能性があります。データソースオブジェクトで一意の検索属性を作成することをお勧めします。
+ **データオブジェクトのタイムスタンプ**：データオブジェクトのタイムスタンプは、類似のプロファイルを統合するためにアイデンティティ解決が有効になっている場合に、プロファイルの競合を解決するために使用されます。複数の類似プロファイルに競合するレコードがある場合、最後に更新されたタイムスタンプを持つプロファイルのレコードが使用されます。
オブジェクトの最終更新日を参照するため、オブジェクトの属性を選択できます。
### ステップ 4: 確認して作成する
データマッピングが作成されたら、このオブジェクトタイプを使用するために **[Add data source integration]** (データソース統合を追加する) を選択します。
![\[サンプルデータのマッピングの詳細と統合ステータスを示す Amazon Connect Customer Profiles インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)
# Amazon Connect のマッピングの送信先について
マッピング先とは、ソースから Amazon Connect で既に定義されている標準定義へのマッピングのことです。
サポートされているマッピング先リストを以下の表に示します。
| ソースオブジェクト | 送信先: 顧客、製品、注文、ケース |
| --- | --- |
| S3 | いずれか |
| Salesforce-Account | お客様 |
| Salesforce-Contact | お客様 |
| Salesforce-Asset | 製品 |
| Zendesk-users | お客様 |
| Marketo-leads | お客様 |
| Servicenow-sys\$1user | お客様 |
| Segment-Identify | お客様 |
| Segment-Customer | お客様 |
| Shopify-Customer | お客様 |
| Shopify-DraftOrder | Order |
| Zendesk-tickets | ケース |
| Servicenow-task | ケース |
| Servicenow-incident | ケース |
# Customer Profiles のオブジェクトタイプマッピングの要件
Customer Profiles で受信データを処理できるように、オブジェクトタイプのマッピングに次の情報が含まれている必要があります。
+ 取り込まれたオブジェクト内のすべてのフィールドが、標準プロファイルにマッピングされるか、データをプロファイルに割り当てるために使用されるかの定義。これによって、取り込まれた**ソース**オブジェクトの、どのフィールドを、標準プロファイルオブジェクト内の特定のフィールドにマッピングする必要があるかを Customer Profiles に伝えます。
+ カスタムデータのソースオブジェクトのどのフィールドにインデックスを付けるか、およびその方法。
ソースデータが Customer Profiles によって取り込まれると、インデックス付きのフィールドによって次の項目が決定されます。
+ 特定のオブジェクトが属しているプロファイル。
+ 互いに関連していて、同じプロファイルに配置する必要があるオブジェクト。例えば、アカウント番号や 問い合わせレコードでの問い合わせ ID などです。
+ プロファイルの検索に使用できる値。例えば、問い合わせの名前にインデックスを付けることができます。これにより、エージェントは特定の名前を持つ顧客に属するすべてのプロファイルを検索できます。
## キーに関する要件
キーを 1 つ以上定義する必要があります。Customer Profiles は、このキーを使用して、カスタムプロファイルオブジェクトをプロファイルにマッピングします。
また、カスタムプロファイルオブジェクトのマッピングには、オブジェクトを一意に識別するキーが 1 つ以上必要です。これにより、このフィールドに同じ値を指定することで更新ができます (これらの要件は 1 つのキーで満たすことができます)。
各キーは、1 つ以上のフィールドで構成されます。
## フィールドに関する要件
フィールド定義は、ソースオブジェクトからそのフィールド名の値を読み取る方法を指定します。フィールド定義では、フィールドに格納されるデータの種類も指定します。
オブジェクトタイプ名は、任意の英数字、「-」、および「\$1」の文字列で、「\$1」で始めることはできません (これは、標準オブジェクトタイプに使用される予約名です)。
# Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細
オブジェクトタイプのマッピング定義には、フィールド定義とキー定義の 2 つの部分があります。
**ヒント**
オブジェクトタイプマッパーを作成する方法については、次のブログ記事を参照してください。[事前構築された Amazon S3 コネクタを使用して、Amazon Connect Customer Profiles でお客様情報を統合して整理する](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/)。または、YouTube でこのビデオをチェックしてください。[カスタマープロファイルデータをコンタクトセンターエクスペリエンスに統合する方法](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s)。
## フィールド定義の詳細
フィールド定義は、フィールドのソース、宛先 (ターゲット)、およびタイプを定義します。例:
```
"Fields": {
"{fieldName}": {
"Source": "{source}",
"Target": "{target}",
"ContentType": "{contentType}"
}, ...
}, ...
```
+ `Source`: これは、フィールドの JSON アクセサか、フィールドの値を生成するための Handlebar マクロです。
解析対象のソースオブジェクトの名前は ` _source` なので、ソースフィールドのすべてのフィールドの先頭にこの文字列を付ける必要があります。`_source` オブジェクトのみがサポートされています。
定数を生成し、複数のソースオブジェクトフィールドを 1 つのフィールドに結合するには、Handlebar マクロソリューションを使用します。これは、インデックス作成に役立ちます。
+ `Target`: 標準オブジェクトタイプで、このフィールドのデータをマッピングする場所を指定します。
標準プロファイルを設定すると、取り込まれるデータの形式について特定の知識がなくても、Customer Profiles 上に構築されたアプリケーションを使用して、データソースから取り込まれたデータを使用できます。
このフィールドはオプションです。キーに含める目的があるときのみ、フィールドを定義することがあります。
このフィールドの形式は、常に JSON アクセサです。サポートされているターゲットオブジェクトは、`_profile` のみです。
+ `ContentType`: 値として、STRING、NUMBER、PHONE\$1NUMBER、EMAIL\$1ADDRESS、NAME がサポートされています。`ContentType` が指定されていない場合、STRING とみなされます。
`ContentType` は、エージェントが値を検索できるように、値のインデックスを作成する方法を決定するために使用されます。例えば、`ContentType` が PHONE\$1NUMBER に設定されている場合、エージェントは任意の形式で電話番号を検索できるように処理されます。文字列「\$115551234567」は「(555)-123-4567」と一致します。
## キー定義の詳細
キーは、1 つ以上のフィールドから成り、これらのフィールドが一体となって、[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API を使用して、オブジェクト (またはそれらが属するプロファイル) を検索するために使用できるキーを定義します。このキーは、プロファイルを一意に識別したり、オブジェクト自体を一意に識別したりするために定義することもできます。
```
"Keys": {
"{keyName}": [{
"StandardIdentifiers": [...],
"FieldNames": [ "{fieldname}", ...]
}], ...
}, ...
```
キー名はドメインに対してグローバルです。2 つの異なるオブジェクトタイプマッピングに同じ名前を持つ 2 つのキーがある場合:
+ これらのキーは同じ名前空間を占有する必要があります
+ これらは、異なるオブジェクト間で場合によってはプロファイルをリンクさせるために使用できます。これらのプロファイルがオブジェクト間で一致する場合、Customer Profiles は 2 つのオブジェクトを同じプロファイルに配置します。
別の言い方をすると、値が同じであることが、キーが関連していることを意味する場合に限り、キーはドメイン内で同じキー名を持つ必要があります。例えば、あるタイプのオブジェクトで指定された電話番号は、別のタイプのオブジェクトで指定された同じ電話番号に関連があります。Salesforce からインポートされたオブジェクトに対して指定された内部識別子は、まったく同じ値であっても、Marketo からインポートされた別のオブジェクトに関連していない可能性があります。
キー定義は以下の 2 つの方法で使用されます。
+ 取り込み中の Customer Profiles 内部では、オブジェクトをどのプロファイルに割り当てるかを把握するために使用されます。
+ [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API を使用してキー値によってプロファイルを検索するために使用されます。
## デフォルトの検索キー
`_phone` や `_email` などのデフォルトの検索キーは、[標準プロファイル](standard-profile-definition.md)、[標準アセット](standard-asset-definition.md)、[標準注文](standard-order-definition.md)、[標準ケース](standard-case-definition.md)のオブジェクトテンプレートによって事前定義されています。デフォルトの検索キーをキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、プロファイルを検索できます。
# Customer Profiles のキーに属性を設定するための標準識別子
標準識別子を使用すると、キーに属性を設定できます。プロファイルにデータを取り込む方法に基づいて、使用する識別子を決定します。例えば、PROFILE 識別子で電話番号をマークします。これは、電話番号が一意の識別子として扱われることを意味します。Customer Profiles に同じ電話番号を持つ 2 つの問い合わせがある場合、問い合わせは 1 つのプロファイルに結合されます。
| 識別子名 | 説明 |
| --- | --- |
| AIR\$1PREFERENCE | この識別子は、このキーがフライトの優先設定を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのフライトの優先設定が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1BOOKING | この識別子は、このキーがフライトの予約を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのフライトの予約が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| AIR\$1SEGMENT | この識別子は、このキーがフライトセグメントを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのフライトセグメントが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1PREFERENCE | この識別子は、このキーがホテルの優先設定を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのホテルの優先設定が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1STAY\$1REVENUE | この識別子は、このキーがホテル滞在の収益を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのホテル滞在の収益が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| HOTEL\$1RESERVATION | この識別子は、このキーがホテル予約を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのホテル予約が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY | この識別子は、このキーがロイヤルティを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのロイヤルティが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1TRANSACTION | この識別子は、このキーがロイヤルティトランザクションを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのロイヤルティトランザクションが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| LOYALTY\$1PROMOTION | この識別子は、このキーがロイヤルティプロモーションを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのロイヤルティプロモーションが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| UNIQUE | この識別子は、オブジェクトタイプごとに唯 1 つのインデックスで指定する必要があります。このキーは、オブジェクトタイプのオブジェクトを一意に識別し、取得したり、必要に応じて送信されたオブジェクトを後日更新したりするために使用されます。 UNIQUE キーを構成するすべてのフィールドは、新しいオブジェクトを送信するときに指定する必要があります。指定しないと、拒否されます。 |
| PROFILE | この識別子は、このキーがプロファイルを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのプロファイルが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| LOOKUP\$1ONLY | この識別子は、オブジェクトを取り込んだ後にキーが保存されないことを示します。キーは、取り込み中にプロファイルを決定するためにのみ使用されます。 キー値は、取り込み時にはプロファイルに関連付けられていません。つまり、この値を使用して検索したり、後で取り込んだオブジェクトを同じキーと照合したりすることはできません。 キーを `UNIQUE` 識別子と `LOOKUP_ONLY` 識別子の両方として指定することはできません。 `NEW_ONLY` 識別子または `LOOKUP_ONLY` 識別子のない `PROFILE` 識別子を持つその他のキーが少なくとも 1 つある場合にのみ、`PROFILE` を `LOOKUP_ONLY` と共に使用できます。唯一の例外は `_profileId` キーです。このキーは、`PROFILE` と `LOOKUP_ONLY` 識別子の組み合わせを単独で持つことができます。 |
| NEW\$1ONLY | オブジェクトが取り込まれる前にプロファイルがまだ存在しない場合、キーはプロファイルに関連付けられます。それ以外の場合、キーは、オブジェクトをプロファイルと照合する場合にのみ使用されます。 キーを `UNIQUE` 識別子と `NEW_ONLY` 識別子の両方として指定することはできません。 `NEW_ONLY` 識別子または `LOOKUP_ONLY` 識別子のない `PROFILE` 識別子を持つその他のキーが少なくとも 1 つある場合にのみ、`PROFILE` を `NEW_ONLY` と共に使用できます。 |
| SECONDARY | オブジェクトをプロファイルと照合する間、Customer Profiles はまず、SECONDARY 識別子を持たないすべての PROFILE キーを検索します。これらがまず考慮されます。SECONDARY キーは、これらのキーを使用して一致するプロファイルが見つからない場合にのみ考慮されます。 |
| ASSET | この識別子は、このキーがアセットを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのアセットが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| ORDER | この識別子は、このキーが順序を一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべての順序が検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
| CASE | この識別子は、このキーがケースを一意に識別することを意味します。この識別子を指定すると、取り込み中に、Customer Profiles によってこのキーが関連付けられているすべてのケースが検索されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/standard-identifiers.html) |
## 互換性のある識別子
![\[さまざまなデータ型に対して許可および制限された識別子とキー名を示すマトリクス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)
# Customer Profiles がキー定義を処理する方法
Customer Profiles は、カスタムオブジェクトマッピングを取り込むと、キー定義を処理します。次の図は、キー定義で標準識別子を処理して、オブジェクトを割り当てるプロファイルを決定する方法を示しています。
![\[オブジェクトの割り当てまたはキューイングのためのプロファイルキーチェックプロセスを示すフローチャート。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-template1.png)
# Customer Profiles がルックアップのインデックスにキーを追加する方法
次の図は、Customer Profiles が標準識別子を処理して、キーを保持するかどうかを決定する方法を示しています。
![\[ルックアップと新しいオブジェクト基準に基づいて Customer Profiles でキーを保持する決定プロセスを示すフローチャート。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-template2.png)
このフローチャートは以下の手順を示します。
1. キーに `LOOKUP_ONLY` が指定されていますか?
+ はいの場合は、キーを保持しないでください。
1. いいえの場合、キーに `NEW_ONLY` が指定されていますか?
+ いいえの場合は、インデックスにキーを保存して、ルックアップに使用できるようにします。
1. はいの場合、オブジェクトを取り込むと新しいプロファイルが作成されますか?
+ はいの場合は、インデックスにキーを保存して、ルックアップに使用できるようにします。
+ いいえの場合、今後のルックアップのためにインデックスにキーを保持しないでください。
# Amazon Connect Customer Profiles の標準プロファイルのオブジェクトタイプマッピング
このセクションのトピックでは、標準プロファイル定義と、外部アプリケーションから標準プロファイルへのオブジェクトタイプマッピングについて説明します。
**Topics**
+ [Amazon AppFlow アクセス要件](appflow-access-requirements-profile.md)
+ [Amazon AppIntegrations アクセス要件](standard-profile-appintegrations-requirements.md)
+ [
# Customer Profiles の Amazon EventBridge アクセス要件
](standard-profile-eventbridge-requirements.md)
+ [標準プロファイルの定義](standard-profile-definition.md)
+ [Salesforce オブジェクトのマッピング](mapping-salesforce-objects.md)
+ [Zendesk オブジェクトのマッピング](mapping-zendesk-objects.md)
+ [Marketo オブジェクトのマッピング](mapping-marketo-objects.md)
+ [ServiceNow オブジェクトのマッピング](mapping-servicenow-objects.md)
+ [セグメントオブジェクトのマッピング](mapping-segment-objects.md)
+ [Shopify オブジェクトのマッピング](mapping-shopify-objects.md)
# Customer Profiles の Amazon AppFlow アクセス要件
Amazon Connect Customer Profiles と Zendesk、Marketo、Salesforce、ServiceNow の統合を作成および削除するには、以下の Amazon AppFlow アクセス要件を使用します。
+ appflow:CreateFlow
+ appflow:DeleteFlow
# Customer Profiles の Amazon AppIntegrations アクセス要件
Amazon Connect Customer Profiles とセグメントおよび Shopify の統合を作成および削除するには、以下の Amazon AppIntegrations アクセス要件を使用します。
+ app-integrations:GetEventIntegration
+ app-integrations:ListEventIntegrationAssociations
+ app-integrations:CreateEventIntegrationAssociation
+ app-integrations:DeleteEventIntegrationAssociation
# Customer Profiles の Amazon EventBridge アクセス要件
Amazon Connect Customer Profiles とセグメントおよび Shopify の統合を作成および削除するには、以下の Amazon EventBridge アクセス要件を使用します。
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Amazon Connect Customer Profiles の標準プロファイル定義
次の表に、 Customer Profiles 標準プロファイルオブジェクトのすべてのフィールドを示します。
| 標準プロファイルフィールド | データ型 | 説明 |
| --- | --- | --- |
| ProfileId | String | お客様プロファイルの一意の識別子。 |
| AccountNumber | String | お客様に付けた一意のアカウント番号。 |
| AdditionalInformation | String | お客様のプロファイルに関連する追加情報。 |
| PartyType | String | お客様を説明するために使用されるプロファイルのタイプ。 有効な値: INDIVIDUAL \$1 BUSINESS \$1 OTHER |
| BusinessName | String | お客様のビジネスの名前。 |
| FirstName | String | お客様のファーストネーム。 |
| MiddleName | String | お客様のミドルネーム。 |
| LastName | String | お客様のラストネーム。 |
| BirthDate | String | お客様の生年月日。 |
| 性別 | String | お客様が自認する性別。 |
| PhoneNumber | String | 携帯番号、自宅番号、またはビジネス番号として指定されていないお客様の電話番号。 |
| MobilePhoneNumber | String | お客様の携帯電話番号。 |
| HomePhoneNumber | String | お客様の自宅電話番号。 |
| BusinessPhoneNumber | String | お客様のビジネス電話番号。 |
| EmailAddress | String | お客様の E メールアドレス。個人アドレスまたはビジネスアドレスとして指定されていないアドレス。 |
| PersonalEmailAddress | String | 顧客の個人用 E メールアドレス。 |
| BusinessEmailAddress | String | お客様のビジネス E メールアドレス。 |
| Address | Address | 郵送用、配送用、請求用ではないお客様に関連付けられた一般的な住所。 |
| ShippingAddress | Address | お客様の配送先住所。 |
| MailingAddress | Address | お客様の郵送先住所。 |
| BillingAddress | Address | お客様の請求先住所。 |
| 属性 | 文字列から文字列へのマッピング | お客様プロファイルの属性のキーと値のペア。 |
| ProfileType | String | プロファイルのタイプ。 有効な値: PROFILE \$1 ACCOUNT\$1PROFILE |
| EngagementPreferences | EngagementPreferences | 顧客またはアカウントのエンゲージメント設定。 |
標準プロファイルオブジェクトは、次の表のキーによってインデックス付けされます。
| 標準インデックス名 | 標準プロファイルフィールド |
| --- | --- |
| \$1phone | PhoneNumber、MobilePhoneNumber、HomePhoneNumber、BusinessPhoneNumber |
| \$1email | EmailAddress、PersonalEmailAddress、BusinessEmailAddress |
| \$1account | AccountNumber |
| \$1profileId | ProfileId |
| \$1fullName | 「FirstName MiddleName LastName」 |
例えば、[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) でをキー名として `_phone` を使用すると、PhoneNumber、MobilePhoneNumber、HomePhoneNumber、または BusinessPhoneNumber 属性が検索値と一致するプロファイルを見つけることができます。
## Address データ型
| 標準プロファイルフィールド | データ型 | 説明 |
| --- | --- | --- |
| Address1 | String | お客様住所の 1 行目。 |
| Address2 | String | お客様住所の 2 行目。 |
| Address3 | String | お客様住所の 3 行目。 |
| Address4 | String | お客様住所の 4 行目。 |
| City | String | お客様が住んでいる市。 |
| Country | String | お客様が住んでいる国。 |
| County | String | お客様が住んでいる郡。 |
| PostalCode | String | お客様住所の郵便番号 |
| Province | String | お客様が住んでいる州/省/都道府県。 |
| State | String | お客様が住んでいる州。 |
## EngagementPreferences データ型
| 標準プロファイルフィールド | データ型 | 説明 |
| --- | --- | --- |
| E メール | ContactPreference オブジェクトの配列 | E メール関連のコンタクト設定のリスト。 |
| 電話 | ContactPreference オブジェクトの配列 | 電話関連のコンタクト設定のリスト。 |
## ContactPreference データ型
| 標準プロファイルフィールド | データ型 | 説明 |
| --- | --- | --- |
| KeyName | String | 検索可能な顧客プロファイルの一意の識別子。 |
| KeyValue | String | keyName に基づいてプロファイルを検索するために使用されるキー値。 |
| ProfileId | String | お客様プロファイルの一意の識別子。 |
| ContactType | String | エンゲージメントに使用されるコンタクトタイプ。有効な値: PhoneNumber \$1 MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress |
# Amazon Connect Customer Profiles の標準プロファイルへの Salesforce オブジェクトのマッピング
このトピックでは、Salesforce オブジェクトのどのフィールドが Customer Profiles の標準プロファイルオブジェクトのフィールドにマップされるかを示します。
## Salesforce-Account オブジェクト
Salesforce-Account オブジェクト内のすべてのフィールドのリストを次に示します。Salesforce-Account オブジェクトのフィールドは、Salesforce インスタンスの設定によって異なる場合があります。
+ ID
+ IsDeleted
+ MasterRecordId
+ 名前
+ 型
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.City
+ BillingAddress.Country
+ BillingAddress.geocodeAccuracy
+ BillingAddress.latitude
+ BillingAddress.longitude
+ BillingAddress.postalCode
+ BillingAddress.state
+ BillingAddress.street
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.city
+ ShippingAddress.country
+ ShippingAddress.latitude
+ ShippingAddress.longitude
+ ShippingAddress.postalCode
+ ShippingAddress.state
+ ShippingAddress.street
+ 電話
+ Fax
+ AccountNumber
+ ウェブサイト
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ 説明
+ Rating
+ サイト
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Jigsaw
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer
## 標準プロファイルへの Salesforce-Account オブジェクトのマッピング
Salesforce-Account オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルオブジェクトにマッピングされます。
次の表に、Salesforce-Account オブジェクトから標準プロファイルにマッピングできるフィールドを示します。(このテーブルには、Person フィールドを含めるように設定された Salesforce インスタンスのマッピングが含まれています)。
| Salesforce-Account マッピング元フィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| ID | Attributes.sfdcAccountId |
| 名前 | BusinessName |
| 電話 | PhoneNumber |
| BillingStreet | BillingAddress.Address1 |
| BillingCity | BillingAddress.City |
| BillingState | BillingAddress.State |
| BillingCountry | BillingAddress.Country |
| BillingPostalCode | BillingAddress.PostalCode |
| ShippingStreet | ShippingAddress.Address1 |
| ShippingCity | ShippingAddress.City |
| ShippingState | ShippingAddress.State |
| ShippingCountry | ShippingAddress.Country |
| ShippingPostalCode | ShippingAddress.PostalCode |
| IsPersonAccount | PartyType |
| PersonMobilePhone | MobilePhoneNumber |
| PersonHomePhone | HomePhoneNumber |
| PersonEmail | PersonalEmailAddress |
| PersonMailingAddress.Street | MailingAddress.Address1 |
| PersonMailingAddress.City | MailingAddress.City |
| PersonMailingAddress.State | MailingAddress.State |
| PersonMailingAddress.Country | MailingAddress.Country |
| PersonMailingAddress.PostalCode | MailingAddress.PostalCode |
| PersonBirthDate | BirthDate |
| PersonOtherStreet | Address.Address1 |
| PersonOtherCity | Address.City |
| PersonOtherState | Address.State |
| PersonOtherCountry | Address.Country |
| PersonOtherPostalCode | Address.PostalCode |
| FirstName | FirstName |
| LastName | LastName |
| MiddleName | MiddleName |
| AccountNumber | AccountNumber |
Salesforce オブジェクトの Salesforce-Account のお客様データは、次の表に示すインデックスを使用して Amazon Connect のお客様プロファイルに関連付けられます。
| 標準インデックス名 | Salesforce-Account マッピング元フィールド |
| --- | --- |
| \$1salesforceAccountId | ID |
例えば、`_salesforceAccountId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API で使用すると、プロファイルを検索できます。特定のプロファイルに関連付けられた Salesforce-Account オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Salesforce-Account` に設定して使用すると検索できます。
## Salesforce-Contact オブジェクト
Salesforce-Contact オブジェクト内のすべてのフィールドのリストを次に示します。
+ ID
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ 名前
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.city
+ OtherAddress.country
+ OtherAddress.geocodeAccuracy
+ OtherAddress.latitude
+ OtherAddress.postalCode
+ OtherAddress.state
+ OtherAddress.street
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.city
+ MailingAddress.country
+ MailingAddress.geocodeAccuracy
+ MailingAddress.latitude
+ MailingAddress.longitude
+ MailingAddress.postalCode
+ MailingAddress.state
+ MailingAddress.street
+ 電話
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ E メール
+ タイトル
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ 説明
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ LastCURequestDate
+ LastCUUpdateDate
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId
## 標準プロファイルへの Salesforce-Contact オブジェクトのマッピング
Salesforce-Contact オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルオブジェクトにマッピングされます。次の表に、Salesforce-Contact オブジェクトから標準プロファイルオブジェクトにマッピングできるフィールドを示します。
| Salesforce-Contact マッピング元フィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| ID | Attributes.sfdcContactId |
| AccountId | Attributes.sfdcAccountId |
| LastName | LastName |
| FirstName | FirstName |
| MiddleName | MiddleName |
| OtherStreet | Address.Address1 |
| OtherCity | Address.City |
| OtherState | Address.State |
| OtherCountry | Address.Country |
| OtherPostalCode | Address.PostalCode |
| MailingStreet | MailingAddress.Address1 |
| MailingCity | MailingAddress.City |
| MailingState | MailingAddress.State |
| MailingCountry | MailingAddress.Country |
| MailingPostalCode | MailingAddress.PostalCode |
| 電話 | PhoneNumber |
| HomePhone | HomePhoneNumber |
| MobilePhone | MobilePhoneNumber |
| E メール | EmailAddress |
| Birthdate | BirthDate |
Salesforce オブジェクトの Salesforce-Contact お客様データは、次の表に示すインデックスを使用して Amazon Connect お客様プロファイルに関連付けられます。
| 標準インデックス名 | Salesforce-Contact マッピング元フィールド |
| --- | --- |
| \$1salesforceContactId | ID |
| \$1salesforceAccountId | AccountId |
例えば、`_salesforceAccountId` と `_salesforceContactId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API を使用すると、プロファイルを検索できます。特定のプロファイルに関連付けられた Salesforce-Contact オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Salesforce-Contact` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準プロファイルへの Zendesk オブジェクトのマッピング
このトピックでは、Customer Profiles の標準プロファイルのフィールドにマッピングされる Zendesk オブジェクトのフィールドのリストを示します。
## Zendesk-users オブジェクト
Zendesk-users オブジェクト内のすべてのフィールドのリストを次に示します。
+ id
+ url
+ external\$1id
+ E メール
+ アクティブ
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ details
+ last\$1login\$1at
+ サイト
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ phone
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ ロール
+ shared
+ タグ
+ 署名
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ updated\$1at
## Zendesk users を標準プロファイルにマッピングする
Zendesk-users オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルにマッピングされます。次の表は、Zendesk-users オブジェクトから標準プロファイルにマッピングできるフィールドの一覧です。
| Zendesk-users のマッピング元フィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| id | Attributes.ZendeskUserId |
| external\$1id | Attributes.ZendeskExternalId |
| E メール | EmailAddress |
| phone | PhoneNumber |
Zendesk オブジェクトの Zendesk-users 顧客データは、次の表に示すインデックスを使用して Amazon Connect お客様プロファイルに関連付けられます。
| 標準インデックス名 | Zendesk-user のマッピング元フィールド |
| --- | --- |
| \$1zendeskUserId | ID |
| \$1zendeskExternalId | external\$1id |
例えば、`_zendeskUserId` と `_zendeskExternalId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API を使用すると、Amazon Connect お客様プロファイルを検索できます。特定のお客様プロファイルに関連付けられている Zendesk-users オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `Zendesk-users` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準プロファイルへの Marketo オブジェクトのマッピング
このトピックでは、Marketo オブジェクトのどのフィールドが、Customer Profiles の標準プロファイルオブジェクトのフィールドにマッピングされるかを示します。
## Marketo-leads オブジェクト
Marketo-leads オブジェクト内のすべてのフィールドのリストを次に示します。
+ id
+ firstName
+ lastName
+ middleName
+ E メール
+ phone
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ アドレス
+ city
+ state
+ country
+ postalcode
+ gender
+ dateOfBirth
## Marketo-leads の標準プロファイルへのマッピング
Marketo-Leads オブジェクトのフィールドの一部は、標準プロファイルにマップされます。
| Marketo-leads マッピング元フィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| id | Attributes.MarketoLeadId |
| sfdcAccountId | Attributes.sfdcAccountId |
| sfdcContactId | Attributes.sfdcContactId |
| firstName | FirstName |
| lastName | LastName |
| middleName | MiddleName |
| E メール | EmailAddress |
| phone | PhoneNumber |
| mobilePhone | MobilePhoneNumber |
| mobilePhone | MobilePhoneNumber |
| billingStreet | BillingAddress.Address1 |
| billingCity | BillingAddress.City |
| billingState | BillingAddress.State |
| billingCountry | BillingAddress.Country |
| billingPostalCode | BillingAddress.PostalCode |
| アドレス | Address.Address1 |
| city | Address.City |
| state | Address.State |
| country | Address.Country |
| postalcode | Address.PostalCode |
| gender | 性別 |
| dataOfBirth | BirthDate |
Marketo の Marketo-leads 顧客データは、次の表に示すインデックスを使用して Amazon Connect お客様プロファイルに関連付けられます。
| 標準インデックス名 | Marketo-leads マッピング元フィールド |
| --- | --- |
| \$1marketoLeadId | id |
| \$1salesforceAccountId | sfdcAccountId |
| \$1salesforceContactId | sfdcContactId |
例えば、`_marketoLeadId`、`_salesforceAccountId`、および `_salesforceContactId` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、Amazon Connect お客様プロファイルを検索できます。特定のお客様プロファイルに関連付けられている Marketo-Leads オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `Marketo-leads` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準プロファイルオブジェクトへの ServiceNow オブジェクトのマッピング
このトピックでは、ServiceNow オブジェクトのどのフィールドが、Amazon Connect Customer Profiles の標準プロファイルオブジェクトのフィールドにマッピングされるかを示します。
## Servicenow-sys\$1user オブジェクト
Servicenow-sys\$1user オブジェクト内のすべてのフィールドのリストを次に示します。
+ sys\$1id
+ アクティブ
+ building
+ calendar\$1integration
+ city
+ company
+ cost\$1center
+ country
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ E メール
+ employee\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ location
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ 名前
+ 通知
+ password\$1needs\$1reset
+ phone
+ photo
+ preferred\$1language
+ roles
+ スケジュール
+ ソース
+ state
+ street
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ sys\$1domain.link
+ sys\$1domain.value
+ sys\$1domain\$1path
+ sys\$1id
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1udpated\$1on
+ time\$1format
+ time\$1zone
+ title
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip
## 標準プロファイルオブジェクトへの Servicenow-sys\$1users のマッピング
Servicenow-sys\$1users オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルオブジェクトにマップされます。
次の表は、Servicenow-sys\$1users オブジェクトから標準プロファイルにマッピングできるフィールドの一覧です。
| Servicenow-sys\$1users のマッピング元フィールド | お客様プロファイルのマッピング先フィールド |
| --- | --- |
| sys\$1id | Attributes.ServiceNowSystemId |
| first\$1name | FirstName |
| last\$1name | LastName |
| middle\$1name | MiddleName |
| gender | 性別 |
| E メール | EmailAddress |
| phone | PhoneNumber |
| home\$1phone | HomePhoneNumber |
| mobile\$1phone | MobilePhoneNumber |
| street | Address.Address1 |
| city | Address.City |
| state | Address.State |
| country | Address.Country |
| zip | Address.PostalCode |
Servicenow オブジェクトの Servicenow-sys\$1user 顧客データは、次の表に示すインデックスを使用して Amazon Connect お客様プロファイルに関連付けられます。
| 標準インデックス名 | Servicenow-sys\$1user のマッピング元フィールド |
| --- | --- |
| \$1serviceNowSystemId | sys\$1id |
例えば、`_serviceNowSystemId` と `_serviceNowIncidentId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API を使用すると、Amazon Connect お客様プロファイルを検索できます。特定のプロファイルに関連付けられた Servicenow-sys\$1user オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Servicenow-sys_user` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準プロファイルオブジェクトへのセグメントオブジェクトのマッピング
このトピックでは、セグメントオブジェクトのどのフィールドが、Amazon Connect Customer Profiles の標準プロファイルオブジェクトのフィールドにマッピングされるかを示します。
## セグメント - オブジェクトの識別
Segment-Identify オブジェクト内のすべてのフィールドの一覧を次に示します。
+ userId
+ 共通フィールド - セグメントドキュメントの[仕様：共通フィールド](https://segment.com/docs/connections/spec/common/)を参照してください
+ セグメント予約特性 - セグメントドキュメントの[特性](https://segment.com/docs/connections/spec/identify/#traits)を参照してください
+ traits.address.street
+ traits.address.city
+ traits.address.state
+ traits.address.postalCode
+ traits.address.country
+ traits.age
+ traits.avatar
+ traits.birthday
+ traits.company.name
+ traits.company.id
+ traits.company.indust
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website
## セグメント識別を標準プロファイルオブジェクトにマッピングする
Segment-Identify オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルオブジェクトにマッピングされます。
次の表は、Segment-Identify オブジェクトから標準プロファイルにマッピングできるフィールドの一覧です。
| Segment-Identify ソースフィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| | 標準プロファイルマッピング先フィールド |
| userId | Attributes.SegmentUserId |
| traits.company.name | BusinessName |
| traits.firstName | FirstName |
| traits.lastName | LastName |
| traits.birthday | BirthDate |
| traits.gender | 性別 |
| traits.phone | PhoneNumber |
| traits.email | EmailAddress |
| traits.address.street | Address.Address1 |
| traits.address.city | Address.City |
| traits.address.state | Address.State |
| traits.address.country | Address.Country |
| traits.address.postalCode | Address.PostalCode |
### 例
次の例では、ソースフィールドをターゲットフィールドにマップする方法を示します。
```
"segmentUserId": {
"Source": "_source.detail.event.detail.userId",
"Target": "_profile.Attributes.SegmentUserId"
}
```
セグメントオブジェクトの Segment-Identify 顧客データは、次の表に示すインデックスを使用して Amazon Connect 顧客プロファイルに関連付けられます。
| 標準インデックス名 | Segment-Identify ソースフィールド |
| --- | --- |
| \$1segmentUserID | userId |
例えば、`_segmentUserId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API で使用すると、Amazon Connect お客様プロファイルを検索できます。特定のプロファイルに関連付けられた Segment-Identify オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Segment-Identify` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準プロファイルオブジェクトへの Shopify オブジェクトのマッピング
このトピックでは、Shopify オブジェクトのどのフィールドが、Amazon Connect Customer Profiles の標準プロファイルオブジェクトのフィールドにマッピングされるかを示します。
## Shopify-Customer オブジェクト
Shopify-Customer オブジェクト内のすべてのフィールドのリストを次に示します。
+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ addresses
+ currency
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ E メール
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ phone
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent .opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ state
+ タグ
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ verified\$1email
## Shopify-Customer オブジェクトを標準プロファイルにマッピングする
Shopify-Customer オブジェクトのフィールドの一部は、Customer Profiles の標準プロファイルオブジェクトにマッピングされます。
次の表は、Shopify-Customer オブジェクトから標準プロファイルにマッピングできるフィールドの一覧です。
| Shopify-Customer ソースフィールド | 標準プロファイルマッピング先フィールド |
| --- | --- |
| id | Attributes.ShopifyCustomerId |
| email | EmailAddress |
| first\$1name | FirstName |
| last\$1name | LastName |
| note | AdditionalInformation |
| phone | PhoneNumber |
| default\$1address.address1 | Address.Address1 |
| default\$1address.address2 | Address.Address2 |
| default\$1address.city | Address.City |
| default\$1address.province | Address.Province |
| default\$1address.country | Address.Country |
| default\$1address.zip | Address.PostalCode |
### 例
次の例では、ソースフィールドをターゲットフィールドにマップする方法を示します。
```
"shopifyCustomerId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_profile.Attributes.ShopifyCustomerId"
}
```
Shopify オブジェクトの Shopify-Customer 顧客データは、次の表に示すインデックスを使用して Amazon Connect お客様プロファイルに関連付けられます。
| 標準インデックス名 | Shopify-Customer ソースフィールド |
| --- | --- |
| \$1shopifyCustomerId | id |
例えば、`_shopifyCustomerId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) API で使用すると、Amazon Connect お客様プロファイルを検索できます。特定のお客様プロファイルに関連付けられている Shopify-Customer オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `Shopify-Customer` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準注文のオブジェクトタイプマッピング
このセクションのトピックでは、標準オーダー定義と、外部アプリケーションから標準オーダーへのオブジェクトタイプマッピングについて説明します。
**Topics**
+ [Amazon AppIntegrations アクセス要件](standard-order-appintegrations-requirements.md)
+ [Amazon EventBridge アクセス要件](standard-order-eventbridge-requirements.md)
+ [標準オーダーの定義](standard-order-definition.md)
+ [Shopify オブジェクトのマッピング](mapping-shopify-objects-standard-order.html.md)
# Amazon AppIntegrations アクセス要件
Amazon Connect Customer Profiles と Shopify の統合を作成および削除するには、以下の Amazon AppIntegrations アクセス要件を使用します。
+ app-integrations:GetEventIntegration
+ app-integrations:ListEventIntegrationAssociations
+ app-integrations:CreateEventIntegrationAssociation
+ app-integrations:DeleteEventIntegrationAssociation
# Amazon EventBridge アクセス要件
Amazon Connect Customer Profiles と Shopify の統合を作成および削除するには、以下の Amazon EventBridge アクセス要件を使用します。
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
# Customer Profiles 標準注文オブジェクトのフィールド
次の表に、Customer Profiles 標準オーダーオブジェクトのすべてのフィールドを示します。
| 標準注文のフィールド | データ型 | 説明 |
| --- | --- | --- |
| OrderId | String | 標準オーダーの一意の識別子。 |
| CustomerEmail | String | 顧客の E メールアドレス。 |
| CustomerPhone | String | 顧客の電話番号。 |
| CreatedDate | String | オーダーの作成日。 |
| UpdatedDate | String | オーダーの更新日。 |
| ProcessedDate | String | オーダーの処理日。 |
| ClosedDate | String | オーダーのクローズ日。 |
| CancelledDate | String | オーダーのキャンセル日。 |
| CancelReason | String | オーダーのキャンセル理由。 |
| Name | String | オーダーの名前。 |
| AdditionalInformation | String | オーダーに関連する追加情報。 |
| ゲートウェイ | String | オーダーの支払いゲートウェイ。 |
| ステータス | String | オーダーのステータス。 |
| StatusCode | String | オーダーのステータスコード。有効な値: DRAFT \$1 ACTIVATED |
| StatusUrl | String | オーダーのステータス URL。 |
| CreditCardNumber | String | 顧客のクレジットカードの最後の 4 桁。 |
| CreditCardCompany | String | 顧客のクレジットカード会社。 |
| FulfillmentStatus | String | オーダーのフルフィルメントステータス。 |
| TotalPrice | String | オーダーの合計価格。 |
| TotalTax | String | オーダーの合計税。 |
| TotalDiscounts | String | オーダーの合計割引。 |
| TotalItemsPrice | String | オーダーの合計品目価格。 |
| TotalShippingPrice | String | オーダーの合計配送料金。 |
| TotalTipReceived | String | 受信したオーダーの合計チップ。 |
| Currency | String | オーダーの通貨。 |
| TotalWeight | String | オーダーの合計重量。 |
| BillingAddress | OrderAddress | お客様の請求先住所。 |
| ShippingAddress | OrderAddress | お客様の配送先住所。 |
| OrderItems | OrderItem list | オーダーの品目。 |
| 属性 | 文字列から文字列へのマッピング | 標準オーダーの属性のキーと値のペア。 |
標準注文オブジェクトは、次の表のキーによってインデックス付けされます。
| 標準インデックス名 | 標準注文のフィールド |
| --- | --- |
| \$1orderId | OrderId |
例えば、`_orderId` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、OrderId が検索値と一致する注文を持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準注文オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `_order` に設定して使用すると検索できます。
## OrderAddress データ型
| 標準注文のフィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | オーダーの住所に関連付けられた名前。 |
| Address1 | String | オーダーの住所の最初の行。 |
| Address2 | String | オーダーの住所の 2 行目。 |
| Address3 | String | オーダーの住所の 3 行目。 |
| Address4 | String | オーダーの住所の 4 行目。 |
| City | String | オーダーの住所の都市。 |
| County | String | オーダーの住所の郡。 |
| State | String | オーダーの住所の州。 |
| Province | String | オーダーの住所の都道府県。 |
| Country | String | オーダーの住所の国。 |
| PostalCode | String | オーダーの住所の郵便番号。 |
## OrderItem データ型
| 標準注文のフィールド | データ型 | 説明 |
| --- | --- | --- |
| タイトル | String | オーダーの品目のタイトル。 |
| Price | String | オーダーの品目の価格。 |
| 数量 | String | オーダーの品目の数量。 |
# Amazon Connect Customer Profiles の標準注文への Shopify オブジェクトのマッピング
このトピックでは、Customer Profiles の標準オーダーオブジェクトの各フィールドに、Shopify オブジェクトのどのフィールドがマップされるのかを示します。
## Shopify-DraftOrder オブジェクト
Shopify-DraftOrder オブジェクトのすべてのフィールドのリストについては、Shopify ドキュメントの「[DraftOrder オブジェクト](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object)」を参照してください。
## Shopify-DraftOrder オブジェクトを標準オーダーにマッピングする
Shopify-DraftOrder オブジェクトのフィールドの一部は、Customer Profiles の標準オーダーオブジェクトにマッピングされます。
次の表は、Shopify-DraftOrder オブジェクトから標準プロファイルにマッピングできるフィールドの一覧です。
ソースに `order_status_url` が存在する場合、`StatusCode` は `ACTIVATED` です。そうでない場合、`StatusCode` は `DRAFT` です。
| Shopify-DraftOrder ソースフィールド | 標準オーダーのフィールド |
| --- | --- |
| id | Attributes.ShopifyOrderId |
| customer.id | Attributes.ShopifyCustomerId |
| note | AdditionalInformation |
| E メール | CustomerEmail |
| currency | Currency |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
| 名前 | 名前 |
| ステータス | ステータス |
| order\$1status\$1url | StatusCode |
| billing\$1address.address1 | BillingAddress.Address1 |
| billing\$1address.address2 | BillingAddress.Address2 |
| billing\$1address.city | BillingAddress.City |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Province |
| billing\$1address.country | BillingAddress.Country |
| billing\$1address.name | BillingAddress.Name |
| shipping\$1address.address1 | ShippingAddress.Address1 |
| shipping\$1address.address2 | ShippingAddress.Address2 |
| shipping\$1address.city | ShippingAddress.City |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Province |
| shipping\$1address.country | ShippingAddress.Country |
| shipping\$1address.name | ShippingAddress.Name |
| invoice\$1url | StatusUrl |
| total\$1price | TotalPrice |
| total\$1tax | TotalTax |
| line\$1items[].title | OrderItems[].Title |
| line\$1items[].price | OrderItems[].Price |
| line\$1items[].quantity | OrderItems[].Quantity |
### 例
次の例では、ソースフィールドをターゲットフィールドにマップする方法を示します。
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Shopify オブジェクトの Shopify-DraftOrder 顧客データは、次のインデックスを使用して Amazon Connect 標準オーダーに関連付けられます。
| 標準インデックス名 | Shopify-DraftOrder ソースフィールド |
| --- | --- |
| \$1shopifyOrderId | id |
例えば、標準オーダーを検索するためには、`_shopifyOrderId` を `ObjectFilter.KeyName` として使用し、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を使用することができます。特定のお客様プロファイルに関連付けられている Shopify-DraftOrder オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `Shopify-DraftOrder` に設定して使用すると検索できます。
## Shopify-Order オブジェクト
Shopify-Order オブジェクトのすべてのフィールドのリストについては、Shopify ドキュメントの「[Order オブジェクト](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object)」を参照してください。
## Shopify-Order オブジェクトを標準オーダーにマッピングする
Shopify-Order オブジェクトのフィールドの一部は、Customer Profiles の標準オーダーオブジェクトにマッピングされます。
次の表は、Shopify-Order オブジェクトから標準オーダーにマッピングできるフィールドの一覧です。
ソースに `order_status_url` が存在する場合、`StatusCode` は `ACTIVATED` です。そうでない場合、`StatusCode` は `DRAFT` です。
| Shopify-Order ソースフィールド | 標準オーダーのフィールド |
| --- | --- |
| id | Attributes.ShopifyOrderId |
| customer.id | Attributes.ShopifyCustomerId |
| cancelled\$1at | CancelledDate |
| cancel\$1reason | CancelReason |
| closed\$1at | ClosedDate |
| created\$1at | CreatedDate |
| currency | Currency |
| E メール | CustomerEmail |
| financial\$1status | ステータス |
| order\$1status\$1url | StatusCode |
| fulfillment\$1status | FulfillmentStatus |
| ゲートウェイ | ゲートウェイ |
| 名前 | 名前 |
| note | AdditionalInformation |
| order\$1status\$1url | StatusUrl |
| phone | CustomerPhone |
| processed\$1at | ProcessedDate |
| total\$1discounts | TotalDiscounts |
| total\$1line\$1items\$1price | TotalItemsPrice |
| total\$1price | TotalPrice |
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice |
| total\$1tax | TotalTax |
| total\$1tip\$1received | TotalTipReceived |
| total\$1weight | TotalWeight |
| updated\$1at | UpdatedDate |
| billing\$1address.address1 | BillingAddress.Address1 |
| billing\$1address.address2 | BillingAddress.Address2 |
| billing\$1address.city | BillingAddress.City |
| billing\$1address.zip | BillingAddress.PostalCode |
| billing\$1address.province | BillingAddress.Province |
| billing\$1address.country | BillingAddress.Country |
| billing\$1address.name | BillingAddress.Name |
| payment\$1details.credit\$1card\$1number | CreditCardNumber |
| payment\$1details.credit\$1card\$1company | CreditCardCompany |
| shipping\$1address.address1 | ShippingAddress.Address1 |
| shipping\$1address.address2 | ShippingAddress.Address2 |
| shipping\$1address.city | ShippingAddress.City |
| shipping\$1address.zip | ShippingAddress.PostalCode |
| shipping\$1address.province | ShippingAddress.Province |
| shipping\$1address.country | ShippingAddress.Country |
| shipping\$1address.name | ShippingAddress.Name |
| line\$1items[].title | OrderItems[].Title |
| line\$1items[].price | OrderItems[].Price |
| line\$1items[].quantity | OrderItems[].Quantity |
### 例
次の例では、ソースフィールドをターゲットフィールドにマップする方法を示します。
```
"shopifyOrderId": {
"Source": "_source.detail.event.detail.payload.id",
"Target": "_order.Attributes.ShopifyOrderId"
}
```
Shopify オブジェクトの Shopify-Order 顧客データは、次のインデックスを使用して、Amazon Connect 標準オーダーに関連付けられます。
| 標準インデックス名 | Shopify-Order ソースフィールド |
| --- | --- |
| \$1shopifyOrderId | id |
例えば、標準オーダーを検索するためには、`_shopifyOrderId` を `ObjectFilter.KeyName` として使用し、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を使用することができます。特定のプロファイルに関連付けられている Shopify-Order オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `Shopify-Order` に設定して使用すると検索できます。
# 標準通信レコードのオブジェクトタイプマッピング
このセクションのトピックでは、標準通信レコードの定義と、キャンペーンイベントから標準通信レコードへのオブジェクトタイプのマッピングについて説明します。
**Topics**
+ [Customer Profiles の標準通信レコードオブジェクトのフィールド](customer-profiles-standard-communication-record-object-fields.md)
+ [Amazon Connect Customer Profiles の標準通信レコードへのキャンペーンオブジェクトのマッピング](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)
# Customer Profiles の標準通信レコードオブジェクトのフィールド
次の表に、Customer Profiles の標準通信レコードオブジェクトのすべてのフィールドを示します。
| 標準 communicationRecord フィールド | データ型 | 説明 |
| --- | --- | --- |
| CommunicationRecordId | String | 標準通信レコードの一意の識別子。 |
| [チャネル] | String | コンタクトセンターに問い合わせるために使用する方法。例: VOICE, CHAT, EMAIL |
| ConnectInstanceArn | String | AWS Connect インスタンスの ARN。 |
| CreatedDate | String | 通信レコードが作成された日時を示すタイムスタンプ。 |
| UpdatedDate | String | 通信レコードが最後に更新された日時を示すタイムスタンプ。 |
| LastEventType | String | この通信に取り込まれた最後のイベントのイベントタイプ。 |
| キャンペーン | キャンペーン | この通信に関連付けられたキャンペーンの詳細。 |
| Endpoint | Endpoint | この通信に使用されるエンドポイントに関する情報。 |
| Events | Map | キーが E メールの配信、開封、クリックなどのイベントタイプであるイベントのマップ。これにより、この通信中に発生した各一意のイベントタイプの最後のイベントが追跡されます。 |
| 属性 | Map | 標準通信レコードの属性のキーと値のペア。 |
標準通信レコードオブジェクトは、次の表のキーによってインデックス付けされます。
| 標準インデックス名 | 標準通信レコードフィールド |
| --- | --- |
| \$1communicationRecordId | CommunicationRecordId |
例えば、`_communicationRecordId` をキー名として [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html) API で使用すると、`CommunicationRecordId` が検索値と一致する通信レコードを持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準 `communicationRecord` オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html) API を、`ProfileId` および `ObjectTypeName` を `_communicationRecord` に設定して使用すると検索できます。
## Campaign データ型
| フィールド | データ型 | 説明 |
| --- | --- | --- |
| CampaignId | String | アウトバウンドキャンペーンの一意の ID。 |
| CampaignName | String | アウトバウンドキャンペーンの名前。 |
| CampaignRunId | String | キャンペーンの特定の実行の一意の ID。 |
| CampaignActivityId | String | キャンペーン内のアクティビティの一意の ID。 |
| SegmentArn | String | ユーザーのセグメントの ARN。 |
## Endpoint データ型
| フィールド | データ型 | 説明 |
| --- | --- | --- |
| EndpointAddress | String | エンドポイントのアドレス (E メールアドレス、電話番号など)。 |
| EndpointType | String | デフォルトの E メールやビジネス E メールなどのエンドポイントのタイプ。 |
## Event データ型
| フィールド | データ型 | 説明 |
| --- | --- | --- |
| UpdatedDate | String | 通信イベントが発生した日時を示すタイムスタンプ。 |
| EventId | String | 各通信イベントの一意の識別子。 |
| EventType | String | 特定の通信イベントタイプ。 |
| 属性 | Map | イベントタイプに固有の属性のキーと値のペア。 |
# Amazon Connect Customer Profiles の標準通信レコードへのキャンペーンオブジェクトのマッピング
このトピックでは、Customer Profiles の標準通信レコードオブジェクトの各フィールドに、キャンペーンオブジェクトのどのフィールドがマップされるのかを示します。
## Campaign-Email オブジェクト
Campaign-Email オブジェクトのすべてのフィールドの一覧については、Amazon SES ドキュメントの「[E メールオブジェクト](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html)」を参照してください。
**Campaign-Email オブジェクトを標準通信レコードにマッピングする**
Campaign-Email オブジェクトのフィールドの一部は、Customer Profiles の標準通信レコードオブジェクトにマッピングされます。
次の表は、Campaign-Email オブジェクトから標準通信レコードにマッピングできるフィールドの一覧です。
| Campaign-Email ソースフィールド | 標準通信レコードターゲットフィールド |
| --- | --- |
| campaign\$1event\$1id | Attributes.LastCampaignEventId |
| outbound\$1request\$1id | Attributes.OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributes.CampaignMessageId |
| channel.name | [チャネル] |
| channel.subtype | Attributes.ChannelSubType |
| endpoint\$1address | Endpoint.EndpointAddress |
| endpoint\$1type | Endpoint.EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campaign.CampaignName |
| campaign\$1id | Campaign.CampaignId |
| campaign\$1run\$1id | Campaign.CampaignRunId |
| campaign\$1activity\$1id | Campaign.CampaignActivityId |
| segment\$1arn | Campaign.SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate |
| campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId |
| campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType |
| email.bounce.bounceType | Events.Bounce.Attributes.BounceType |
| email.bounce.bounceSubType | Events.Bounce.Attributes.BounceSubType |
| email.click.link | Events.Click.Attributes.Link |
| email.click.ipAddress | Events.Click.Attributes.IpAddress |
| email.open.ipAddress | Events.Open.Attributes.IpAddress |
| email.reject.reason | Events.Reject.Attributes.Reason |
| email.renderingFailure.templateName | Events.RenderingFailure.Attributes.TemplateName |
| email.renderingFailure.errorMessage | Events.RenderingFailure.Attributes.ErrorMessage |
| email.deliveryDelay.delayType | Events.DeliveryDelay.Attributes.DelayType |
| email.complaint.complaintFeedbackType | Events.Complaint.Attributes.ComplaintFeedbackType |
| email.complaint.complaintSubType | Events.Complaint.Attributes.ComplaintSubType |
| email.mail.commonHeaders.subject | Attributes.Subject |
## Campaign-SMS オブジェクト
Campaign-SMS オブジェクトのすべてのフィールドの一覧については、AWS End User Messaging SMS ドキュメントの「[SMS オブジェクト](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html)」を参照してください。
**Campaign-SMS オブジェクトを標準通信レコードにマッピングする**
Campaign-SMS オブジェクトのフィールドの一部は、Customer Profiles の標準通信レコードオブジェクトにマッピングされます。
次の表は、Campaign-SMS オブジェクトから標準通信レコードにマッピングできるフィールドの一覧です。
| Campaign-SMS ソースフィールド | 標準通信レコードターゲットフィールド |
| --- | --- |
| campaign\$1event\$1id | Attributes.LastCampaignEventId |
| outbound\$1request\$1id | Attributes.OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributes.CampaignMessageId |
| channel.name | [チャネル] |
| channel.subtype | Attributes.ChannelSubType |
| endpoint\$1address | Endpoint.EndpointAddress |
| endpoint\$1type | Endpoint.EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign\$1name | Campaign.CampaignName |
| campaign.campaign\$1id | Campaign.CampaignId |
| campaign.campaign\$1run\$1id | Campaign.CampaignRunId |
| campaign\$1activity\$1id | Campaign.CampaignActivityId |
| segment\$1arn | Campaign.SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate |
| campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId |
| campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType |
| sms.messageType | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageType |
| sms.messageStatus | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageStatus |
| sms.messageStatusDescription | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.MessageStatusDescription |
| sms.totalMessagePrice | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.TotalMessagePrice |
| sms.totalCarrierFee | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.TotalCarrierFee |
| sms.isoCountryCode | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.IsoCountryCode |
## Campaign-Telephony オブジェクト
Campaign-Telephony オブジェクトのすべてのフィールドのリストについては、 AWS 「エンドユーザーメッセージング SMS ドキュメント」の[「Voice オブジェクト](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html)」を参照してください。
**Campaign-Telephony オブジェクトを標準通信レコードにマッピングする**
Campaign-Telephony オブジェクトのフィールドの一部は、Customer Profiles の標準通信レコードオブジェクトにマッピングされます。
次の表は、Campaign-Telephony オブジェクトから標準通信レコードにマッピングできるフィールドの一覧です。
| Campaign-Telephony ソースフィールド | 標準通信レコードターゲットフィールド |
| --- | --- |
| campaign\$1event\$1id | Attributes.LastCampaignEventId |
| outbound\$1request\$1id | Attributes.OutboundCampaignRequestId |
| campaign\$1message\$1id | Attributes.CampaignMessageId |
| channel.name | [チャネル] |
| channel.subtype | Attributes.ChannelSubType |
| endpoint.endpoint\$1address | Endpoint.EndpointAddress |
| endpoint.endpoint\$1type | Endpoint.EndpointType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campaign.CampaignName |
| campaign.campaign\$1id | Campaign.CampaignId |
| campaign.campaign\$1run\$1id | Campaign.CampaignRunId |
| campaign.campaign\$1activity\$1id | Campaign.CampaignActivityId |
| campaign.segment\$1arn | Campaign.SegmentArn |
| outbound\$1request\$1creation\$1timestamp | CreatedDate |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate |
| campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId |
| campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType |
| voice.agentInfo.connectedToAgentTimestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.ConnectedToAgentTimestamp |
| voice.customerVoiceActivity.greetingEndTimestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.GreetingEndTimestamp |
| voice.answeringMachineDetectionStatus | Events.\$1\$1campaign\$1event\$1type\$1\$1.Attributes.AnsweringMachineDetectionStatus |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## Campaign-Orchestration オブジェクト
**Campaign-Orchestration オブジェクトを標準通信レコードにマッピングする**
Campaign-Orchestration オブジェクトのフィールドの一部は、Customer Profiles の標準通信レコードオブジェクトにマッピングされます。
次の表は、Campaign-Orchestration オブジェクトから標準通信レコードにマッピングできるフィールドの一覧です。
| Campaign-Orchestration ソースフィールド | 標準通信レコードターゲットフィールド |
| --- | --- |
| campaign\$1event\$1id | Attributes.LastCampaignEventId |
| channel.name | [チャネル] |
| channel.subtype | Attributes.ChannelSubType |
| instance\$1arn | ConnectInstanceArn |
| campaign.campaign\$1name | Campaign.CampaignName |
| campaign.campaign\$1id | Campaign.CampaignId |
| campaign.campaign\$1run\$1id | Campaign.CampaignRunId |
| campaign.campaign\$1activity\$1id | Campaign.CampaignActivityId |
| campaign.segment\$1arn | Campaign.SegmentArn |
| campaign\$1event\$1timestamp | UpdatedDate |
| campaign\$1event\$1type | LastEventType |
| campaign\$1event\$1timestamp | Events.\$1\$1campaign\$1event\$1type\$1\$1.UpdatedDate |
| campaign\$1event\$1id | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventId |
| campaign\$1event\$1type | Events.\$1\$1campaign\$1event\$1type\$1\$1.EventType |
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp |
## 例
次の例では、ソースフィールドをターゲットフィールドにマップする方法を示します。
```
"channel": {
"source": "_source.engagement.channel.name",
"target": "_communicationRecord.Channel"
}
```
# Customer Profiles の標準アセットのオブジェクトタイプマッピング
このセクションのトピックでは、標準アセット定義と、外部アプリケーションから標準アセットへのオブジェクトタイプマッピングについて説明します。
**Topics**
+ [Amazon AppFlow アクセス要件](appflow-access-requirements-asset.md)
+ [標準アセットの定義](standard-asset-definition.md)
+ [標準アセットへの Salesforce オブジェクトのマッピング](mapping-salesforce-objects-to-asset.md)
# Customer Profiles の Amazon AppFlow アクセス要件
Amazon Connect Customer Profiles と Salesforce の統合を作成および削除するには、以下の Amazon AppFlow アクセス要件を使用します。
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Amazon Connect Customer Profiles の標準アセット定義
次の表に、Customer Profiles での標準アセットオブジェクトに関するすべてのフィールドを示します。
| 標準アセットフィールド | データ型 | 説明 |
| --- | --- | --- |
| AssetId | String | 標準アセットの一意の識別子。 |
| AssetName | String | アセットの名前。 |
| SerialNumber | String | アセットのシリアル番号。 |
| ModelNumber | String | アセットのモデル番号。 |
| ModelName | String | アセットのモデル名。 |
| ProductSKU | String | アセットの在庫保持単位。 |
| PurchaseDate | String | アセットの購入日。 |
| UsageEndDate | String | アセットの使用終了日。 |
| ステータス | String | アセットのステータス。 |
| Price | String | アセットの価格。 |
| 数量 | String | アセットの数量。 |
| 説明 | 文字列 | アセットに関する説明。 |
| AdditionalInformation | String | アセットに関連する追加情報。 |
| DataSource | String | アセットのデータソース。 |
| 属性 | 文字列から文字列へのマッピング | 標準アセットの属性のキーと値のペア。 |
標準アセットオブジェクトは、次の表のキーによってインデックス付けされます。
| 標準インデックス名 | 標準アセットフィールド |
| --- | --- |
| \$1assetId | AssetId |
| \$1assetName | AssetName |
| \$1serialNumber | SerialNumber |
例えば、`_assetName` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、AssetName が検索値と一致するアセットを持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準アセットオブジェクトは、[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) を、`ProfileId` および `ObjectTypeName` を `_asset` に設定して使用すると検索できます。
# Customer Profiles の標準アセットへの Salesforce オブジェクトのマッピング
このトピックでは、Customer Profiles の標準アセットオブジェクトの各フィールドに、Salesforce オブジェクトのどのフィールドがマップされるのかを示します。
## Salesforce-Asset オブジェクト
Salesforce-Asset オブジェクト内のすべてのフィールドの一覧を次に示します。
+ ID
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ 名前
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ ステータス
+ 料金
+ 数量
+ 説明
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate
## 標準アセットに Salesforce-Asset オブジェクトをマッピングする
Salesforce-Asset オブジェクトのフィールドの一部は、Customer Profiles の標準アセットオブジェクトにマッピングされます。
次の表に、Salesforce-Asset オブジェクトから標準アセットにマッピングできるフィールドを示します。
| Salesforce-Asset のマッピング元フィールド | 標準アセットのマッピング先フィールド |
| --- | --- |
| ID | Attributes.sfdcAssetId |
| ContactId | Attributes.sfdcContactId |
| AccountId | Attributes.sfdcAccountId |
| SerialNumber | SerialNumber |
| StockKeepingUnit | ProductSKU |
| UsageEndDate | UsageEndDate |
| ステータス | ステータス |
| 料金 | 料金 |
| 数量 | 数量 |
| 説明 | 説明 |
Salesforce オブジェクトの顧客データ Salesforce-Asset は、次の表に示すインデックスを使用して Amazon Connect の標準アセットに関連付けられます。
| 標準インデックス名 | Salesforce-Asset のマッピング元フィールド |
| --- | --- |
| \$1salesforceAssetId | ID |
| \$1salesforceContactId | ContactId |
| \$1salesforceAccountId | AccountId |
例えば、標準アセットを検索するためには、`ObjectFilter.KeyName` に `_salesforceAssetId` および `_salesforceAccountId` を指定しながら [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を使用できます。特定のプロファイルに関連付けられた Salesforce-Asset オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Salesforce-Asset` に設定して使用すると検索できます。
# Customer Profiles の標準ケースのオブジェクトタイプマッピング
このセクションのトピックでは、標準ケースの定義と、外部アプリケーションから標準ケースへのオブジェクトタイプマッピングについて説明します。
**Topics**
+ [Amazon AppFlow アクセス要件](appflow-access-requirements-case.md)
+ [標準ケースでの定義](standard-case-definition.md)
+ [Zendesk オブジェクトのマッピング](mapping-zendesk-objects-case.md)
+ [ServiceNow オブジェクトのマッピング](mapping-servicenow-objects-standard-case.md)
# Customer Profiles の Amazon AppFlow アクセス要件
Amazon Connect Customer Profiles と Zendesk および ServiceNow の統合を作成および削除するには、以下の Amazon AppFlow アクセス要件を使用します。
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`
# Customer Profiles 標準ケースオブジェクトのフィールド
次の表に、Customer Profiles での標準ケースオブジェクトのすべてのフィールドを示します。
| 標準ケースフィールド | データ型 | 説明 |
| --- | --- | --- |
| CaseId | String | 標準ケースの一意の識別子。 |
| タイトル | String | ケースのタイトル。 |
| 概要 | String | ケースの概要。 |
| ステータス | String | ケースのステータス。 |
| Reason | String | ケースの理由。 |
| CreatedBy | String | ケースの作成者。 |
| CreatedDate | String | ケースの作成日。 |
| UpdatedDate | String | ケースが更新された日付。 |
| ClosedDate | String | ケースが閉じられた日付。 |
| AdditionalInformation | String | ケースに関連する追加情報。 |
| DataSource | String | ケースのデータソース。 |
| 属性 | 文字列から文字列へのマッピング | 標準ケースの属性のキーと値のペア。 |
標準ケースオブジェクトは、次の表のキーによってインデックス付けされます。
| 標準インデックス名 | 標準ケースフィールド |
| --- | --- |
| \$1caseId | CaseId |
例えば、`_caseId` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、CaseId が検索値と一致するケースを持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準ケースオブジェクトは、[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) を、`ProfileId` および `ObjectTypeName` を `_case` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準ケースへの Zendesk オブジェクトのマッピング
このトピックでは、Customer Profiles の標準ケースの各フィールドにマッピングされる、Zendesk オブジェクトのフィールドの一覧を示します。
## Zendesk-tickets オブジェクト
以下に、Zendesk-tickets オブジェクト内のすべてのフィールドを一覧で示します。
+ id
+ url
+ 型
+ subject
+ raw\$1subject
+ 説明
+ priority
+ ステータス
+ 受取人
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organization\$1id
+ group\$1id
+ collaborator\$1ids
+ email\$1cc\$1ids
+ follower\$1ids
+ forum\$1topic\$1id
+ problem\$1id
+ has\$1incidents
+ due\$1at
+ タグ
+ via.channel
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1ids
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachments
+ is\$1public
+ created\$1at
+ updated\$1at
## Zendesk-tickets オブジェクトを標準ケースにマッピングする
Zendesk-tickets オブジェクトのフィールドの一部は、Customer Profiles 内の標準ケースにマッピングされます。次の表は、Zendesk-tickets オブジェクトから標準ケースにマッピングできるフィールドの一覧です。
| Zendesk-tickets のマッピング元フィールド | 標準ケースでのターゲットフィールド |
| --- | --- |
| requester\$1id | Attributes.ZendeskUserId |
| id | Attributes.ZendeskTicketId |
| subject | タイトル |
| 説明 | 概要 |
| ステータス | ステータス |
| requester\$1id | CreatedBy |
| created\$1at | CreatedDate |
| updated\$1at | UpdatedDate |
Zendesk オブジェクトの顧客データ Zendesk-tickets は、次の表に示すインデックスを使用して、Amazon Connect の標準ケースに関連付けられます。
| 標準インデックス名 | Zendesk-tickets のマッピング元フィールド |
| --- | --- |
| \$1zendeskUserId | requester\$1id |
| \$1zendeskTicketId | id |
例えば、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API で `ObjectFilter.KeyName` として `_zendeskUserId` および `_zendeskTicketId` を使用することで、標準ケースを検索できます。特定のプロファイルに関連付けられた Zendesk-tickets オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Zendesk-tickets` に設定して使用すると検索できます。
# Amazon Connect Customer Profiles の標準ケースへの ServiceNow オブジェクトのマッピング
このトピックでは、Amazon Connect Customer Profiles 内の標準ケースの各フィールドに、ServiceNow オブジェクトのどのフィールドがマッピングされるのかを示します。
## Servicenow-task オブジェクト
Servicenow-task オブジェクト内のすべてのフィールドの一覧を以下に示します。
+ sys\$1id
+ アクティブ
+ activity\$1due
+ additional\$1assignee\$1list
+ approval
+ approval\$1history
+ approval\$1set
+ assigned\$1to
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ calendar\$1duration
+ closed\$1at
+ closed\$1by
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ コメント
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contract
+ correlation\$1display
+ アクティブ
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ 説明
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impact
+ knowledge
+ location
+ made\$1sla
+ 数値
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ state
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ アクティブ
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1worked
+ upon\$1approval
+ upon\$1reject
+ urgency
+ user\$1input
+ watch\$1list
+ work\$1end
+ work\$1notes
+ work\$1notes\$1list
+ work\$1start
## ServiceNow-task を標準ケースにマッピングする
Servicenow-task オブジェクトのフィールドの一部は、Customer Profiles 内の標準ケースにマッピングされます。
次の表は、Servicenow-task オブジェクトから標準ケースにマッピングできるフィールドの一覧です。
| Servicenow-task マッピング元フィールド | 標準ケースでのターゲットフィールド |
| --- | --- |
| sys\$1id | Attributes.ServiceNowTaskId |
| opened\$1by.link | Attributes.ServiceNowSystemUserId |
| short\$1description | タイトル |
| 説明 | 概要 |
| ステータス | ステータス |
| sys\$1created\$1by | CreatedBy |
| sys\$1created\$1on | CreatedDate |
| sys\$1updated\$1on | UpdatedDate |
Servicenow の顧客データ Servicenow-task は、次の表に示すインデックスを使用して Amazon Connect 標準ケースに関連付けられます。
| 標準インデックス名 | Servicenow-task マッピング元フィールド |
| --- | --- |
| \$1serviceNowTaskId | sys\$1id |
| \$1serviceNowSystemId | open\$1by.link |
例えば、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API で `ObjectFilter.KeyName` として `_serviceNowTaskId` および `_serviceNowSystemId` を使用することで、標準ケースを検索できます。特定のプロファイルに関連付けられた Servicenow-task オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Servicenow-task` に設定して使用すると検索できます。
## Servicenow-incident オブジェクト
Servicenow-incident オブジェクト内のすべてのフィールドの一覧を次に示します。
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ category
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severity
+ subcategory
## Servicenow-incident を標準ケースにマッピングする
Servicenow-incident オブジェクトのフィールドの一部は、Customer Profiles 内の標準ケースにマッピングされます。
次の表は、Servicenow-incident オブジェクトから標準ケースにマッピングできるフィールドの一覧です。
| Servicenow-Incident マッピング元フィールド | 標準ケースでのターゲットフィールド |
| --- | --- |
| sys\$1id | Attributes\$1ServiceNowIncidentId |
| caller\$1id.link | Attributes\$1ServiceNowSystemUserId |
| incident\$1status | ステータス |
| caller\$1id.link | CreatedBy |
| resolved\$1at | ClosedDate |
| category | Reason |
Servicenow オブジェクトの顧客データ Servicenow-incident は、次の表に示すインデックスを使用して Amazon Connect の標準ケースに関連付けられます。
| 標準インデックス名 | Servicenow ソースフィールド |
| --- | --- |
| \$1serviceNowIncidentId | sys\$1id |
| \$1serviceNowSystemId | caller\$1id.link |
例えば、標準ケースを見つけるために、ObjectFilter.KeyName で `_serviceNowIncidentId` および `_serviceNowSystemId` を指定しながら、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を使用することができます。特定のプロファイルに関連付けられた Servicenow-incident オブジェクトは、[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API を`ProfileId` および `ObjectTypeName` を `Servicenow-incident` に設定して使用すると検索できます。
# 標準フライト優先設定のオブジェクトタイプマッピング
このセクションのトピックでは、標準フライト優先設定の定義について説明します。
**Topics**
+ [
# Customer Profiles の標準フライト優先設定オブジェクトのフィールド
](standard-air-preference-object-fields.md)
# Customer Profiles の標準フライト優先設定オブジェクトのフィールド
次の表に、Customer Profiles の標準フライト優先設定オブジェクトのすべてのフィールドを示します。
**フライトの優先設定**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| PreferenceId | String | 標準フライト優先設定の一意の識別子 |
| Name | String | 優先設定の名前 |
| CreatedDate | String | 優先設定の作成日 |
| CreatedBy | String | 作成者の識別子 |
| UpdatedDate | String | 最終更新日 |
| UpdatedBy | String | 最後に更新したユーザーの識別子 |
| StartDate | String | 優先設定の開始日 |
| EndDate | String | 優先設定の終了日 |
| ステータス | String | 優先設定の現在のステータス。 |
| ReferenceId | String | 参照されるオブジェクトの ID |
| ReferenceType | String | 参照されるオブジェクトのタイプ |
| TravelType | String | 移動のタイプ (直通便など) |
| Transfer | String | 希望する乗り換えのタイプ |
| ArrivalAirport | String | 優先到着空港 |
| ArrivalTerminal | String | 優先到着空港ターミナル |
| DepartureAirport | String | 優先出発空港 |
| DepartureTerminal | String | 優先出発空港ターミナル |
| HomeAirport | String | ホーム空港 |
| CheckInChannel | String | チェックインモード |
| CheckInChannelDevice | String | チェックインに使用するデバイス |
| Language | Language | コミュニケーションに使用する言語の詳細 |
| Seat | Seat | 座席選択の詳細 |
| Journey | Journey | 旅行の優先設定 |
| Accessibility | Accessibility | アクセシビリティリクエストの詳細 |
| Insurance | Insurance | 保険の詳細 |
| Interest | Interest | 関心の詳細 |
| Loyalty | Loyalty | ロイヤルティの詳細 |
| Dining | Dining | ダイニングの優先設定 |
| MediaEntertainment | MediaEntertainment | メディアとエンターテインメントの優先設定 |
| PaymentForm | PaymentForm | 支払い方法の優先設定 |
| PetInfo | PetInfo | ペットの詳細 |
| SpecialRequest | SpecialRequest | 特別なリクエストの詳細 |
| TicketDistribution | TicketDistribution | チケット送付の設定 |
| Marketing | Marketing | マーケティングの優先設定 |
| Medical | Medical | 医療に関する優先設定 |
| Baggage | Baggage | 荷物の優先設定 |
| ContactDetail | ContactDetail | コンタクトに関する優先設定の詳細 |
| ContactDetailAddress | ContactDetailAddress | 連絡先アドレスの詳細 |
| ContactDetailCommunication | ContactDetailCommunication | コミュニケーションに関する優先設定 |
| 属性 | Map | フライトの優先設定の属性のキーと値のペア |
標準フライト優先設定オブジェクトは、次の表のキーによってインデックス付けされます。
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1airPreferenceId | PreferenceId |
| \$1airReferenceId | ReferenceId |
例えば、`_airPreferenceId` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、PreferenceId が検索値と一致するフライトの優先設定を持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準 airPreference オブジェクトは、[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) を、`ProfileId` および `ObjectTypeName` を `_airPreference` に設定して使用すると検索できます。
**ContactDetail データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | コンタクトタイプ (個人、緊急など) |
| PreferenceLevel | String | このコンタクトの優先度レベル |
| PhoneNumber | String | Phone number (電話番号) |
| Relationship | String | プロファイルとの関係 |
| EmailAddress | String | E メールアドレス |
| EmailLanguage | String | 連絡先の詳細の E メールコミュニケーションの優先言語 |
| PhoneLanguage | String | 連絡先の詳細の電話コミュニケーションの優先言語 |
**ContactDetailAddress データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | 連絡先の住所のタイプ |
| Address1 | String | 連絡先住所の最初の行。 |
| Address2 | String | 連絡先住所の 2 行目。 |
| Address3 | String | 連絡先住所の 3 行目。 |
| Address4 | String | 連絡先住所の 4 行目。 |
| City | String | 連絡先住所の都市。 |
| Country | String | 連絡先住所の国。 |
| County | String | 連絡先住所の郡。 |
| PostalCode | String | 連絡先住所の郵便番号 |
| Province | String | 連絡先住所の都道府県。 |
| State | String | 連絡先住所の州。 |
**ContactDetailCommunication データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Method | String | コミュニケーション方法 (SMS、E メールなど) |
| PreferenceLevel | String | コミュニケーション方法の優先レベル |
**Language データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| PhoneLanguage | String | 電話コミュニケーションの優先言語 |
| EmailLanguage | String | E メールコミュニケーションの優先言語 |
| InPersonLanguage | String | 対面コミュニケーションの優先言語 |
| PreferenceLevel | String | 言語の優先レベル |
**Seat データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| PreferenceLevel | String | 座席設定の優先レベル |
| Direction | String | 優先する座席の位置 (例: 前方、後方) |
| Location | String | 優先する座席の場所 (窓側、通路側など) |
| ポジション | String | 座席の位置 (左、右など) |
| Row | String | 優先する座席の行 |
| ClassOfService | String | 座席クラス (例: エコノミー、ビジネス) |
| NeighborFree | String | 隣の席が空席の席の優先設定 |
| Infant | String | チャイルドシートの優先設定 |
| ExtraSeat | String | 追加の座席の優先設定 |
**Journey データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| MaxConnections | String | 乗り継ぎの最大数 |
| PreferredAirline | String | 優先する航空会社 |
| UpgradeAuction | String | アップグレード入札へのオプトイン |
| FlightTime | String | 優先するフライト時間 |
| FlightMaxDuration | String | 優先する最大フライト時間 |
**Accessibility データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Wheelchair | String | 車いすに関するアクセシビリティ情報 |
| Bathroom | String | トイレに関するアクセシビリティ情報 |
| Assistance | String | 補助に関する情報 |
| DisabilityType | String | 障害に関する情報 |
| SupportAnimal | String | 介助動物に関する情報 |
| ProximityToFacilities | String | 施設への距離に関する必要姓 |
**Insurance データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | 保険会社またはプランの名前 |
| PreferenceLevel | String | 保険の優先レベル |
**Interest データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | 具体的な関心の分野 |
| PreferenceLevel | String | この関心の優先度 |
**Loyalty データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | ロイヤルティプログラムの名前 |
| MembershipId | String | ロイヤルティプログラムのメンバーシップ ID |
| PreferenceLevel | String | ロイヤルティプログラムの優先レベル |
**Dining データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| MealType | String | 優先する食事のタイプ |
| FavoriteCuisine | String | お気に入りの料理のタイプ |
| Beverage | String | 優先する飲み物 |
| DietaryRestriction | String | 食事制限 |
| AllergyInfo | String | アレルギーの詳細 |
| PreferenceLevel | String | ダイニングの優先レベル |
**Media and entertainment データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | 優先するエンターテインメントの名前 |
| PreferenceLevel | String | メディア/エンターテインメントの優先レベル |
**PaymentForm データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Name | String | 支払い方法の名前 |
| タイプ | String | 支払いのタイプ (クレジットカード、PayPal など) |
| PreferenceLevel | String | 支払い方法の優先レベル |
| UsageContext | String | 支払い方法を使用する場所 |
**PetInfo データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | ペットのタイプ |
| PreferenceLevel | String | ペットに関する優先レベル |
**SpecialRequest データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | 特別なリクエストのタイプ |
| Name | String | リクエストの名前または説明 |
| PreferenceLevel | String | リクエストの優先レベル |
**TicketDistribution データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| PreferenceLevel | String | チケット送付の優先レベル |
| Method | String | チケットの送付方法 (E メール、物理など) |
| TicketTime | String | チケット送付の優先時間 |
**Marketing データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| ChannelType | String | マーケティングチャンネルのタイプ (SMS、E メールなど) |
| OptIn | String | マーケティングのオプトインステータス |
| Frequency | String | マーケティングコミュニケーションの頻度 |
| StartDate | String | 優先するマーケティングの開始日 |
| EndDate | String | 優先するマーケティングの終了日 |
**Medical データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Oxygen | String | (航空会社提供、乗客所有、濃縮器など) |
| MedicalEquipment | String | 医療機器の詳細 (CPAP 機器、酸素濃縮器など)。 |
| Assistance | String | 旅行中に一般的な医療支援が必要かどうかを指定します (フライト中のサポート、薬剤のサポート)。 |
| Stretcher | String | フライト中に旅行者がストレッチャーを必要とする場合。通常は医療輸送ケースに使用されます。 |
| WheelChair | String | 車いすの詳細 (非防漏型、ウェットセル、固定、RampNeeded、stairsAssistance、航空会社提供など) |
**Baggage データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Animal | String | 旅行者が介助動物またはペットと一緒に旅行しているかどうかを示し、関連する仕様または制限が含まれます(inHold、Cabin)。 |
| BaggageType | String | 優先するタイプの荷物対応を指定します (持ち込みのみ、チェックイン済みの荷物、サイズ超過など)。 |
| Assistance | String | 旅行者が空港のポーターサービスやカーブサイドの荷物のヘルプなど、荷物の輸送や管理の支援を必要とするかどうかを示します。 |
| PreferenceLevel | String | 荷物フィールドの優先レベル |
# 標準ホテル優先設定のオブジェクトタイプマッピング
このセクションのトピックでは、標準ホテル優先設定の定義について説明します。
**Topics**
+ [
# Customer Profiles の標準ホテル優先設定オブジェクトのフィールド
](standard-hotel-preference-object-fields.md)
# Customer Profiles の標準ホテル優先設定オブジェクトのフィールド
次の表に、Customer Profiles の標準ホテル優先設定オブジェクトのすべてのフィールドを示します。
**ホテルの優先設定**
| 標準 hotelPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| PreferenceId | String | 標準ホテル優先設定の一意の識別子 |
| Name | String | 優先設定の名前 |
| CreatedDate | String | 優先設定の作成日 |
| CreatedBy | String | 作成者の識別子 |
| UpdatedDate | String | 最終更新日 |
| UpdatedBy | String | 最後に更新したユーザーの識別子 |
| StartDate | String | 優先設定の開始日 |
| EndDate | String | 優先設定の終了日 |
| ステータス | String | 優先設定の現在のステータス。 |
| Smoking | String | 喫煙に関する優先設定 |
| CleaningTime | String | クリーニング時間 |
| CheckInType | String | チェックインのタイプ |
| CheckOutType | String | チェックアウトのタイプ |
| ReferenceId | String | 参照されるオブジェクトの ID |
| ReferenceType | String | 参照されるオブジェクトのタイプ |
| ロケーション | ロケーション | ホテルの部屋の場所に関する優先設定 |
| Bedding | Bedding | ベッドに関する優先設定 |
| Tour | Tour | ツアーに関する優先設定 |
| ContactDetail | ContactDetail | コンタクトに関する優先設定の詳細 |
| ContactDetailAddress | ContactDetailAddress | 連絡先アドレスの詳細 |
| ContactDetailCommunication | ContactDetailCommunication | コミュニケーションに関する優先設定 |
| Language | Language | 言語に関する優先設定 |
| CarRental | CarRental | レンタカーの優先設定 |
| Accessibility | Accessibility | アクセシビリティの優先設定 |
| Interest | Interest | 関心の詳細 |
| Loyalty | Loyalty | ロイヤルティの優先設定 |
| Dining | Dining | ダイニングの優先設定 |
| MediaEntertainment | MediaEntertainment | メディアとエンターテインメントの優先設定 |
| PaymentForm | PaymentForm | 支払い形式の優先設定 |
| PetInfo | PetInfo | ペット情報の優先設定 |
| SpecialRequest | SpecialRequest | 特別なリクエストの詳細 |
| Marketing | Marketing | マーケティングの優先設定 |
| Medical | Medical | 医療に関する優先設定 |
| Baggage | Baggage | 荷物に関する優先設定 |
| 属性 | Map | ホテルの優先設定の属性のキーと値のペア |
標準ホテル優先設定オブジェクトは、次の表のキーによってインデックス付けされます。
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1hotelPreferenceId | PreferenceId |
| \$1hotelReferenceId | ReferenceId |
例えば、`_hotelPreferenceId` をキー名として [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) で使用すると、PreferenceId が検索値と一致するホテルの優先設定を持つプロファイルを見つけることができます。特定のプロファイルに関連付けられている標準 hotelPreference オブジェクトは、[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) を、`ProfileId` および `ObjectTypeName` を `_hotelPreference` に設定して使用すると検索できます。
**ContactDetail データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | コンタクトタイプ (個人、緊急など) |
| PreferenceLevel | String | このコンタクトの優先度レベル |
| PhoneNumber | String | Phone number (電話番号) |
| Relationship | String | プロファイルとの関係 |
| EmailAddress | String | E メールアドレス |
| EmailLanguage | String | 連絡先の詳細の E メールコミュニケーションの優先言語 |
| PhoneLanguage | String | 連絡先の詳細の電話コミュニケーションの優先言語 |
**ContactDetailAddress データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| タイプ | String | 連絡先の住所のタイプ |
| Address1 | String | 連絡先住所の最初の行。 |
| Address2 | String | 連絡先住所の 2 行目。 |
| Address3 | String | 連絡先住所の 3 行目。 |
| Address4 | String | 連絡先住所の 4 行目。 |
| City | String | 連絡先住所の都市。 |
| Country | String | 連絡先住所の国。 |
| County | String | 連絡先住所の郡。 |
| PostalCode | String | 連絡先住所の郵便番号。 |
| Province | String | 連絡先住所の都道府県。 |
| State | String | 連絡先住所の州。 |
**ContactDetailCommunication データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Method | String | コミュニケーション方法。 |
| PreferenceLevel | String | コミュニケーション方法の優先レベル |
| Frequency | String | コミュニケーションの頻度 |
**Language データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| PhoneLanguage | String | 電話での優先言語 |
| EmailLanguage | String | E メールでの優先言語 |
**CarRental データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Vendor | String | 優先するレンタカー会社 |
| VehicleType | String | 優先する車両タイプ |
| PreferenceLevel | String | レンタカーの優先レベル |
**Location データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| PreferredFloor | String | ルームフロアの優先設定 |
| ElevatorProximity | String | エレベーターへの近さの優先設定 |
| QuietZone | String | クワイエットゾーンの優先設定 |
| LobbyProximity | String | ロビーへの近さの優先設定 |
| View | String | 優先するルームビュー |
| RoomType | String | 優先するルームタイプ |
| PreferenceLevel | String | ロケーションの優先レベル |
**Bedding データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| BedType | String | 優先するベッドタイプ |
| MattressType | String | 優先するマットレスタイプ |
| PillowType | String | 優先する枕のタイプ |
| NumberOfPillows | String | 優先する枕の数 |
| BeddingMaterial | String | ベッドのマテリアル |
| Allergy | String | アレルギーに関するベッドの設定 |
**Tour データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| City | String | 優先するシティツアー |
| Cultural | String | カルチャーツアーに関する関心 |
| Adventure | String | アドベンチャーツアーに関する関心 |
| Nightlife | String | ナイトライフツアーに関する関心 |
| GuideLanguage | String | ツアーガイドの優先言語 |
| StartTime | String | ツアーの優先開始時刻 |
| GroupSize | String | ツアーの優先グループサイズ |
| PreferenceLevel | String | ツアーの優先設定の重要性 |
**Accessibility データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Wheelchair | String | 車いすに関するアクセシビリティ情報 |
| Bathroom | String | トイレに関するアクセシビリティ情報 |
| Assistance | String | 補助に関する情報 |
| DisabilityType | String | 障害に関する情報 |
| SupportAnimal | String | 介助動物に関する情報 |
| ProximityToFacilities | String | 施設への距離に関する必要姓 |
**Interest データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| NameOfInterest | String | 関心の名前 |
| PreferenceLevel | String | 関心の優先レベル |
**Loyalty データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| LoyaltyName | String | ロイヤルティプログラムの名前 |
| MembershipId | String | ロイヤルティメンバーシップ ID |
| PreferenceLevel | String | ロイヤルティの優先レベル |
| PriorityServices | String | プライオリティサービスの優先設定 |
**Dining データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| MealType | String | 優先する食事タイプ |
| FavoriteCuisine | String | お気に入りの料理の優先設定 |
| Beverage | String | 飲み物の優先設定 |
| DietaryRestriction | String | 食事制限 |
| AllergyInfo | String | アレルギー情報 |
| PreferenceLevel | String | ダイニングの優先レベル |
**MediaEntertainment データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Name | String | 優先するメディアまたはエンターテインメントの名前 |
| PreferenceLevel | String | メディアまたはエンターテインメントの優先レベル |
**PaymentForm データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Name | String | 支払い方法に関連付けられた名前 |
| タイプ | String | 支払い方法のタイプ |
| PreferenceLevel | String | 支払い方法の優先レベル |
| UsageContext | String | 支払いフォームが使用されるコンテキスト |
**PetInfo データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | ペットのタイプ |
| PreferenceLevel | String | ペットの優先レベル |
**Special Request データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | 特別なリクエストのタイプ |
| Name | String | 特別なリクエストの名前 |
| PreferenceLevel | String | リクエストの優先レベル |
**Marketing データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| ChannelType | String | マーケティングチャンネルのタイプ (SMS、E メールなど) |
| OptIn | String | マーケティングのオプトインステータス |
| Frequency | String | マーケティングコミュニケーションの頻度 |
| StartDate | String | 優先するマーケティングの開始日 |
| EndDate | String | 優先するマーケティングの終了日 |
**Medical データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Oxygen | String | 酸素供給の優先設定 |
| MedicalEquipment | String | 医療機器の詳細 |
| Assistance | String | 必要な医療支援の種類 |
| Stretcher | String | ゲストのストレッチャー要件 |
| WheelChair | String | 必要な車いすのタイプとサポート |
**Baggage データ型**
| 標準 hotelPreference フィールド | 型 | 説明 |
| --- | --- | --- |
| Bicycle | String | 自転車の運搬に関するニーズ |
| BaggageType | String | 荷物の詳細 (かさばるなど) |
| Courier | String | 配送業者関連の荷物の優先設定 |
| Fragile | String | 壊れやすいアイテムの優先設定 |
| 優先設定レベル | String | 荷物の優先レベル |
# 標準フライト予約のオブジェクトタイプマッピング
このセクションのトピックでは、標準フライト予約の定義について説明します。
**Topics**
+ [
# Customer Profiles の標準フライト予約オブジェクトのフィールド
](standard-air-booking-object-fields.md)
# Customer Profiles の標準フライト予約オブジェクトのフィールド
次の表に、Customer Profiles の標準フライト予約オブジェクトのすべてのフィールドを示します。
**AirBooking**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| BookingId | String | 標準フライト予約の一意の識別子 |
| ContextId | String | 予約ソースをトレースするためのコンテキスト固有の識別子 |
| PreferenceRef | String | 予約の Preference オブジェクトを参照する識別子 |
| BookingName | String | 予約に関連付けられた名前 |
| PassengerIndex | String | 予約内の乗客のインデックス |
| TravellerId | String | 予約に関連付けられた旅行者の一意の識別子 |
| GroupBooking | String | 予約がグループ用かどうかを示します |
| NumberOfPassengers | String | 予約内の乗客の合計数 |
| NumberOfAdults | String | 予約に含まれる成人の合計数 |
| NumberOfChildren | String | 予約に含まれる子供の合計数 |
| ProcessedDate | String | 予約が処理された日付 |
| CreatedDate | String | 予約が作成された日付 |
| CreatedBy | String | 作成者の ID |
| UpdatedDate | String | 最終更新日 |
| UpdatedBy | String | 予約を最後に更新したユーザーの識別子 |
| ステータス | String | 現在の予約ステータス |
| PriorityStatus | String | 予約の優先ティア |
| ReservationStatus | String | 予約ステータス |
| MarketingCode | String | マーケティングソースまたはキャンペーンを表すコード |
| MarketingName | String | マーケティングキャンペーンの名前 |
| TravelAgent | String | 予約に関連付けられた旅行代理店 |
| TravelAgency | String | 法人の旅行代理店の名前 |
| TravelCorpNumber | String | 法人顧客番号 |
| Booker | String | 予約を行った人物かどうかを示します |
| AdditionalInformation | String | 追加のフリーフォーム情報 |
| E メール | String | 移動日の更新に関する連絡先 E メール |
| PhoneNumber | String | 移動日の更新に関する連絡先電話番号 |
| CancelledDate | String | 予約のキャンセル日 (該当する場合) |
| Diplomat | String | 外交ステータスを示します |
| Child | String | 乗客が子供かどうかを示します |
| Disabled | String | 障害のステータスを示します |
| Oxygen | String | 酸素サポートの必要性を示します |
| PetOnly | String | 予約はペットの輸送専用です |
| CancellationCharge | String | 該当する場合はキャンセル料金。0 はキャンセルが無料であることを示します |
| Refundable | String | 予約の返金の詳細 |
| Inventory | Inventory | 予約のインベントリの詳細 |
| Loyalty | Loyalty | 予約のロイヤルティの詳細 |
| [チャネル] | [チャネル] | 予約チャンネルの詳細 |
| Payment | Payment | 予約の支払いの詳細 |
| BillingAddress | Address | 予約の請求先住所の詳細 |
| Price | Price | 予約料金の詳細 |
| PaymentStatus | PaymentStatus | 予約の支払いステータス |
| 属性 | Map | カスタム属性または拡張属性 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1airBookingId | BookingId |
| \$1airPreferenceRef | PreferenceRef |
**Loyalty データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| ProgramName | String | ロイヤルティプログラムの名前 |
| MembershipId | String | ロイヤルティプログラムのメンバーシップ番号 |
| Tier | String | ロイヤルティメンバーシップのティアレベル |
**Channel データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| CreationChannelId | String | 予約の作成に使用されるチャンネルの ID |
| LastUpdatedChannelId | String | 予約の更新に使用されるチャンネルの ID |
| Method | String | チャンネルを介して使用される方法 (ウェブ、アプリ、電話など) |
**Payment データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | 支払い方法のタイプ (カード、クーポンなど) |
| CreditCardToken | String | 安全な参照のためのトークン化されたカード |
| CreditCardType | String | 使用するクレジットカードのタイプ |
| CreditCardExpiration | String | カードの有効期限 |
| Cvv | String | CVV 番号 |
| NameOnCreditCard | String | カードの所有者名 |
| RoutingNumber | String | 銀行ルーティング番号 (該当する場合) |
| AccountNumber | String | 銀行口座番号 (該当する場合) |
| VoucherId | String | 支払いに使用されるバウチャー |
| DiscountCode | String | 適用されるプロモーション割引コード |
| DiscountPercent | String | 支払いに適用される割引率 |
**Billing Address データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Address1 | String | お客様住所の 1 行目。 |
| Address2 | String | お客様住所の 2 行目。 |
| Address3 | String | お客様住所の 3 行目。 |
| Address4 | String | お客様住所の 4 行目。 |
| City | String | 顧客の住所の市区町村。 |
| Country | String | 顧客の住所の国。 |
| County | String | 顧客の住所の郡。 |
| PostalCode | String | お客様住所の郵便番号 |
| Province | String | 顧客の住所の県。 |
| State | String | 顧客の住所の州 |
**Price データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| TotalPrice | String | 予約の合計価格 |
| BasePrice | String | 予約の基本価格 |
| TravellerPrice | String | 旅行者ごとの価格 |
| DiscountAmount | String | 基本価格に適用される割引 |
| Currency | String | 支払いが行われた通貨 |
**Payment Status データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| PaidAt | String | 支払いが完了したタイムスタンプ |
| AwaitingPayment | String | 支払いが保留中であることを示します |
| RequiredBy | String | 支払期日 |
**Inventory データ型**
| 標準 airBooking フィールド | 型 | 説明 |
| --- | --- | --- |
| Seats | String | 予約中の座席の合計数 |
# 標準フライトセグメントのオブジェクトタイプマッピング
このセクションのトピックでは、標準フライトセグメントの定義について説明します。
**Topics**
+ [
# Customer Profiles の標準フライトセグメントオブジェクトのフィールド
](standard-air-segment-object-fields.md)
# Customer Profiles の標準フライトセグメントオブジェクトのフィールド
次の表に、Customer Profiles での標準フライトセグメントオブジェクトに関するすべてのフィールドを示します。
**フライトセグメント**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| SegmentId | String | 標準フライトセグメントの一意の識別子 |
| BookingRef | String | 予約リファレンス識別子 |
| SegmentName | String | セグメントの名前/説明 |
| PassengerIndex | String | 乗客のインデックス番号 |
| SegmentIndex | String | セグメントのインデックス番号 |
| SeatSelection | String | 座席選択の詳細 |
| NumberOfPassengers | String | 乗客の総数 |
| NumberOfLegs | String | フライト区間の数 |
| Tier | String | 乗客ティア/ステータスレベル |
| オリジン | String | 出発空港コード |
| OriginCountryCode | String | 出発国コード |
| Dest | String | 到着空港コード |
| DestCountryCode | String | 到着国コード |
| ProcessedDate | String | セグメントが処理された日付。 |
| CreatedDate | String | レコードの作成日 |
| CreatedBy | String | レコードを作成したユーザー |
| UpdatedDate | String | レコードの最終更新日 |
| UpdatedBy | String | レコードを最後に更新したユーザー |
| ステータス | String | セグメントの現在のステータス |
| FlightNumber | String | 便名 |
| Carrier | String | 運用キャリアコード |
| CarrierType | String | キャリアタイプ |
| IsInternational | String | フライトが国際便かどうかを示します |
| IsEticket | String | E チケットかどうかを示します |
| IsArmed | String | 武装した乗客かどうかを示します |
| LapInfant | String | 2 歳未満のお子様の詳細 |
| Pet | String | ペット同伴かどうかを示します |
| PrisonerOrGuard | String | 囚人またはガードのステータスを示します |
| Child | String | 乗客が子供かどうかを示します |
| Married | String | セグメントが既婚かどうかを示します |
| CheckinEligible | String | チェックイン資格を示します |
| InEligibleReason | String | チェックイン資格を満たさない場合の理由 |
| UnEscortedMinor | String | 付き添いのない未成年者ステータスを示します |
| PremiumAccess | String | プレミアムアクセスの購入を示します |
| MissingData | String | 欠落しているデータを示します |
| CurrentClassOfService | String | 現在のサービスクラス |
| BookedClassOfService | String | 最初に予約されたサービスクラス |
| CodeShare | String | コードシェアフライトを示します |
| ReverseCodeShare | String | リバースコードシェアを示します |
| MarketCarrierCode | String | マーケティングキャリアコード |
| OpCarrierCode | String | 運用キャリアコード |
| InConnection | String | 到着接続便の詳細 |
| OutConnection | String | 出発接続便の詳細 |
| MilesToEarn | String | 獲得するマイル |
| Duration | String | 飛行時間 |
| DurationTimeUnit | String | 飛行時間の単位 |
| Distance | String | 飛行距離 |
| DistanceUnit | String | 距離計測の単位 |
| SellType | String | これが搭乗拒否かどうかを示します |
| GoShow | String | これがゴーショウかどうかを示します |
| Incapacitated | String | 乗客に障害があるかどうかを示します |
| Upgraded | String | フライトがアップグレードされたかどうかを示します |
| Downgraded | String | フライトがダウングレードされたかどうかを示します |
| BaggageInsurance | String | 荷物保険 |
| MaxAllowedBaggage | String | 預けられる荷物の最大数 |
| BaggageQuantity | String | 荷物の数 |
| BaggageFee | String | 荷物の料金の合計 |
| Arrival | ポート | セグメントの到着の詳細 |
| Departure | ポート | セグメントの出発の詳細 |
| Seat | Seat | 座席の詳細 |
| Priority | Priority | 優先度の詳細 |
| DOC | DOC | 旅行の付随ドキュメント情報 |
| Baggage | 荷物リスト | 荷物の詳細 |
| Pets | ペットリスト | ペットの詳細 |
| OtherServices | OtherService のリスト | その他のサービスの詳細 |
| 属性 | Map | その他の属性 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1airSegmentId | SegmentId |
| \$1airBookingRef | BookingRef |
**Baggage データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| ID | String | 荷物の識別子 |
| TagNumber | String | 荷物タグ番号 |
| DepartureDate | String | 出発日 |
| BaggageType | String | 荷物の種類 |
| Weight | String | 荷物の重量 |
| Length | String | 荷物の長さ |
| Width | String | 荷物の幅 |
| Height | String | 荷物の高さ |
| PriorityBagDrop | String | 優先荷物預けサービス |
| PriorityBagReturn | String | 優先荷物受け取りサービス |
| HandsFreeBaggage | String | ハンズフリー荷物サービス |
| Fee | String | 荷物の料金 |
| IsGateBag | String | ゲートチェックの荷物を示します。 |
| IsHeavy | String | 重い荷物を示します |
**Seat データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| SeatNumber | String | 座席番号 |
| SeatZone | String | 座席のゾーン |
| SeatType | String | 座席のタイプ |
| Price | String | 座席料金 |
| NeighborFree | String | 隣接する座席が空いているかどうかを示します |
| UpgradeAuction | String | 入札アップグレードの可用性を示します |
| Available | String | 座席の可用性を示します |
| ExtraSeat | String | 追加の座席を示します |
| AdditionalInformation | String | 追加の座席の情報 |
**Port データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| Location | String | 場所の名前 |
| Code | String | 空港コード |
| Terminal | String | 空港ターミナル |
| Country | String | 空港の国 |
| Date | String | 日付 |
| Time | String | Time |
| EstimatedTime | String | 推定時間 |
| ScheduledTime | String | スケジュール時間 |
**Priority データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| TransactionId | String | トランザクション識別子 |
| PriorityServiceType | String | 優先サービスのタイプ |
| LoungeAccess | String | ラウンジアクセスを示します |
| Price | String | 優先サービス料金 |
| AdditionalInformation | String | 追加の優先度情報 |
**Pet データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| Species | String | ペットの種類 |
| Breed | String | ペットの品種 |
| Weight | String | ペットの重量 |
| WeightUnit | String | 重量の測定単位 |
| TransportType | String | ペットの輸送タイプ |
**OtherService データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| ServiceType | String | サービスのタイプ |
| 説明 | 文字列 | サービスの説明 |
| Price | String | サービス価格 |
**Doc データ型**
| 標準 airSegment フィールド | 型 | 説明 |
| --- | --- | --- |
| DocType | String | ドキュメントのタイプ |
| DocTypeNeeded | String | ドキュメントが必要かどうかを示します |
| Nationality | String | ドキュメントでの国籍 |
| DateOfBirth | String | 生年月日 |
| AppId | String | アプリケーション識別子 |
| AgentId | String | エージェント識別子 |
| VerifiedDateTime | String | ドキュメントの確認日時 |
# 標準ホテル予約のオブジェクトタイプマッピング
このセクションのトピックでは、標準ホテル予約の定義について説明します。
**Topics**
+ [
# Customer Profiles の標準ホテル予約オブジェクトのフィールド
](standard-hotel-reservation-object-fields.md)
# Customer Profiles の標準ホテル予約オブジェクトのフィールド
次の表に、Customer Profiles の標準ホテル予約オブジェクトのすべてのフィールドを示します。
**ホテルの予約**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| ReservationId | String | 標準ホテル予約の一意の識別子 |
| ConfirmationNumber | String | ホテルまたは予約エンジンによって提供される確認番号 |
| PreferenceRef | String | 予約の Preference オブジェクトを参照する識別子 |
| ステータス | String | 予約の現在のステータス (確認済み、キャンセル済みなど) |
| TripType | String | 旅行の目的または性質 (休暇、ビジネスなど) |
| BrandCode | String | ホテルブランドを表すコード |
| HotelCode | String | 特定のホテルを識別するコード |
| PhoneNumber | String | 予約の連絡先電話番号 |
| EmailAddress | String | 予約の連絡先 E メールアドレス |
| GroupId | String | 予約をグループ予約にリンクする ID |
| ContextId | String | 予約ソースをトレースするためのコンテキスト固有の識別子 |
| ProcessedDate | String | 予約が処理されたときのタイムスタンプ |
| CreatedDate | String | 予約が作成されたときのタイムスタンプ |
| CreatedBy | String | 予約を作成したユーザー/システムの識別子 |
| UpdatedDate | String | 予約が最後に更新されたタイムスタンプ |
| UpdatedBy | String | 予約を更新したユーザー/システムの識別子 |
| AgentId | String | 予約を処理するエージェントの ID |
| Reserver | String | プロファイルが予約者であるかどうかを示します。 |
| SameDayRate | String | 予約が同じ日に行われたかどうかを示します |
| Refundable | String | 予約が返金可能かどうかを示します |
| CancellationCharge | String | 該当する場合はキャンセル料金。0 はキャンセルが無料であることを示します |
| TransactionId | String | トランザクションの一意の識別子 |
| AmountPerNight | String | 部屋の 1 泊あたりの請求額 |
| AdditionalNote | String | 特別な注意事項または指示 |
| NumberOfNights | String | 予約の宿泊日数 |
| NumberOfGuests | String | 予約の合計ゲスト数 |
| TotalAmountBeforeTax | String | 税引き前の合計コスト |
| TotalAmountAfterTax | String | 税引き後の合計コスト |
| Checkout | CheckOut | チェックアウトの詳細 |
| Loyalty | Loyalty | ロイヤルティの詳細 |
| Room | Room | ルームの詳細 |
| CheckIn | CheckIn | チェックインの詳細 |
| Payment | Payment | 支払いの詳細 |
| Currency | Currency | 通貨の詳細 |
| Cancellation | Cancellation | キャンセルの詳細 |
| [チャネル] | [チャネル] | チャンネルの詳細 |
| RatePlan | RatePlan | レートプランの詳細 |
| Guests | Guests | ゲストの詳細 |
| Services | Service List | サービスのリスト |
| 属性 | Map | その他の属性 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1hotelReservationId | ReservationId |
| \$1hotelPreferenceRef | preferenceRef |
**Checkout データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Early | String | アーリーチェックアウトがスケジュールまたはリクエストされている |
| Late | String | レイトチェックアウトがスケジュールまたはリクエストされている |
| 自分 | String | セルフチェックアウトがスケジュールまたはリクエストされている |
| Date | String | 予約のチェックアウト日 |
**Loyalty データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| ProgramName | String | ロイヤルティプログラムの名前 |
| MembershipId | String | ロイヤルティプログラムのメンバーシップ ID |
| Tier | String | ロイヤルティティアまたはレベル |
**Room データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| TypeCode | String | ルームタイプ/カテゴリのコード |
| TypeName | String | ルームタイプの名前 |
| TypeDesc | String | ルームタイプの説明 |
| Number | String | 割り当てられた部屋番号 |
| Capacity | String | ルームの最大キャパシティ |
| AccessibilityType | String | アクセシビリティ機能 |
| SmokingAllowed | String | 部屋で喫煙が許可されているかどうかを示します |
**CheckIn データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Date | String | 予約のチェックイン日 |
| DigitalKey | String | デジタルルームキーが発行されたかどうかを示します |
| Early | String | アーリーチェックインがリクエストされたかどうかを示します |
| Late | String | レイトチェックインがリクエストされたかどうかを示します |
| RoomKeys | String | 発行されたルームキーの数 |
| UserSelectedRoom | String | ゲストが自分の部屋を選択した場合は true |
**Payment データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | 支払い方法のタイプ (クレジットカード、デビットカード、クーポンなど) |
| CreditCardToken | String | トークン化されたクレジットカード番号 |
| CreditCardType | String | クレジットカードのタイプ (Visa、Amex など) |
| CreditCardExpiration | String | クレジットカードの有効期限 |
| Cvv | String | カード検証値 |
| NameOnCreditCard | String | クレジットカードに印刷された名前 |
| RoutingNumber | String | 銀行ルーティング番号 |
| AccountNumber | String | 銀行口座番号 |
| VoucherId | String | 使用された場合のバウチャー ID |
| DiscountCode | String | 適用された割引コード |
| DiscountPercent | String | 割引適用率 |
**Currency データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Code | String | 通貨の ISO コード (USD など) |
| Name | String | 通貨のフルネーム (米ドルなど) |
| 記号 | String | 通貨の記号 (\$1 など) |
**Cancellation データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Reason | String | キャンセルの理由 |
| Comment | String | 追加のキャンセルコメント |
**Channel データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| CreationChannelId | String | 予約が行われたチャンネルの ID |
| LastUpdatedChannelId | String | 予約を最後に更新したチャンネルの ID |
| Method | String | 予約に使用する方法 (ウェブ、モバイルアプリなど) |
**RatePlan データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Code | String | 予約されたレートプランのコード識別子 |
| Name | String | 予約したレートプランの名前 |
| 説明 | 文字列 | レートプランの説明 |
**Service データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| ServiceType | String | サービスのタイプ (スパ、朝食など) |
| 説明 | 文字列 | サービスの説明 |
| Cost | String | サービスのコスト |
**Guest データ型**
| 標準 hotelReservation フィールド | 型 | 説明 |
| --- | --- | --- |
| Adults | String | 成人のゲストの数 |
| Children | String | 子供のゲストの数 |
# 標準ロイヤルティのオブジェクトタイプマッピング
このセクションのトピックでは、標準ロイヤルティの定義について説明します。
**Topics**
+ [
# Customer Profiles の標準ロイヤルティオブジェクトのフィールド
](standard-loyalty-object-fields.md)
# Customer Profiles の標準ロイヤルティオブジェクトのフィールド
次の表に、Customer Profiles の標準ロイヤルティオブジェクトのすべてのフィールドを示します。
**Loyalty**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| LoyaltyId | String | 標準ロイヤルティの一意の識別子 |
| ProgramId | String | ロイヤルティプログラムの識別子 |
| MembershipId | String | プログラム内の代替識別子 |
| ProgramName | String | ロイヤルティプログラムの名前 |
| Group | String | ロイヤルティプログラムのグループまたはカテゴリ |
| [チャネル] | String | ロイヤルティプログラムにアクセスするチャンネル |
| CreatedDate | String | ロイヤルティアカウントの作成日 |
| EnrollmentDate | String | 顧客のプログラムへの登録日 |
| CreatedBy | String | ロイヤルティアカウントの作成ユーザーまたはシステム |
| UpdatedDate | String | ロイヤルティアカウントの最終更新日 |
| LastUpdatedBy | String | ロイヤルティアカウントの最終更新ユーザーまたはシステム |
| UpgradeDate | String | ティアの最終アップグレード日 |
| RenewalDate | String | ロイヤルティメンバーシップの更新日 |
| AdditionalInformation | String | 追加情報 |
| EmailAddress | String | 顧客の E メールアドレス |
| EmailAddressVerified | String | E メールが検証済みかどうかを示すフラグ |
| PhoneNumber | String | 顧客の電話番号 |
| PhoneNumberVerified | String | 電話番号が検証済みかどうかを示すフラグ |
| ステータス | String | ロイヤルティアカウントの現在のステータス |
| Tier | Tier | ティアの詳細 |
| Points | Points | ポイントの詳細 |
| PointExpirations | PointExpiration リスト | ポイントの有効期限の詳細 |
| Payment | Payment | 支払いの詳細 |
| PaymentInformation | PaymentInformation | 支払い情報の詳細 |
| BillingAddress | Loyalty Address | アドレスの詳細 |
| 属性 | Map | 他でカバーされていない追加の属性 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1loyaltyId | LoyaltyId |
| \$1loyaltyMembershipId | membershipId |
**Loyalty Address データ型**
| 標準 airPreference フィールド | データ型 | 説明 |
| --- | --- | --- |
| Address1 | String | お客様住所の 1 行目。 |
| Address2 | String | お客様住所の 2 行目。 |
| Address3 | String | お客様住所の 3 行目。 |
| Address4 | String | お客様住所の 4 行目。 |
| City | String | お客様が住んでいる市。 |
| Country | String | お客様が住んでいる国。 |
| County | String | お客様が住んでいる郡。 |
| PostalCode | String | お客様住所の郵便番号 |
| Province | String | お客様が住んでいる州/省/都道府県。 |
| State | String | お客様が住んでいる州。 |
**Tier データ型**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| CurrentTier | String | 顧客の現在のロイヤルティ階層 |
| NextTier | String | 顧客が次に到達可能なティア |
| PointsToNextTier | String | 次のティアに到達するために必要なポイント |
**Points データ型**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| Points.Unit | String | ポイントの測定単位 |
| Points.Lifetime | String | 獲得された合計ライフタイムポイント |
| Points.Balance | String | 現在のポイント残高 |
| Points.Redeemed | String | 交換された合計ポイント |
**PointExpiration データ型**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| Points | String | 有効期限が切れるポイント |
| Date | String | ポイントの有効期限 |
**Payment データ型**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | 支払いのタイプ |
| CreditCardToken | String | トークン化されたクレジットカードのリファレンス |
| CreditCardType | String | クレジットカードのタイプ (Visa など) |
| CreditCardExpiration | String | クレジットカードの有効期限 |
| Cvv | String | カード検証値 |
| NameOnCreditCard | String | クレジットカードの名前 |
| RoutingNumber | String | 銀行ルーティング番号 |
| AccountNumber | String | 銀行口座番号 |
| VoucherId | String | バウチャーの識別子 |
**PaymentInformation データ型**
| 標準ロイヤルティフィールド | 型 | 説明 |
| --- | --- | --- |
| スケジュール | String | 支払いスケジュール |
| LastPaymentDate | String | 最終支払い日 |
| NextPaymentDate | String | 次の支払い日 |
| NextBillAmount | String | 次の請求額 |
| CurrencyCode | String | 通貨コード (USD など) |
| CurrencyName | String | 通貨のフルネーム |
| CurrencySymbol | String | 通貨記号 (\$1 など) |
# 標準ロイヤルティトランザクションのオブジェクトタイプマッピング
このセクションのトピックでは、標準ロイヤルティトランザクションの定義について説明します。
**Topics**
+ [
# Customer Profiles の標準ロイヤルティトランザクションオブジェクトのフィールド
](standard-loyalty-transaction-object-fields.md)
# Customer Profiles の標準ロイヤルティトランザクションオブジェクトのフィールド
次の表に、Customer Profiles の標準ロイヤルティトランザクションオブジェクトのすべてのフィールドを示します。
**ロイヤルティトランザクション**
| 標準 loyaltyTransaction フィールド | 型 | 説明 |
| --- | --- | --- |
| TransactionId | String | 標準ロイヤルティトランザクションの一意の識別子 |
| TransactionName | String | トランザクションの名前またはラベル。 |
| TransactionType | String | トランザクションのタイプ (獲得、引き換え、調整など)。 |
| ProgramRef | String | 関連するロイヤルティプログラムへの参照。 |
| MembershipRef | String | トランザクションで使用されたロイヤルティメンバーシップへの参照。 |
| PromotionRef | String | このトランザクションに影響を与えたプロモーションへの参照。 |
| CreatedDate | String | トランザクションの作成日。 |
| TransactionDate | String | トランザクションの発生日。 |
| 業界 | String | トランザクションに関連付けられた業界 (航空会社、ホテルなど)。 |
| Location | String | トランザクションが発生した場所。 |
| CreatedBy | String | トランザクションを作成したユーザーの識別子。 |
| UpdatedDate | String | トランザクションの最終更新日。 |
| UpdatedBy | String | トランザクションを最後に更新したユーザーの識別子。 |
| ステータス | String | トランザクションの現在のステータス。 |
| AccrualType | String | 発生方法 (手動、自動など）。 |
| Category | String | トランザクションのカテゴリ (フライト、ホテルの滞在など)。 |
| [チャネル] | String | トランザクションが開始されたチャンネル (オンライン、店舗内など)。 |
| ProductId | String | トランザクションに関連付けられた製品またはサービスの識別子。 |
| Amount | String | トランザクションで消費または取引された金額。 |
| OriginValue | String | 変換またはオフセットの前の元の値。 |
| OriginValueCurrency | String | 元のトランザクション値の通貨。 |
| OriginValueOffset | String | プロモーション、返金などの元の値の調整。 |
| PointsEarned | String | このトランザクションで獲得された合計ポイント。 |
| PointOffset | String | 調整されたポイント (ボーナス、ペナルティなど)。 |
| QualifyingPointsEarned | String | ティア認定にカウントされるポイント。 |
| TierBefore | String | トランザクション前の顧客のティア。 |
| TierAfter | String | トランザクション後の顧客のティア。 |
| Brand | String | トランザクションに関連付けられたブランド。 |
| 説明 | 文字列 | トランザクションの説明。 |
| AdditionalInformation | String | トランザクションに関連する自由形式の追加情報。 |
| PaymentMethod | String | 使用された支払い方法 (カード、バウチャーなど)。 |
| PointTransfer | PointTransfer | ポイント転送の詳細 |
| 属性 | Map | その他の属性 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1loyaltyTransactionId | TransactionId |
**PointTransfer データ型**
| 標準 loyaltyTransaction フィールド | 型 | 説明 |
| --- | --- | --- |
| TransferId | String | 転送トランザクションの識別子。 |
| SourceProgramId | String | ソースロイヤルティプログラムの ID。 |
| DestinationProgrmId | String | 送信先ロイヤルティプログラムの ID。 |
| SourceMembershipId | String | ソースプログラムのメンバーシップ ID。 |
| DestinationMembershipId | String | 送信先プログラムのメンバーシップ ID。 |
| PointsTransferred | String | ソースプログラムから差し引かれたポイント。 |
| PointsReceived | String | 送信先プログラムにクレジットされるポイント。 |
# 標準ロイヤルティプロモーションのオブジェクトタイプマッピング
このセクションのトピックでは、標準ロイヤルティプロモーションの定義について説明します。
使用する
**Topics**
+ [
# Customer Profiles の標準ロイヤルティプロモーションオブジェクトのフィールド
](standard-loyalty-promotion-object-fields.md)
# Customer Profiles の標準ロイヤルティプロモーションオブジェクトのフィールド
次の表に、Customer Profiles の標準ロイヤルティプロモーションオブジェクトのすべてのフィールドを示します。
**ロイヤルティプロモーション**
| 標準 loyaltyPromotion フィールド | 型 | 説明 |
| --- | --- | --- |
| PromotionId | String | 標準ロイヤルティプロモーションの一意の識別子 |
| PromotionName | String | プロモーションの名前を示します。 |
| PromotionType | String | プロモーションのタイプまたはカテゴリ (ボーナス、ティアブースト、クーポンなど)。 |
| ProgramType | String | プロモーションが関連付けられているロイヤルティプログラムのタイプを示します。 |
| ProgramRef | String | 関連するロイヤルティプログラムのリファレンス ID。 |
| PartnerId | String | プロモーションに関係するパートナー組織のリファレンス ID。 |
| PartnerNumber | String | パートナーに関連する識別子または番号。 |
| Tier | String | プロモーションの対象または影響を受けるティアレベル。 |
| StartDate | String | プロモーションがアクティブになった日付。 |
| EnrolledDate | String | ユーザーがプロモーションに登録された日付。 |
| EndDate | String | プロモーションの終了日。 |
| Amount | String | プロモーションに関連する金額またはポイント値。 |
| Period | String | プロモーションの期間 (毎週、毎月、キャンペーンベースなど)。 |
| ステータス | String | プロモーションの現在のステータス (アクティブ、期限切れ、完了など)。 |
| CreatedDate | String | プロモーションレコードの作成日。 |
| CreatedBy | String | プロモーションレコードを作成したユーザーまたはシステム。 |
| UpdatedDate | String | プロモーションレコードの最終更新日。 |
| UpdatedBy | String | プロモーションを最後に更新したユーザーまたはシステム。 |
| CampaignRef | String | このプロモーションが属するより広範なキャンペーンへの外部参照。 |
| AdditionalInformation | String | プロモーションに関するその他のメモまたはマーケティングコピー。 |
| TriggerLimit | TriggerLimit | トリガー制限の詳細 |
| Usage | Usage | 使用状況の詳細 |
| Rules | Rules | プロモーションルールの詳細 |
| Incentive | Incentive | プロモーションインセンティブの詳細 |
| 属性 | Map | 追加のメタデータまたはプログラム固有の値。 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1loyaltyPromotionId | PromotionId |
**Rules データ型**
| 標準 loyaltyPromotion フィールド | 型 | 説明 |
| --- | --- | --- |
| Name | String | プロモーションルール内のルール名。 |
| 説明 | 文字列 | プロモーションルール内のルールの説明。 |
**Incentive データ型**
| 標準 loyaltyPromotion フィールド | 型 | 説明 |
| --- | --- | --- |
| タイプ | String | インセンティブのタイプ (bonusPoints、クーポン、tierUpgrade など)。 |
| 値 | 文字列 | ポイント量やクーポン値など、インセンティブの値。 |
| Unit | String | インセンティブ値の単位 (ポイント、%、USD など)。 |
**TriggerLimit データ型**
| 標準 loyaltyPromotion フィールド | 型 | 説明 |
| --- | --- | --- |
| Times | String | プロモーションをトリガーできる回数。 |
| Interval | String | トリガー制限の間隔。 |
**Usage データ型**
| 標準 loyaltyPromotion フィールド | 型 | 説明 |
| --- | --- | --- |
| UsageProgressPercent | String | プロモーション使用状況の進行状況の割合。 |
| UsageCompleted | String | 完了した使用状況の数。 |
| UsageTarget | String | 使用状況のターゲット。 |
# ウェブ分析オブジェクトのオブジェクトタイプマッピング
**WebAnalytics 標準オブジェクトスキーマ**
| フィールド | タイプ | 説明 |
| --- | --- | --- |
| イベントの属性 |
| EventId | String | ウェブ分析イベントの一意の識別子。 |
| EventType | String | ページビュー、フォーム送信、ボタンクリック、 などのウェブ分析イベントのタイプメインラインをプルアップする\$1u0000earch bar インタラクション、アプリエラープロンプト、カートインタラクション、購入、スクロールなど。 |
| EventTimestamp | Number | イベントのエポックミリ秒タイムスタンプ。 |
| EventDuration | Number | EventDuration は、ユーザーが特定のインタラクションに費やした時間を秒単位で表します。一般的なユースケースには、製品の表示にかかった時間、特定のページの閲覧セッションの長さ、機能にかかった時間などがあります。 |
| EventValue | Number | EventValue は、インタラクションイベントの値または重要度を表す数値属性です。一般的なユースケースには、トランザクションイベントの購入額、製品評価の評価値、ビデオビューの完了率などがあります。 |
| セッション属性 |
| Session.Id | String | セッションの一意の識別子。 |
| Session.StartTimestamp | Number | セッションの開始タイムスタンプを示すエポックミリ秒。 |
| ページ/画面の属性 |
| Page.Title | String | モバイルアプリのウェブアプリ/スクリーン名のタイトル。 |
| Page.Location | String | ウェブページの URL。モバイルの場合、ディープリンクまたは画面へのルートである可能性があります。 |
| Page.Referrer | String | 前の画面/ページ。 |
| Page.Category | String | 画面/ページの論理グループ。ネストされた URLs/アプリケーションの場所をグループ化する場合に便利です。 |
| HTML/DOM 要素 |
| Element.Id | String | HTML 要素 ID |
| Element.Type | String | 要素タイプ - ボタン、アンカーリンクなど |
| Element.Classes | String | 要素の CSS スタイルクラス |
| Element.Text | String | 要素テキスト (ボタン、入力フィールドのプレースホルダーなどに便利です）。 |
| Element.AltText | String | HTML 要素の AltText (一般的にイメージに使用されます）。 |
| Element.Source | String | 動画、画像などのソース。 |
| フォーム |
| Form.Id | String | 入力フォームの一意の識別子 |
| Form.Name | String | フォームの名前 |
| フォームの長さ | String | フォームの入力フィールドの数。 |
| Form.ValidationErrors | Number | フォーム内の検証エラーの数。 |
| Form.FieldsCompleted | Number | 完了したフィールドの数。 |
| Form.FieldsRequired | Number | 必須フィールドの数。 |
| 検索 |
| Search.Query | String | 入力で使用されるクエリ文字列 |
| Search.TotalMatchingResults | Number | 検索結果の合計数。 |
| Search.ResultsPerPage | Number | ページごとに表示される結果の数。 |
| Search.CurrentResultsPage | Number | ユーザーが表示している現在の結果ページ。 |
| Search.FilterExpression | String | 使用される追加のフィルター式。 |
| Search.SortCriteria | String | 検索結果をソートするための条件。例 - 関連性、価格など。 |
| Search.SortOrder | String | 検索結果のソート順 - 昇順/降順。 |
| 項目/項目リスト |
| Item | Item | イベント内のフォーカスされた項目。カートに追加された項目、表示された項目などを示します。 |
| ItemsList | リスト- | イベント内のアイテムのフォーカスリスト。購入したアイテム、カート内のアイテム、アイテムの検索結果などを示します。 |
| アイテムインプレッション |
| AdditionalItemImpressions | リスト
- | 追加のアイテムインプレッションリスト |
| カート |
| Cart.Id | String | カートの一意の識別子。 |
| Cart.ItemsCount | Number | カート内の項目の数。 |
| Cart.Currency | String | カート値の通貨。 |
| Cart.Value | Number | カート内の項目の金額。 |
| 注文情報 |
| OrderId | String | 注文の一意の識別子。ここでは注文識別子のみを保存し、注文に関連するその他の情報は標準注文オブジェクトに保存されます。 |
| デバイス |
| DeviceId | String | ユーザーのデバイスの一意の識別子。 |
| 属性をスクロールする |
| Scroll.DepthPercentage | String | 垂直スクロール深度の割合。これにより、ユーザーがウェブページをスクロールする距離を把握できます。 |
| Scroll.PositionX | Number | 左からのピクセル単位の水平スクロール位置。 |
| Scroll.PositionY | Number | 上部からのピクセル単位の垂直スクロール位置。 |
| エラー |
| Error.Description | String | エラーの簡単な説明。 |
| Error.Type | String | ユーザー入力エラー/サーバーエラー。 |
| ユーザー |
| User.Id | String | ユーザーの一意の識別子 |
| User.AnonymousId | String | 匿名 UserId。これは、ユーザーがログインしていないときに割り当てられた uniqueId になります。 |
| User.IsReturning | String | ユーザーが再アクセスするかどうかを示すブール値。 |
| User.IsLoggedIn | String | ユーザーがログインしているかどうかを示すブール値。 |
| アクティビティの場所 |
| Location.Country | String | ユーザーアクティビティの国。 |
| Location.State | String | ユーザーアクティビティの状態。 |
| Location.Province | String | ユーザーアクティビティの都道府県。 |
| Location.County | String | ユーザーアクティビティの郡。 |
| Location.City | String | ユーザーアクティビティの都市。 |
| Location.Latitude | String | ユーザーアクティビティの場所の座標 |
| Location.Longitude | String | ユーザーアクティビティの場所の座標 |
| アプリケーション属性 |
| Application.Name | String | アプリケーションの名前。 |
| Application.Version | String | デバイスが Mobile の場合は、ここでアプリケーションバージョンをキャプチャできます。ユーザーは、母集団 A/B テストまたは実験属性にこれを使用することを検討することもできます。 |
| Application.Environment | String | のようなアプリケーション環境 - Beta、Gamma、Prod。 |
| カスタム属性 |
| 属性 | Map | イベントに追加するカスタム属性またはメタデータ。 |
**WebAnalytics 項目オブジェクトスキーマ**
| フィールド | タイプ | 説明 |
| --- | --- | --- |
| ID | String | 項目の一意の識別子。 |
| タイトル | String | 項目のタイトル。 |
| Category | String | 項目のカテゴリ。 |
| 値 | 文字列 | 項目の金額。 |
| 通貨 | String | 項目の通貨。 |
| 数量 | Number | 項目の数量。 |
| ImpressionType | String | イベントのインプレッションタイプを識別する文字列。例 - 注目、スポンサー付き、おすすめなど。 |
| ImpressionId | String | インプレッションを一意に識別するための文字列識別子。 |
**デバイス標準オブジェクトスキーマ**
| フィールド | タイプ | 説明 |
| --- | --- | --- |
| DeviceId | String | デバイスの一意の識別子。 |
| タイプ | String | デバイスのタイプ (デスクトップ、モバイルなど) |
| モデル | String | などのデバイスモデル - Macbook Pro/Air、IPhone 16 など |
| Manufacturer | String | デバイスの製造元。 |
| OperatingSystem | String | Windows、MacOs、IOS、Android を示します。 |
| OperatingSystemVersion | String | OS バージョン |
| ScreenWidth | Number | Screen ViewPort の幅 |
| ScreenHeight | Number | Screen ViewPort の高さ |
| ブラウザ | String | ユーザーが操作しているブラウザの名前。 |
| BrowserVersion | String | ブラウザのバージョン |
| [Locale] (国) | String | デバイスまたはアプリケーションのロケール。 |
| 属性 | Map | デバイスのカスタム属性。 |
# Item Catalog のオブジェクトタイプマッピング
| フィールド | タイプ | 説明 |
| --- | --- | --- |
| ID | String | カタログ内の項目の一意の識別子。 |
| Name | String | 項目の名前 |
| Code | String | カタログ項目のコード |
| タイプ | String | カタログ項目のタイプ |
| Category | String | カタログ内の項目のカテゴリ |
| 説明 | 文字列 | 項目の説明 |
| AdditionalInformation | String | 項目に関連する追加情報。 |
| ImageLink | String | 項目のイメージへのリンク |
| Link | String | 項目 URL |
| Price | String | 項目の料金 |
| CreatedAt | Long | 項目が作成されたエポックタイムスタンプ |
| UpdatedAt | Long | 項目が更新されたエポックタイムスタンプ |
| 属性 | Map | 追加の項目属性 |
**注記**
ドメインオブジェクトタイプは APIs。すべてのレコメンダーが最初に削除されたら、アイテムカタログ統合を削除できます。これにより、データの依存関係の問題を防ぐことができます。
**削除するステップ:**
1. ドメイン内のすべての既存のレコメンダーを削除する
2. 項目カタログ統合に移動します。
3. 削除オプションを選択します。
# 標準ホテル滞在収益のオブジェクトタイプマッピング
このセクションのトピックでは、標準ホテル滞在収益の定義について説明します。
**Topics**
+ [
# Customer Profiles の標準ホテル滞在収益オブジェクトのフィールド
](standard-hotel-stay-revenue-object-fields.md)
# Customer Profiles の標準ホテル滞在収益オブジェクトのフィールド
次の表に、Customer Profiles の標準ホテル滞在収益オブジェクトのすべてのフィールドを示します。
**ホテル滞在収益**
| 標準 hotelStayRevenue フィールド | 型 | 説明 |
| --- | --- | --- |
| StayRevenueId | String | 標準ホテル滞在収益の一意の識別子。 |
| CurrencyCode | String | 通貨の ISO コード (USD など) |
| CurrencyName | String | 通貨のフルネーム (米ドルなど) |
| CurrencySymbol | String | 通貨の記号 (\$1 など) |
| ReservationId | String | ホテル予約の一意の識別子 |
| GuestId | String | ゲストの一意の識別子。 |
| LastUpdatedOn | String | 滞在レコードの最終更新のタイムスタンプ |
| CreatedOn | String | 滞在レコードが作成された時刻のタイムスタンプ |
| LastUpdatedBy | String | 滞在レコードを最後に更新したユーザー/システムの識別子 |
| CreatedBy | String | 滞在レコードを作成したユーザー/システムの識別子 |
| StartDate | String | ホテル滞在の開始日 |
| HotelCode | String | 特定のホテルを識別するコード |
| タイプ | String | 収益のタイプ (ルームレート、雑費、税など) |
| 説明 | 文字列 | 収益項目の説明 |
| Amount | String | 収益項目の金額 |
| ProcessedDate | String | 収益が処理された日付 |
| ステータス | String | 収益項目のステータス |
| 属性 | Map | 追加のメタデータまたはプログラム固有の値。 |
**標準インデックスフィールド**
| 標準インデックス名 | 標準優先設定レコードフィールド |
| --- | --- |
| \$1hotelStayRevenueId | StayRevenueId |
# Customer Profiles のオブジェクトタイプの追加プロパティ
プロパティタイプは、オブジェクトタイプのデータを暗号化するために使用するキーを定義します。
このオブジェクトの取り込みによって新しいプロファイルを作成できるかどうかを定義するオプションがあります。通常、既存のプロファイルに一致しないオブジェクトが取り込まれると、このオプションが true である限り、新しいプロファイルが作成されます。これが true でない場合は、取り込まれたオブジェクトが作成され、ドメインのデッドレターキューに書き込まれます。
また、このオブジェクトタイプのデータを Customer Profiles に保持する期間も含まれています。
**注記**
個々のオブジェクトの保存期間は、データの取り込み時に設定されます。特定のオブジェクトタイプの保存期間を変更すると、新たに取り込まれるデータにのみ適用されます。すでに取り込まれた既存のデータには適用されません。
**注記**
このオブジェクトが既存のプロファイルと一致する場合、API 呼び出しまたはエージェントワークスペースによって手動で入力されたフィールドは上書きされません。これは、自動取り込みによって手動の取り込みが上書きされるのを防ぐためです。
例えば、エージェントワークスペースのエージェントが FirstName「John」を使用してプロファイルを手動で作成したとします。標準プロファイルの FirstName フィールドにデータをマッピングするオブジェクトが取り込まれます。このオブジェクトがプロファイルに関連付けられている場合、FirstName「John」は上書きされません。
# 推定プロファイル
フィールドを持たないオブジェクトを取り込んでプロファイルが作成された場合、この新しいプロファイルの標準プロファイルオブジェクトは空になります。この空の標準プロファイルオブジェクトを、**推定プロファイル**と呼びます。
推定プロファイルを作成する場合、プロファイルオブジェクトから次の 2 つのフィールドが標準オブジェクトに入力されます (使用可能な場合)。
+ `EMAIL_ADDRESS` のコンテンツタイプで定義されているフィールドが取り込んだオブジェクト内にある場合、標準プロファイルの `EmailAddress` フィールドにこの値が入力されます。
+ `PHONE_NUMBER` のコンテンツタイプのフィールドが取り込んだオブジェクト内にある場合、標準プロファイルの `PhoneNumber` フィールドにこの値が入力されます。
これらのフィールドの値は、フィールド定義で定義されたターゲットを持っていない場合でも、標準プロファイルに入力されます。
コンタクトレコードテンプレートの種類と、ドメインで使用されるテンプレートの調整方法については、「[問い合わせレコードテンプレートの使用例](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples)」を参照してください。
# Amazon Connect Customer Profiles のコンタクトレコードテンプレート
問い合わせレコードは、電話やチャットなどのさまざまな問い合わせイベントから重要なメタデータを取得するプロファイルオブジェクトとして機能します。顧客とのやりとりを文書化して分析する上で重要な役割を果たします。
コンタクトイベントが発生すると、ドメインに適用できる 3 つの異なるデフォルトテンプレートが提供されます。これらのテンプレートは、システム内での問い合わせイベントの処理方法を規定する設定オプションとして機能します。各テンプレートには特定のルールとアクションが定義されているため、ビジネスニーズに合わせて問い合わせイベントの処理を調整できます。
**Topics**
+ [
## 推定プロファイルの作成とプロファイルの自動関連付け (CTR-NoInferred)
](#ctr-contact-record-template-no-inferred)
+ [
## プロファイルの自動関連付けのみ (CTR-AutoAssociateOnly)
](#ctr-contact-record-template-auto-associate)
+ [
## 推定プロファイルの作成のみ (CTR)
](#ctr-contact-record-template-inferred-only)
+ [
## 問い合わせレコードテンプレートの使用例
](#ctr-contact-record-template-usage-examples)
+ [
## AWS コンソールでコンタクトレコードタイプを更新する方法
](#ctr-contact-record-template-usage-examples-console)
+ [
## E メール連絡先からプロファイルに名前を自動的に追加する
](#add-email-names-to-profile)
## 推定プロファイルの作成とプロファイルの自動関連付け (CTR-NoInferred)
**説明**
CTR-NoInferred テンプレートを使用しているとき、電話などの問い合わせイベントが発生すると、データを処理するための特定のプロセスが開始されます。まず、システムは `_ctrContactId` キーを使用して、問い合わせイベントに関連する既存のプロファイルを検索します。一致するプロファイルが見つかった場合、問い合わせイベントは自動的にそのプロファイルに関連付けられます。ただし、`_ctrContactId` キーを使用して既存のプロファイルが見つからなかった場合、システムは `_phone` というセカンダリキーを使用してプロファイルを検索します。このキーは、問い合わせイベントに関連付けられた電話番号に基づいて既存のプロファイルを検索するために使用されます。一致するプロファイルが見つかると、問い合わせイベントは自動的にそのプロファイルに関連付けられます。
`_ctrContactId` キーと `_phone` キーのいずれでも既存のプロファイルが見つからない場合、システムは新しい推定プロファイルを作成します。この推定プロファイルに問い合わせイベントのメタデータが入力され、情報がシステム内で確実にキャプチャおよび保存されます。
このプロセスにより、問い合わせイベントの効率的な処理が可能になり、既存のプロファイルとの自動関連付けが容易になり、必要に応じて推定プロファイルを作成できるようになります。これらのメカニズムを活用することで、組織は顧客とのやりとりの包括的な記録を維持し、システム内で問い合わせイベントデータを効果的に管理できます。
CTR-NoInferred テンプレートは、特に重複するプロファイルを減らすという大きな利点があるため、デフォルトの動作として使用することを推奨します。
![\[問い合わせレコードの CTR-NoInferred テンプレート図。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)
## プロファイルの自動関連付けのみ (CTR-AutoAssociateOnly)
**説明**
CTR-AutoAssociateOnly テンプレートは CTR-NoInferred テンプレートと同様に機能しますが、重要な違いが 1 つあります。自動関連付けの対象となる既存のプロファイルが見つからない場合、推定プロファイルを作成しません。
電話などの問い合わせイベントが発生すると、CTR-AutoAssociateOnly テンプレートは `_ctrContactId` キーを使用して、一致する既存のプロファイルを検索します。プロファイルが見つかった場合、問い合わせイベントは自動的にそのプロファイルに関連付けられます。
ただし、`_ctrContactId` キーを使用して既存のプロファイルが見つからなかった場合、テンプレートは `_phone` キーを使用する二次検索メカニズムを採用します。問い合わせイベントと同じ電話番号に関連付けられている既存のプロファイルを検索します。一致するプロファイルが見つかった場合、問い合わせイベントは自動的にそのプロファイルに関連付けられます。
CTR-AutoAssociateOnly テンプレートを使用する目的は、プロファイルの作成を厳密に制御しながら、既存のプロファイルとの自動関連付けを可能にすることです。CTR-NoInferred テンプレートとは異なり、このテンプレートでは一致が見つからなかった場合に推定プロファイルは作成されません。これにより、プロファイルは手動でのみ作成されるため、組織はプロファイル管理をより高度に制御し、正確に行うことができます。
CTR-AutoAssociateOnly テンプレートを利用することで、組織はプロファイル作成に関する特定のルールを守りながら自動関連付けを活用できます。このアプローチにより、問い合わせイベントの処理が合理化され、プロファイルエコシステムを正確に制御できるため、正確なデータ表現が保証され、効率的な顧客管理が容易になります。
![\[問い合わせレコード CTR-AutoAssociateOnly テンプレート図。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)
## 推定プロファイルの作成のみ (CTR)
**説明**
CTR テンプレートは、`_ctrContactId` キーを使用して既存のプロファイルを検索し、一致が見つかった場合は、問い合わせイベントをプロファイルに自動的に関連付けます。ただし、既存のプロファイルが見つからない場合、テンプレートは推定プロファイルを作成し、それに問い合わせイベントのメタデータを入力します。
この動作により、既存のプロファイルが存在しない場合でも問い合わせイベントが確実にキャプチャされますが、推定プロファイルが多数作成される可能性があります。このように推定プロファイルが大量にあると、システム内でプロファイルが重複する問題が発生する可能性があります。
この懸念に対処し、より良いプロファイル管理方法を促進するために、CTR-NoInferred テンプレートをデフォルトオプションとして使用することを強くお勧めします。CTR-NoInferred テンプレートを使用することにより、システムは推定プロファイルを作成する必要がなくなるため、重複プロファイルの発生が減少します。このテンプレートを使用すると、問い合わせイベントをより合理的かつ効率的に処理できるため、データの整合性と精度が向上します。
CTR-NoInferred テンプレートをデフォルトの選択肢として採用することで、組織はプロファイル管理プロセスを最適化し、データの重複を最小限に抑え、顧客とのやり取りをより確実に表現できます。
![\[問い合わせレコードの CTR テンプレート図。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)
## 問い合わせレコードテンプレートの使用例
**Amazon Connect 管理ウェブサイト**
+ Amazon Connect 管理ウェブサイトで、新しいドメインを作成するときに、目的の CTR 動作を選択するオプションがあります。これは、**[プロファイルの作成と自動関連付け]** セクションにあるラジオボタンオプションを使用して実行できます。同様に、既存のドメインを選択するとき、ラジオボタンオプションは、そのドメインに以前関連付けられていた動作を反映します。
+ 現在有効になっているドメインを編集すると、ドメインの詳細ページの **[プロファイルの作成と自動関連付け]** セクションに、現在適用されている動作が表示されます。このセクションのヘッダーにある **[編集]** ボタンを選択すると、**[編集]** **[プロファイルの作成と自動関連付け]** ページにリダイレクトされます。ここで、要件に応じて異なる動作を選択できます。
+ または、**[データマッピング]** ページから CTR マッピングを表示している場合、**[テンプレートを変更]** ボタンを選択できます。このアクションを実行した場合も、**[編集]** **[プロファイルの作成と自動関連付け]** ページが表示され、ニーズに合った別の動作を選択できます。
これらのオプションを使用すると、ドメインの CTR 動作を柔軟に管理できるため、特定の好みや変化するビジネス要件に基づいて、設定を簡単にカスタマイズおよび変更できます。
**AWS CLI**
+ **CTR-NoInferred** テンプレートを使用するには、CLI で次のコマンドを実行します。
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ **CTR-AutoAssociateOnly** テンプレートを使用するには、CLI で次のコマンドを実行します。
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ **CTR** テンプレートを使用するには、CLI で次のコマンドを実行します。
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `
**API**
API の使用方法については、[PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) を参照してください。
## AWS コンソールでコンタクトレコードタイプを更新する方法
1. Customer Profiles コンソールで、**[Customer Profiles のドメイン]** セクションの **[詳細を表示]** を選択します。
![\[[Customer Profiles のドメイン] セクションで [詳細を表示] を選択します\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)
1. **[ドメインの詳細]** ページの **[プロファイルの作成と自動関連付け]** セクションで **[編集]** を選択します。
![\[[プロファイルの作成と自動関連付け] セクションで [編集] を選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)
1. ドメインに適用するコンタクトレコードの動作を選択して、**[保存]** を選択します。
![\[ドメインに適用するコンタクトレコードの動作を選択して、[保存] を選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)
## E メール連絡先からプロファイルに名前を自動的に追加する
E メール連絡先から顧客のプロファイルに名前を入力するフローを設定できます。[[プロファイルの更新]](customer-profiles-block.md#customer-profiles-block-properties-update-profile) アクションを使用するように設定された [Customer Profiles](customer-profiles-block.md) ブロックを使用します。
# Customer Profiles の \$1phone キーを使用して見つけた 1 つのプロファイルにコンタクトレコードを関連付ける
`_phone` キーを使って見つけた 1 つのプロファイルに、問い合わせレコードを自動的に関連付けることができます。
**例**
ドメインでは、`CreateProfile` API によって次のプロファイルが作成されます。
```
{
"FirstName": "John",
"LastName": "Doe",
"PhoneNumber": "+11234567890"
}
```
デフォルトの CTR テンプレートを使用して `PhoneNumber` \$111234567890 から通話を受信した場合、エージェントが同じ発信者の問い合わせレコードを既に上記のプロファイルに手動で関連付けていない限り、問い合わせレコードが上記のプロファイルに自動的に関連付けられることはありません。問い合わせレコードが手動または自動で関連付けられなかった場合、Customer Profiles は問い合わせレコードの情報を使用して推定プロファイルを作成します。
エージェントの手動での介入なしで自動的に上記のプロファイルを問い合わせレコードに関連付けるには、CTR-NoInferred テンプレートを使用します。 CTR-NoInferred テンプレートを使用して `PhoneNumber` \$111234567890 から通話を受信すると、問い合わせレコードは自動的に `_phone` プロファイルキーを使用して上記のプロファイルに関連付けられます。
Customer Profiles が問い合わせレコードをプロファイルに自動的に関連付けることが*できない* 2 つのシナリオがあります。
+ `_phone` プロファイルキーを使用して複数のプロファイルが見つかった場合、Customer Profiles は問い合わせレコードを一意のプロファイルに関連付けることができず、リクエストは拒否されます。
+ `_phone` プロファイルキーに対応するプロファイルが見つからない場合、Customer Profiles は推定プロファイルを作成します。
デフォルトの CTR テンプレートを置き換えて CTR-NoInferred テンプレートを使用するには、CLI で次のコマンドを実行します。
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`
デフォルトの動作に戻すには、CLI で次のコマンドを実行します。
`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`
# Amazon Connect Customer Profiles のオブジェクトタイプマッピングの例
## プロファイルを生成するオブジェクトタイプマッピング
次の例は、標準プロファイルに入力するデータを示しています。
以下は、入力オブジェクトです。
```
{
"account": 1234,
"email": "john@examplecorp.com",
"address": {
"address1": "Street",
"zip": "Zip",
"city": "City"
},
"firstName": "John",
"lastName": "Doe"
}
```
次のコードは、入力オブジェクトの標準プロファイルオブジェクトへのマッピングと `PersonalEmailAddress`、`fullName`、および `accountId` (一意のキー) のインデックス作成を示しています。
```
{
"Fields": {
"accountId": {
"Source": "_source.account",
"Target": "_profile.AccountNumber",
"ContentType": "NUMBER"
},
"shippingAddress.address1": {
"Source": "_source.address.address1",
"Target": "_profile.ShippingAddress.Address1"
},
"shippingAddress.postalCode": {
"Source": "_source.address.zip",
"Target": "_profile.ShippingAddress.PostalCode"
},
"shippingAddress.city": {
"Source": "_source.address.city",
"Target": "_profile.ShippingAddress.City"
},
"personalEmailAddress": {
"Source": "_source.email",
"Target": "_profile.PersonalEmailAddress",
"ContentType": "EMAIL_ADDRESS"
},
"fullName": {
"Source": "{{_source.firstName}} {{_source.lastName}}"
},
"firstName": {
"Source": "_source.firstName",
"Target": "_profile.FirstName"
},
"lastName": {
"Source": "_source.lastName",
"Target": "_profile.LastName"
}
},
"Keys": {
"_email": [
{
"FieldNames": ["personalEmailAddress"]
}
],
"_fullName": [
{
"FieldNames": ["fullName"]
}
],
"_account": [
{
"StandardIdentifiers": ["PROFILE","UNIQUE"],
"FieldNames": ["accountId"]
}
]
}
}
```
なお、`email` と `fullname` はインデックス付けされますが、プロファイルの検索には使用されません。アカウントは一意のキーです。オブジェクトを指定する必要があります。同じアカウント ID を持つオブジェクトが取り込まれるたびに、同じアカウント ID の以前のオブジェクトは上書きされます。
標準プロファイルオブジェクトには、複数のフィールドが入力されます (`Target` を定義したフィールドを参照してください)。
## 標準プロファイルに入力されないオブジェクトタイプマッピング
この例は、より複雑なユースケースを示しています。プロファイルに関連するデータを取り込みますが、必ずしも標準プロファイルオブジェクトに入力されるとは限りません。
以下は、入力オブジェクトです。
```
{
"email": "john@examplecorp.com",
"timestamp": "2010-01-01T12:34:56Z",
"subject": "Whatever this is about",
"body": "Body of ticket"
}
```
次に、このデータをマッピングする方法の 1 つを示します。
```
{
"Fields": {
"email": {
"Source": "_source.email",
"ContentType": "EMAIL_ADDRESS"
},
"timestamp": {
"Source": "_source.timestamp"
}
},
"Keys": {
"_email": [
{
"StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
"FieldNames": ["email"]
}
],
"ticketEmail": [
{
"StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
"FieldNames": ["email"]
}
],
"uniqueTicket": [
{
"StandardIdentifiers": ["UNIQUE"],
"FieldNames": ["email","timestamp"]
}
]
}
}
```
この例では、データを取り込み、最初の検索時に E メールアドレスを取り込みます。
+ E メールアドレスが単一のプロファイルに一致する場合、その E メールアドレスはその特定のプロファイルにデータをアタッチするために使用されます。チケットの一意の識別子は、E メールとタイムスタンプで構成されます。これは、他の一意の識別子は存在しないためです。
+ 指定された E メールでプロファイルが存在しない場合、`EmailAddress` のフィールドだけが設定されている新しいプロファイルが作成されます。取り込まれたオブジェクトは、この新しい**推定プロファイル**に添付されます。プロファイルを見つけることができる 2 つの検索可能なキーは `_email` と `uniqueTicket` です。
+ 指定された電子メールアドレスで複数のプロファイルが存在する場合、`EmailAddress` フィールドだけが設定された新しいプロファイルが作成され、オブジェクトはこの新しいプロファイルに添付されます。このプロファイルは、`_email` および `uniqueTicket` に加えて、`ticketEmail` キーが定義されて作成されます。その E メールからその後に送られるチケットは、この新しい**推定プロファイル**に割り当てられます。その理由は、` _email` キーが 3 つのプロファイルを参照しているため、破棄されますが、`ticketEmail` キーは単一のプロファイル (新しい推定プロファイル) のみを参照しているので、引き続き有効だからです。
+ 新しい**推定プロファイル**が作成された場合、`EmailAddress` フィールドには、そのプロファイルを作成した最初のオブジェクトから入力されます。
# Amazon Connect Customer Profiles の暗黙的なプロファイルオブジェクトタイプ
([ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html) API が返す) テンプレート ID の名前と一致するオブジェクトタイプはどれでも、明示的に定義せずに使用できます。オブジェクトタイプは、このオブジェクトタイプのテンプレート定義の定義と完全に一致します。明示的なオブジェクトタイプが定義されている場合は、暗黙的なオブジェクトタイプが置き換えられます。
暗黙的なオブジェクトタイプは、[ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html) API に含まれているか、[GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html) オペレーションで返されますが、そのオブジェクトタイプから取り込まれたデータをすべて削除する場合は、削除できます。
# Amazon Connect の生成 AI を活用したデータマッピング
Amazon Connect Customer Profiles は、生成 AI を活用したカスタマーデータマッピング機能を提供します。これにより、統合プロファイルの作成に必要な時間が大幅に短縮され、よりパーソナライズされたカスタマーエクスペリエンスを提供できます。
この機能を使用すると、コンタクトセンターの管理者が Adobe Analytics、Salesforce、Amazon Simple Storage Service (S3) などの 70 以上の利用可能なノーコードデータコネクタのいずれかから顧客データを追加すると、 Amazon Connect Customer Profiles はこれらのソースのデータを分析して、異なるソース間で異なる形式で存在するデータを整理して統合プロファイルにまとめる方法を自動的に決定します Amazon Connect。コンタクトセンターの管理者は顧客プロファイルを確認して設定を完了できるため、関連する顧客情報をエージェントに提供したり、IVR やチャットボットを動的にパーソナライズして顧客満足度とエージェントの生産性を向上したりできます。
生成 AI を活用した顧客データマッピングは、次のリージョンで使用できます。
+ 米国東部 (バージニア北部)
+ 米国西部 (オレゴン)
+ アフリカ (ケープタウン)
+ アジアパシフィック (シンガポール)
+ アジアパシフィック (シドニー)
+ アジアパシフィック (東京)
+ アジアパシフィック (ソウル)
+ カナダ (中部)
+ 欧州 (フランクフルト)
+ 欧州 (ロンドン)
## 生成 AI を活用したデータマッピングのセットアップ
1. Amazon Connect Customer Profiles コンソールを開きます。
1. **[データソースの統合]** タブで、**[データソース統合を追加]** をクリックします。
1. 接続を設定します。サポートされているすべてのコネクタが利用できるデータソースをドロップダウンから選択します。
![\[サポートされているすべてのコネクタが利用できるデータソースをドロップダウンから選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)
1. データをマップします。データマッピングを自動生成するオプションを選択するか、既存のマッピングテンプレートを選択するか、一からデータマッピングを作成します。
![\[データをマップします。データマッピングを自動生成するオプションを選択するか、既存のマッピングテンプレートを選択するか、一からデータマッピングを作成します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)
1. マッピングの概要を確認します。すべての顧客属性を示す、自動生成されたマッピング結果の概要を確認します。データインジェストを開始する前に、取り込みキーを編集して確認します。フィールドマッピングとキーの詳細については、「[Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細](object-type-mapping-definition-details.md)」を参照してください。
![\[マッピングの概要を確認します。すべての顧客属性を示す、自動生成されたマッピング結果の概要を確認します。データインジェストを開始する前に、取り込みキーを編集して確認します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)
## 仕組み
このシステムは 4 つのフェーズで動作します。最初のフェーズでは、Customer Profiles がソース属性を取得し、利用可能な場合はデータソースからデータをサンプリングして、ターゲットに最適なオブジェクトタイプを決定します。Amazon S3 データソースの場合、選択した Amazon S3 バケットとプレフィックスで見つかった最初の CSV ファイルがサンプルデータとして使用されます。その他のデータソースの場合、Customer Profiles は AppFlow を介してソース属性を取得します。第 2 フェーズでは、大規模言語モデル (LLM) を利用して各カスタム属性をさらに処理し、標準の Customer Profiles 属性にマッピングします。第 3 フェーズでも顧客識別子など、キーとして機能する適切な属性を選択するために、LLM が再度使用されます。最後に 4 番目のフェーズでは、タイムスタンプ形式検出機能がタイムスタンプを解析して、レコードの適切な時系列の順序を維持します。このシステムは、予測結果を組み合わせた後、20 秒以内に最大 120 の属性のマッピングを生成できます。
## 生成 AI を活用したデータマッピングのトラブルシューティング
次のセクションには、発生する可能性のあるエラーメッセージが表示されます。また、各問題の原因と解決策を示します。
### エラー: オブジェクト文字列を JSON に解析できませんでした
リクエスト内のオブジェクト文字列が有効な JSON ではありません。リクエスト内のオブジェクト文字列を確認して、有効な JSON であることを確認します。
### エラー: 「objects」の値が制約を満たすことができませんでした。メンバーの長さは 5 以下である必要があります
リクエストに含まれるオブジェクトが多すぎます。各リクエストでは最大 5 つのオブジェクトが許可されます。オブジェクトの数を 5 つ以下に減らします。
### エラー: 120 の属性の制限を超えました
JSON オブジェクトでは、ネストされた JSON 属性を含め、最大 120 の属性が許可されます。JSON オブジェクトからマッピングする必要のない一部の属性を削除します。
![\[JSON オブジェクトでは、ネストされた JSON 属性を含め、最大 120 の属性が許可されます。JSON オブジェクトからマッピングする必要のない一部の属性を削除します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)
### 警告: データを区別する **[一意のキー]** が見つかりませんでした。ユーザーのプロファイルを識別する **[プロファイルキー]** が見つかりませんでした。
モデルが指定されたオブジェクトから有効なオブジェクトタイプを見つけることができませんでした。入力を変更するか、提案に従って手動マッピングの方法を使用します。
![\[モデルが指定されたオブジェクトから有効なオブジェクトタイプを見つけることができませんでした。入力を変更するか、提案に従って手動マッピングの方法を使用します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)
# Amazon Connect Customer Profiles のデータ制限
Amazon Connect Customer Profiles では、統合プロファイルの作成に使用するさまざまなタイプの顧客データに対してデータインジェスト制限を設定することで、データのオンボーディングをカスタマイズできます。データマッピングの制限を設定すると、マッピングで取り込むデータの量に優先順位を付けることができます。プロファイルあたりのすべてのマッピングでのデフォルトの上限は 1000 です。
**注記**
データ制限は推定値であり、多少変動する可能性があります。1 つのプロファイルで取り込み量が多い間は、上下に数ユニットの偏差が生じる可能性があります。
## Customer Profiles データ制限を設定する方法
1. Amazon Connect Customer Profiles コンソールを開きます。
1. **[データ制限]** タブを選択して、データオブジェクトの制限を設定します。
![\[[データ制限] タブに移動して、データオブジェクトの制限を設定します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)
1. 目的のデータオブジェクトの制限にカーソルを合わせ、編集アイコンを選択します。
![\[目的のデータオブジェクトの制限にカーソルを合わせ、編集アイコンを選択します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)
1. 制限を入力し、チェックマークアイコンを選択して制限を保存または更新します。
![\[画像では、新しい制限の入力を示し、制限を保存または更新するために使用されるチェックマークアイコンを強調表示しています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)
## Customer Profiles データ制限をクリアする方法
1. 制限をクリアするデータオブジェクトのラジオボタンを選択します。その後、**[制限をクリア]** を選択できるようになります。
![\[[データ制限] ページのデータオブジェクトの左側にあるラジオボタンが強調表示されています。ここでラジオボタンを選択すると、オブジェクトのデータ制限のクリアボタンが有効になります。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)
1. *confirm* と入力して、選択したデータオブジェクトの制限値をクリアします。
![\[データオブジェクトの制限値をクリアすることを確認するポップアップボックス。クリアのアクションを確認するには、すべて小文字で「confirm」と入力します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)
# 顧客データを作成して、Customer Profiles に取り込む
Amazon S3 を使用して任意のソースからデータを定義し、カスタム統合や事前構築の統合を必要とせずに、お客様プロファイルをシームレスに充実させることができます。例えば、関連する購入履歴情報をエージェントに提供するとします。内部アプリケーションから S3 のスプレッドシートファイルに購買取引データをインポートし、それをお客様プロファイルにリンクできます。
これを設定するには、お客様プロファイルオブジェクトの表示方法を記述する[オブジェクトタイプマッピング](customer-profiles-object-type-mapping.md)を定義する必要があります。このマッピングでは、データのフィールドを使用して、標準プロファイルのフィールドに入力する方法、またはデータを特定のプロファイルに割り当てる方法を定義します。
オブジェクト型のマッピングを作成したら、[PutProfileObject ](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObject.html) API を使用して、CRM からカスタムプロファイルオブジェクトにカスタムプロファイルデータをアップロードできます。
**注記**
Customer Profiles は、ドット表記を含む CSV ヘッダーからのデータの取り込みをサポートしていません。
Customer Profiles がデータマッピングのために Amazon S3 バケットからデータにアクセスするために必要な IAM アクセス許可のリストについては、「[Actions defined by Amazon Connect Customer Profiles](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnectcustomerprofiles.html#amazonconnectcustomerprofiles-actions-as-permissions)」の表で「`PutProfileObject`」を参照してください。
## Customer Profile の取り込み
**アカウントベースのプロファイルの取り込み**
1. S3 へのファイルのアップロード account-profiles で参照されるプロファイルと account-profiles 自体の取り込みは、個別に行う必要があります。
1. account-profile の取り込みに使用される新しいファイルには、プロファイルタイプと E メールおよび電話のエンゲージメント設定という新しい属性を含める必要があります。
1. AWS コンソールを使用して S3 から Customer Profiles にファイルを取り込む
**サンプルプロファイル (以下のアカウントベースのプロファイルで参照) CSV**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**account-based profiles のサンプル CSV**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/customer-profiles-object-type-mappings.html)
**E メールを含むエンゲージメント設定の例**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PersonalEmailAddress"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PersonalEmailAddress"}
]
```
**電話を含むエンゲージメント設定の例**:
```
[
{"KeyName": "CustomerId", "KeyValue": "456", "ContactType": "PhoneNumber"},
{"KeyName": "CustomerId", "KeyValue": "789", "ContactType": "PhoneNumber"}
]
```
**注記**
**ProfileType** `PROFILE` では、同じ方法を使用してエンゲージメント設定を取り込んで追加できます。
1. 2 つのデータマッピングを作成します。1 つはサブプロファイル用、もう 1 つはアカウントベースのプロファイル用です。
![\[記述された関係に基づいてマッピングをそれぞれ作成する 2 つのデータソース統合を作成します。例えば、accounts/profiles などです。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-1.png)
1. 次に、顧客プロファイル属性をマッピングします。`ProfileType` という名前の送信先を書き留めます。
![\[次に、顧客プロファイル属性をマッピングします。ProfileType という名前の送信先を書き留めます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-2.png)
**アカウントベースのプロファイルで参照されるプロファイルを取り込むためのオブジェクトタイプのマッピングの例**
```
{
"AllowProfileCreation": true,
"Description": "Standard Profile Object Type",
"Fields": {
"FirstName": {
"ContentType": "STRING",
"Source": "_source.FirstName",
"Target": "_profile.FirstName"
},
"LastName": {
"ContentType": "STRING",
"Source": "_source.LastName",
"Target": "_profile.LastName"
},
"PhoneNumber": {
"ContentType": "PHONE_NUMBER",
"Source": "_source.PhoneNumber",
"Target": "_profile.PhoneNumber"
},
"PersonalEmailAddress": {
"ContentType": "EMAIL_ADDRESS",
"Source": "_source.PersonalEmailAddress",
"Target": "_profile.PersonalEmailAddress"
},
"State": {
"ContentType": "STRING",
"Source": "_source.State",
"Target": "_profile.Address.State"
},
"CustomerId": {
"ContentType": "STRING",
"Source": "_source.CustomerId",
"Target": "_profile.Attributes.CustomerId"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
}
},
"Keys": {
"CustomerId": [
{
"FieldNames": [
"CustomerId"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. このプロセスを繰り返して、アカウントベースのプロファイルを取り込みます。Note EngagementPreferences.Email and EngagementPreference.Phone.
![\[このプロセスを繰り返して、アカウントベースのプロファイルを取り込みます。Note EngagementPreferences.Email and EngagementPreference.Phone.\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-ingesting-account-based-profiles-3.png)
**アカウントベースのプロファイルを取り込むためのオブジェクトタイプマッピングの例**
```
{
"AllowProfileCreation": true,
"Description": "Account-based profiles Object Type",
"Fields": {
"AccountNumber": {
"ContentType": "STRING",
"Source": "_source.AccountId",
"Target": "_profile.AccountNumber"
},
"PrimaryOwner": {
"ContentType": "STRING",
"Source": "_source.PrimaryOwner",
"Target": "_profile.Attributes.PrimaryOwner"
},
"SecondaryOwner": {
"ContentType": "STRING",
"Source": "_source.SecondaryOwner",
"Target": "_profile.Attributes.SecondaryOwner"
},
"ProfileType": {
"ContentType": "STRING",
"Source": "_source.ProfileType",
"Target": "_profile.ProfileType"
},
"EmailEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.EmailEngagementPreferences",
"Target": "_profile.EngagementPreferences.Email"
},
"PhoneEngagementPreferences": {
"ContentType": "STRING",
"Source": "_source.PhoneEngagementPreferences",
"Target": "_profile.EngagementPreferences.Phone"
}
},
"Keys": {
"Account": [
{
"FieldNames": [
"AccountNumber"
],
"StandardIdentifiers": [
"PROFILE",
"UNIQUE"
]
}
]
}
}
```
1. 記述された関係に基づいてマッピングをそれぞれ作成する 2 つのデータソース統合を作成します。例えば、accounts/profiles などです。
**注記**
アカウントベースのプロファイルの取り込みは、Amazon Connect Customer Profiles コンソールの [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html) API または Profile メトリクスを使用して、アカウントベースのプロファイルで参照されるプロファイルの正常な取り込みを検証した後にのみ行う必要があります。
自動生成マッピングは、アカウントベースのプロファイルとサブプロファイルの取り込みには使用できません。
連絡先設定の E メールと電話番号のリストには、子プロファイルを参照する `KeyName`、`KeyValue`、または `ProfileId` のいずれかが含まれます。`KeyName` は一意の識別子である必要があります。
サブプロファイルを更新しても、アカウントベースのプロファイルのエンゲージメント設定は更新されません。更新は取り込みパスを介して行う必要があります。
# Amazon Connect Customer Profiles と Kinesis の統合を作成する
次の手順では、Amazon Kinesis Data Stream から Amazon Connect Customer Profiles にオブジェクトをストリーミングするプロセスの概要を説明します。統合は、主に 2 つのステップで構成されます。
1. Kinesis Data Stream から EventBridge バスにデータをストリーミングするように EventBridge パイプを設定する
1. 作成した EventBridge パイプを使用して Kinesis Data Stream と Customer Profiles のデータ統合を設定する
## ステップ 1: Kinesis から EventBridge にデータをストリーミングする
1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインの [**Event Buses**] (イベントバス) を選択します。
1. [**イベントバスの作成 (Create event bus)**] を選択します。
1. **[イベントバスの詳細]** セクションで、わかりやすい名前を指定します。例えば、`kinesis-to-customer-profiles`。
1. **[作成]** を選びます。
1. [Kinesis Data Stream の詳細] ページに移動します。
1. **[EventBridge パイプ]** タブを選択し、**[Kinesis Data Stream をパイプに接続]** を選択します。
1. EventBridge パイプの名前を作成します。
1. **[ターゲットセットアップ]** ページが表示されるまで、セットアップウィザードに従います。
1. ステップ 1 で作成したイベントバスをターゲットとして選択します。例えば、`kinesis-to-customer-profiles`。
1. **[ターゲット]** セクションの後に、**[ターゲット入力トランスフォーマー]** アコーディオンを展開します。
1. ターゲット入力トランスフォーマーで、以下のように設定します。
```
{
"data": <$.data>
}
```
1. **[パイプを作成]** を選択して、セットアップを完了します。
この時点で、EventBridge への Kinesis イベントのルーティングが正常に設定されます。次に、Customer Profiles との統合を作成します。
## ステップ 2: EventBridge データを Customer Profiles に取り込む
1. Amazon Connect コンソールで **[Customer Profiles]** に移動します。
1. **[データソースの統合]** タブで、**[データソース統合を追加]** を選択します。
1. **[データソース]** ドロップダウンから **[Kinesis]** を選択します。
1. **[EventBridge パイプ名]** ドロップダウンで、ステップ 1 で作成したパイプを選択し、**[次へ]** を選択します。
1. **[データマッピング]** ページで、適切なオブジェクトタイプマッピングを選択し、**[次へ]** を選択します。
1. **[確認と統合]** ページで設定を確認し、**[データソース統合を追加]** を選択して設定を完了します。
Kinesis Data Stream が Amazon Connect Customer Profiles と統合され、Kinesis から Customer Profiles にイベントを送信する準備が整いました。
# 統合された顧客プロファイルデータをエクスポートする
Amazon Connect Customer Profiles は、統合された顧客プロファイルの Amazon Kinesis Data Stream へのリアルタイムのデータエクスポートを提供します。データストリーミングを有効にすると、新しいプロファイルや既存のプロファイルへの更新のデータを Amazon Kinesis Data Stream に自動的に受信できます。
Customer Amazon Connect Profiles からのup-to-dateを使用して、CRMs やマーケティングオートメーションツールなどのソースシステムデータを最新の状態に保つことができます。例えば、カスタマーがコンタクトセンターに電話して住所を更新すると、エージェントは変更を加えて新しいカスタマーの住所を追加でき、更新されたプロファイル情報は Kinesis Data Stream にリアルタイムで送信されます。
これを設定するには、Customer Profiles コンソールで**[データエクスポート]**を有効にする必要があります。
## リアルタイムエクスポートを有効にする
**ドメインのデータストリーミングを有効にするには**
1. Amazon Connect Customer Profiles コンソールを開きます。
1. **[データエクスポート]** タブを選択し、**[データストリーミングを有効にする]** を選択します
![\[リアルタイムのデータエクスポートにより、Kinesis データストリームが可能になります。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-real-time-export-1.png)
1. **[データストリーミングを有効にする]** を選択して、ドロップダウンメニューから既存の Kinesis データストリームを選択するか、**[新しい Kinesis データストリームを作成する]** を選択して Kinesis コンソールを開きストリームを作成します。詳細については、「[ストリームの作成および管理](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)」を参照してください。
![\[リアルタイムのデータエクスポートにより、Kinesis データストリームが可能になります。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-real-time-export-2.png)
1. **[データストリーミングを有効にする]** ボタンを選択して設定を保存します。
## リアルタイムエクスポートを無効にする
**ドメインのデータストリーミングを無効にするには**
1. Amazon Connect Customer Profiles コンソールを開きます。
1. **[データエクスポート]** タブを選択し、**[データストリーミングを無効にする]** を選択します。
![\[リアルタイムのデータエクスポートは Kinesis データストリームを無効にします。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/disable-real-time-export-1.png)
## リアルタイム Kinesis ペイロード
**JSON のサンプル出力イベント**
```
{
"SchemaVersion": 0,
"EventId": "eventId",
"EventTimestamp": "2020-01-01T00:00:00Z",
"EventType": "CREATED",
"DomainName": "domainName",
"ObjectTypeName": "objectTypeName",
"AssociatedProfileId": "associatedProfileId",
"ProfileObjectUniqueKey": "profileObjectUniqueKey",
"Object": {
"map": {
"k1": [
"a",
"b",
"c"
]
}
},
"IsMessageRealTime": true
}
```
**SchemaVersion**
スキーマの現在のバージョン。
**EventId**
一意のイベント ID。
**EventTimestamp**
ISO8601 標準を使用したイベントのタイムスタンプ。
**EventType**
エクスポートされたイベントのタイプ。
値: CREATED、UPDATED、HEALTH\$1CHECK
+ CREATED: エクスポートイベントは CreateProfile 用でした。
+ UPDATED: エクスポートイベントは UpdateProfile 用でした。
+ HEALTH\$1CHECK: エクスポートイベントは、Customer Profiles が Kinesis Stream で正常に `putEvent` できることを確認するための HealthCheck イベント用でした。
**DomainName**
ドメインイベントはイベントの `/Domain` に属します。
**ObjectTypeName**
イベントのオブジェクトタイプ
値: `_profile`、`_asset`、`_order`、`_case`。`Salesforce-Account` など、定義済みのテンプレート名や、[ PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) API を使用して作成できるカスタム定義のオブジェクト名を使用することもできます。
**AssociatedProfileId**
オブジェクトが関連付けられている標準プロファイルの ID。オブジェクトタイプが `_profile` ではない場合のみ存在します。
**ProfileObjectUniqueKey**
サービスによって生成される ProfileObject の一意の識別子。
タイプ: 文字列
**Object**
標準プロファイルまたは標準プロファイルオブジェクト自体。
**IsMessageRealTime**
メッセージがリアルタイムであるか、再配信されたかを通知するフラグ。
**JSON のサンプルペイロード**
```
{
"SchemaVersion": 0,
"EventId": "6049bf39-0000-0000-0000-b75656dd51a8",
"EventTimestamp": "2023-02-24T07:17:05.356Z",
"EventType": "UPDATED",
"DomainName": "SampleDomain",
"ObjectTypeName": "Salesforce-Account",
"AssociatedProfileId": "5ffcee99ab0000000000b3ae01225e40",
"ProfileObjectUniqueKey": "cNo77ZI0000000000pCPB7RQcqfeBaRfBwrzW2MMbws=",
"Object": {
"Id": "0012v00002kVKVuAAO",
"IsDeleted": false,
"Name": "Company A",
"Phone": "+12065551234",
"PhotoUrl": "/services/images/photo/0012v00002kVKVuAAO",
"OwnerId": "0052v00000fmQ7sAAE",
"CreatedDate": "2019-12-13T07:56:04.000+0000",
"CreatedById": "0052v00000fmQ7sAAE",
"LastModifiedDate": "2023-02-22T20:29:43.000+0000",
"LastModifiedById": "0052v00000fmQ7sAAE",
"SystemModstamp": "2023-02-22T20:29:43.000+0000",
"LastActivityDate": "2020-03-18",
"LastViewedDate": "2023-02-23T00:09:49.000+0000",
"LastReferencedDate": "2023-02-23T00:09:49.000+0000",
"CleanStatus": "Pending"
},
"IsMessageRealTime": true
}
```
# Kinesis Data Stream へのリアルタイムイベントのエクスポート時のトラブルシューティング
Kinesis Data Stream に最初にイベントをエクスポートするときに、遅延が発生する場合があります。これは、サービスリンクロールの IAM アクセス許可の伝播にかかる時間が原因です。実際の問題が発生すると、ストリーミングステータスがエラー状態になる可能性があります。
![\[イベントが送信先 Kinesis Data Stream に到達できず、エラー状態になっています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/real-time-export-troubleshooting.png)
次のセクションには、発生する可能性のあるエラーメッセージが表示されます。また、各問題の原因と解決策を示します。
## エラー: Kinesis Data Stream はアクティブではありません。設定を確認して、後でイベントストリームを再作成してください
送信先の Kinesis Data Stream は、`ACTIVE` 状態ではありません。これは、Kinesis Data Stream の作成中または削除中に発生する可能性があります。このエラーを解決するには、Kinesis Data Stream が ACTIVE 状態であることを確認し、データストリーミング設定を再度有効にします。
## エラー: Kinesis Data Stream は存在しません。有効な Kinesis Data Stream の送信先を使用してイベントストリームを再作成してください
送信先の Kinesis Data Stream は削除されます。このエラーを解決するには、既存の Kinesis Data Stream を送信先としてデータストリーミングを再度有効にします。
## エラー: Kinesis Data Stream はスロットリングされています。Kinesis のより高いスループットを適切にプロビジョニングすることを検討してください
送信先の KKinesis Data Stream がスロットリングされています (プロビジョニングが不十分)。このエラーを解決するには、送信先の Kinesis Data Stream に十分なシャード数があることを確認してから、データストリーミングを再度有効にします。
## エラー: Kinesis Data Stream の暗号化に使用される KMS キーがスロットリングされています。KMS リクエストクォータを適切に増やすことを検討してください
Kinesis Data Stream で使用されている KMS キーがスロットリングされています。このエラーを解決するには、データストリーミングを再度有効にしてください。
## エラー: Kinesis Data Stream の KMS キー設定を確認してください
Customer Profiles は Kinesis Data Stream で使用される KMS キーにアクセスできません。これは、KMS キーに Customer Profiles サービスにリンクされたロールからのアクセスを拒否するキーポリシーが設定されている場合や、キーが [有効] ステータスになっていない場合に発生する可能性があります。このエラーを解決するには、KMS キーポリシーで Customer Profiles サービスにリンクされたロールからのアクセスが拒否されていないこと、およびキーのステータスが [有効] になっていることを確認してください。このエラーを解決するには、データストリーミングを再度有効にします。
# 統合されたすべての顧客プロファイルデータに一括エクスポートを設定する
**注記**
このトピックのステップを完了するには、デベロッパースキルが必要であり、 と AWS KMS Amazon S3 の使用経験が必要です。
Amazon Connect Customer Profiles が統合された顧客プロファイルを作成する際、ファーストパーティソースとサードパーティーソースのデータを組み合わせることで、未加工データと情報をより正確なプロファイルに強化、改良、改善します。Customer Profiles は、新しいデータを追加することでデータセットの品質も改善します。改善されたデータセットを、より多くの情報に基づく、ターゲットを絞ったマーケティング、販売、カスタマーサービス戦略の策定など、追加のユースケースで活用することができます。例えば、統合された顧客プロファイルを活用して以下を行うことができます。
+ ドメイン全体に含まれる顧客データを監査する。
+ 売上レポートやマーケティングレポートなどの社内分析を実行する。
+ 独自のツールやサードパーティー製品にデータをエクスポートして、広告のパーソナライズや顧客ターゲティングに活用する。
統合された顧客プロファイルデータを追加のユースケースで活用するには、Amazon S3 に一括エクスポートできます。このトピックでは、その方法について説明します。
**Topics**
+ [
## ステップ 1: KMS キーと S3 バケットを設定する
](#enable-cpbulk-export)
+ [
## ステップ 2: 一括エクスポートジョブを作成する
](#create-bulk-export-job)
+ [
## ステップ 3: 一括エクスポートジョブのステータスを確認する
](#check-status-bulk-cp-export)
+ [
## ステップ 4: S3 でエクスポートされたデータを表示する
](#view-bulk-cp-export)
+ [
## 一括エクスポートジョブを更新する
](#update-bulk-cp-export)
+ [
## 一括エクスポートジョブを削除またはキャンセルする - サポートされていません
](#delete-bulk-cp-export)
## ステップ 1: KMS キーと S3 バケットを設定する
ドメインの一括エクスポートを有効にするには、次のリソースを設定する必要があります。
+ [特定のリソースポリシーを持つ KMS キー](#cp-kms)
+ [特定のリソースポリシーを持つ送信先 S3 バケット](#cp-s3-bulk)。バケットで[アクセスコントロールリスト (ACL)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) を設定しないでください。
次に、これらのステップについて説明します。
### 新しい KMS キーを作成するか、既存の KMS キーを再利用する
一括エクスポート用に KMS キーを設定するには、一括エクスポート先として設定する予定の Amazon S3 バケットと同じ AWS リージョンにある既存の KMS キーを作成または再利用する必要があります。Amazon Connect AppIntegrations サービスがキーに対して KMS アクションを実行することを許可する必要があります。
以下のステートメントを**キーポリシー**に追加します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Enable AppIntegrations access to KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root"
],
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### 送信先 S3 バケットを設定する
KMS キーと同じ AWS リージョンに新規または既存のバケットを設定し、S3 バケットにリソースポリシーを設定する必要があります。
バケットを設定するときは、必ず **SSE-KMS による暗号化**を選択し、前の手順と同じ KMS キーを使用してください。また、S3 バケットで ACL を有効にしないでください。
以下に、リソースポリシーの例を示します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow AppIntegrations to write data to destination bucket",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
"arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## ステップ 2: 一括エクスポートジョブを作成する
一括エクスポートジョブを作成するには、次の Amazon Connect AppIntegrations API を呼び出します。
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): この API は、データソース (Customer Profiles など) との統合を作成します。
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): この API は、データソースを使用して送信先 (S3 バケットなど) にデータを書き込みます。
これらの API を呼び出す方法の詳細については、以下を参照してください。
### データ統合を作成する
データ統合は、データの*データソース*を表します。[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html) API を呼び出すか、[create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html) CLI コマンドを実行してデータ統合を作成できます。Customer Profiles *オブジェクトタイプ*と Customer Profiles *ドメイン*を指定する必要があります。
複数のオブジェクトタイプをエクスポートする場合は、それぞれに個別のデータ統合を作成する必要があります。例えば、`_profile` と `_asset` オブジェクトの両方をエクスポートする場合は、2 つの個別のデータ統合を作成する必要があります。
**注記**
過去 30 分以内に取り込まれたデータは、エクスポートに含まれない場合があります。
次のコードサンプルは、[create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html) CLI コマンドを実行する方法を示しています。
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "bulk-export-job-01" \
--description "Data integration for _profile objects" \
--kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \
--source-uri "AmazonConnect://AppIntegrations" \
--object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
```
次のコードサンプルは、[CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html) API を呼び出す方法を示しています。
```
{
"Description": "Data integration for _profile objects",
"KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012",
"Name": "unique-data-integration-name-01",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"my-domain-pdx"
],
"objectType": [
"_profile"
]
}
}
}
```
### データ統合の関連付けを作成する
データ統合の関連付けは、データをエクスポートする送信先と、エクスポート対象のデータを選択するための時間範囲を表します。[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html) API を呼び出すか、[create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html) CLI コマンドを実行してデータ統合を作成できます。`StartTime` および `EndTime` プロパティを使用して時間範囲を設定します。この時間範囲は、Customer Profiles でオブジェクトが最後に更新された時間に対応します。
指定する送信先 S3 バケットは、バケット名のみにすることも、データをエクスポートする追加のフォルダまたは S3 プレフィックスを含めることもできます。
**注記**
**同時一括エクスポートジョブ**のクォータについては、「[Amazon Connect Customer Profiles サービスクォータ](amazon-connect-service-limits.md#customer-profiles-quotas)」を参照してください。完了または失敗した一括エクスポートジョブは、同時実行クォータにはカウントされなくなります。
次のコードサンプルは、[create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html) CLI コマンドを実行する方法を示しています。
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--destination-uri "s3://amzn-s3-demo-bucket1" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
次のコードサンプルは、[CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html) API を呼び出す方法を示しています。
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## ステップ 3: 一括エクスポートジョブのステータスを確認する
一括エクスポートジョブのステータスを表示するには、[ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html) API を呼び出すか、[list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html) CLI コマンドを実行します。
次のコードサンプルは、[list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html) CLI コマンドを実行する方法を示しています。
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"
```
## ステップ 4: S3 でエクスポートされたデータを表示する
データ統合の関連付けが `IN_PROGRESS` の場合、S3 バケットへのデータのコピーが開始します。
エクスポートされたデータは、次のパス構造を使用して書き込まれます。
+ \$1BucketNameAndFolderName\$1
+ \$1AwsAccountId\$1
+ \$1DomainName\$1
+ \$1RequestTimestamp\$1
+ \$1lStartTime\$1-\$1EndTime\$1
+ \$1ObjectTypeName\$1
+
以下はパスの例です。
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## 一括エクスポートジョブを更新する
ジョブが完了したら、データ統合の関連付けを別のデータプルの開始時刻とデータプルの終了時刻で更新できます。これにより、新しい一括エクスポートジョブが作成されます。これは、過去に一括エクスポートを実行し、前回のエクスポート以降に更新されたデータのみをエクスポートする場合に実行できます。例えば、前回の一括エクスポートジョブが 3 か月前の場合、データ統合の関連付けを 3 か月前から今日までの時間範囲で更新できます。
[UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html) API を呼び出すか、[update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html) CLI コマンドを実行してエクスポートジョブを更新できます。
次のコードサンプルは、[update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html) CLI コマンドを実行する方法を示しています。
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01" \
--data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \
--execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
```
## 一括エクスポートジョブを削除またはキャンセルする - サポートされていません
一括エクスポートを削除またはキャンセルすることはできません。エクスポートジョブが完了すると、エクスポートクォータにはカウントされなくなります。
# Amazon Connect Customer Profiles ドメインを削除する
マッピングを削除すると、その特定のマッピングに関連付けられているオブジェクトとデータのみが削除されます。プロファイルに複数のオブジェクトが関連付けられている場合、特定のマッピングを削除してもプロファイルデータは消去されないことがあります。特定のデータを削除する場合は、マッピングを削除しますが、プロファイルに他のマッピングからのデータが含まれている場合は、プロファイルが残る可能性があります。これにより、既存のプロファイルに追加料金が発生する場合があります。これを防ぐには、次の手順に従って Amazon Connect コンソールを使用して Customer Profiles ドメインを削除できます。
1. Amazon Connect コンソールにログインし、左側のナビゲーションペインから Customer Profiles を選択します。Customer Profiles ドメインを選択し、**[詳細を表示]** を選択します。
![\[Amazon Connect Customer Profiles のドメイン削除ページ、[詳細を表示] ドメインボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/delete-customer-profiles-domain-step1.png)
1. [**Delete domain (ドメインの削除)**] を選択します。
![\[Amazon Connect Customer Profiles のドメイン削除ページ、[ドメインの削除] ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/delete-customer-profiles-domain-step2.png)
1. ドメインを削除するには、ボックスに「*confirm*」と入力し、**[ドメインの削除]** を選択します。
![\[Amazon Connect Customer Profiles のドメイン削除ページ、確認を手動で入力した後、[ドメインの削除] 確認ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/delete-customer-profiles-domain-step3.png)
# Amazon Connect Customer Profiles の計算属性を設定する
*計算属性*は、数式を使用して他の属性から派生した値です。これらを使用して、ユーザーの集計動作を識別できます。
計算属性を作成して独自のビジネスロジックを定義し、顧客プロファイルデータを実用的なデータポイントに変換できます。これにより、インタラクティブな音声レスポンスなどの自動エクスペリエンスをパーソナライズできます。
計算属性を使用することで、顧客の過去の行動に関する主要な属性を特定できます。例えば、次のようになります。
+ 最後にアクセスしたウェブサイトまたは最後に話したエージェント
+ 優先チャンネルや問い合わせ頻度などの動作パターン
+ 新規顧客や平均チケットサイズなどの顧客価値
企業は計算属性 API を使用して、平均、カウント、最小値、最大値、平均などの一般的な集計演算を使用して新しい属性を作成できます。
計算属性は、未加工のデータをリアルタイムで自動的に実用的なデータポイントやメトリクスに変換します。コンタクトセンターの管理者は、顧客プロファイルにある未加工データに基づいて計算を定義および設定できます。これらの計算された属性により、自動音声応答（IVR）やチャットボットなどの自動化されたエクスペリエンスを簡単に構築できます。パーソナライズされたエクスペリエンスを構築し、エージェントがカスタマーの状況をより早く理解できるように支援できます。
計算属性 API が利用可能な AWS リージョンのリストについては、「」を参照してください[Customer Profiles の計算された属性 API のリージョン別の可用性](regions.md#customerprofiles_calculatedattributesregion)。 APIs
**Topics**
+ [計算属性の使用の開始](customerprofiles-calculated-attributes-admin-website.md)
+ [計算属性 API](customerprofiles-calculated-attributes-apis.md)
+ [カスタムの計算属性定義の作成](customerprofiles-calculated-attributes-creating-definition.md)
+ [計算属性値を検証する](customerprofiles-calculated-attributes-validating-values.md)
+ [デフォルトの計算属性](customerprofiles-default-calculated-attributes.md)
+ [エラーメッセージと解決策](customerprofiles-calculated-attributes-troubleshooting.md)
# Amazon Connect Customer Profiles の計算属性の開始方法
計算属性を使用して独自のビジネスロジックを定義し、顧客プロファイルデータを実用的なデータポイントに変換して、インタラクティブな音声応答などの自動化されたエクスペリエンスをパーソナライズできます。
計算属性を使用することで、顧客の過去の動作、動作パターン、顧客価値に関する主要な属性を特定できます。
このセクションのトピックでは、計算属性を作成、表示、編集、削除する方法について説明します。
**Topics**
+ [計算属性を作成する](calculated-attributes-admin-website-create.md)
+ [イベントフィルターを設定する](calculated-attributes-admin-website-event-filters.md)
+ [計算属性を表示する](calculated-attributes-admin-website-view.md)
+ [計算属性を編集する](calculated-attributes-admin-website-edit.md)
+ [計算属性を削除する](calculated-attributes-admin-website-delete.md)
# Amazon Connect で計算属性を作成する
1. 前提条件: 必要なセキュリティプロファイルのアクセス許可があることを確認します。詳細については、「[Amazon Connect Customer Profiles で計算属性のアクセス許可を更新する](security-profile-customer-profile-calc-attribs.md)」を参照してください。
1. Amazon Connect 管理ウェブサイトで、**Customer Profiles**、**計算属性**に移動し、**計算属性**テーブルビューで属性**の作成**を選択します。
![\[エージェントワークスペースの Customer Profiles タブ、関連付けボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-create-1.png)
1. 計算属性を作成するには、名前を割り当て、属性に関する詳細説明 (オプション) を追加し、必要なフィールドを選択します。
+ **計算:** 属性の計算方法 (平均/数/合計/最小/最初の発生/最後の発生/最大発生数) を定義します。
+ **属性:** 顧客プロファイルデータからのデータポイント。
**注記**
標準オブジェクトタイプ (`_asset`、`_case`、`_order`) から属性を選択する場合、属性名は PascalCase である必要があります。つまり、属性名に含まれる各単語の最初の文字は、`_case.CreatedBy` や `_order.TotalPrice` のように大文字になります。
![\[エージェントワークスペースの Customer Profiles タブ、関連付けボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-create-2.png)
1. さらに、**プラスアイコンをクリックすると、別の属性を追加できます。最大 2 つの属性を選択して計算し、演算子で組み合わせることができます。*プラス*や*マイナス*などの演算子を指定して属性値を結合します。
![\[エージェントワークスペースの Customer Profiles タブ、関連付けボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-create-3.png)
1. 計算を選択したら、オプションでイベント数、期間、ソースタイムスタンプを設定できます。計算属性はデフォルトで、無制限のイベント、無制限の期間、および取り込み日に基づくタイムスタンプを使用するように設定されています。
指定した期間に 1 つ以上のイベントが発生すると、出力が返されます。
+ **イベント数:** 制限を設定する、または無制限 (デフォルト) を使用する
+ **期間:** 特定の期間を設定する、または無制限 (デフォルト) を使用する
+ **ソースタイムスタンプ:** 特定のタイムスタンプフィールド、または取り込み日 (デフォルト) を選択する
**注記**
イベント制限はありませんが、最も古いデータが新しいデータに置き換えられるデータサイズ制限があります。ソースタイムスタンプは、作成後に変更することはできません。
![\[エージェントワークスペースの Customer Profiles タブ、関連付けボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-create-4.png)
1. 必要に応じて、関連するイベントのみを計算に含める基準を定義できます。詳細については「[イベントフィルターを設定する](calculated-attributes-admin-website-event-filters.md)」を参照してください。
1. **[作成]** を選択して、計算属性を作成します。
1. 計算属性の作成が正常に完了すると、セグメントまたはフローで計算属性を使用するためのバナーがテーブルビューに表示されます。また、準備状況に基づく計算属性のステータスを表示することもできます。
![\[計算属性が作成されたことを示すバナー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-create-5.png)
# イベントフィルターを設定する
イベントフィルターを使用すると、計算属性で使用するプロファイルオブジェクトをフィルタリングできます。例えば、イベントフィルターで顧客の標準アセットオブジェクトをフィルタリングして、**ステータスがインストール済みまたは登録済み**のアセットのみが計算に含まれるようにすることができます。
**注記**
計算属性の定義を作成した後でイベントフィルターを編集することはできません。
計算属性を作成する際に、1 つまたは複数のイベントフィルターを作成できます。イベントフィルターは、以下のコンポーネントで構成されています。
![\[イベントフィルターコンポーネント。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-event-filters-1.png)
+ **フィルターグループ**: プロファイルオブジェクトに適用するフィルターのグループ。OR 関係によって接続されている複数のフィルターグループを追加できます。
+ **フィルター**: 属性、演算子、値を指定して、計算属性の計算に含まれるプロファイルオブジェクトをフィルタリングします。ユースケースに必要な数のフィルターを追加できます。
+ **属性**: フィルタリングするオブジェクトの属性。Customer Profiles ドメインに保存されているオブジェクトから属性を選択するか、オブジェクトタイプ定義で定義されているフィールド名を使用できます。オブジェクトタイプのマッピングの詳細については、「[Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細](object-type-mapping-definition-details.md)」を参照してください。
**注記**
Amazon Connect 管理ウェブサイトでは、属性ドロップダウンに、プロファイルオブジェクトが最後に保存または更新された時刻のタイムスタンプが 属性で表示されます。
プロファイルオブジェクトの属性と同じ名前のオブジェクトタイプのフィールドの両方がある場合、イベントフィルターはフィルタリングでオブジェクトタイプのフィールド名を優先します。例えば、プロファイルオブジェクトに **Status** という名前の属性があり、**Status** という名前のオブジェクトタイプフィールドがある場合、フィルターはフィルタリングにオブジェクトタイプフィールド **Status** を使用します。
+ **演算子** - 演算子は入力された値と属性の関係を決定します。詳細については、「[フィルター演算子](#calculated-attributes-admin-website-event-filter-operators)」を参照してください。
+ **値** — オブジェクトをフィルタリングする値。OR 関係によって接続された複数の値を指定できます。例えば、*アセットのステータスはインストール済みまたは登録済み*。値は大文字と小文字が区別されます。例えば、*Asset's Status is Installed* と *Asset's Status is installed* は異なる結果を返します。プロファイルオブジェクトを表示するには、Amazon Connect Customer Profiles の [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html) API を使用します。
オプションで、最大 2 つのイベントフィルターを作成し、それらの間の関係 (AND/OR/EXCLUDE) を作成できます。関係の詳細については、「[イベントフィルター間の関係](#calculated-attributes-admin-website-relationship-between-event-filters)」を参照してください。
## フィルター演算子
演算子は、入力された値と属性の関係を決定します。以下の表で、利用できる演算子について説明します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/calculated-attributes-admin-website-event-filters.html)
**注記**
Amazon Connect 管理ウェブサイトの計算された属性は、すべての時間ベースのフィルターに UTC タイムゾーンとデフォルトの時刻の 00:00:00 UTC を使用します。日付でフィルタリングできますが、時刻は同じ値として記録されます。2024-01-01 と日付を入力すると、コンソールは 2024-01-01T00:00:00Z として時刻を渡します。
**注記**
デフォルトでは、イベントフィルターはプロファイルオブジェクトが保存または更新されたときに評価されます。例えば、`PurchaseDate` が過去 1 週間以内の標準アセットオブジェクトをフィルタリングする場合、相対時間は*アセットオブジェクトが保存または更新された時点から過去 1 週間以内*として計算されます。つまり、フィルタリング結果は、オブジェクトの保存または更新のタイミングによって異なる場合があります。
## イベントフィルター間の関係
必要に応じて、2 番目のイベントフィルターを追加し、1 番目のイベントフィルターとの関係を定義できます。 Amazon Connect 管理ウェブサイトで計算属性を作成する場合、計算属性ごとに最大 2 つのイベントフィルターを設定できます。2 番目のイベントフィルターを計算属性に追加する場合は、2 つのイベントフィルターの接続を指定する 2 つの方法のいずれかを選択できます。
+ **AND 関係** — AND 関係を使用して 2 つのイベントフィルターを接続する場合、1 番目と 2 番目のイベントフィルターの両方を満たすオブジェクトが計算に含まれます。
+ **OR 関係** — OR 関係を使用して 2 つのイベントフィルターを接続する場合、1 番目または 2 番目のイベントフィルターのいずれかを満たすオブジェクトが計算に含まれます。
+ **EXCLUDE 関係** — EXCLUDE 関係を使用して 2 つのイベントフィルターを接続する場合、最初のイベントフィルターは満たすが、2 番目のイベントフィルターは満たさないオブジェクトが計算に含まれます。
## 次の手順
+ [フローエディタを介してコンタクトセンターで計算属性を使用する](https://docs.aws.amazon.com/connect/latest/adminguide/customer-profiles-block.html#customer-profiles-block-properties-get-calculated-attributes)
+ [計算属性を使用して顧客セグメントを定義する](https://docs.aws.amazon.com/connect/latest/adminguide/segmentation-admin-website)
+ [Amazon Connect で計算属性を表示する](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-view.html)
+ [Amazon Connect で計算属性を編集する](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-edit.html)
+ [Amazon Connect で計算属性を削除する](https://docs.aws.amazon.com/connect/latest/adminguide/calculated-attributes-admin-website-delete.html)
# Amazon Connect で計算属性を表示する
1. https://*instance name*.my.connect.aws/ で Amazon Connect 管理者ウェブサイトにログインします。管理者アカウント、またはセキュリティプロファイルに **Customer Profiles - 計算属性** のアクセス許可を持つアカウントを使用します。
1. Amazon Connect の左側のナビゲーションペインで、**[Customer Profiles]**、**[計算属性]** の順に選択します。
1. **[計算属性]** ページで、表の **[名前]** 列から計算属性を選択します。
次の図は、**[名前]** 列に一覧表示されている計算属性の例を示しています。
![\[計算属性を一覧表示する表。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-view-1.png)
1. これで、選択した属性の詳細を確認できます。次の図は、計算属性の詳細ページを示しています。
![\[計算属性の詳細ビュー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-view-2.png)
# Amazon Connect で計算属性を編集する
1. 計算属性を編集するには、**[編集]** ボタンを有効にするラジオボタンをオンにして、テーブルビュー内の属性を選択します。**[編集]** を選択します。
![\[計算属性を編集する\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-1.png)
1. **[説明]**、**[イベントの数]**、**[期間]** を編集できます。終了したら、**[保存]** を選択します。
![\[計算属性を編集します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-edit-2.png)
# Amazon Connect で計算属性を削除する
1. 計算属性を削除するには、削除する属性の横にあるラジオボタンをオンにして、テーブル内の属性を選択します。
1. 選択したら、**[削除]** をクリックします。
1. **[属性を削除]** ポップアップ画面で詳細を検証して、**「confirm」と入力して **[削除]** ボタンを有効にします。
![\[計算属性を削除します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/calculated-attributes-admin-website-delete-1.png)
1. **[削除]** を選択します。
# Amazon Connect Customer Profiles の計算属性 API
次の Customer Profiles の計算された属性 API を使用できます
------
#### [ CreateCalculatedAttributeDefinition ]
**CreateCalculatedAttributeDefinition**
新しい計算された属性を作成します。これには、ドメイン内の既存のオブジェクトタイプが必要です。1 つのソースオブジェクトから取得する属性と、それらにまとめて適用する数学演算を定義できます。また、時間範囲やオブジェクト数も定義できます。
作成後、Customer Profiles に取り込まれた新しいオブジェクトデータが計算された属性に含まれます。このデータは `GetCalculatedAttributeForProfile` API を使用してプロファイル用に取得できます。履歴データも使用するには、`UseHistoricalData` を true に指定します。API レスポンスの `Readiness` フィールドと `Status` フィールドには、計算属性に履歴データを含めるステータスに関する情報が表示されます。
計算された属性を定義すると、ドメイン内のすべてのプロファイルで使用できるようになります。それぞれの計算された属性は、1 つの ObjectType と、その ObjectType から最大 2 つのフィールドのみを参照できます。
**リクエスト**
```
POST /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
```
**レスポンス**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**リクエストボディ**
+ **CalculatedAttributeName**
計算された属性の一意の (ドメインごとの) 名前。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **DisplayName**
計算された属性の表示名。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ 必須: いいえ
+ **説明**
計算された属性の説明。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 1,000
+ 必須: いいえ
+ **UseHistoricalData**
計算属性の作成前に取り込まれた履歴データを計算に含めるかどうか。
+ 型: ブール値
+ 必須: いいえ
+ **AttributeDetails**
定義に使用されている属性と、属性間の算術演算の詳細。以下のコンポーネントを参照してください。
+ **属性**
数式で指定された属性項目のリスト。
+ **AttributeItem**
数式で指定された 1 つの属性項目の詳細。
+ 名前
+ プロファイルオブジェクトタイプで定義される属性の名前。
+ タイプ: 文字列
+ **Expression**
属性リストに指定されている属性項目に対して実行される数式。式の各要素は \$1"\$1ObjectTypeName.AttributeName\$1\$1" の構造に従っている必要があります。
+ 例: `{ObjA.AttributeA} - {ObjA.AttributeB}`
+ タイプ: 文字列
+ 次の算術演算のみがサポートされています: `+ - * /`
+ 計算された属性定義を作成した後は、式を変更することはできません。
+ **条件**
計算された属性集計基準としきい値を定義します。
+ タイプ: 条件オブジェクト
+ Range
+ ObjectCount
+ Threshold
+ **[Range]** (範囲)
データが集計に含まれる相対的な期間。
+ 型: 範囲オブジェクト
+ 値: 指定した単位の時間の長さ。`ValueRange` は値を上書きします。
+ タイプ: 整数
+ 必須: いいえ
+ ValueRange: 計算属性にデータを含む相対的な期間を顧客が指定するための構造。終了点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。ValueRange は Value を上書きします。
+ 型: ValueRange
+ 必須: いいえ
+ Start
+ オブジェクトを含める開始時刻。開始点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。
+ タイプ: 整数
+ 必須: はい
+ 修了
+ オブジェクトを含める終了時刻。開始点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。
+ タイプ: 整数
+ 必須: はい
+ TimestampSource: 日付を解析する JSON オブジェクトのフィールドを指定する式。式は \$1"\$1ObjectTypeName.\$1\$1" の構造に従う必要があります。例えば、オブジェクトタイプが MyType で、ソース JSON が `{"generatedAt": {"timestamp": "1737587945945"}}` の場合、TimestampSource は `"{MyType.generatedAt.timestamp}"` である必要があります。
+ 長さの制限：最小長 1、最大長は 255 です。
+ 必須: いいえ
+ TimestampFormat: JSON オブジェクトのタイムスタンプフィールドを指定する形式。この値は、EPOCHMILLI (秒/ミリ秒レベルの精度を持つ Unix エポックタイムスタンプの場合)、または ISO\$18601 (秒/ミリ秒レベルの精度を持つ ISO\$18601 形式に従い、オプションのオフセットは Z または HH:MM または HHMM の形式) のいずれかである必要があります。例えば、オブジェクトタイプが MyType で、ソース JSON が `{"generatedAt": {"timestamp": "2001-07-04T12:08:56.235-0700"}},` の場合、TimestampFormat は `"ISO_8601"` である必要があります。
+ 単位: 時間の単位
+ 有効な値: 日
+ 必須: はい
+ 必須: はい
+ 初期スコープ: 最大 366 日
+ **ObjectCount**
計算された属性に使用されるプロファイルオブジェクトの数。
+ タイプ: 数値
+ 範囲: 1 から 100
+ 必須: いいえ
+ **Threshold**
true/false の計算された属性を生成する比較ロジック。
+ タイプ: しきい値オブジェクト
+ 値
+ しきい値の値
+ タイプ: 文字列
+ 必須: いいえ
+ オペレーター
+ しきい値の演算子
+ 型: ENUM
+ 有効な値:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ 必須: いいえ
+ **Statistic**
計算された属性に対して実行する集計操作。
+ 型: ENUM
+ 有効な値:
+ FIRST\$1OCCURRENCE
+ LAST\$1OCCURRENCE
+ COUNT
+ SUM
+ MINIMUM
+ MAXIMUM
+ AVERAGE
+ MAX\$1OCCURRENCE
------
#### [ UpdateCalculatedAttributeDefinition ]
**UpdateCalculatedAttributeDefinition**
計算された属性定義を更新します。更新は、表示名、説明、時間範囲、オブジェクト数、およびしきい値に制限されます。この API は部分更新をサポートしているため、更新が必要なパラメータのみを含める必要があります。
**注記**
Conditions を更新する場合:
計算属性の日付範囲を拡大しても、現在の日付範囲を超える履歴データは含まれないことに注意してください。
TimestampSource と TimestampFormat は、計算属性定義の作成後に更新することはできません。
**リクエスト**
```
PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
```
{
"DisplayName": "string",
"Description": "string",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
}
}
```
**レスポンス**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**リクエストボディ**
+ **DisplayName**
計算された属性の表示名。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z_][a-zA-Z_0-9-\s]*$`
+ 必須: いいえ
+ **説明**
計算された属性の説明。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 1,000
+ 必須: いいえ
+ **条件**
計算された属性集計基準としきい値を定義します。
+ タイプ: 条件オブジェクト
+ Range
+ ObjectCount
+ Threshold
+ **[Range]** (範囲)
データが集計に含まれる相対的な期間。
+ タイプ: 範囲オブジェクト
+ 値: 指定した単位の時間の長さ
+ タイプ: 整数
+ 必須: いいえ
+ ValueRange: 計算属性にデータを含む相対的な期間を顧客が指定するための構造。終了点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。ValueRange は Value を上書きします。
+ 型: ValueRange
+ 必須: いいえ
+ Start
+ オブジェクトを含める開始時刻。開始点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。
+ タイプ: 整数
+ 必須: はい
+ 修了
+ オブジェクトを含める終了時刻。開始点が過去のものであることを示すには正の数値を使用し、将来のものであることを示すには負の数値を使用します。
+ タイプ: 整数
+ 必須: はい
+ 単位: 時間の単位
+ 有効な値: 日
+ 必須: はい
+ 必須: はい
+ 初期スコープ: 最大 366 日
+ **ObjectCount**
計算された属性に使用されるプロファイルオブジェクトの数。
+ タイプ: 数値
+ 範囲: 1 から 100
+ 必須: いいえ
+ **Threshold**
true/false の計算された属性を生成する比較ロジック。
+ タイプ: しきい値オブジェクト
+ 値
+ しきい値の値
+ タイプ: 文字列
+ 必須: いいえ
+ オペレーター
+ しきい値の演算子
+ 型: ENUM
+ 有効な値:
+ GREATER\$1THAN
+ LESS\$1THAN
+ EQUAL\$1TO
+ NOT\$1EQUAL\$1TO
+ 必須: いいえ
------
#### [ GetCalculatedAttributeDefinition ]
**GetCalculatedAttributeDefinition**
計算された属性定義を取得します。
**リクエスト**
```
GET /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**リクエストボディ**
```
The request does not have a request body.
```
**レスポンス**
```
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Unit": "string",
"Value": number
"ValueRange"
{
"Start": number
"End": number
},
"TimestampFormat": "string",
"TimestampSource": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"UseHistoricalData" boolean,
"Status": "PREPARING" | "IN_PROGRESS" | "COMPLETED" | "FAILED",
"Readiness": {
"ProgressPercentage": number,
"Message": "string",
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
```
**URI リクエストパラメータ**
+ **DomainName**
ドメインの一意の名前。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **CalculatedAttributeName**
計算された属性の一意の (ドメインごとの) 名前。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
------
#### [ DeleteCalculatedAttributeDefinition ]
**DeleteCalculatedAttributeDefinition**
既存の計算された属性定義を削除します。デフォルトの計算された属性を削除することは可能ですが、いったん削除するとそのアクションを元に戻すことはできず、元に戻す場合は `CreateCalculatedAttributeDefinition` API を使用して自分で再作成する必要があることに注意してください。
**リクエスト**
```
DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName
```
**リクエストボディ**
```
The request does not have a request body.
```
**レスポンス**
```
The response does not have a response body.
```
**URI リクエストパラメータ**
+ **DomainName**
ドメインの一意の名前。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **CalculatedAttributeName**
計算された属性の一意の (ドメインごとの) 名前。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
------
#### [ ListCalculatedAttributeDefinitions ]
**ListCalculatedAttributeDefinitions**
ドメインのすべての計算された属性定義を取得します。
**リクエスト**
```
GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**リクエストボディ**
```
The request does not have a request body.
```
**レスポンス**
```
{
"Items": [
{
"UseHistoricalData": boolean,
"ReadinessStatus": PREPARING | IN_PROGRESS | COMPLETED | FAILED,
"CalculatedAttributeName": "string",
"CreatedAt": number,
"Description": "string",
"DisplayName": "string",
"LastUpdatedAt": number,
"Tags": {
"string" : "string"
}
}
],
"NextToken": "string"
}
```
**URI リクエストパラメータ**
+ **DomainName**
ドメインの一意の名前。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **MaxResults**
ページごとに返されるオブジェクトの最大数。
+ 有効範囲: 最小値 1 最大値 100
+ **NextToken**
前回の ListCalculatedAttributeDefinition API 呼び出しからのページ分割トークン。
+ 長さの制限：最小長 1、最大長 1,024
------
#### [ GetCalculatedAttributeForProfile ]
**GetCalculatedAttributeForProfile**
計算を開始し、1 つのプロファイルの 1 つの計算された属性の結果を取得します。
**リクエスト**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName
```
**リクエストボディ**
```
The request does not have a request body.
```
**レスポンス**
```
{
"Name": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial": "string",
"LastObjectTimestamp" : number
}
```
**URI リクエストパラメータ**
+ **DomainName**
ドメインの一意の名前。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **CalculatedAttributeName**
計算された属性の一意の (ドメインごとの) 名前。
+ タイプ: 文字列
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
------
#### [ ListCalculatedAttributesForProfile ]
**ListCalculatedAttributesForProfile**
計算を開始し、1 つのプロファイルのすべての計算された属性の結果を取得します。
**リクエスト**
```
GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken
```
**リクエストボディ**
```
The request does not have a request body.
```
**レスポンス**
```
{
"Items": [
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Value": "string",
"IsDataPartial" : "string",
"LastObjectTimestamp" : number
},
...
],
"NextToken": "string"
}
```
**URI リクエストパラメータ**
+ **DomainName**
ドメインの一意の名前。
+ 長さの制限：最小長 1、最大長 64
+ パターン: `^[a-zA-Z0-9_-]+$`
+ 必須: はい
+ **ProfileId**
+ パターン: `[a-f0-9]{32}`
+ 必須: はい
+ **MaxResults**
ページごとに返されるオブジェクトの最大数。
+ 有効範囲: 最小値 1 最大値 100
+ **NextToken**
前回の ListCalculatedAttributeDefinition API 呼び出しからのページ分割トークン。
+ 長さの制限：最小長 1、最大長 1,024
------
# Amazon Connect Customer Profiles のカスタムの計算属性定義を作成する
Customer Profiles の [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) API を使用すると、カスタムオブジェクトタイプに基づいて独自の計算された属性をプログラムで作成できます。
このトピックでは、カスタム JSON ファイルを使用して計算された属性を作成する方法を示します。
## ステップ 1: JSON ファイルを作成する
次の内容を含む JSON ファイルを作成します。
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"UseHistoricalData": true,
"DisplayName": "your-display-name",
"Description": "your-description",
"AttributeDetails": {
"Attributes": [
{
"Name": "your-attribute-name"
}
],
"Expression": "{your-object-type.your-attribute-name}"
},
"Statistic": "your-statistic",
"Conditions": {
"Range": {
"ValueRange"
{
"Start": your-range-start
"End": your-range-end
},
"TimestampSource": "{your-object-type.your-timestamp-source}",
"Unit": "days"
},
"ObjectCount": your-object-count,
"Threshold": {
"Value": "your-threshold-value",
"Operator": "your-threshold-operator"
}
}
}
```
JSON を独自の値でカスタマイズするには、以下のガイドラインに従います。
+ **属性**:これには、計算された属性に使用するオブジェクトタイプのフィールドの名前が含まれている必要があります。このリストで参照されている 2 つの属性がサポートされています。
+ **式**: 属性間で実行する基本的な数式がサポートされています。属性が 1 つしかない場合はこのフィールドに `{ObjectTypeName.AttributeName}`、それ以外の数式を念頭に置いている場合は、このフィールドには両方の属性を含める必要があります。
+ **統計**: これは、実際に集計操作を実行する計算 API のいずれかを呼び出す時に実行される操作です。ほとんどは一目瞭然ですが、そうでないものについては説明を追加しました。
**サポート対象の統計情報**
+ `FIRST_OCCURRENCE` は、最も古い取り込みオブジェクトの式で指定された属性を返します。
+ `LAST_OCCURRENCE` は、最新の取り込みオブジェクトの式で指定された属性を返します。
+ `COUNT` は、選択したデータからカウントを返します。
+ `SUM` は、選択したデータの合計を返します。
+ `MINIMUM` は、選択したデータから最小値を返します。
+ `MAXIMUM` は、選択したデータから最大値を返します。
+ `AVERAGE` は、選択したデータから平均を返します。
+ `MAX_OCCURRENCE` は、式で指定されている最も頻繁に出現する値を返します。
+ **範囲**:
+ 単位: 現在は DAYS 単位のみをサポートしています。
+ ValueRange: ValueRange の開始または終了フィールドに、開始する日付までの日数を示す正の数値と、開始する将来の日付までの日数を示す負の数値を指定します。
+ TimestampSource: 日付を解析する JSON オブジェクトのフィールドを指定する式。式は \$1"\$1ObjectTypeName.\$1\$1" の構造に従う必要があります。例えば、オブジェクトタイプが MyType で、ソース JSON が `{"generatedAt": {"timestamp": "1737587945945"}}` の場合、TimestampSource は `"{MyType.generatedAt.timestamp}"` である必要があります。
+ **ObjectCount**: 計算された属性計算の基準となるオブジェクトの数を示します。
+ **しきい値**: 正確に計算された属性値の代わりに、例えば特定の値よりも大きいかどうかを知りたい場合は、しきい値を使用できます。
しきい値には任意の文字列を指定でき、次のしきい値演算子がサポートされています。
+ `GREATER_THAN`
+ `LESS_THAN`
+ `EQUAL_TO`
+ `NOT_EQUAL_TO`
+ UseHistoricalData: 計算属性の作成前に取り込まれた履歴データを計算に含めるかどうか。
## ステップ 2: CreateCalculatedAttributeDefinition API を呼び出す
値を使用して JSON ファイルを作成し、カスタマイズしたら、次の例に示すように [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) API を呼び出します。
```
aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name
```
以下のエンドポイントを使用することもできます。
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes
```
# API を使用して Amazon Connect Customer Profiles の計算属性値を検証する
`GetCalculatedAttributeForProfile` と `ListCalculatedAttributesForProfile` の 2 つの API はプロファイルレベルにあります。
+ **GetCalculatedAttributeForProfile** - 1 つのプロファイルについて単一の計算された属性を取得します。
+ **ListCalculatedAttributesForProfile** - 1 つのプロファイルの計算された属性のリストを取得します
有効なプロファイル ID があれば、計算された属性の値が表示されます。
**レスポンスの例**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"IsDataPartial": "true",
"Value": "24144"
}
```
**IsDataPartial** - このフラグは、時間範囲 (30 日) またはオブジェクト数のいずれかが達成されていないため、計算された属性がまだ計算中であることを示します。例えば、30 日間の平均を求める場合、30 日が経過した後にのみ、`IsDataPartial` フィールドは false に設定されます。
## 計算された属性のリストの取得
**CLI AWS を使用する**
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --profile-id your-profile-id
```
**カスタム AWS JSON ファイルで CLI を使用する**
次の内容を含む JSON ファイルを作成します。
```
{
"DomainName": "your-domain-name",
"ProfileId" "some-profile-id"
}
```
```
aws customer-profiles list-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**エンドポイント**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/
```
## 1 つの計算された属性を取得
**CLI AWS を使用します**。
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --domain-name your-domain-name --calculated-attribute-name your-calculated-attribute-name --profile-id your-profile-id
```
**カスタム AWS JSON ファイルで CLI を使用します**。
次の内容を含む JSON ファイルを作成します。
```
{
"DomainName": "your-domain-name",
"CalculatedAttributeName": "your-calculated-attribute-name",
"ProfileId" "your-profile-id"
}
```
```
aws customer-profiles get-calculated-attributes-for-profile --region your-region --cli-input-json file://list_calculated_attributes_for_profile_cli.json
```
**エンドポイント**
```
https://profile.your-region.amazonaws.com/domains/your-domain-name/profile/your-profile-id/calculated-attributes/your-calculated-attribute-name
```
# Amazon Connect Customer Profiles のデフォルトの計算属性
## デフォルトの CTR 計算属性
Amazon Connect Customer Profiles は、問い合わせレコードに基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**最も頻繁なチャンネル**
```
{
"CalculatedAttributeName": "_most_frequent_channel",
"DisplayName": "Most frequent channel",
"Description": "Returns customer's frequently used communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**最後のチャンネル**
```
{
"CalculatedAttributeName": "_last_channel",
"DisplayName": "Last channel",
"Description": "Returns customer's last communication channel. Channels include voice, chat, task.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "channel"
}
],
"Expression": "{CTR.channel}"
},
"Tags": {
}
}
```
**最後のエージェント識別子**
```
{
"CalculatedAttributeName": "_last_agent_id",
"DisplayName": "Last agent identifier",
"Description": "Returns identifier of the last agent customer connected with.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.id"
}
],
"Expression": "{CTR.agent.id}"
},
"Tags": {
}
}
```
**頻繁な発信者**
```
{
"CalculatedAttributeName": "_frequent_caller",
"DisplayName": "Frequent caller",
"Description": "Returns true or false based on the number of times a customer has called.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "COUNT",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": {
"Value": "5",
"Operator": "GREATER_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "contactId"
}
],
"Expression": "{CTR.contactId}"
},
"Tags": {
}
}
```
**平均保留時間**
```
{
"CalculatedAttributeName": "_average_hold_time",
"DisplayName": "Average hold time",
"Description": "Returns customer's average hold time for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Tags": {
}
}
```
**平均通話時間**
```
{
"CalculatedAttributeName": "_average_call_duration",
"DisplayName": "Average call duration",
"Description": "Returns customer's average call duration for voice calls.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "AVERAGE",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null
},
"AttributeDetails": {
"Attributes": [
{
"Name": "disconnectTimestamp"
},
{
"Name": "initiationTimestamp"
}
],
"Expression": "{CTR.disconnectTimestamp} - {CTR.initiationTimestamp}"
},
"Tags": {
}
}
```
**顧客の最大保留時間**
```
{
"CalculatedAttributeName": "_maximum_hold_time",
"DisplayName": "Customer's maximum hold time",
"Description": "Returns customer's maximum hold time for voice calls in the past month.",
"AttributeDetails": {
"Attributes": [
{
"Name": "agent.customerHoldDurationMillis"
},
{
"Name": "queue.durationMillis"
}
],
"Expression": "{CTR.agent.customerHoldDurationMillis} + {CTR.queue.durationMillis}"
},
"Statistic": "MAXIMUM",
"Conditions": {
"Range": {
"Value": 30,
"Unit": "DAYS"
},
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## デフォルトのプロファイル計算属性
Amazon Connect Customer Profiles は、プロファイルに基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**新規顧客**
```
{
"CalculatedAttributeName": "_new_customer",
"DisplayName": "New customer",
"Description": "Returns true or false for new customer profiles created.",
"CreatedAt": null,
"LastUpdatedAt": null,
"Statistic": "TIME_DIFFERENCE_FROM_NOW",
"Conditions": {
"ObjectCount": null,
"Threshold": {
"Value": "30",
"Operator": "LESS_THAN"
}
},
"AttributeDetails": {
"Attributes": [
{
"Name": "createdAt"
}
],
"Expression": "{_profile.createdAt}"
},
"Tags": {
}
}
```
## デフォルトのアセット計算属性
Amazon Connect Customer Profiles は、アセットに基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**アセットの数**
```
{
"CalculatedAttributeName": "_assets_count",
"DisplayName": "Count of assets",
"Description": "Returns the count of assets for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetId"
}
],
"Expression": "{_asset.AssetId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**最初のアセット購入日**
```
{
"CalculatedAttributeName": "_asset_first_occurrence",
"DisplayName": "First asset purchased date",
"Description": "Returns purchase date of the customer's first asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最後のアセット購入日**
```
{
"CalculatedAttributeName": "_asset_last_occurrence",
"DisplayName": "Last asset purchased date",
"Description": "Returns purchase date of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "PurchaseDate"
}
],
"Expression": "{_asset.PurchaseDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**合計アセット価格**
```
{
"CalculatedAttributeName": "_assets_price_sum",
"DisplayName": "Total asset price",
"Description": "Returns customer's total asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "SUM",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**平均アセット価格**
```
{
"CalculatedAttributeName": "_assets_price_average",
"DisplayName": "Average asset price",
"Description": "Returns customer's average asset price.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Price"
}
],
"Expression": "{_asset.Price}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最初のアセット名**
```
{
"CalculatedAttributeName": "_assets_name_first_occurrence",
"DisplayName": "First asset name",
"Description": "Returns name of the customer's first asset",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最後のアセット名**
```
{
"CalculatedAttributeName": "_assets_name_last_occurrence",
"DisplayName": "Last asset name",
"Description": "Returns name of the customer's last asset.",
"AttributeDetails": {
"Attributes": [
{
"Name": "AssetName"
}
],
"Expression": "{_asset.AssetName}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
## デフォルトのケース計算属性
Amazon Connect Customer Profiles は、ケースに基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**ケースの数**
```
{
"CalculatedAttributeName": "_cases_count",
"DisplayName": "Count of cases",
"Description": "Returns the count of customer's cases for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**最初のケース作成日**
```
{
"CalculatedAttributeName": "_case_first_occurrence",
"DisplayName": "First case created date",
"Description": "Returns created date of the customer's first case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最後のケース作成日**
```
{
"CalculatedAttributeName": "_case_last_occurrence",
"DisplayName": "Last case created date",
"Description": "Returns created date of the customer's last case.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_case.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**オープンケースの数**
```
{
"CalculatedAttributeName": "_cases_open_status_count",
"DisplayName": "Count of open cases",
"Description": "Returns the count of customer's open cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**クローズされたケースの数**
```
{
"CalculatedAttributeName": "_cases_closed_status_count",
"DisplayName": "Count of closed cases",
"Description": "Returns the count of customer's closed cases.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CaseId"
}
],
"Expression": "{_case.CaseId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Status": {
"DimensionType": "INCLUSIVE",
"Values": ["Closed"]
}
}
}
]
}
]
},
"Launched": false
}
```
## デフォルトのコミュニケーションレコード計算属性
Amazon Connect Customer Profiles は、通信レコードに基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**最終 E メール開封日**
```
{
"CalculatedAttributeName": "_campaign_email_last_open",
"DisplayName": "Last email open date",
"Description": "Returns the last email open date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.Open.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.Open.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**E メール開封数**
```
{
"CalculatedAttributeName": "_campaign_email_open_count",
"DisplayName": "Email open count",
"Description": "Returns the number of times emails were opened by a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Open.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Open"]
}
}
}
]
}
]
},
"Launched": false
}
```
**E メール配信数**
```
{
"CalculatedAttributeName": "_campaign_email_delivery_count",
"DisplayName": "Email delivery count",
"Description": "Returns the number of times emails were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:Email"]
},
"Events.Delivery.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["Delivery"]
}
}
}
]
}
]
},
"Launched": false
}
```
**SMS 配信数**
```
{
"CalculatedAttributeName": "_campaign_sms_delivery_count",
"DisplayName": "SMS delivered count",
"Description": "Returns the number of times SMS were delivered to a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CommunicationRecordId"
}
],
"Expression": "{_communicationRecord.CommunicationRecordId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ALL",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_DELIVERED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_DELIVERED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**最後の SMS ブロック日**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop",
"DisplayName": "Last SMS blocked date",
"Description": "Returns the last SMS blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
**キャリアによる最後の SMS ブロック日**
```
{
"CalculatedAttributeName": "_campaign_sms_last_stop_carrier",
"DisplayName": "Last SMS carrier blocked date",
"Description": "Returns the last SMS carrier blocked date of the customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "Events.TEXT_CARRIER_BLOCKED.UpdatedDate"
}
],
"Expression": "{_communicationRecord.Events.TEXT_CARRIER_BLOCKED.UpdatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Filter": {
"Include": "ANY",
"Groups": [
{
"Type": "ALL",
"Dimensions": [
{
"Attributes": {
"Attributes.ChannelSubType": {
"DimensionType": "INCLUSIVE",
"Values": ["connect:SMS"]
},
"Events.TEXT_CARRIER_BLOCKED.EventType": {
"DimensionType": "INCLUSIVE",
"Values": ["TEXT_CARRIER_BLOCKED"]
}
}
}
]
}
]
},
"Launched": false
}
```
## デフォルトの注文計算属性
Amazon Connect Customer Profiles は、注文に基づいてout-of-the使用できるデフォルトの属性を提供します。属性は次のとおりです。
**注文の数**
```
{
"CalculatedAttributeName": "_orders_count",
"DisplayName": "Count of orders",
"Description": "Returns the count of orders for a customer.",
"AttributeDetails": {
"Attributes": [
{
"Name": "OrderId"
}
],
"Expression": "{_order.OrderId}"
},
"Statistic": "COUNT",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**最初の注文作成日**
```
{
"CalculatedAttributeName": "_order_first_occurrence",
"DisplayName": "First order created date",
"Description": "Returns created date of the customer's first order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "FIRST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**最後の注文作成日**
```
{
"CalculatedAttributeName": "_order_last_occurrence",
"DisplayName": "Last order created date",
"Description": "Returns created date of the customer's last order.",
"AttributeDetails": {
"Attributes": [
{
"Name": "CreatedDate"
}
],
"Expression": "{_order.CreatedDate}"
},
"Statistic": "LAST_OCCURRENCE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
**すべての注文の合計価格**
```
{
"CalculatedAttributeName": "_orders_total_price_sum",
"DisplayName": "Total price of all orders",
"Description": "Returns sum of total price for all customer's orders.",
"Statistic": "SUM",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold":null
},
"Launched": false
}
```
**合計価格の注文平均**
```
{
"CalculatedAttributeName": "_orders_total_price_average",
"DisplayName": "Orders average of total price",
"Description": "Returns average of total price for all customer's orders.",
"AttributeDetails": {
"Attributes": [
{
"Name": "TotalPrice"
}
],
"Expression": "{_order.TotalPrice}"
},
"Statistic": "AVERAGE",
"Conditions": {
"Range": null,
"ObjectCount": null,
"Threshold": null
},
"Launched": false
}
```
# Amazon Connect Customer Profiles の計算属性のエラーメッセージと解決策
次の表は、各エラーの計算された属性エラーメッセージ、原因、および解決方法を示しています
| エラーメッセージ | 原因 | 解決策 |
| --- | --- | --- |
| プロファイルの計算属性を取得すると NULL 値が表示される | これは、計算された属性にデータがないことが原因と考えられます。計算された属性を作成したら、新しいデータを取り込む必要があります。 | 統合または CreateProfile および PutProfileObject API を使用して、新しいデータを取り込んだり、古いデータを再取り込みします。 |
# Amazon Connect Customer Profiles で顧客セグメントを設定する
*顧客セグメント*は、特定の属性を共有する顧客のグループです。例えば、顧客セグメントには、特定の都市に住むすべての顧客、または頻繁に電話をかけ、平均支出が 500 USD を超えるすべての顧客が含まれる場合があります。 Amazon Connect アウトバウンドキャンペーンでは、顧客セグメントにキャンペーンを送信できます。
顧客セグメントは、定義した属性に基づいて動的に評価され、属性の値が変更されると時間の経過とともに変化する可能性があります。例えば、Customer Profiles ドメインに新しいプロファイルを追加した場合、または既存のプロファイルを変更または削除した場合、その顧客セグメントのプロファイルの数は増減する可能性があります。顧客セグメントの作成の詳細については、「[Amazon Connect で顧客セグメントを構築する](customer-segments-building-segments.md)」を参照してください。
でセグメントを構築するための前提条件として Amazon Connect、管理者は AWS マネジメントコンソールでドメインを設定し、プロファイル、注文、アセット、ケースデータを Customer Profiles に取り込むように統合を設定する必要があります。詳細については、「[Amazon Connect インスタンスで Customer Profiles を有効にする](enable-customer-profiles.md)」を参照してください。データ統合を有効にすると、ドメインに送信される新しいデータに基づいて動的セグメントを引き続き生成できます。
顧客セグメントには、Amazon Connect Customer Profiles ドメインの顧客プロファイルのみが含まれます。Customer Profiles は、S3 または外部アプリケーションから取り込むか、エージェントアプリ、コンタクトフロー、または API を使用して作成できます。顧客プロファイルの詳細については、「[Amazon Connect の顧客プロファイルとは何か](customer-profiles-what-data.md)」を参照してください。
**Topics**
+ [顧客セグメントを構築する](customer-segments-building-segments.md)
+ [セグメントを管理する](customer-segments-managing-segments.md)
+ [インポートされたファイルからセグメントを作成する](customer-segments-imported-files.md)
+ [セグメントを CSV ファイルにエクスポートする](customer-segments-exporting-segments.md)
+ [セグメント AI アシスタントを使用する](customer-segments-ai-assistant.md)
+ [トラブルシューティング](customer-segments-troubleshooting.md)
# Amazon Connect で顧客セグメントを構築する
**注記**
**SQL (ベータ) を使用したセグメンテーションでは、データストアを有効にする必要があります。Customer Profiles のホームページ画面にアクセスし、上部の青いバナーからデータストアを有効にしてください。**
**注記**
Amazon Connect 管理ウェブサイトのセグメンテーションビルダーエクスペリエンスに移動するには、この機能のセキュリティプロファイルのアクセス許可が必要です。詳細については、「[顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる](security-profile-customer-profile-segmentation.md)」を参照してください。
セグメントを構築する前に、Customer Profiles ドメインの設定データ統合を使用して Customer Profiles ドメインにプロファイルを入力することをお勧めします。Customer Profiles とのデータ統合の設定方法の詳細については、「[外部アプリケーションと Amazon Connect Customer Profiles との統合](integrate-external-apps-customer-profiles.md)」を参照してください。
セグメントには、計算属性を使用してキャプチャしたイベントを含めることができます。カスタム計算属性を設定し、Customer Profiles が提供するデフォルトの計算属性を確認する方法の詳細については、「[Amazon Connect Customer Profiles の計算属性を設定する](customerprofiles-calculated-attributes.md)」を参照してください。
Amazon Connect には、顧客セグメントを構築する 2 つの方法があります。1/ Spark SQL を使用してセグメントを定義する (ベータ、データストアを有効にする必要があります）、2/ オーディエンスグループとフィルターを使用してセグメントを定義する (Classic Segmentation)。どちらの場合も、生成 AI を活用したセグメント AI アシスタントを介して自然言語プロンプトを使用できます。いずれかの方法でセグメントを定義する場合は、そのセグメントを別のセグメントに移動し、再度開始する必要があります。
## Spark SQL を使用したセグメント
Spark SQL を搭載したセグメントを使用すると、完全な Customer Profile データおよび拡張機能を使用してセグメントを定義できます。標準プロファイルオブジェクト属性とカスタムオブジェクト属性を使用できます。標準オブジェクトとカスタムオブジェクトを結合してさまざまなオブジェクトのデータを使用する、パーセンタイルなどの統計でセグメントをフィルタリングする、日付フィールドを標準化して比較するなど、SQL ベースの機能を使用することもできます。
まず、Segment Assistant AI に自然言語プロンプトを入力します。セグメント AI アシスタントは、Spark SQL への翻訳を含むセグメントを定義します。Segment Assistant AI は、セグメントの定義にかかったステップを提供し、作成しようとしていたものと一致することを検証できます。SQL、自然言語での SQL ステップ、および AI が生成した Spark SQL の概要を表示して、さらに検証に役立てることもできます。変更する場合は、自然言語プロンプトを更新するか、Spark SQL を直接編集できます。
Spark SQL セグメントを直接作成することもできます。
**Classic セグメンテーションと同様に、Spark SQL を搭載したセグメントは、セグメントメンバーシップコール、フローブロック、アウトバウンドキャンペーンで使用できます。**
**セグメントメンバーシップコール、フローブロック、または顧客イベントによって開始されたアウトバウンドキャンペーンで Spark SQL セグメントを使用すると、最後にエクスポートされたセグメント (セグメントスナップショット) が使用されます。メンバーシップに使用されるセグメントスナップショットは、作成から 1 年後に期限切れになります。4XX エラーが発生した場合は、セグメント (セグメントスナップショット) をエクスポートしていることを確認してください。**
**カスタマーセグメントによって開始されたアウトバウンドキャンペーンでは、セグメント (セグメントスナップショット) をエクスポートする必要はありません。**
### ステップ 1: 新しいセグメントを構築する
セグメント AI アシスタントで、「セグメントの作成方法」を選択すると、貴重なセグメントの作成に関する詳細なガイダンスが表示されます。「セグメントを生成したい」を選択すると、セグメントを作成する自然言語プロンプトが表示されます。
または、SQL を使用してクエリエディタで新しいセグメントを定義します。
**注 - タイムゾーンベースのアウトバウンドキャンペーンを作成する場合は、タイムゾーン属性がセグメントの出力の一部であることを確認する必要があります。**
**注 - アウトバウンドキャンペーンでセグメントを使用する場合は、セグメント出力のプロファイル IDsが一意であることを確認する必要があります**
### ステップ 2: 名前と説明を指定する
[名前] に、後で判別しやすいような顧客セグメント名を入力します。
**注 -** Amazon Connect 管理ウェブサイトは、セグメント`DisplayName`の として入力された名前を使用し、それに基づいて識別子を生成します。生成された識別子は、Customer Profiles API を使用してセグメントにアクセスする際に `SegmentDefinitionName` として使用されます。
オプションで、顧客セグメントの説明を [説明] に入力します。
### ステップ 3: セグメントを確認して検証する
セグメント AI アシスタントが使用したデータと、セグメントの生成にかかった AI モデルの手順を確認します。作成した SQL を確認して、クエリエディタでセグメントを定義することもできます。セグメントを作成できなかった場合は、正確なセグメントを作成するために提供されたフィードバックに対処します。セグメントが生成されると、Customer Profiles は自動的にセグメント見積りを作成します。
編集する場合は、「新しい会話」をクリックするか、クエリエディタで SQL を作成/編集して、新しいプロンプトを指定できます。
セグメント AI アシスタントを使用していない場合は、クエリを検証し、クエリエディタの下にある「クエリの検証と見積り」ボタンをクリックして見積りを作成できます。
**注 - Spark SQL を使用するセグメントは、他のクエリエンジンと同様に、セグメントで使用するプロファイルデータと使用する SQL の量に応じて時間がかかります (オブジェクト間での複数の結合には時間がかかります）。**
### ステップ 4: セグメントを作成する
セグメントを構築し、満足したら、右上の「セグメントの作成」ボタンを選択します。セグメントを作成したら、フローのセグメントとアウトバウンドキャンペーンのセグメントを使用して、アクション - .csv へのエクスポートを選択できます。
**注 - アウトバウンドキャンペーンまたはフローブロックでセグメントを使用する場合、セグメントが最後に作成された日時に基づいてセグメントメンバーシップがチェックされます。フローまたはキャンペーンの実行中にリアルタイムのセグメントメンバーシップチェックが必要な場合は、 Classic セグメンテーションを使用します。**
## オーディエンスグループとフィルターを使用した従来のセグメンテーション
顧客セグメントを作成する際は、初期オーディエンスを選択し、セグメントを定義するフィルターを選択してそのオーディエンスを絞り込みます。例えば、オーディエンスグループを作成し、特定の国に住んでいて、頻繁に電話をかけるすべての顧客のフィルターを選択できます。セグメントは、キャンペーンの実行時、コンタクトフローの実行時、セグメントの見積りまたはエクスポート時など、オンデマンドで再計算されます。そのため、各セグメントのサイズやメンバーシップは、時間の経過とともに変化します。
さらに、2 番目のオーディエンスグループを作成し、2 つのオーディエンスグループ間の関係 (AND、OR、または EXCLUDE) を作成して、最初のオーディエンスグループから顧客をさらに絞り込んだり、連結したり、除外したりできます。
![\[2 つのオーディエンスグループ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-building-segments-1.png)
## オーディエンスグループ
顧客セグメントを作成する際は、1 つまたは複数のオーディエンスグループを作成します。オーディエンスグループは、以下のコンポーネントで構成されます。
![\[オーディエンスグループのコンポーネントを示す概念図。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-audience-groups-1.png)
+ **初期オーディエンス**: 初期のユーザー母集団を定義する顧客セグメント。最大 5 つの初期オーディエンス、または Customer Profiles ドメイン内のすべてのプロファイルを指定できます。
+ **フィルターグループ**: 初期オーディエンスに適用するオーディエンス情報のカテゴリ。OR 関係によって接続された複数のフィルターグループを追加できます。
+ **フィルター** – フィルターは、セグメントに属するオーディエンスの数を減らします。フィルタは、ニーズに合わせてセグメントを調整する目的で、いくつでも追加できます。
顧客セグメントには 1 つ以上のオーディエンスグループが必要ですが、オプションで 2 番目のオーディエンスグループを作成し、2 つのオーディエンスグループ間の関係 (AND/OR/EXCLUDE) を作成できます。関係の詳細については、「[ステップ 5: 2 番目のオーディエンスグループを追加する (オプション)](#step-5-add-the-second-audience-group-optional)」を参照してください。
## 顧客セグメントの作成
以下の手順では、顧客セグメントの作成と設定について説明します。
+ ステップ 1: 新しいセグメントを構築する
+ ステップ 2: 名前と説明を設定する
+ ステップ 3: オーディエンスグループ 1 に含める初期オーディエンスを選択する
+ ステップ 4: フィルターグループを選択して設定する (オプション)
+ ステップ 5: オーディエンスグループ 2 を追加する (オプション)
### ステップ 1: 新しいセグメントを構築する
1. セグメントを作成するには、前提条件としてセキュリティプロファイルのアクセス許可を作成していることを確認します。詳細については、「[顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる](security-profile-customer-profile-segmentation.md)」を参照してください。さらに、セグメントのメンバーシップを最もよく視覚化するには、セグメントの作成前にデータを取り込むことをお勧めします。S3 または外部アプリケーションを介してプロファイルを取り込むには、「[顧客データを作成して、Customer Profiles に取り込む](customer-profiles-object-type-mappings.md)」または「[外部アプリケーションと Amazon Connect Customer Profiles との統合](integrate-external-apps-customer-profiles.md)」を参照してください。
1. 顧客セグメントのテーブルビューで **[セグメントを作成する]** を選択します。
![\[セグメントを作成するボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-1-build-a-new-segment-1.png)
### ステップ 2: 名前と説明を指定する
+ **[名前]** に、後で判別しやすいような顧客セグメント名を入力します。
**注記**
Amazon Connect 管理ウェブサイトは、入力された名前をセグメント`DisplayName`の として使用し、それに基づいて識別子を生成します。生成された識別子は、Customer Profiles API を使用してセグメントにアクセスする際に `SegmentDefinitionName` として使用されます。
+ オプションで、顧客セグメントの説明を **[説明]** に入力します。
![\[セグメント名セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-2-configure-specify-name-and-description-1.png)
### ステップ 3: オーディエンスグループ 1 に含める初期オーディエンスを選択する
まず、オーディエンスグループの初期オーディエンスをどのように定義するかを選択します。
1. **[オーディエンスグループ 1]** の **[オーディエンスグループ 1]** ドロップダウンリストで、オーディエンスグループに含める 1 つまたは複数のセグメントを選択するか、**[Customer Profiles のすべてのプロファイル]** を選択します。
**注記**
初期オーディエンスとして複数のセグメントを選択すると、セグメントは `OR` 関係によって接続されます。例えば、**[Premium メンバーシップの顧客]** セグメントおよび **[Basic メンバーシップの顧客]** セグメントを初期オーディエンスとして選択すると、いずれかのセグメントに含まれるすべてのプロファイルが含まれます。
![\[初期オーディエンスドロップダウンリスト。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1.png)
1. ProfileType でセグメントを作成するには、まず **[Customer Profiles のすべてのプロファイル]** を初期オーディエンスとして使用します。このアプローチにより、アカウントベースのプロファイルを効果的にフィルタリングできます。特に指定しない限り、セグメントテーションプロセスは Customer Profiles ドメイン内のすべてのプロファイルを自動的にエクスポートすることに注意してください。このデフォルトの動作により、包括的なカバレッジが保証されますが、特定のターゲットニーズに合わせて調整できます。
以下は、セグメント定義の作成方法の例です (アカウントベースまたは標準プロファイルベース)。
**すべてのアカウントベースのプロファイルをフィルタリングします (ProfileType=ACCOUNT\$1PROFILE)。**
![\[すべてのアカウントベースのプロファイルをフィルタリングします (ProfileType=ACCOUNT_PROFILE)。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-5.png)
**注記**
サブプロファイルのみを使用してセグメントを作成するには、アカウントベースのプロファイルを除外する新しいオーディエンスを作成します。例えば、`ProfileType` を含むプロファイルは PROFILE で `ProfileType` は空です。
![\[サブプロファイルのみを使用してセグメントを作成するには、アカウントベースのプロファイルを除外する新しいオーディエンスを作成します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-6.png)
**`Phone` を使用してリーチするアカウントをターゲットとするキャンペーンの例**
![\[Phone を使用してリーチするアカウントをターゲットとするキャンペーンの例\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-1-7.png)
この例では、キャンペーンは次の呼び出しシーケンスを持つ単一のアカウントを対象としています。
1. John にリーチする最初の試み (ID: 2)
1. John が応答しない場合、バックアップ連絡先として Sally (ID: 3) を呼び出します。
1. 初期オーディエンスを選択すると、**[推定オーディエンス]** セクションが更新され、対象となるプロファイルが表示されます。オーディエンスグループを編集したら、[推定オーディエンス] セクションの **[更新]** ボタンをクリックして、推定を再取得できます。
![\[推定オーディエンスセクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-3-choose-the-starting-audiences-to-include-in-audience-group-2.png)
### ステップ 4: オーディエンスフィルターを選択して適用する (オプション)
初期オーディエンスを選択したら、条件付きロジックを属性に適用することでオーディエンスをさらに絞り込むことができます。セグメントは、標準プロファイル属性、カスタムプロファイル属性、計算属性をサポートします。
![\[オーディエンスフィルター。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-1.png)
**オーディエンスフィルターを選択して設定するには、次の手順を実行します。**
1. **[属性]** では、以下のタイプの属性を選択できます。
1. **計算属性** - 計算属性のいずれかに基づいてオーディエンスをフィルタリングします。
デフォルトの計算属性、およびカスタム計算属性の設定方法については、「[Amazon Connect Customer Profiles の計算属性を設定する](customerprofiles-calculated-attributes.md)」を参照してください。
1. **標準属性** — 標準プロファイル属性のいずれかに基づいてオーディエンスをフィルタリングします。
標準プロファイル属性の一覧については、「[Amazon Connect Customer Profiles の標準プロファイル定義](standard-profile-definition.md)」を参照してください。
1. **カスタム属性** — カスタムプロファイル属性のいずれかに基づいてオーディエンスをフィルタリングします。
**注記**
ドメイン内には、最新のプロファイル属性を最大 1000 個保存できます。ドメインに大量の属性が含まれている場合、最も古い属性がこの一覧に表示されない可能性があります。
1. **[演算子]** を選択します。演算子は、入力された値と属性の関係を決定します。利用できる演算子について説明します。利用可能な演算子は、選択した属性の値のタイプによって異なります。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/customer-segments-building-segments.html)
**注記**
Amazon Connect 管理ウェブサイトの顧客セグメントは、すべての時間ベースのフィルターに UTC タイムゾーンとデフォルトの時刻の 00:00:00 UTC を使用します。日付をフィルタリング できますが、時刻は同じ値として記録されます。2024-01-01 と日付を入力すると、コンソールは 2024-01-01T00:00:00Z として時刻を渡します。
**注記**
計算属性のフィルターを指定すると、計算属性定義の期間を上書きできます。例えば、フィルター `Frequent caller is true for the event time period of 60 days` は *頻繁な発信者* [Amazon Connect Customer Profiles のデフォルトの計算属性](customerprofiles-default-calculated-attributes.md) を上書きして、[計算属性定義で設定された期間](customerprofiles-calculated-attributes-apis.md)ではなく、過去 60 日間の値を評価することができます。この上書きはセグメントに固有であり、計算属性定義自体には影響しません。
![\[評価する属性、演算子、値。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-2.png)
1. 値を指定します。`OR` 関係によって接続された複数の値を指定できます。例えば、`Address.Country` は `USA` または `Mexico` です。値の入力では、ドメインに保存されている顧客プロファイルに基づいて文字列演算子の候補がドロップダウンに表示されます。
**注記**
値は大文字と小文字が区別されます。例えば、*Address.Country is US* は *Address.Country is us* とは異なる結果を返します。
1. (オプション) このフィルターグループに追加の属性を適用するには、**[\$1 フィルター]** を選択します。フィルターの別のグループを作成するには、**[\$1グループ]** を選択します。
**注記**
フィルターグループに複数のフィルターがある場合、フィルターは AND 関係によって接続されます。例えば、「*Address.Country is USA*」と「*Customer’s average hold time is more than 10 seconds*」の 2 つのフィルターを含むフィルターグループの場合、*Address.Country* が USA で、**かつ***平均保留時間*が 10 秒を超えるプロファイルはセグメントに含まれます。
オーディエンスグループに複数のフィルターグループがある場合、管理ウェブサイトの顧客セグメントは OR Amazon Connect 関係を使用してフィルターグループ間を接続します。
![\[2 つのオーディエンスフィルター。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-4-choose-and-apply-audience-filters-optional-3.png)
1. オーディエンスグループのセットアップが完了したら、**[セグメントを作成]** を選択します。
### ステップ 5: 2 番目のオーディエンスグループを追加する (オプション)
必要に応じて、2 番目のオーディエンスグループを追加し、オーディエンスグループ 1 との関係を定義します。Amazon Connect 管理ウェブサイトを使用して顧客セグメントを作成する場合、各セグメントは最大 2 つのオーディエンスグループを持つことができます。セグメントに 2 つ目のオーディエンスグループを追加する場合、2 つのオーディエンスグループの接続方法を 2 つの方法から選択することができます。
+ **AND 関係** — AND 関係を使用して 2 つのオーディエンスを接続する場合、セグメントにはオーディエンスグループ 1 とオーディエンスグループ 2 の両方のフィルターを満たすすべてのプロファイルが含まれます。
+ **OR 関係** — OR 関係を使用して 2 つのオーディエンスを接続する場合、セグメントにはオーディエンスグループ 1 またはオーディエンスグループ 2 のフィルターを満たすすべてのプロファイルが含まれます。
+ **EXCLUDE 関係** — EXCLUDE 関係を使用して 2 つのオーディエンスを接続する場合、セグメントにはオーディエンスグループ 2 のプロファイルを除くオーディエンスグループ 1 のプロファイルが含まれます。
**2 番目のオーディエンスグループを設定するには、次の手順を実行します。**
1. オーディエンスグループ 1 を設定した後、**AND**、**OR**、または **EXCLUDE** の関係を選択します。
![\[AND、OR、または EXCLUDE オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-1.png)
1. オーディエンスグループ 2 で初期オーディエンスを選択します。詳細については、「[ステップ 3: オーディエンスグループ 1 に含める初期オーディエンスを選択する](#step-3-choose-the-starting-audiences-to-include-in-audience-group)」を参照してください。
1. (オプション) セグメントを絞り込むフィルターを選択します。詳細については、「[ステップ 4: オーディエンスフィルターを選択して適用する (オプション)](#step-4-choose-and-apply-audience-filters-optional)」を参照してください。
1. セグメントのセットアップが完了したら、[**Create segment**] を選択します。これで、セグメントが作成され、アウトバウンドキャンペーンまたはアウトバウンドフローでセグメントを使用できるようになりました。
![\[セグメントが正常に作成されたことを示すメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/step-5-add-the-second-audience-group-optional-2.png)
## Spark SQL を使用したセグメントの作成
Spark SQL を搭載したセグメントを使用すると、完全な Customer Profile データおよび拡張機能を使用してセグメントを定義できます。標準プロファイルオブジェクト属性とカスタムオブジェクト属性を使用できます。標準オブジェクトとカスタムオブジェクトを結合してさまざまなオブジェクトのデータを使用する、パーセンタイルなどの統計でセグメントをフィルタリングする、日付フィールドを標準化して比較するなど、SQL ベースの機能を使用することもできます。
まず、Segment Assistant AI に自然言語プロンプトを入力します。セグメント AI アシスタントは、Spark SQL への翻訳を含むセグメントを定義します。Segment Assistant AI は、セグメントの定義にかかったステップを提供し、作成しようとしていたものと一致することを検証できます。SQL、自然言語での SQL ステップ、および AI が生成した Spark SQL の概要を表示して、さらに検証に役立てることもできます。変更する場合は、自然言語プロンプトを更新するか、Spark SQL を直接編集できます。
Spark SQL セグメントを直接作成することもできます。
Spark SQL を搭載したセグメントは、セグメントメンバーシップコール、フローブロック、アウトバウンドキャンペーンで使用できます。セグメントが最後に作成された時点 (セグメントスナップショット) でセグメントをチェックします。4XX エラーが発生した場合は、セグメントスナップショットを実行します。
**注記**
**SQL セグメンテーションは、最大 10 年分のデータがあるデータストアで実行されます。クラシックセグメンテーションでは、最新のデータ (過去 3 年間に更新されたデータ) を使用します。**
### ステップ 1: 新しいセグメントを構築する
セグメント AI アシスタントで、「セグメントの作成方法」を選択すると、貴重なセグメントの作成に関するガイダンスが表示されます。「セグメントを生成したい」を選択すると、セグメントを作成する自然言語プロンプトが表示されます。
または、SQL を使用してクエリエディタで新しいセグメントを定義します。
### ステップ 2: 名前と説明を指定する
[名前] に、後で判別しやすいような顧客セグメント名を入力します。
**注記**
Amazon Connect 管理ウェブサイトは、入力された名前をセグメント`DisplayName`の として使用し、それに基づいて識別子を生成します。生成された識別子は、Customer Profiles API を使用してセグメントにアクセスする際に `SegmentDefinitionName` として使用されます。
オプションで、顧客セグメントの説明を [説明] に入力します。
### ステップ 3: セグメントを確認して検証する
セグメント AI アシスタントが使用したデータと、セグメントの生成にかかった AI モデルの手順を確認します。作成した SQL を確認して、クエリエディタでセグメントを定義することもできます。セグメントを作成できなかった場合は、正確なセグメントを作成するために提供されたフィードバックに対処します。セグメントが生成されると、Customer Profiles は自動的にセグメント見積りを作成します。
編集する場合は、「新しい会話」をクリックするか、クエリエディタで SQL を作成/編集して、新しいプロンプトを指定できます。
セグメント AI アシスタントを使用していない場合は、クエリを検証し、クエリエディタの下にある「クエリの検証と見積り」ボタンをクリックして見積りを作成できます。
**注記**
Spark SQL を使用するセグメントは、他のクエリエンジンと同様に、セグメントで使用するプロファイルデータと使用される SQL の量に応じて時間がかかります (たとえば、オブジェクト間での複数の結合には通常時間がかかります）。
### ステップ 4: セグメントを作成する
セグメントを構築し、満足したら、右上の「セグメントの作成」ボタンを選択します。セグメントを作成したら、フローのセグメントとアウトバウンドキャンペーンのセグメントを使用して、アクション - .csv へのエクスポートを選択できます。
**注記**
アウトバウンドキャンペーンまたはフローブロックでセグメントを使用する場合、セグメントが最後に作成された日時に基づいてセグメントメンバーシップがチェックされます。フローまたはキャンペーンの実行中にリアルタイムのセグメントメンバーシップチェックが必要な場合は、 Classic セグメンテーションを使用します。
# Amazon Connect で顧客セグメントを管理する
Amazon Connect 管理ウェブサイトを使用して、顧客セグメントの作成、表示、コピー、および他の管理タスクを行うことができます。顧客セグメントを開いて設定を表示すると、そのセグメントを使用するキャンペーンをすばやく作成することもできます。セグメント作成の詳細については、「 Amazon Connect デベロッパーガイド」の「[Amazon Connect で顧客セグメントを構築する](customer-segments-building-segments.md)」を参照してください。
**顧客セグメントを管理するには**
1. **[顧客セグメント]** ページで、管理するセグメントに移動するか、アクションを選択します。
![\[顧客セグメントページ、セグメントの一覧。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-managing-segments-1.png)
1. **[アクション]** メニューでは、以下のオプションを使用できます。
1. **詳細の表示** — セグメントが作成された日時、セグメントが最後に更新された日時など、顧客セグメントに関する情報を表示するには、このオプションを選択します。Amazon Connect ユーザーには、このアクションを実行するための **CustomerProfiles.Segments.View** セキュリティプロファイルのアクセス許可が必要です。
1. **複製** – このオプションを選択すると、選択したセグメントをコピーし、新しい顧客セグメントを作成することができます。その後、元のセグメントを変更することなく、新しいセグメントの設定を変更できます。 Amazon Connect ユーザーには、このアクションを実行するための **CustomerProfiles.Segments.Create** security profile アクセス許可が必要です。
1. **CSV をエクスポート** – このオプションを選択すると、顧客セグメントがコンピュータ上のファイルにエクスポートされます。詳細については、「[Amazon Connect の CSV ファイルに顧客セグメントをエクスポートする](customer-segments-exporting-segments.md)」を参照してください。 Amazon Connect ユーザーには、このアクションを実行するための **CustomerProfiles.Segments.Export** セキュリティプロファイルのアクセス許可が必要です。
1. **削除** – 顧客セグメントを完全に削除するには、このオプションを選択します。削除した後にセグメントを復元することはできません。 Amazon Connect このアクションを実行するには**CustomerProfiles.Segments.Delete** セキュリティプロファイルのアクセス許可が必要です。
**重要**
セグメントを削除すると、そのセグメントを使用するアクティブなキャンペーンは失敗します。同様に、セグメントの上に構築されたセグメントは機能しなくなります。セグメントを削除する前に、セグメントがアクティブなキャンペーンや他のセグメントで使用されていないことを確認することをお勧めします。
# Amazon Connect でインポートされたファイルからセグメントを作成する
**注記**
Amazon Connect 管理ウェブサイトのセグメンテーションビルダーエクスペリエンスにアクセスするには、適切なセキュリティプロファイルのアクセス許可が設定されていることを確認します。詳細については、「[顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる](security-profile-customer-profile-segmentation.md)」を参照してください。
顧客セグメントのインポートでは、プロファイルデータを含む CSV ファイルを使用して新しいプロファイルを作成するか、既存のプロファイルを更新して、セグメントにグループ化します。CSV ファイルのサイズは 1GB 未満で、標準プロファイル属性にマッピングされる有効なヘッダーが含まれている必要があります。
以下の手順では、インポートされた顧客セグメントの作成と設定について説明します。
1. [新しいセグメントの作成](#create-new-segment)
1. [CSV ファイルをアップロードする](#upload-csv-file)
1. [セグメントの詳細を設定する](#configure-segment-details)
1. [顧客属性をマッピングする](#map-customer-attributes)
1. [プロファイルの有効期限を設定する](#set-profile-expiry)
1. [セグメントのインポートの作成とモニタリング](#create-monitor-segment-import)
## 新しいセグメントの作成
1. セグメントを作成するには、前提条件としてセキュリティプロファイルのアクセス許可を作成していることを確認します。詳細については、「[顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる](security-profile-customer-profile-segmentation.md)」を参照してください。
1. Amazon Connect 管理ウェブサイトで、**Customer Profiles****Customer セグメント**に移動します。
1. **[セグメントの作成]** を選択し、ドロップダウンから **[ファイルアップロードから]** を選択します。
## CSV ファイルをアップロードする
次のいずれかの方法で CSV ファイルを選択します。
+ **[ファイルの選択]** を選択して、ファイルを選択します。
+ ファイルをアップロード領域にドラッグアンドドロップします。
ファイルは、次の条件を満たす必要があります。
+ CSV 形式であること
+ サイズが 1GB 未満であること
+ ヘッダーが含まれていること
+ UTF-8 でエンコード済みであること
## セグメントの詳細を設定する
**[名前]** で、セグメントの識別可能な識別子を指定します。このフィールドは必須です。
+ 文字 (a～z、A～Z)、数字 (0～9)、ハイフン (-)、またはアンダースコア (\$1) のみを使用します。
+ 先頭は文字または数字にする必要があります (アンダースコアは使用できません)。
+ 最大文字数は 255 文字です。
**注記**
Amazon Connect 管理ウェブサイトは、この名前をセグメント`DisplayName`の として使用し、一意の`SegmentDefinitionName`識別子を生成します。この識別子は、Amazon Connect Customer Profiles API を介してセグメントにアクセスするときに使用されます。
**[説明]** (オプション) には、セグメントに関する詳細を追加します。
+ 最大文字数は 1000 文字です。
## 顧客属性をマッピングする
オブジェクトタイプマッピングは、Customer Profiles が CSV データを処理する方法を定義します。このマッピングは以下の目的で使用されます。
+ CSV データは標準プロファイルオブジェクトの入力方法を決定します。
+ プロファイル割り当てのインデックスを作成するフィールドを指定します。
オブジェクトタイプマッピングの詳細については、「[顧客データを作成して、Customer Profiles に取り込む](customer-profiles-object-type-mappings.md)」を参照してください。
CSV 列を Customer Profiles 属性にマッピングするには、次のいずれかのオプションを選択します。
### オプション 1: AI を活用したマッピング (推奨)
1. **[顧客属性の生成]** を選択し、**[次へ]** を選択します。
1. システムは CSV ヘッダーを分析し、標準プロファイル属性への適切なマッピングを提案します。
1. 提案されたマッピングを確認します。
1. オプション: マッピングをカスタマイズします。
+ 標準プロファイル属性マッピングを変更します。
+ `Attributes.attribute-name` の形式を使用してカスタム属性を追加します。
+ 一意の識別子を更新します。
### オプション 2: 手動マッピング
1. 各 CSV 列ヘッダーをプロファイル属性にマッピングします。
+ 標準プロファイル属性を使用します。詳細な一覧については、「[Amazon Connect Customer Profiles の標準プロファイル定義](standard-profile-definition.md)」を参照してください。
+ `Attributes.attribute-name` の形式を使用してカスタム属性を作成します。
**注記**
最大 25 個の属性をマッピングできます。
1. 顧客識別子 (一意のキー) としてマッピングされた属性を 1 つ選択します。
### 顧客識別子を選択する
マッピングが完了したら、顧客識別子としてマッピングされた属性を 1 つ選択します。Amazon Connect Customer Profiles は、この識別子を使用して以下を行います。
+ 新しいプロファイルを作成するか、既存のプロファイルを更新します。
+ 受信データを既存のプロファイルと照合します。
**注記**
属性マッピングは、AI を活用したマッピングまたは手動マッピングのどちらの場合でも、セットアップ中にいつでも変更できます。
## プロファイルの有効期限を設定する
インポートされたプロファイルの有効期限を指定します。
1. 有効期限オプションを選択します。
+ デフォルト: インポート日から 14 日間
+ カスタム: 日付ピッカーを使用して日付を選択する
1. カスタム有効期限の場合:
+ 最小: インポートから 1 日後
+ 最大: インポート後 90 日
Customer Profiles は、セグメントとプロファイルドメインから期限切れのプロファイルを削除します。
**注記**
データ保持要件に合った有効期限を選択します。カスタム日付を選択する前に、デフォルトの 14 日間の期間がビジネスニーズを満たしているかどうかを検討してください。
## セグメントのインポートの作成とモニタリング
**セグメントを作成する**
1. の設定を確認します。
1. [**Create segment**] を選択します。
1. システムは以下を行います。
+ CSV ファイルをアップロードします。
+ データに基づいてプロファイルを作成/更新します。
+ プロファイルをセグメントにグループ化します。
+ 通知バナーを使用して進行状況を表示します。
インポートの進行状況をモニタリングする
+ セグメントの詳細ページでインポートの進行状況を表示します。
+ 通知バナーは、インポートジョブが進行中であることを示しています。
+ インポートジョブの詳細テーブルには、以下が表示されます。
+ ファイル名
+ インポートジョブの作成日
+ インポートジョブの完了日
+ 処理されたプロファイルの数
+ 成功したインポートの数
+ 失敗したインポートの数
+ インポートは、進行中にキャンセルできます。
+ インポートジョブが進行中でも、セグメントはキャンペーンで使用できます。
**注記**
インポートされたセグメントは、インポートが完了すると、アウトバウンドキャンペーンまたはエクスポートの他のセグメントと同様に使用できます。インポートステータスや結果などのセグメントの詳細は、セグメントの詳細ページから表示できます。
# Amazon Connect の CSV ファイルに顧客セグメントをエクスポートする
Amazon Connect 管理ウェブサイトの**顧客セグメント**ページから、既存のセグメントをコンピュータ上のファイルにエクスポートできます。エクスポート すると、Customer Profiles は顧客セグメントのプロファイルに関連付けられているすべてのプロファイル属性を CSV ファイルにエクスポートします。
**顧客セグメントをエクスポートするには**
1. [顧客セグメント] ページのアクションドロップダウンで、**[CSV をエクスポート]** を選択します。
![\[顧客セグメントページ、CSV をエクスポートオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-exporting-segments-1.png)
または、**[詳細の表示]** ページに移動し、**[次のアクション]**、**[ダウンロード]** の順に選択します。
![\[セグメントのセグメント詳細ページ、次のアクションオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-exporting-segments-2.png)
**注記**
Amazon Connect 管理ウェブサイトでは、最大 350,000 個のプロファイルを含む顧客セグメントのエクスポートがサポートされています。多数のプロファイルを含むセグメントをエクスポートする必要がある場合は、Customer Profiles API の `CreateSegmentSnapshot` オペレーションを使用します。この `CreateSegmentSnapshot` オペレーションでは、セグメントを ORC、JSONL、CSV ファイルとして S3 バケットにエクスポートできます。API は、バケット内のエクスポートされたセグメントに加えてテストファイルを出力することに注意してください。
1. エクスポートジョブが開始されたら、プロセスが完了するまで、ダウンロードを含むウィンドウまたはタブを開いたままにします。
![\[セグメントがエクスポートされていることを示すメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-exporting-segments-3.png)
1. エクスポートジョブが完了すると、 Amazon Connect 管理者ウェブサイトは自動的にファイルのダウンロードを開始します。
![\[セグメントが正常にダウンロードされたことを示すメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-exporting-segments-4.png)
エクスポートされた CSV ファイルには、エクスポートされたプロファイル全体で入力された[すべての標準プロファイル属性と顧客プロファイル属性](https://docs.aws.amazon.com/connect/latest/adminguide/standard-profile-definition.html)が含まれます。
# Amazon Connect でセグメント AI アシスタントを使用する
Amazon Connect Customer Profiles は生成 AI を活用したセグメンテーションをサポートしており、非技術系ビジネスユーザーは自然言語クエリ ([セグメント AI アシスタント](#generating-a-segment-by-prompt)) を使用してオーディエンスを構築し、顧客データのトレンド ([セグメント作成用のインスピレーションカード](#inspiration-cards-for-segment-creation)) に基づいてレコメンデーションを受け取ることができます。これらの機能は、[Amazon Bedrock](https://aws.amazon.com/bedrock/) の高度な AI アルゴリズムを活用して、プロアクティブでパーソナライズされたアウトリーチを通じて顧客満足度を向上させ、収益を促進します。例えば、先週カスタマーサポートに頻繁に連絡した顧客セグメントを作成し、カスタマイズされたサービスオファーを提供することができます。また、総支出が増加した顧客を識別し、カスタマイズされた割引を提供して、ロイヤルティを促進し、ビジネスの成長につなげることができます。
生成 AI をセグメンテーションワークフローに組み込むことで、以下の利点を得ることができます。
+ **セグメント作成の簡素化**: 会話型言語を使用して複雑な顧客セグメントを構築し、非技術系ユーザーがプロセスにアクセスできるようにして、効率を向上させます。
+ **データ駆動型セグメント作成のヒント**: 顧客データのトレンドに基づいて AI を活用したセグメントのヒントを受け取ります。
+ **カスタマイズの強化:** カスタマイズされたコミュニケーションとオファーのために、特定の顧客グループを簡単に特定してターゲットにします。
以下のセクションでは、各機能、その使用方法、顧客セグメンテーションの取り組みの改善に役立つ利点について説明します。
**注記**
セグメント AI アシスタントを使用するには、セグメント作成のアクセス許可である **CustomerProfiles.Segments.Create** が必要です。
これらの AI を活用したツールは貴重な提案を提供しますが、推奨されるセグメントを確認して調整し、それが組織の特定のビジネス目標と一致し、データ使用ポリシーに準拠していることを確認することが重要です。
## セグメント作成のインスピレーションカード
インスピレーションカードは、**[顧客セグメント]** ページの AI を活用した機能です。この機能は、セグメント作成プロセスを簡素化および強化します。インスピレーションカードの 3 つの例を次の図に示します。
![\[顧客セグメントページのインスピレーションカードの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/inspiration-cards-for-segment-creation-1.png)
これらのカードは、Amazon Connect Customer Profiles のデータに基づいて、毎回最大 3 つのカテゴリのセグメントアイデアを生成し、セグメント作成プロセスのヒントを提供し、プロセスを合理化します。
**注記**
トレンドデータは、デフォルトの計算属性のイベント取り込み日に基づいています。
**主な特徴**
+ **データ駆動型のインスピレーション**: 各インスピレーションカードは、特定の顧客データとトレンドに合わせたセグメントのアイデアを示します。
+ インスピレーションカードは、ビジネスにフォーカスした 3 つのテーマにまたがるアイデアを提供します。
+ **プロモーション**: 特定のプロモーション戦略で顧客をターゲットにするためのアイデア。
+ **保持**: 顧客保持の取り組みのセグメントを特定します。
+ **サポート**: カスタマーサービスに特別な注意が必要な顧客グループを特定します。
+ **インサイトベースのレコメンデーション**: 過去のトレンド、データインサイト、生成 AI を活用して、有意義で実用的なインサイトを作成します。
**インスペクションカードの使用方法**
1. **[顧客セグメント]** ページに移動します。
1. [インスピレーションカード] セクションを見つけます。3 つのセグメント候補が表示されます。
1. 各カードを確認して、提案されたセグメントとその潜在的な活用方法を理解します。
1. 使用するカードを見つけたら、そのカードの **[開始]** を選択します。
1. **[さらに詳しく調べる]** を選択して、追加のインスピレーションカードを生成します。これらのカードは、Amazon Connect Customer Profiles データに基づいて新しいセグメントアイデアを提供することができます。
1. **[開始]** を選択すると、**[セグメントを作成]** ページに自動的に移動します。
1. 選択したセグメントのアイデアがセグメントビルダーに入力され、レビューと調整の準備が整います。
## 自然言語プロンプトを使用してセグメントを生成する
セグメント AI アシスタントは、自然言語プロンプトを使用してセグメントを作成するガイド付きアプローチを提供します。これにより、複雑なセグメントを作成するプロセスが簡素化され、ターゲットオーディエンスを自然言語で記述し、構造化された実用的なセグメント定義を受け取ることができます。
次の図は、セグメント AI アシスタントプロンプトの例を示しています。
![\[セグメント AI アシスタントプロンプトの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/generating-a-segment-by-prompt-1.png)
**この機能にアクセスするには:**
1. **[顧客セグメント]** ページに移動し、**[セグメントを作成]** を選択します。
1. 次の図に示すように、ページの右側にあるセグメント AI アシスタントパネルを見つけます。
![\[ページの右側にあるセグメント AI アシスタントパネルの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/generating-a-segment-by-prompt-2.png)
**セグメント AI アシスタントを使用する**
1. アシスタントは、セグメンテーションのニーズを理解するための一連の質問を通じてユーザーをガイドします。アシスタントとのすべてのインタラクションパスはプロンプトの生成につながります。
1. ユーザーは、目的のセグメントをテキストで説明できます。
1. プロンプトアクションステップは、詳細な説明を記述するためのリファレンスとしてサンプルプロンプトを提供します。
1. 入力に基づいて、Amazon Connect は構造化セグメント定義を生成します。
1. 生成されたセグメント定義は、セグメントビルダーに自動的に適用されます。
1. 標準のセグメントビルダーツールを使用して、生成されたセグメントをさらに調整することができます。セグメントビルダーのフィルターを変更すると、以前に生成された既存の条件が上書きされます。
1. 生成されたセグメントを確認し、必要な調整を行ったら、**[セグメントを作成]** を選択してプロセスを確定できます。このアクションはセグメントを保存し、キャンペーンで使用できるようにします。
**ベストプラクティス**
セグメント AI アシスタントを使用する際は、次のベストプラクティスに留意してください。
+ 具体的な指示を記述します。セグメント AI アシスタントは、既存の属性の名前を使用すると、より正確な条件を生成します。
+ 参照するすべての属性がドメインに存在することを確認します。
+ シンプルなプロンプトから始めて、さまざまなプロンプトを試します。最初の試行で必要なものが生成されない場合は、プロンプトを書き換えます。新しいプロンプトを送信する、または **[新しい会話]** を選択すると、既存の条件が置き換えられます。
+ セグメントビルダーでセグメントの調整と検証の時間を割り当てて、セグメントが実際のデータ値を正確に反映していることを確認します。
**注記**
セグメント AI アシスタントは、一般的な記述子と基準で動作するように設計されています。セグメントを記述する際は、データ保護規制と会社ポリシーに常に従ってください。プロンプトと説明に機密情報や個人情報が含まれていないことを確認してください。
## 生成されたセグメントに関するフィードバックを提供する
セグメントが生成されたら、ユーザーは機能のパフォーマンスを評価して、フィードバックを提供することをお勧めします。このフィードバックメカニズムは、セグメント生成プロセスを改善し、ビジネスニーズを効果的に満たすのに役立ちます。次の図は、フィードバックページを示しています。
![\[フィードバックが記録されたメッセージの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/providing-feedback-on-generated-segments-1.png)
このフィードバックプロセスは次の 2 つのステップで構成されています。
1. **初期フィードバック**: アラートセクションの右下隅に、サムアップアイコンとサムダウンアイコンがあります。これらのいずれかをクリックして、生成されたセグメントに対する一般的な満足度を示します。
1. **追加のフィードバック**: サムアップアイコンまたはサムダウンアイコンを選択すると、より詳細なフィードバックを提供するオプションが表示されます。これは、自由形式のコメントを残すことができるテキスト入力フィールドです。
包括的な評価になるよう、クイックリアクション (サムアップ/サムダウン) とテキスト入力の両方を使用し、該当する場合は具体的な例やユースケースを提供してください。生成されたセグメントがビジネス目標とどのように整合しているかにフォーカスし、セグメント生成プロセスを強化する改善や追加機能を提案することをお勧めします。
セグメント生成プロセスを強化する改善点または追加機能を提案します。
フィードバックプロセスに積極的に参加することで、ユーザーはセグメント生成機能の継続的な改善に貢献し、最終的にはより効果的な顧客セグメンテーションとターゲットを絞ったマーケティング戦略につながります。
## エラー処理
セグメント AI アシスタントを使用して顧客セグメントを生成する場合、**現在リクエストを処理できない**ことを示すエラーメッセージが表示されることがあります。このエラーは、セグメント作成の有効なプロンプトを提供した後でも発生する可能性があります。
次の図は、エラーメッセージの例を示しています。
![\[Amazon Connect がリクエストを処理できないことを示すエラーメッセージの例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-segments-ai-error-handling-1.png)
以下のステップは、このエラーの理解とトラブルシューティングに役立ちます。
**考えられる原因:**
+ **システム負荷が高い**: セグメント AI アシスタントで需要が高いか、複数のリクエストが同時に処理されている可能性があります。
+ **一時的なサービスの中断**: サービスが新しいセグメントリクエストを処理する機能に短時間の中断が発生する可能性があります。
+ **複雑なクエリ**: システムでは、特に複雑なセグメントクエリやリソースを大量に消費するセグメントクエリの処理にさらに時間がかかる場合があります。
**対応方法:**
+ **少し時間を置いて再試行する**: エラーメッセージは、再試行するまで数分待つことを勧めています。これにより、システムが一時的な問題を解決する時間を確保できます。
+ **セグメントを手動で作成する**: すぐにセグメントが必要な場合は、セグメントビルダーを使用して手動で作成できます。
**再試行する方法:**
1. 数分待ちます。
1. チャットインターフェイスの下部にある **[新しい会話]** を選択します。
1. 新しい会話を開始し、セグメント作成のプロンプトを再入力します。
**ベストプラクティス**
+ 複数回試行してもエラーが解決しない場合は、セグメントの条件を簡素化するか、より小さく管理しやすいリクエストに分割することを検討してください。
+ システムオーバーロードの原因となる可能性があるため、間隔を開けずにリクエストを繰り返すことは避けてください。
+ 問題が解決しない場合は、カスタマーサポートに連絡してサポートを受けてください。
このエラーは通常一時的なものであり、提供された指示に従って目的のセグメントを正常に作成できることに注意してください。
## 既知の制限事項
セグメント AI アシスタントを効果的に使用するには、データ処理ライフサイクルを理解することが不可欠です。このセクションでは、データ統合のさまざまなフェーズでビジネスユーザーが期待できることと、それがセグメントの提案にどのように影響するかについて概説します。
**データ処理と品質への影響:** セグメント AI アシスタントは、初期データ取り込みと後処理の 2 つの主要なフェーズを経て進化します。初期取り込み中、システムは実際の属性値を十分に活用できず、プロンプト解釈への依存が高くなる可能性があります。例えば、*VIP 顧客*へのプロンプトは、データから既存の*ゴールド*ティアを使用する代わりに *VIP* セグメントを提案する場合があります。処理が完了すると、システムは実際の属性値を活用してセグメントをより正確に作成し、プロンプト解釈への依存を減らし、全体的なセグメンテーション品質を向上させます。
**注記**
高度な機能に依存する前に、完全なデータ処理に十分な時間を確保してください。顧客プロファイルデータを定期的に更新します。セグメントの精度は、Amazon Connect Customer Profiles の顧客データの完全性と最新性によって異なります。レスポンスでは欠落している属性にフラグが付けられます。
**システムパフォーマンス:** 大量のデータを処理する際、セグメント生成の潜在的な遅延が予想されます。システムは一般的なワークロード向けに最適化されていますが、セグメンテーションのニーズが広範な企業は、それに応じてプロセスを調整する必要がある場合があります。
**属性の可用性**: 生成されたセグメントの品質は、Amazon Connect Customer Profiles で利用可能な顧客データによって異なります。顧客プロファイルデータがより包括的で最新であるほど、システムはより正確にプロンプトを解釈し、関連するセグメントを定義できます。存在しない属性がある場合、欠落している属性を含むメッセージが返されます。
**プロンプトの複雑さ**: セグメント定義が非常に複雑または曖昧な場合、自然言語処理で制限を受ける場合があります。ユーザーは、比較的単純なプロンプトから始めて、機能の使用経験の増加に合わせてより複雑なプロンプトを使用する必要があります。
**セグメントの調整**: システム生成セグメントは優れた出発点ですが、顧客はセグメントがビジネス目標に完全に一致するように詳細を確認して調整することができます。セグメンテーションインターフェイスを使用して、最初の生成後にセグメントを完全にカスタマイズできます。
**パフォーマンスとスケーリング**: 同時実行性が高い場合、言語モデルが各プロンプトを処理する必要があるため、セグメント生成プロセスに多少の遅延が発生する可能性があります。このシステムは一般的なセグメンテーションワークロードを処理するように設計されていますが、セグメンテーションの需要が非常に高い顧客は、それに応じてワークフローを調整する必要がある場合があります。
# Amazon Connect での顧客セグメントのトラブルシューティング
## 顧客セグメントオプションが左側のナビゲーションパネルに表示されない
Amazon Connect 管理ウェブサイトの左側のナビゲーションパネルに **Customer segments** オプションが存在しない場合は、ユーザーのセキュリティプロファイルに **Customer segment - View** アクセス許可があるかどうかを確認します。 詳細については、「」を参照してください [顧客セグメントを管理するためのセキュリティプロファイルのアクセス許可を割り当てる](security-profile-customer-profile-segmentation.md)。アクセス許可が更新されたら、Amazon Connect 管理ウェブサイトページを更新して変更を反映します。
## エクスポート CSV ボタンが使用できない、またはエクスポートジョブがタイムアウトしました
350,000 を超えるプロファイルを含むセグメントのエクスポートは、 Amazon Connect 管理ウェブサイトではサポートされていません。このタイプのセグメントについては、コマンドラインリファレンス (CLI) または SDK を介して `CreateSegmentSnapshot` API を使用して Amazon S3 バケットにエクスポートすることをお勧めします。
## エラー: 60 個の一意の属性の制限に達しました
このエラーは、セグメント定義の一意の属性の数がクォータを超えた場合に発生します。初期オーディエンスを含む一意の属性の数は再帰的にカウントされます。
**ソリューション**
+ セグメント定義のオーディエンスフィルターを削除するか、オーディエンスフィルターを含む初期オーディエンスを削除することで、一意の属性の数を減らします。
+ サービスクォータ (セグメント内の一意の属性の最大数) の[クォータ引き上げ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)をリクエストします。
デフォルトのサービスクォータの詳細については、「[Amazon Connect Customer Profiles のサービスクォータ](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)」を参照してください。
## エラー: 10 個の一意の計算属性の制限に達しました
このエラーは、セグメント定義の一意の計算属性の数がクォータを超えた場合に発生します。初期オーディエンスを含む一意の計算属性の数は再帰的にカウントされます。
**ソリューション**
+ セグメント定義の計算属性のオーディエンスフィルターを削除するか、計算属性のオーディエンスフィルターを含む初期オーディエンスを削除することで、一意の計算属性の数を減らします。
+ サービスクォータ (セグメント内の一意の計算属性の最大数) の[クォータ引き上げ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)をリクエストします。
デフォルトのサービスクォータの詳細については、「[Amazon Connect Customer Profiles のサービスクォータ](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)」を参照してください。
## エラー: 初期オーディエンスの深度 5 の制限に達しました
このエラーは、初期オーディエンスの深度がクォータを超えた場合に発生します。深度は、オーディエンスグループ内のすべての初期オーディエンスに対して再帰的にカウントされます。例えば、セグメント「レンタルアップグレードの対象者」を初期オーディエンスとして選択し、セグメント「レンタルアップグレードの対象者」が別のセグメントを初期オーディエンスとして持つ場合、深度は 2 になります。
**ソリューション**
+ 深くネストされた初期オーディエンスを含むオーディエンスグループ内の 1 つ以上の初期オーディエンスを削除します。
デフォルトのサービスクォータの詳細については、「[Amazon Connect Customer Profiles のサービスクォータ](https://docs.aws.amazon.com/general/latest/gr/connect_region.html#limits_customer_profiles)」を参照してください。
# Amazon Connect Customer Profiles でプロファイルエクスプローラーを設定する
Amazon Connect Customer Profiles のプロファイルエクスプローラーは、顧客の包括的な 360° ビューを提供する動的なオールインワンダッシュボードです。フラグメント化された顧客データを統合することで、組織はデータ表示をカスタマイズすることができます。インタラクションを追跡し、顧客情報を実用的なインサイトに変換して、ビジネス価値と顧客ロイヤルティを高めることができます。旅行業および接客業などの業界の組織は、プロファイルエクスプローラーを使用して、直感的なインターフェイスを通じて顧客をよりよく理解し、顧客とつながることができます。
+ リアルタイムの検索結果で、複数の ID (E メール、電話、予約リファレンスなど) を同時に使用して**顧客をすぐに検索**できます。
+ **ビューをカスタマイズ**して、特定のビジネスニーズに最も関連性の高い情報を優先し、関連性が最も高いと定義した顧客データを強調表示するドメイン固有のレイアウトを設計します。
+ インタラクティブなビジュアライゼーションとデータ表示を使用して、人口統計データ、コミュニケーション履歴、行動インタラクション、セグメントメンバーシップなど、**完全な顧客コンテキストにアクセスします**。
+ **AI を活用したインサイト**を、主要なパターンとカスタマイズされた行動推論にフォーカスした顧客概要で活用します。
![\[プロファイルエクスプローラーダッシュボード。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-profile-explorer-1.png)
**Topics**
+ [
# プロファイルエクスプローラーを有効にする
](enabling-profile-explorer.md)
+ [はじめに](getting-started-profile-explorer.md)
+ [
# レイアウト定義
](layout-definition.md)
+ [
# エージェントワークスペースにプロファイルエクスプローラーを追加する
](add-profileexplorer-to-agentworkspace.md)
# プロファイルエクスプローラーを有効にする
次の手順では、管理者およびユーザー向けにプロファイルエクスプローラーを有効にします。このプロセスでは、レイアウト設定と表示アクセスの両方のアクセス許可を設定します。
**Topics**
+ [
## 管理者がレイアウトを定義できるようにする
](#enable-administrators-define-layout)
+ [
## ユーザーがプロファイルエクスプローラーを表示できるようにする
](#enable-users-view-profile-explorer)
+ [
## 設定の確認
](#verify-setup)
## 管理者がレイアウトを定義できるようにする
管理者には、プロファイルエクスプローラーレイアウトを作成および編集するための特定のアクセス許可が必要です。
+ プロファイルエクスプローラーのセキュリティプロファイル内に次のアクセス許可を割り当てます。
+ **プロファイルエクスプローラー - 編集**: 既存のプロファイルエクスプローラーレイアウトの変更を許可します。
+ **プロファイルエクスプローラー - 作成**: プロファイルエクスプローラーレイアウトの作成を許可します。
+ **プロファイルエクスプローラー - 表示**: 設定されたプロファイルエクスプローラーレイアウトの表示を許可します。
![\[プロファイルエクスプローラーレイアウトの作成、編集、表示をユーザーに許可するアクセス許可を追加します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-administrators-define-layout-1.png)
## ユーザーがプロファイルエクスプローラーを表示できるようにする
ユーザーには、プロファイルエクスプローラーレイアウトにアクセスして操作するための適切なアクセス許可が必要です。
+ プロファイルエクスプローラーのセキュリティプロファイル内に次のアクセス許可を割り当てます。
+ **プロファイルエクスプローラー - 表示**: 設定されたプロファイルエクスプローラーレイアウトの表示を許可します。
![\[プロファイルエクスプローラーレイアウトの表示をユーザーに許可するアクセス許可を追加します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/enable-users-view-profile-explorer-1.png)
## 設定の確認
プロファイルエクスプローラーが正常に有効になっていることを確認するには:
管理者としてログインし、以下ができるかどうかを確認します。
+ プロファイルエクスプローラーページにアクセスする。
+ プロファイルエクスプローラーレイアウトを作成および変更する。
通常のユーザーとしてログインし、以下ができるかどうかを確認します。
+ プロファイルエクスプローラーにアクセスする。
+ プロファイルエクスプローラーのレイアウトを表示する。
+ 有効化された機能を使用する。
# Amazon Connect Customer Profiles のプロファイルエクスプローラーの使用を開始する
プロファイルエクスプローラーの使用を開始し、基本的なインターフェイスについて学びます。
**Topics**
+ [
# レイアウトコントロール
](layout-controls.md)
+ [
# エクスプローラーレイアウトの編集
](editing-explorer-layout.md)
+ [
# エクスプローラーレイアウトを保存する
](saving-explorer-layout.md)
# レイアウトコントロール
![\[プロファイルエクスプローラーレイアウトの表示をユーザーに許可するアクセス許可を追加します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/layout-controls-1.png)
プロファイルエクスプローラーのウェルカムコンソール。
1. 編集タブ
1. ウィジェットの追加
1. レイアウトアクション
## 編集タブ
タブコントロールを使用してダッシュボードを論理セクションに整理します。
+ **1a。タブの追加**: 顧客データの異なる側面を表示するための新しいタブを作成する
+ **1b。タブの削除**: レイアウトから不要なタブを削除する
+ **1c。タブ名の変更**: タブ名をカスタマイズしてコンテンツを反映する
+ **1d. タブの順序変更**: タブをドラッグアンドドロップして任意の順序で配置する
![\[編集タブがポップアップ表示されます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/layout-controls-2.png)
## ウィジェットの追加
さまざまなデータ視覚化ウィジェットを使用してアクティブなタブを強化します。
### 使用可能なウィジェット
+ デフォルトのウィジェット
+ [生成 AI の概要](default-widgets.md#generative-ai-summary)
+ [顧客情報](default-widgets.md#customer-information)
+ [計算属性](default-widgets.md#calculated-attribute)
+ [Contacts](default-widgets.md#contacts)
+ [事例](default-widgets.md#cases-cp)
+ [注文](default-widgets.md#orders-cp)
+ [アセット](default-widgets.md#assets-cp)
+ カスタムウィジェット
+ [[テーブル]](custom-widgets.md#table-widget)
+ [キーと値のペア](custom-widgets.md#key-value-pair)
+ [キーメトリクス](custom-widgets.md#key-metric)
+ [ドーナツグラフ](custom-widgets.md#donut-chart)
使用するウィジェットを選択して、使用を開始してください。
## レイアウトアクション
ダッシュボード全体の設定を管理します。
+ **レイアウトの保存**: 現在のダッシュボード設定を保持する
![\[レイアウトポップアップを保存します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/layout-controls-3.png)
**注記**
すべての変更は、保存されるまでドラフトに含まれます。
# エクスプローラーレイアウトの編集
ウィジェットとその配置を管理するためのシンプルで直感的なコントロールを使用して、プロファイルエクスプローラーのレイアウトをカスタマイズします。
## ウィジェットコントロール
各ウィジェットの右上隅には 3 つのドットメニューがあり、主に 2 つのオプションがあります。
+ **1A 編集**: 特定のウィジェットの設定パネルを開きます
+ **1B 削除**: レイアウトからウィジェットを削除します
![\[エクスプローラーレイアウトのポップアップを編集または削除します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/widget-controls-1.png)
## ウィジェットのカスタマイズ
+ **ドラッグアンドドロップ**: ダッシュボードの任意の場所にウィジェットを再配置します。
+ **サイズ変更**: ウィジェットのボーダーを選択してドラッグし、サイズを調整します。
+ **設定**: 各ウィジェットタイプに固有の編集パネルから詳細設定にアクセスします。
![\[エクスプローラーレイアウトでのウィジェットのカスタマイズと並べ替え。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/widget-customization-1.png)
**注記**
各ウィジェットタイプには固有の設定オプションがあります。特定のウィジェット設定の詳細については、ウィジェットのドキュメントを参照してください。
## 新しいウィジェットの追加
レイアウトに新しいコンポーネントを追加するには、コントロールパネルの **[ウィジェットを追加]** ボタンを使用します。
# エクスプローラーレイアウトを保存する
プロファイルエクスプローラーのレイアウト設定を保存および管理する方法。
## レイアウトの持続性
プロファイルエクスプローラーレイアウトに加えた変更は、保存する必要があります。保存されていない変更は、ページから移動したりブラウザを更新したりすると失われます。
## デフォルトレイアウト
各プロファイルエクスプローラーには、1 つのデフォルトレイアウトが含まれています。これは組織の基本設定として機能し、必要に応じて変更できます。
## 変更を保存する
レイアウトの変更を保存するには:
1. レイアウトアクションメニューで、**[保存]** を選択します。
1. [保存] ダイアログで変更を確認します。
1. 保存が完了すると、レイアウトはすべてのユーザーに対して更新されます。
![\[エクスプローラーレイアウトのレイアウトの保存ダイアログ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/saving-changes-1.png)
**注記**
レイアウトの変更を保存するには、適切なアクセス許可が必要です。必要なアクセス権限については、「[プロファイルエクスプローラーを有効にする](enabling-profile-explorer.md)」を参照してください。
# レイアウト定義
プロファイルエクスプローラーレイアウトの構造とコンポーネントについて説明します。
**Topics**
+ [
# 仕組み
](how-it-works.md)
+ [
# ウィジェット
](widgets.md)
# 仕組み
プロファイルエクスプローラーには、顧客情報を表示するためのさまざまなウィジェットが用意されており、レイアウトはダッシュボードの完全な構造と設定を表す JSON 定義として保存されます。ビジュアルレイアウトの各ウィジェットとコンポーネントは、この定義内の特定の JSON ブロックに対応します。
## コアコンポーネント
レイアウト定義のすべてのコンポーネントは、次の 5 つの一般的な要素で構成されます。
+ **タイプ**
+ コンポーネントカテゴリを定義する
+ コンポーネントのレンダリング方法を決定する
+ 例: BoardItem, Table, KeyValuePair
+ **ID**
+ 各コンポーネントの一意の識別子
+ コンポーネントの追跡と更新に使用される
+ ビルダーでコンポーネントが作成されると自動的に生成される
+ **プロンプト**
+ コンポーネント固有のプロパティ
+ 外観と動作を制御する
+ 設定を含む
+ **Children**
+ ネストされたコンポーネントまたはコンテンツ
+ 階層関係を定義する
+ 複数のサブコンポーネントを含めることができる
+ **DataSource**
+ データオリジンを指定する
+ データ取得パラメータを定義する
+ コンポーネントのデータバインディングを制御する
## レイアウトコンポーネント定義の例
ダッシュボードテーブルコンポーネントの JSON 構造の例を次に示します。
```
{
"Id": "unique-identifier",
"Type": "BoardItem",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "Table",
"Props": {},
"Children": [
{
"Id": "unique-identifier",
"Type": "TextContent",
"Props": {},
"Children": ["string"]
}
]
}
],
"DataSource": [
{
"Type": "source-type",
"Params": {}
}
]
}
```
## 動的データ設定
プロファイルエクスプローラーは、テンプレート式を使用して、コンポーネント内で Customer Profiles データに動的にアクセスして表示します。
### 単一値のサポート
Key Value ペアや Key メトリクスなどのコンポーネントでは、以下にアクセスできます。
#### 標準プロファイル情報
```
{{Customer.}}
```
使用例:
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`
#### 計算属性
```
{{Customer.CalculatedAttributes.}}
```
使用例:
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`
### 表形式のデータサポート構文
#### 計算属性
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```
#### セグメント
```
{{Customer.CalculatedAttributes.DisplayName}}
```
```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```
#### プロファイルオブジェクト
```
{{Customer.ObjectAttributes..}}
```
**使用例**:
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`
### 実装例
#### 単一値コンポーネント
```
{
"Type": "KeyValuePair",
"Props": {
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Children": ["Customer Name"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.FirstName}}"]
}
}
}
]
}
}
```
#### 表形式コンポーネント
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Cell": {
"Content": {
"Type": "TextContent",
"Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
}
},
"Header": "Contact ID"
}
]
}
}
```
**注記**
レイアウトで使用する前に、参照する属性、オブジェクト、セグメントが Customer Profiles 設定に存在することを確認してください。
# ウィジェット
プロファイルエクスプローラーで使用できるさまざまなウィジェットタイプについて説明します。
## 概要
プロファイルエクスプローラーのウィジェットは、レイアウト定義内の JSON コンポーネントから構築された複合要素です。これらのウィジェットは複雑な JSON 構造を表していますが、UI ビルダーは技術的な構成を自動的に処理し、ダッシュボード管理を簡単にアクセスできるようにします。
**Topics**
+ [
## 概要
](#widgets-overview)
+ [
## 使用可能なウィジェット
](#available-widgets)
+ [
# デフォルトのウィジェット
](default-widgets.md)
+ [
# カスタムウィジェット
](custom-widgets.md)
## 使用可能なウィジェット
+ デフォルトのウィジェット
+ [生成 AI の概要](default-widgets.md#generative-ai-summary)
+ [顧客情報](default-widgets.md#customer-information)
+ [計算属性](default-widgets.md#calculated-attribute)
+ [Contacts](default-widgets.md#contacts)
+ [事例](default-widgets.md#cases-cp)
+ [注文](default-widgets.md#orders-cp)
+ [アセット](default-widgets.md#assets-cp)
+ カスタムウィジェット
+ [[テーブル]](custom-widgets.md#table-widget)
+ [キーと値のペア](custom-widgets.md#key-value-pair)
+ [キーメトリクス](custom-widgets.md#key-metric)
+ [ドーナツグラフ](custom-widgets.md#donut-chart)
# デフォルトのウィジェット
プロファイルエクスプローラーは、Customer Profiles データとシームレスに連携するように設計された事前設定済みのウィジェットコレクションを備えています。これらのデフォルトのウィジェットは、最低限の設定ですぐに値を提供し、数回のクリックで高度なダッシュボードを構築できます。
![\[エクスプローラーレイアウトへのデフォルトのウィジェットの追加。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/default-widgets-1.png)
## すぐに使用可能なウィジェット
+ [生成 AI の概要](#generative-ai-summary)
+ [顧客情報](#customer-information)
+ [計算属性](#calculated-attribute)
+ [Contacts](#contacts)
+ [事例](#cases-cp)
+ [注文](#orders-cp)
+ [アセット](#assets-cp)
**注記**
これらのウィジェットは事前設定済みですが、特定のニーズに合わせてカスタマイズできます。これらは、オンボーディングを容易にするための出発点として機能します。
## 生成 AI の概要
プロファイルエクスプローラーは、主要な行動パターンを強調した簡潔な概要を生成するデフォルトの AI を活用した顧客インサイトを提供し、インタラクション履歴に基づいてカスタマイズされた顧客インサイトを提供し、Customer 360 データからの実用的なレコメンデーションを表示します。AI 生成の概要は、複数の顧客タッチポイントにわたるパターンを特定し、各顧客固有のカスタマイズされた行動インサイトを提供し、カスタマーエクスペリエンスの向上とロイヤルティの向上をサポートすることで、組織がデータ駆動型の意思決定を行うのに役立ちます。
![\[生成 AI の概要ウィジェット。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/generative-ai-summary-1.png)
## 顧客情報
顧客情報ウィジェットは、キーと値のペアコンポーネントを使用して、標準の Customer Profile データの明確で整理されたビューを提供します。このデフォルトのウィジェットは、重要な顧客情報を理解しやすい形式で自動的に表示します。
### 概要
このウィジェットは、キーと値のペアコンポーネントを使用して、顧客属性を構造化レイアウトで表示します。
+ 名
+ 姓
+ E メールアドレス
+ 電話番号
+ Address
+ アカウント番号
+ プロファイル ID
### データ
ウィジェットは Customer Profiles ドメインに自動的に接続し、標準プロファイル属性から情報を取得します。基本機能に追加の設定は必要ありません。
**注**: このウィジェットには標準プロファイル属性が事前設定されていますが、特定のニーズに基づいて標準プロファイルのどの属性を表示するかをカスタマイズできます。
#### 詳細情報
+ [標準プロファイルの定義](standard-profile-definition.md)
+ キーと値のペア
## 計算属性
計算属性ウィジェットを使用すると、顧客プロファイルの計算属性のデータを利用して、主要なメトリクスコンポーネントを表示できます。
### 概要
計算属性ウィジェットを使用すると、顧客プロファイルの計算属性のデータを利用して、主要なメトリクスコンポーネントを表示できます。
### コンポーネント機能
+ 計算メトリクスを単一値インジケータとして表示する
### ユースケースの例は次のとおりです。
+ キャンペーン配信
+ オープンケース
+ 平均通話時間
+ チャンネル設定
### 設定
計算属性を選択し、任意の表示形式を選択します。
**注記**
計算属性は、このウィジェットで使用する前に Customer Profiles ドメインで設定する必要があります。
**詳細はこちら**
+ キーメトリクス
+ [計算属性を設定する](customerprofiles-calculated-attributes-admin-website.md)
## Contacts
Table JSON コンポーネントを使用して構築されたコンタクトウィジェットは、Customer Profiles のコンタクトオブジェクトデータを整理された表形式で表示します。このウィジェットは Customer Profiles CTR データに自動的に接続し、主要なコンタクト情報とインタラクション履歴を表示します。
### 機能
+ すべての顧客コンタクトイベントを表示する
+ コンタクトレコードのソートとフィルタリング
+ 表示されたコンタクトフィールドをカスタマイズする
+ 詳細なコンタクト情報にアクセスする
Customer Profiles の CTR オブジェクトの詳細については、「[Amazon Connect Customer Profiles のコンタクトレコードテンプレート](ctr-contact-record-template.md)」を参照してください。
## 事例
Table JSON コンポーネントを使用して構築されたケースウィジェットは、Customer Profiles のケースオブジェクトデータを整理された表形式で表示します。このウィジェットは Customer Profiles の Case データに自動的に接続し、サポートインタラクションとケース管理の詳細を表示します。
### 機能
+ すべての顧客ケースを表示する
+ ケースレコードのソートとフィルタリング
+ 表示されたケースフィールドをカスタマイズする
+ 詳細なケース情報にアクセスする
Customer Profiles ケースオブジェクトの詳細については、「[Customer Profiles の標準ケースのオブジェクトタイプマッピング](object-type-mapping-standard-case.md)」を参照してください。
## 注文
Table JSON コンポーネントを使用して構築された注文ウィジェットは、Customer Profiles の注文オブジェクトデータを整理された表形式で表示します。このウィジェットは、Customer Profiles の注文データに自動的に接続し、購入履歴とトランザクションの詳細を表示します。
### 機能
+ すべての顧客注文イベントを表示する
+ 注文レコードのソートとフィルタリング
+ 表示された注文フィールドをカスタマイズする
+ 詳細な注文情報にアクセスする
Customer Profiles の注文オブジェクトの詳細については、「[Amazon Connect Customer Profiles の標準注文のオブジェクトタイプマッピング](object-type-mapping-standard-order.md)」を参照してください。
## アセット
Table JSON コンポーネントを使用して構築されたアセットウィジェットは、Customer Profiles のアセットオブジェクトデータを整理された表形式で表示します。このウィジェットは Customer Profiles のアセットデータに自動的に接続し、顧客所有の製品やサービスを表示します。
### 機能
+ すべての顧客アセットレコードを表示する
+ アセットデータのソートとフィルタリング
+ 表示されたアセットフィールドをカスタマイズする
+ 詳細なアセット情報にアクセスする
Customer Profiles のアセットオブジェクトの詳細については、「[Customer Profiles の標準アセットのオブジェクトタイプマッピング](object-type-mapping-standard-asset.md)」を参照してください。
# カスタムウィジェット
特定のビジネスニーズに合わせて、カスタマイズされたダッシュボードコンポーネントを空の状態から作成します。カスタムウィジェットを使用すると、事前定義済みのデータなしで独自のビジュアライゼーションを構築できます。
![\[プロファイルエクスプローラーレイアウトへのカスタマーウィジェットの追加。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/custom-widgets-1.png)
## 使用可能なカスタムコンポーネント
+ [[テーブル]](#table-widget)
+ [キーと値のペア](#key-value-pair)
+ [キーメトリクス](#key-metric)
+ [ドーナツグラフ](#donut-chart)
## カスタムウィジェットの構築
**各カスタムウィジェットは、以下を使用して設定できます。**
+ カスタムデータソース
+ カスタムディスプレイ
+ カスタム フィールド
+ カスタムアイテムインタラクション
## [テーブル]
カスタムテーブルコンポーネントは、データを表形式で表示するための柔軟な設定オプションを提供し、インタラクションと整理のための高度な機能を備えています。
### 機能
1. **列の設定**
+ カスタム列ヘッダーを定義する
+ 各列のデータを指定する
+ データフォーマットオプションを設定する
+ 列の配置を定義する
1. **フィルタリング**
+ テーブル内の項目をすばやくフィルタリングする
1. **リンク**
+ リソースリンクを接続する
+ 以下へのシームレスなナビゲーション:
+ セグメント
+ 計算属性
+ 新しいタブで開く
+ **外部 URL リンク**
+ 行項目の値を選択可能な URL に変換する
+ 新しいタブで開く
+ 行データに基づいてリンクを動的に生成する
+ ドロワービューリンク
+ サイドドロワーで詳細情報を開く
+ ページを離れずに完全なレコードの詳細を表示する
1. データの整理
+ グループ化
+ 特定のフィールド名で行をグループ化する
+ 永続的なグループ設定
+ ソート
+ 任意の列フィールドでソートする
+ 昇順での表示
+ 永続的なソート設定
**図 1**
![\[カスタムテーブルウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/table-features-1.png)
**図 2**
![\[別のカスタムテーブルウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/table-features-2.png)
### 設定例
```
{
"Type": "Table",
"Props": {
"ColumnDefinitions": [
{
"Header": "Table column header"
"Cell": {
"Content": {
"Props": {
"Variant": "Link",
"LinkOptions": {
"LinkType": "Drawer"
}
},
"Type": "TextContent",
"Children": ["string"]
}
},
}
]
}
}
```
## キーと値のペア
キーと値のペアコンポーネントを使用すると、関連するデータポイントを柔軟に読み取れる形式で整理して表示できます。
### 概要
カスタムキーと値の関係を定義して動的データ表示を作成します。このコンポーネントは、次のような属性ペアを表示する場合に特に便利です。
+ 顧客の詳細情報
+ アカウント情報
### 機能
1. **インタラクティブリンクオプション**
+ リソースリンクを接続する
+ 関連リソースに直接リンクする
+ 以下へのシームレスなナビゲーション:
+ 計算属性
+ セグメント
+ 新しいタブで開く
+ 外部 URL リンク
+ 項目の値を選択可能な URL に変換する
+ 新しいタブで開く
+ ドロワービューリンク
+ サイドドロワーで詳細情報を開く
+ ページを離れずに完全な詳細を表示する
1. 列の設定
+ キーと値のペアの 1～4 列を定義する
1. 論理グループでペアを整理する
**図 1**
![\[カスタムキー値ペアウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/key-value-pair-features-1.png)
**図 2**
![\[別のカスタムキー値ペアウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/key-value-pair-features-2.png)
### 設定例
```
{
"Type": "KeyValuePair",
"Id": "UniqueId",
"Props": {
"Columns": 2,
"Items": [
{
"Label": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {
"FontWeight": "bold"
},
"Children": ["Profile id"]
}
},
"Value": {
"Content": {
"Type": "TextContent",
"Id": "UniqueId",
"Props": {},
"Children": ["[string]"]
}
}
}
]
}
}
```
**注記**
このコンポーネントは現在、UI ビルダーで `ProfileObjects` をサポートしていません。
## キーメトリクス
キーメトリクスコンポーネントを使用すると、重要なビジネスメトリクス、KPI、重要な統計を簡単に理解しやすい形式で表示できます。
### 概要
重要なデータポイント、トレンド、またはステータスインジケータを強調表示する可視性の高いメトリクスディスプレイを作成します。このコンポーネントは、以下の表示に最適です。
+ 業績インジケーター
+ 重要な測定値
+ ステータスの概要
+ トレンドインジケーター
### 機能
1. **ラージディスプレイテキスト**
1. **メトリクス形式**
1. **インタラクティブリンクオプション**
+ リソースリンクを接続する
+ 関連リソースに直接リンクする
+ 以下へのシームレスなナビゲーション:
+ 計算属性
+ セグメント
+ 新しいタブで開く
+ 外部 URL リンク
+ 項目の値を選択可能な URL に変換する
+ 新しいタブで開く
+ ドロワービューリンク
+ サイドドロワーで詳細情報を開く
+ ページを離れずに完全な詳細を表示する
1. **メトリクスレイアウトを整理する**
**図 1**
![\[カスタムキーメトリクスウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/key-metric-features-1.png)
**図 2**
![\[別のカスタムキーメトリクスウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/key-metric-features-2.png)
### 設定例
```
{
"Type": "KeyMetrics",
"Props": {
"MetricDefinitions": [
{
"MetricLabel": "Total Revenue",
"MetricValue": {
"Content": {
"Type": "TextContent",
"Props": {
"Format": "USD",
"FontSize": "large",
"FontWeight": "bold"
},
"Children": ["[string]"]
}
},
"Columns": 1
}
]
}
}
```
**注記**
このコンポーネントは現在、UI ビルダーで `ProfileObjects` をサポートしていません。
## ドーナツグラフ
ドーナツグラフコンポーネントを使用すると、円形のドーナツグラフを通じてセンチメントスコアを視覚化できます。
### 概要
カスタムスコア基準を定義して、動的なセンチメントの視覚化を作成します。このコンポーネントは、次の表示に特に便利です。
+ 成功のメトリクス
+ 達成率
+ リスク評価
+ 業績インジケーター
### 機能
1. センチメント分析オプション
+ ポジティブセンチメント
+ ゼロから開始
+ 基準に照らしてアチーブメントを追跡:
+ カスタムポイント値
+ 色分けされたセグメント
+ 基準を満たしていない場合はグレー
+ 達成率を表示する
+ ネガティブセンチメント
+ 最大値から開始
+ 減点を追跡;
+ 色分けされたセグメント
+ 減点システム
+ 残り値をグリーンで表示
+ 最終スコアを表示する
1. 計算属性値
1. 演算子オプション
+ Equal To
+ Not Equal To
+ Greater Than
+ Less Than
1. 条件値
1. 条件ごとに割り当てられたポイント
**図 1: ポジティブセンチメントの例**
![\[ポジティブセンチメントウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/donut-chart-features-1.png)
**図 2: ネガティブセンチメントの例**
![\[ネガティブセンチメントウィジェットの編集例。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/donut-chart-features-2.png)
### 設定例
```
{
"Type": "DonutChart",
"Props": {
"Variant": "PositiveSentiment",
"ConditionDefinitions": [
{
"Title": "Customer Satisfaction",
"Color": "#4CAF50",
"CalculatedAttribute": "satisfaction_score",
"Operator": "GREATER_THAN",
"ValueCondition": 8,
"Points": 10
}
]
}
}
```
**注記**
**現時点では、ドーナツはデータソースとして計算属性のみをサポートします。**
**すべての条件定義には、タイトル、色、計算属性、演算子、値条件、ポイント値を含める必要があります。**
# エージェントワークスペースにプロファイルエクスプローラーを追加する
デフォルトでは、適切な[セキュリティプロファイルのアクセス許可](enabling-profile-explorer.md)を持つユーザーは、 Amazon Connect 管理者ウェブサイトでプロファイルエクスプローラーを表示できます。エージェントがエージェントワークスペースでプロファイルエクスプローラーにアクセスできるようにすることもできます。このトピックでは、その方法について説明します。
次の図は、エージェントワークスペースのプロファイルエクスプローラーの例を示しています。
![\[エージェントワークスペース、プロファイルエクスプローラータブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/profile-explorer-agent-workspace.png)
## エージェントと共有するプロファイルエクスプローラーレイアウトを作成する
以下に高レベルの概要を示します。
1. プロファイルエクスプローラーレイアウトを作成するための[セキュリティプロファイルのアクセス許可](enabling-profile-explorer.md)があることを確認します。
1. [Amazon Connect Customer Profiles のプロファイルエクスプローラーの使用を開始する](getting-started-profile-explorer.md) の手順に従って、エージェントと共有するレイアウトを作成して保存します。
## プロファイルエクスプローラーを統合として Amazon Connect に追加する
1. Amazon Connect コンソールの左側のナビゲーションで、次の図に示すように****統合を選択します。
![\[Amazon Connect コンソール、統合メニュー項目。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/integrations.png)
1. **統合**ページで、**統合の追加**を選択します。
1. **統合の追加**ページで、**基本情報**セクションの次のフィールドに入力します。
1. **[表示名]**: アプリケーションのフレンドリー名。**この名前は、エージェントワークスペースのタブでエージェントに表示されます**。セキュリティプロファイルにも表示されます。この名前は後で変更できます。
1. **統合識別子**: 統合に固有の公式名。アクセス URL ごとに 1 つの統合しかない場合は、アクセス URL のオリジンを使用することをお勧めします。この名前を変更することはできません。
1. **[説明]** (オプション): このアプリケーションの説明を任意で入力できます。この説明はエージェントには表示されません。
1. **統合タイプ**: **標準アプリケーション**を選択します。
1. **[コンタクトのスコープ]**: **[コンタクトごと]** を選択します。これは、着信コールのサポートに必要な設定です。
1. **[初期化タイムアウト]**: ワークスペースとの接続を確立するために許容される最大時間 (ミリ秒単位)。
次の図は、これらのフィールドの設定を示しています。初期化タイムアウトは 5 秒に設定されています。
![\[エージェントワークスペースのプロファイルエクスプローラーで設定された基本情報セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/add-integration.png)
1. **[アクセス]** セクションで、以下のフィールドを入力します。
1. **[アクセス URL]**: アプリケーションがホストされている URL。この URL は、https で始まるセキュアな URL でなければなりません。ただし、ローカルホストの場合は除きます。
**重要**
URL には `?_appLayoutMode=embedded` が含まれている必要があります。例えば、次のようになります。
`https://{CONNECT_INSTANCE}/customer-profiles/profile-explorer?_appLayoutMode=embedded`
を含めない場合`?_appLayoutMode=embedded`、 Amazon Connect 管理ウェブサイトの左側のナビゲーションがエージェントワークスペースに表示されます。
このフィールドで許可される内容の詳細については、「[統合](3p-apps.md#onboard-3p-apps-how-to-integrate)」を参照してください。
1. **[承認済みオリジン - オプション]**: アクセス URL と異なる場合に許可すべき許可リスト URL。この URL は、https で始まるセキュアな URL でなければなりません。ただし、ローカルホストの場合は除きます。
1. **[アクセス許可]** と **[Iframe 設定]** の 2 つのセクションへの入力はオプションで、プロファイルエクスプローラーのエージェントワークスペースへの追加には必須ではありません。これらのセクションの詳細については、「[統合](3p-apps.md#onboard-3p-apps-how-to-integrate)」を参照してください。
1. **[インスタンスの関連付け]**: エージェントが使用しているインスタンスを選択します。
このアカウントリージョン内の任意のインスタンスに、この統合へのアクセスを許可できます (複数可）。
1. [**Add integration**] (統合の追加) を選択します。
## 新しいセキュリティプロファイルへのアクセス許可をエージェントに割り当てる
このステップでは、新しい統合にアクセスするためのエージェントアクセス許可を割り当て、プロファイルエクスプローラーにアクセス許可を表示する必要があります。
1. Amazon Connect 管理ウェブサイトで、 **エージェント**セキュリティプロファイルに移動します。
1. **[セキュリティプロファイルの編集]** ページで、以下のアクセス許可を割り当てます。
+ **Customer Profiles** - **プロファイルエクスプローラー** - **表示**
+ **エージェントアプリケーション** - **統合の名前** - **アクセス**
次の図は、**プロファイルエクスプローラー**という名前の新しい統合に追加されたアクセス許可の例を示しています。
![\[新しい統合のセキュリティプロファイルのアクセス許可。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/profile-explorer-securityperms.png)
## 新しいアプリケーションをピン留めするようにエージェントに伝える
通常のコミュニケーション方法を使用して、エージェントワークスペースに新しいアプリケーションをピン留めするようにエージェントに伝えます これにより、ワークスペースインスタンス全体でプロファイルエクスプローラーにアクセスできます。
+ 次の図に示すように、エージェントワークスペースでさらに表示アイコンを選択して、**[タブをピン留めする]** を選択します。
![\[エージェントワークスペース、タブをピン留めするオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/pin-tab.png)
## サポートされている機能
上記のステップを完了すると、プロファイルエクスプローラーは着信コンタクトの検索をサポートします。以下がサポートされています。
+ 電話とチャット: フルサポート
+ カスタムコンタクト属性: プロファイルエクスプローラーが読み取るユーザー定義属性の完全なサポート。フロー内でユーザー定義属性を設定して、顧客ユースケースをサポートできます。例えば、次のようになります。
```
{
"profileSearchKey": "_phone",
"profileSearchValue": "" }
```
詳細については、「[顧客プロファイルを自動的に入力する](auto-pop-customer-profile.md)」を参照してください。
# 予測インサイト (プレビュー)
*Predictive Insights* (プレビュー) は、人工知能を使用して顧客向けにパーソナライズされた製品とコンテンツのレコメンデーションを生成する Amazon Connect Customer Profiles の機能です。顧客とのインタラクションデータを分析することで、Predictive Insights は、すべての顧客とのタッチポイントでより関連性の高いエクスペリエンスを提供するのに役立ちます。
## Predictive Insights の仕組み
Predictive Insights (プレビュー) は AI モデルを使用して顧客の行動パターンを分析し、リアルタイムのレコメンデーションを生成します。サービスは、購入履歴やブラウジングアクティビティなどのカスタマーインタラクションデータを処理し、パターンや好みを特定します。
+ **ステップ 1: **既存のデータコネクタを使用してインタラクションデータをプロファイルに追加し、顧客インタラクションデータを使用して AI モデルをトレーニングする
+ **ステップ 2:** S3 に項目カタログを追加して、Customer Profiles が を介して項目データにアクセスできるようにする AWS マネジメントコンソール
+ **ステップ 3:** レコメンデーションタイプ (類似アイテム、頻繁にペアリングされるアイテム、人気アイテム) を定義してレコメンデーションを作成する
+ **ステップ 4:** エージェントワークスペース、フロー、Connect AI エージェントを含む Amazon Connect エコシステム全体にレコメンデーションを適用する
## 前提条件
+ **Customer Profiles でデータストアを有効にする**
Customer Profiles を使用して AI モデルをトレーニングするには、データストアを有効にする必要があります。詳細については、Customer Profile Data Store の詳細を参照してください。
+ **KMS**
でデータを暗号化するように Customer Profiles を設定しました AWS KMS key。
+ **セキュリティプロファイル**
予測インサイトを有効にして、表示 (予測インサイトのリストと表示）、レコメンデーションの作成 (レコメンデーションの作成）、削除 (レコメンデーションの削除）、編集 (レコメンデーションの更新) のアクセス許可をサポートするようにセキュリティプロファイルを設定しました。
## Predictive Insights を使用する利点
Predictive Insights の使用には、いくつかの主な利点があります。
+ パーソナライズされたレコメンデーションによるカスタマーエクスペリエンスの向上
+ 関連する製品の提案を通じて販売機会を増やす
+ 関連するレコメンデーションを自動的に表示してエージェントの時間を節約する
+ すべての顧客のタッチポイントで一貫したレコメンデーションを提供する
+ 顧客の行動の変化に応じてリアルタイムで提案を更新する
# Predictive Insights の使用を開始する
Predictive Insights の使用を開始するには、次の手順に従います。
**Topics**
+ [
## ステップ 1: インタラクションデータを Customer Profiles に追加する
](#add-interaction-data)
+ [
## ステップ 2: Item Catalog データを追加する
](#add-item-catalog-data)
+ [
## ステップ 3: 予測インサイトを作成する
](#create-predictive-insights)
+ [
## ステップ 4: カスタマーエンゲージメントチャネル全体で Predictive Insights を使用する
](#use-across-customer-engagement-channels)
## ステップ 1: インタラクションデータを Customer Profiles に追加する
Customer Profiles の既存のデータコネクタを活用して、インタラクションデータを標準の Web Analytics Object にマッピングできます。
詳細については、「[ウェブ分析オブジェクトのオブジェクトタイプマッピング](standard-loyalty-promotion-object-mapping-web-analytics.md)」を参照してください。
## ステップ 2: Item Catalog データを追加する
Standard Catalog データを使用して、ドメイン内のカタログ内の個々の製品を表すことができます。このカタログデータはドメインレベルに存在し、特定の顧客プロファイルには関連付けられていません。これは、パーソナライズ機能に活用できる製品の構造化された表現として機能します。カタログ情報を取り込んで維持するための柔軟なオプションを提供するデータコネクタを使用して、製品または項目情報をドメインオブジェクトとして Customer Profiles にインポートし、製品データをシステム内で最新に保ち、アクセスできるようにします。
詳細については、「[Item Catalog のオブジェクトタイプマッピング](standard-loyalty-promotion-object-mapping-item-catalog.md)」を参照してください。
## ステップ 3: 予測インサイトを作成する
Amazon Connect を使用すると、特定の製品レコメンデーションのニーズに合わせた特殊な AI モデルを構築およびデプロイできます。これらのモデルは、Connect Web UI を介して設定することも、独自のビジネスシナリオに合わせて APIs を介してプログラムで設定することもできます。Predictive Insights には、いくつかのタイプのレコメンデーションが用意されています。
1. **推奨 **- 特定のユーザーに合わせたパーソナライズされたレコメンデーションを提供します。レコメンデーションは、クリックストリームイベント、購入イベント、消費されたコンテンツなどのユーザーの過去の動作に基づいています。
1. **類似アイテム** - 生成 AI を使用して、カタログ内の既存のアイテムとテーマ的に類似しているアイテムを検索します。顧客が代替アイテムのレコメンデーションをユーザーに提供したいアップセリングまたは代替ユースケースに最適です。
1. **頻繁にペアになる項目** - カタログ内の既存の項目と頻繁に相互作用する項目を推奨します。クロスセリングまたは補完的なアイテムレコメンデーションのユースケースに最適です。
1. **人気アイテム ** - ユーザーによって最も一般的にやり取りされるアイテムを推奨するように設計されています。
1. **現在トレンド **- では、最近の期間でエンゲージメント速度が最も向上したアイテムを推奨しています。これは、ユーザーインタラクションでウイルス性が発生している項目を表面化するように設計されています。
**注記**
Predictive Insights で AI モデルを有効にするには、プレビューで使用できます。今後、追加の料金が適用される場合があります。
**レコメンデーションタイプ別の項目の制限**
次の表は、使用されるレコメンデーションタイプに応じて、レコメンデーション生成の対象となるアイテムの最大数を示しています。
| **レコメンデーションタイプ** | **説明** | **[制限]** |
| --- | --- | --- |
| おすすめ | 予測インサイトで考慮される項目の最大数 | 4,000 万 |
| 類似項目 | 予測インサイトで考慮される項目の最大数 | 1000 万 |
| その他のすべてのビジネスシナリオ | 予測インサイトで考慮される項目の最大数 | 750,000 |
## ステップ 4: カスタマーエンゲージメントチャネル全体で Predictive Insights を使用する
### Connect Flows での Customer Profile Recommendations の使用
このセクションでは、Customer Profiles Get profile recommendations フローブロックを使用して、プロファイルの AI を活用したレコメンデーションをリアルタイムで生成することで、問い合わせ中のユーザーエクスペリエンスを向上させる方法について説明します。
**フローブロックのプロパティ**
**Get profile recommendations** フローブロックには、設定する次のプロパティがあります。
1. **プロファイル ID (必須):**
このブロックを機能させるには、プロファイル ID が必要です。**プロファイルレコメンデーションの取得**フローブロックは、ここで提供されるプロファイル ID のレコメンデーションを生成します。プロファイル ID を手動で入力するか、 属性に保存されている事前定義された値を使用するかを選択できます。事前定義された値を使用する場合は、前の**プロファイルの取得**ブロックを使用してプロファイル ID を指定してください。**プロファイルの取得**ブロックを使用して特定のプロファイルを特定してから、次のブロックでレコメンデーションを生成します。
1. **レコメンダー名 (必須):**
このブロックを機能させるには、レコメンダー名が必要です。これは、指定されたプロファイル ID のレコメンデーションを生成するために使用するレコメンダーの名前です。レコメンデーションの生成には、アクティブなレコメンダーのみを使用できます。
1. **最大結果 (必須):**
指定されたプロファイル ID に対して生成するレコメンデーションの最大数。これは 1～3 のレコメンデーションです。
1. **レコメンデーション属性 (必須):**
問い合わせ属性に保持するレコメンデーションレスポンスの属性を定義します。
1. **項目 ID:**
これは、指定されたプロファイル ID のレコメンデーションを生成するための追加のコンテキストとして提供されるアイテム ID です。アイテム ID は、*「類似アイテム*」または*「頻繁にペアリングされるアイテム*」レコメンダータイプを使用する場合にのみ必要です。プロファイル ID を手動で入力するか、 属性に保存されている事前定義された値を使用するかを選択できます。事前定義された値を使用する場合は、前述の**計算属性の取得ブロックを使用してアイテム ID **を指定してください。**計算属性の取得**ブロックを使用して特定のアイテム ID を特定してから、次のブロックでレコメンデーションを生成します。
**フローブロックブランチ**
**プロファイルレコメンデーションの取得**フローブロックは、問い合わせを次のブランチにルーティングできます。
1. **成功: **
指定されたプロファイル ID のレコメンデーションが正常に生成されました。選択したレコメンデーション属性は、コンタクト属性 \$1.Customer.Recommendations に保持されました。
1. **エラー**:
レコメンデーションの生成中にエラーが発生しました。これは、システムエラー、または**プロファイルレコメンデーションの取得**ブロックの設定方法が原因である可能性があります。
1. **見つかりません:**
レコメンデーションを生成できませんでした。
**ブロックからのレコメンデーションの使用**
レコメンデーションレスポンスは、レコメンデーションオブジェクトの JSON リストとして \$1.Customer.Recommendations 問い合わせ属性 JSONPath に保持されます。各レコメンデーションオブジェクトには、選択した**レコメンデーション属性**が含まれます。
Lambda 関数の次のサンプル Python コードスニペットは、レコメンデーションをプロファイルレコ**メンデーションの取得**ブロックから変換し、他の問い合わせ属性に保持して、レコメンデーションを後続のブロックで使用できるようにする方法を示しています。
```
import boto3
import json
# Handle lambda request
def lambda_handler(event, context):
print("Contact flow data: ", event)
# Transform recommendations
recommendations = event['Details']['Parameters']['Recommendations']
contact_attributes = {}
for i, rec in enumerate(recommendations):
contact_attributes.update(flatten(rec, i))
# Set contact attributes using each recommendation attribute value
print("Setting contact attributes: ", contact_attributes)
try:
client = boto3.client('connect', region_name="us-west-2")
client.update_contact_attributes(
InstanceId=event['Details']['ContactData']['InstanceARN'].rsplit('/', 1)[1],
InitialContactId=event['Details']['ContactData']['InitialContactId'],
Attributes=contact_attributes
)
print("Contact attributes set successfully.")
except Exception as e:
print("Error setting contact attributes: ", e)
# Success response
return {
'statusCode': 200,
'body': json.dumps('Success')
}
# Flatten a nested object into a simple string:string object
def flatten(recommendation, index):
flat = {}
for key, value in recommendation.items():
if isinstance(value, dict):
flat.update(flatten(value, index))
else:
flat[f"Rec{index}_{key}"] = str(value)
return flat
```
**プロファイルレコメンデーションの取得**ブロックを使用してフローを設定したら、それを使用して、問い合わせ中に顧客向けのレコメンデーションを生成できます。
### アウトバウンドキャンペーンでの Customer Profile Recommendations の使用
Predictive Insights を Amazon Connect アウトバウンドキャンペーンと統合して、E メールや SMS チャネルを通じてパーソナライズされたレコメンデーションを提供できます。イベントトリガーキャンペーンを作成するときに、キャンペーンに関連付けられた顧客プロファイルの AI を活用したレコメンデーションを自動的に生成するように、レコメンデーションセクションを設定できます。
この統合では、Web Analytics オブジェクトマッピングをイベントカテゴリとして使用して顧客とのインタラクションデータをキャプチャします。これにより、レコメンデーションエンジンは顧客の行動に基づいて関連性の高いターゲットを絞った提案を提供できます。
イベントトリガーキャンペーンでレコメンデーションを設定するstep-by-stepについては、「」を参照してください[イベントトリガーを使用してアウトバウンドキャンペーンを作成する](how-to-create-campaigns-using-event-triggers.md)。
### セールスレコメンデーション用の Connect AI エージェントのセットアップ
Amazon Q in Connect は、新しい「オーケストレーション」エージェントタイプを通じてエージェント機能を強化します。この機能は、アイテムのレコメンデーションを提供できるセールス AI エージェントの作成に特に役立ちます。特に、アップセルやクロスセルのシナリオで役立ちます。
**ご利用開始にあたって**
実装を開始するには、 にアクセスして Amazon Connect AWS マネジメントコンソール に移動します。アクセス URL を使用して Connect インスタンスにログインしたら、左側のメニューから Amazon Q を見つけ、AI エージェントを選択します。事前設定された AI Agent of Type Orchestration (SalesAgent) は、QiC ページの AI Agents の下書きステータスにあります。このテンプレートには、1P ツールに必要なすべての設定とレコメンデーションのプロンプト例が用意されています。
**カスタムエージェントの作成**
カスタム販売エージェントを作成するには、まずオーケストレーションタイプの新しい AI エージェントを作成し、既存の SalesAgent テンプレートからコピーします。このプロセスは、テンプレートから新しいエージェントにすべてのツールと設定を転送します。
**エージェントをカスタマイズする**
エージェントのプロンプトを更新する場合、管理者には 2 つの主要なオプションがあります。既存のエージェントプロンプトをセールスエージェントプロンプトに追加してアップセル識別手順を追加するか、SalesAgentプロンプトを削除して、現在公開されているエージェントに基づいて新しいオーケストレーションプロンプトを作成し、セールスエージェントプロンプトを追加することで、新しく開始できます。この柔軟性により、特定のビジネスニーズとドメイン要件に合ったカスタマイズされたソリューションが可能になります。
**フロー設定と統合**
エージェント設定を確定して公開した後、次のステップでは、Flows で Amazon Lex ボットを作成します。インバウンドフローを更新して、作成された Lex ボットに GetCustomerInput ブロックを含める必要があり、新しい SalesAgent を追加のオプションで選択する必要があります。プロファイル ID を取得するための Customer Profile フローブロックと Set-Contact Attributes フローブロックの両方を追加し、プロファイル ID と値のキーとして CustomerId を \$1Customer.ProfileId に設定する必要があります。
この実装では、チャット問い合わせと音声通話の両方がサポートされ、顧客入力が Lex ボットの QIC エージェントにシームレスに渡されます。この包括的なセットアップにより、Amazon Connect 環境内で AI 主導の販売レコメンデーションとアップセルの機会が可能になります。システムの柔軟性により、インテリジェントな販売支援のコア機能を維持しながら、特定の業界のニーズに基づいてカスタマイズできます。このソリューションは、AI を活用したレコメンデーションとの顧客とのインタラクションを強化し、最終的にはより効果的な販売およびカスタマーサービスオペレーションをサポートするためのフレームワークを提供します。管理者は、ドメイン固有の指示を追加し、ビジネス要件に合わせてレコメンデーションタイプをカスタマイズすることで、実装をさらに絞り込むことができます。
### エージェントアシスタンスに使用する SalesAgent の設定
エージェントワークスペースの接続チャットウィジェットで Q 内で使用されるように SalesAgent を設定できます。そのためには、主に 2 つのモノを変更する必要があります。
1. AIAgent プロンプトを更新して、問い合わせのトランスクリプトにアクセスする手順を示します。
1. プロンプトエディタで SalesAgent に関連付けられたプロンプトを開き、プロンプトを更新して、 がアクセスできる問い合わせのトランスクリプトにアクセスする手順を追加します。` {{$.transcript}} `
1. 以下は、SalesAgent プロンプトに追加できるサンプルプロンプトです。
```
**IMPORTANT**
**Guide on how to process requests and information:**
- The messages section contains YOUR conversation with the customer service agent
- Respond to the agent's questions/requests in the messages section
- The transcript below is background information about the agent's conversation with their customer
- Do not respond directly to the customer - you are helping the AGENT
Background context from agent-customer conversation.
The following transcript is for your information ONLY. Do not directly respond to messages in this conversation, but instead look at the messages section for what the agent requests you to do.
IF YOU REFERENCE ANY INFORMATION FROM THIS SECTION: You should indicate so by saying "According to your conversation with the customer ..."
{{$.transcript}}
```
1. AIAgent を新しいプロンプトバージョンで更新し、デフォルト設定 → エージェントアシスタンスユースケースをこのエージェントで更新します。
**注記**
セルフサービスとエージェントアシスタンスのユースケースには 2 つの異なる Sales AIAGent を使用することをお勧めします。どちらもプロンプトにわずかな変更が必要なためです。これを行うには、エージェントをクローンし、プロンプトバージョンを変更して、それぞれのユースケースに合わせて正しい AI エージェントを指すようにデフォルト設定を更新します。
1. 問い合わせのインバウンドフローを更新します。
1. GetCustomerInput ブロックを削除し、代わりに Connect Assistant フローブロックを追加します。
1. フローブロック設定に AIAssistant ARN を入力し、適切な AIAGent を選択します。
これで、このフローを通常のインバウンドとして使用でき、Q in Connect チャットウィジェットはユーザーのリクエストに役立つレコメンデーションを提供できるようになります。
## データに関する考慮事項
以下のセクションでは、ユースケースを照合し、Predictive Insights のデータ準備状況を評価する方法に関するガイダンスを提供します。
### ユースケースを Predictive Insights に一致させましたか?
Predictive Insights のパーソナライゼーションタイプは、次のユースケースに対処できます。
+ ユーザー向けにパーソナライズされたレコメンデーションの生成
+ 類似商品や関連商品のレコメンド
+ トレンド商品や人気商品のレコメンド
+ 関連性による項目の順序変更
### アイテムインタラクションデータは十分ですか?
すべてのユースケースとパーソナライゼーションタイプについて、それぞれ少なくとも 2 つのインタラクションを持つ 25 人の一意のユーザーに対して、少なくとも 1,000 件のアイテムインタラクションが必要です。質の高いレコメンデーションを行うには、1,000 人以上のユーザーからのアイテムインタラクションが少なくとも 50,000 件あり、それぞれ 2 回以上のアイテムインタラクションがあることが推奨されます。
### リアルタイムのイベントストリーミングアーキテクチャは導入されていますか?
Connect Customer Profiles にリアルタイムイベントをストリーミングできる場合は、リアルタイムのパーソナライゼーションを活用できます。一部のパーソナライゼーションタイプでは、Predictive Insights はユーザーの最新のアクティビティから学習し、アプリケーションを使用するときにレコメンデーションを更新できます。
### データは Predictive Insights 用に最適化されていますか?
データ内の以下の点を確認することをお勧めします。
+ 欠落している値を確認します。レコードの少なくとも 70% にすべての属性のデータを含めることをおすすめします。NULL 値を許容する列は 70% 以上記入しておくことをお勧めします。
+ 命名規則の不一致、アイテムのカテゴリの重複、データセット間の ID の不一致、ID の重複など、データ内の不正確さや問題を修正します。これらの問題は、レコメンデーションに悪影響を及ぼしたり、予期しない動作につながる可能性があります。例えば、データには「N/A」と「該当なし」の両方が含まれていても、「N/A」のみに基づいてレコメンデーションを除外している場合があります。「該当なし」とマークされたアイテムはフィルターでは削除されません。
+ 複数のジャンルの映画など、アイテム、ユーザー、またはアクションが複数のカテゴリを持つことができる場合は、カテゴリ値を 1 つの属性にまとめ、それぞれの値を \$1 演算子で区切ります。例えば、映画のジャンルデータは、アクション \$1 アドベンチャー \$1 スリラーなどです。
+ 1 つの列に使用できるカテゴリは 1000 個以上にならないようにしてください (列にフィルタリングのみを目的としたデータが含まれている場合を除く)。
# Amazon Connect Customer Profiles API を使用する
プログラムでドメインとプロファイルを管理する方法については、「[Amazon Connect Customer Profiles API Reference](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html)」を参照してください。
## ListObjectTypeAttributeValues API
ListObjectTypeAttributeValues API は、指定された属性の最新の個別の値にアクセスできるため、オブジェクトタイプ内のリアルタイムのデータ検証と整合性チェックに役立ちます。この API はドメイン間で動作し、カスタムオブジェクトタイプと標準オブジェクトタイプの両方をサポートします。API は、オブジェクトタイプ名、属性名、ドメイン名を入力パラメータとして受け入れ、約 350KB のストレージ制限までの値を返します。
**メモ:**
+ フィールドごとに最大 350KB の属性値を保存し、最新の値を最初に優先します。この制限に達すると、新しいエントリのスペースを確保するために、古い値が自動的に削除されます。
## GetObjectTypeAttributeValues API
GetObjectTypeAttributeValues API は、特定のオブジェクトタイプ内の属性に関する統計インサイトを提供しますが、データストアが有効になっているドメインでのみ使用できます。この API は、毎日の計算を実行して属性値に関する統計情報を提供し、データのパターンと傾向を理解するのに役立ちます。統計計算は 1 日に 1 回実行され、属性データ特性の一貫したスナップショットを提供します。
**メモ:**
+ 2 つのシナリオで null 値を受け取ります。
+ データボールトを有効にした後の最初の期間中 (計算サイクルが発生しない限り、1 日に 1 回）。
+ 数値を含まない属性の場合。
Customer Profiles を独自のエージェントアプリケーションに統合する場合は、CustomerProfileJS オープンソースライブラリを使用することをお勧めします。詳細については、[GitHub](https://github.com/amazon-connect/amazon-connect-customer-profiles) の CustomerProfilesJS リポジトリを参照してください。
既存のアプリケーションを Amazon Connect と統合する方法の詳細については、「[Amazon Connect Streams](https://github.com/aws/amazon-connect-streams)」を使用してください。問い合わせコントロールパネル (CCP) コンポーネントをアプリに埋め込むことができます。
# Amazon Connect Customer Profiles での IPv6 サポートについて
## パブリック接続
すべての Amazon Connect Customer Profiles API は IPv4 呼び出しおよび IPv6 呼び出しを完全にサポートしています。
```
profile.Region.api.aws
```
**例：**
```
profile.us-east-1.api.aws
```
AWS CLI では、これらのエンドポイントを明示的に使用する必要があります。
```
aws customer-profiles list-domains \
--endpoint https://profile.us-east-1.api.aws \
--region us-east-1
```
古い API は、下位互換性として引き続き使用できます。これらは、IPv4 呼び出しのみをサポートします。
```
profile.Region.amazonaws.com
```
**例：**
```
profile.us-east-1.amazonaws.com
```
## プライベート接続
Amazon VPC コンソールまたは AWS コマンドラインインターフェイス (AWS CLI) を使用して、Amazon Connect Customer Profiles サービスの VPC エンドポイントを作成できます。詳細については、「AWS PrivateLink ユーザーガイド」の「[インターフェイスエンドポイントの作成](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html)」を参照してください。
次のサービス名を使用して、Amazon Connect Customer Profiles の VPC エンドポイントを作成します。
```
com.amazonaws.Region.profile
```
**例：**
```
com.amazonaws.us-east-1.profile
```
エンドポイントのプライベート DNS を有効にすると、リージョンの IPv4 および IPv6 をサポートする DNS 名 (例、profile.us-east-1.api.aws) を使用して、Amazon Connect Customer Profiles への API リクエストを作成できます。
または、リージョンの古い DNS 名も IPv4 としてのみサポートされます。
**例：**
```
profile.us-east-1.amazonaws.com
```
# 例: Amazon Connect Customer Profiles と Amazon S3 をプログラムで統合する
Customer Profiles の [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API を使用して、S3、Salesforce、Marketo などの統合をプログラムで作成できます。
このトピックでは、現在サポートされている最小値である 15 分の同期間隔で S3 との統合を作成する方法を説明します。
## ステップ 1: JSON ファイルを作成する
次の内容を含む JSON ファイルを作成します。
```
{
"DomainName": "your-domain",
"ObjectTypeName": "your-object-name",
"FlowDefinition": {
"FlowName": "your-flow-name",
"KmsArn": "the key ARN is the same as your domain's key",
"Description": "Created by Customer Profiles",
"TriggerConfig": {
"TriggerType": "Scheduled",
"TriggerProperties": {
"Scheduled": {
"ScheduleExpression": "rate(15minutes)",
"DataPullMode": "Incremental",
"ScheduleStartTime": 1634244800.435,
"FirstExecutionFrom": 1594166400
}
}
},
"SourceFlowConfig": {
"ConnectorType":"S3",
"SourceConnectorProperties": {
"S3": {
"BucketName": "your-bucket",
"BucketPrefix": "your-prefix"
}
}
},
"Tasks": [
{"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
{"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
]
}
}
```
JSON を独自の値でカスタマイズするには、以下のガイドラインに従います。
+ `FlowName`: STRING [a-zA-Z0-9][\$1w\$1@\$1.-]\$1 を使用できる。
+ `ScheduleStartTime`: 現在の `DateTime` \$1 5 分のエポックタイムを設定する
+ `FirstExecutionFrom`: S3 に移動し、ファイルの日付を見て、最も古い日付より前の日付を使用する。
+ `Tasks`: `TaskType` を定義する。`Sourcefields` フィールドには、その配列内の CSV にあるすべての列を指定する必要があります。次に、その配列内の各項目に対して、`ConnectorOperator` を指定する必要があります。次は、`colA` と `colB` の 2 つの列を持つ CSV ドキュメントの例です。
## ステップ 2: PutIntegration API を呼び出す
値を使用して JSON ファイルを作成し、カスタマイズしたら、次の例に示すように [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API を呼び出します。
```
aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2
```
`PutIntegration` からの応答はフロー URI を返します。例:
```
{
"DomainName": "testDomain",
"Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
"ObjectTypeName": "your objec type",
"CreatedAt": "2021-10-14T13:51:57.748000-07:00",
"LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
"Tags": {}
}
```
## ステップ 3: Amazon AppFlow StartFlow API を呼び出す
フロー URI を使用して Amazon AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html) API を呼び出します。例:
```
aws appflow start-flow —flow-name uri --region us-west-2
```