翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 統合された顧客プロファイルデータをエクスポートする
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 サービスにリンクされたロールからのアクセスが拒否されていないこと、およびキーのステータスが [有効] になっていることを確認してください。このエラーを解決するには、データストリーミングを再度有効にします。