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