翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect Customer Profiles のオブジェクトタイプのマッピング定義の詳細
<a name="object-type-mapping-definition-details"></a>

オブジェクトタイプのマッピング定義には、フィールド定義とキー定義の 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)。

## フィールド定義の詳細
<a name="field-definition-details"></a>

フィールド定義は、フィールドのソース、宛先 (ターゲット)、およびタイプを定義します。例: 

```
"Fields": {
        "{fieldName}": {
            "Source": "{source}",
            "Target": "{target}",
            "ContentType": "{contentType}"
        }, ...
    }, ...
```
+ `Source`: これは、フィールドの JSON アクセサか、フィールドの値を生成するための Handlebar マクロです。

  解析対象のソースオブジェクトの名前は ` _source` なので、ソースフィールドのすべてのフィールドの先頭にこの文字列を付ける必要があります。`_source` オブジェクトのみがサポートされています。

  定数を生成し、複数のソースオブジェクトフィールドを 1 つのフィールドに結合するには、Handlebar マクロソリューションを使用します。これは、インデックス作成に役立ちます。
+ `Target`: 標準オブジェクトタイプで、このフィールドのデータをマッピングする場所を指定します。

  標準プロファイルを設定すると、取り込まれるデータの形式について特定の知識がなくても、Customer Profiles 上に構築されたアプリケーションを使用して、データソースから取り込まれたデータを使用できます。

  このフィールドはオプションです。キーに含める目的があるときのみ、フィールドを定義することがあります。

  このフィールドの形式は、常に JSON アクセサです。サポートされているターゲットオブジェクトは、`_profile` のみです。
+ `ContentType`: 値として、STRING、NUMBER、PHONE\_NUMBER、EMAIL\_ADDRESS、NAME がサポートされています。`ContentType` が指定されていない場合、STRING とみなされます。

  `ContentType` は、エージェントが値を検索できるように、値のインデックスを作成する方法を決定するために使用されます。例えば、`ContentType` が PHONE\_NUMBER に設定されている場合、エージェントは任意の形式で電話番号を検索できるように処理されます。文字列「\+15551234567」は「(555)-123-4567」と一致します。

## キー定義の詳細
<a name="key-definition-details"></a>

キーは、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 を使用してキー値によってプロファイルを検索するために使用されます。

## デフォルトの検索キー
<a name="object-type-mapping-default-search-keys"></a>

`_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) で使用すると、プロファイルを検索できます。