

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Pemetaan tipe objek di Profil Pelanggan Amazon Connect
<a name="customer-profiles-object-type-mapping"></a>

Pemetaan tipe objek memberi tahu Profil Pelanggan cara menelan jenis data tertentu. Ini memberikan Profil Pelanggan dengan informasi penting, seperti:
+ Bagaimana data harus diisi dari objek dan dicerna ke dalam objek profil standar. 
+ Bidang apa yang harus diindeks dalam objek dan bagaimana bidang tersebut kemudian harus digunakan untuk menetapkan objek jenis ini ke profil tertentu.

Topik di bagian ini memberikan informasi dan langkah-langkah untuk membantu Anda mengatur pemetaan tipe objek, termasuk cara membuat pemetaan tipe objek, detail definisi pemetaan, serta konsep dan terminologi kunci. 

**Topics**
+ [Terminologi dan konsep pemetaan tipe objek pelanggan](customer-profiles-terminology.md)
+ [Buat pemetaan tipe objek](create-object-type-mapping.md)
+ [Detail definisi pemetaan tipe objek di Amazon Connect Customer Profiles](object-type-mapping-definition-details.md)
+ [Properti tambahan dari jenis objek di Profil Pelanggan](additional-properties-object-types.md)
+ [Profil yang disimpulkan](inferred-profiles.md)
+ [Templat catatan kontak](ctr-contact-record-template.md)
+ [Kaitkan Rekaman Kontak dengan satu profil yang ditemukan menggunakan kunci \$1phone di Profil Pelanggan](auto-associate-profile-using-phone-profile-key.md)
+ [Contoh pemetaan tipe objek di Amazon Connect Customer Profiles](examples-object-type-mappings.md)
+ [Jenis objek profil implisit di Amazon Connect Customer Profiles](implicit-profile-object-types.md)
+ [Pemetaan data bertenaga AI generatif](genai-powered-data-mapping.md)
+ [Batas data Profil Pelanggan](customer-profiles-data-limits.md)

# Terminologi dan konsep pemetaan tipe objek pelanggan
<a name="customer-profiles-terminology"></a>

Terminologi dan konsep berikut adalah pusat pemahaman Anda tentang pemetaan tipe objek kustom. 

**Objek profil standar**  <a name="StandardProfileObject"></a>
*Objek profil standar adalah objek* standar yang berisi semua profil.   
Objek profil standar berisi bidang standar, seperti nomor telepon, alamat email, nama, dan data standar lainnya. Data ini dapat diambil dalam format standar terlepas dari sumbernya (misalnya, Salesforce, ServiceNow, atau Marketo).

**Objek profil**  <a name="ProfileObject"></a>
*Objek profil* adalah satu unit informasi yang diketahui tentang profil. Misalnya, informasi tentang panggilan telepon, tiket, kasus, atau bahkan catatan klik-aliran dari situs web.  
Objek profil tunggal dapat mencapai 250 KB dan dapat berupa dokumen JSON terstruktur apa pun.   
+ Setiap objek profil memiliki tipe. Misalnya, objek profil dapat berupa catatan kontak Amazon Connect, ServiceNow Pengguna, atau Prospek Marketo. 
+ Tipe mengacu pada pemetaan tipe objek.
+ Pemetaan tipe objek mendefinisikan bagaimana objek tertentu harus dicerna ke dalam Profil Pelanggan.

**Profil**  <a name="Profile"></a>
*Profil* berisi semua informasi yang diketahui tentang pelanggan atau kontak tertentu. Ini termasuk objek profil standar tunggal dan sejumlah objek profil tambahan.

**Pemetaan tipe objek**  <a name="ObjectTypeMapping"></a>
*Pemetaan tipe objek* memberi tahu Profil Pelanggan cara menelan jenis data tertentu. Ini memberikan Profil Pelanggan dengan informasi berikut:   
+ Bagaimana data harus diisi dari objek dan dicerna ke dalam objek profil standar. 
+ Bidang apa yang harus diindeks dalam objek dan bagaimana bidang tersebut kemudian harus digunakan untuk menetapkan objek jenis ini ke profil tertentu.

**Templat pemetaan**  <a name="MappingTemplate"></a>
*Template pemetaan* adalah pemetaan tipe objek standar yang disertakan dengan layanan Profil Pelanggan.  
Profil Pelanggan mencakup templat pemetaan untuk catatan kontak Amazon Connect, Akun Salesforce, ServiceNow Pengguna, dan Prospek Marketo. Untuk daftar lengkap template pemetaan yang tersedia, gunakan [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API.  
Dengan templat pemetaan, Anda dapat dengan cepat menyerap data dari sumber terkenal tanpa harus menentukan informasi tambahan apa pun.

# Membuat pemetaan tipe objek di Amazon Connect Customer Profiles
<a name="create-object-type-mapping"></a>

Pemetaan tipe objek memberi tahu Profil Pelanggan cara menelan jenis data tertentu dari aplikasi sumber—seperti Salesforce, Zendesk, atau S3—ke dalam objek profil standar terpadu. Anda kemudian dapat menampilkan data dalam objek tersebut (misalnya, alamat pelanggan dan email) ke agen Anda menggunakan [aplikasi agen Amazon Connect](customer-profile-access.md). 

Pemetaan tipe objek menyediakan Profil Pelanggan dengan informasi berikut: 
+ Bagaimana data harus diisi dari objek dan dicerna ke dalam objek profil standar.
+ Bidang apa yang harus diindeks dalam objek dan bagaimana bidang tersebut kemudian harus digunakan untuk menetapkan objek jenis ini ke profil tertentu.

Ada dua cara Anda dapat membuat pemetaan tipe objek:
+ Gunakan konsol Amazon Connect. Antarmuka pengguna membuat fitur pemetaan data mudah diakses. Misalnya, Anda dapat menambahkan atribut kustom, dan menentukan pencarian dan pengidentifikasi unik untuk model kontak. Tidak diperlukan pengkodean\$1 
+ Gunakan API Profil Pelanggan. Untuk informasi selengkapnya, lihat [Referensi API Profil Pelanggan Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).

Topik ini menjelaskan cara membuat pemetaan menggunakan konsol Amazon Connect.

## Membuat pemetaan data menggunakan konsol Amazon Connect
<a name="create-object-type-mapping-ui"></a>

Amazon Connect memberikan pengalaman tanpa kode untuk memetakan data pelanggan dari aplikasi lokal dan pihak ketiga dengan Amazon S3, Salesforce,, Zendesk, dan Marketo. ServiceNow

Untuk membuat pemetaan data, Anda menentukan pemetaan tipe objek yang menjelaskan seperti apa objek profil kustom itu. Pemetaan ini menentukan bagaimana bidang dari data Anda dapat digunakan untuk mengisi bidang di profil standar atau bagaimana mereka dapat digunakan untuk menetapkan data ke profil tertentu.

### Langkah 1: Mengatur pemetaan data
<a name="step1-how-to-set-up-data-mapping"></a>

1. Buka konsol Amazon Connect di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Amazon Connect Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Amazon Connect**, dengan kotak di sekitar alias instance.  
![\[Halaman instans pusat kontak virtual Amazon Connect, alias instans.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)

1. Di panel navigasi, pilih **Profil pelanggan**, **Pemetaan data**.

1. Pilih **Buat pemetaan data** untuk memulai.

1. Pada halaman **Siapkan pemetaan data**, di bagian **Deskripsi**, tambahkan nama yang akan membantu Anda mengidentifikasi sumber atau tujuan pemetaan ini. Ini adalah meta-data dari tipe objek. 

1. Di bagian **Sumber data**:

   1. Pilih dari mana datanya berasal, seperti Salesforce atau Zendesk. Berdasarkan pilihan Anda, Amazon Connect secara otomatis memilih tujuan yang tersedia berdasarkan templat yang telah ditentukan. 

   1. Pilih objek sumber. Ini digunakan bagi Anda untuk membangun profil terpadu Anda.

   1. Di bagian **Tujuan pemetaan**, pilih data yang ingin Anda gunakan untuk membangun profil pelanggan terpadu Anda. Informasi ini dapat muncul ke arus Anda dan agen untuk mempersonalisasi interaksi dengan kontak.

      Untuk informasi selengkapnya tentang tujuan pemetaan yang didukung, lihat[Tentang pemetaan tujuan di Amazon Connect](about-mapping-destinations.md).

   1. Di bagian **Opsi tambahan**, Anda dapat memilih kapan harus memilih keluar dari membuat profil baru, dan berapa lama untuk mempertahankannya. Opsi ini membantu Anda mengelola biaya.
**catatan**  
Secara default periode retensi domain adalah 366 hari. Untuk mengubah periode retensi yang ditetapkan pada domain Anda, gunakan [UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API. 

1. Jika Anda memilih sumber selain S3, di *application* bagian **Buat koneksi dengan**, pilih sambungan Amazon AppFlow atau Amazon EventBridge yang ada untuk menghubungkan data Anda, atau buat koneksi baru. Anda dapat membuat koneksi baru dengan memasukkan detail tentang akun Anda untuk sumber data ini.

   Setelah koneksi dibuat, Anda akan memilih objek yang ingin Anda konsumsi dari sumber data Anda. 

1. Pilih **Berikutnya**.

### Langkah 2: Atribut peta
<a name="step2-how-to-map-attributes"></a>

Pada halaman **atribut *tipe* Peta**, Anda akan melihat tabel pemetaan bidang diisi dengan template yang telah ditentukan, berdasarkan tujuan pemetaan. Misalnya, diisi dengan atribut pelanggan, produk, kasus, atau pesanan. Anda dapat mengubah template yang telah ditentukan dengan memilih atribut (seperti AccountNumber) dan kemudian memilih tujuan yang berbeda, atau memasukkan salah satu atribut kustom Anda sendiri. 

Gambar berikut menunjukkan contoh halaman yang diisi dengan atribut pelanggan dari template.

![\[Menu navigasi Amazon Connect, halaman atribut pelanggan Peta.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)


Anda dapat menghapus apa yang tidak ingin diisi di profil pelanggan, mengubah sumber, dan menambahkan atribut khusus.

Pemetaan ini menggunakan sumber data Anda untuk mengisi informasi kontak pelanggan, seperti nomor telepon di profil pelanggan. Ini menggunakan atribut dari template profil standar.

**Tip**  
Jika Anda memilih untuk menambahkan atribut khusus, tujuan akan selalu memiliki awalan yang `Attributes.` ditambahkan ke dalamnya. Ini memungkinkan Amazon Connect mengenali bahwa itu adalah atribut khusus.   

![\[Antarmuka pemetaan atribut pelanggan yang menunjukkan bidang sumber yang dipetakan ke bidang tujuan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/custom-attribute-cp.png)

Agen sekarang dapat melihat atribut kustom di Connect Agent Application di bawah tab **Informasi Tambahan** yang diurutkan dalam urutan abjad. Anda dapat membuat nama pilihan Anda untuk setiap atribut yang akan ditampilkan ke agen dengan menggunakan format berikut: `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
Semua atribut kustom yang tertelan akan ditampilkan di Aplikasi Connect Agent. Jika Anda tidak ingin menampilkan informasi tertentu kepada agen Anda, jangan mengonsumsi atribut khusus saat ini.

### Langkah 3: Tentukan pengidentifikasi
<a name="step3-how-to-specify-identifiers"></a>

Pada halaman **Tentukan pengidentifikasi**, lengkapi bagian berikut. Bergantung pada data apa yang Anda petakan, mungkin tidak semua ini akan muncul di halaman Anda.

**catatan**  
Nama-nama `_profileId``_orderId`,`_caseId`,,, dan `_assetId` dicadangkan untuk penggunaan internal. Jika Anda memutuskan untuk menggunakan nama-nama ini sebagai salah satu nama pengenal Anda, mereka harus dinyatakan sebagai`LOOKUP_ONLY`, yang berarti sistem kami tidak akan menyimpannya agar sesuai dengan profil, aset standar, pesanan standar, kasus standar, atau menyimpannya untuk mencari profil, aset, kasus, atau pesanan Anda. Jika Anda ingin kunci ini dapat digunakan untuk mencari dan mencocokkan, Anda harus mengganti nama kunci Anda. Untuk informasi selengkapnya tentang pengenal `LOOKUP_ONLY` standar, lihat[Pengidentifikasi standar untuk menyetel atribut pada kunci di Profil Pelanggan](standard-identifiers.md). 
+ **Pengidentifikasi unik**: Anda harus memiliki pengenal unik untuk data Anda untuk menghindari kesalahan saat tertelan. Pengenal ini juga dikenal sebagai kunci unik. Profil Pelanggan menggunakannya untuk membedakan data ini dari objek sumber data lainnya, dan untuk mengindeks pencarian dan pembaruan data. 

  Hanya ada satu pengenal unik.
+ **Pengidentifikasi pelanggan**: Anda harus memiliki setidaknya satu pengidentifikasi pelanggan untuk data Anda untuk menghindari kesalahan saat tertelan. Pengenal juga dikenal sebagai kunci profil.

  Profil Pelanggan menggunakannya untuk menentukan apakah kasus data dikaitkan dengan profil yang ada atau digunakan untuk membuat profil baru dengan mencari profil lain untuk pengenal ini.

  Anda dapat memiliki beberapa pengidentifikasi pelanggan. 
**Tip**  
Agen dapat menggunakan salah satu Identifier pelanggan ini di Ruang Kerja Agen untuk menemukan profil milik pelanggan pada interaksi.
+ **Pengidentifikasi produk**: Anda harus memiliki setidaknya satu pengidentifikasi produk untuk data Anda untuk menghindari kesalahan saat tertelan. Identifier juga dikenal sebagai kunci aset.

  Profil Pelanggan menggunakannya untuk membedakan data ini dari data pembelian produk pelanggan lainnya. Ini juga digunakan untuk menentukan apakah data dapat dikaitkan dengan profil yang ada atau digunakan untuk membuat profil baru dengan mencari profil lain untuk pengenal ini.

  Anda dapat memiliki beberapa pengidentifikasi produk.
+ **Pengidentifikasi kasus**: Anda harus memiliki setidaknya satu pengidentifikasi kasus untuk data Anda untuk menghindari kesalahan saat tertelan. Pengidentifikasi juga dikenal sebagai kunci kasus.

  Profil Pelanggan menggunakannya untuk membedakan data ini dari data kasus pelanggan lainnya. Ini juga digunakan untuk menentukan apakah data dapat dikaitkan dengan profil yang ada atau digunakan untuk membuat profil baru dengan mencari profil lain untuk pengenal ini.

  Anda dapat memiliki beberapa pengidentifikasi kasus.
+ **Pengenal pesanan**: Anda harus memiliki setidaknya satu pengenal pesanan untuk data Anda untuk menghindari kesalahan saat tertelan. Pengenal juga dikenal sebagai kunci pesanan.

  Profil Pelanggan menggunakannya untuk membedakan data ini dari data pesanan pelanggan lainnya. Ini juga digunakan untuk menentukan apakah data dapat dikaitkan dengan profil yang ada atau digunakan untuk membuat profil baru dengan mencari profil lain untuk pengenal ini.

  Anda dapat memiliki beberapa pengidentifikasi pesanan.
+ **Atribut pencarian tambahan - opsional**: Anda dapat memilih atribut di objek sumber data yang ingin Anda indeks agar dapat dicari. Secara default, semua pengidentifikasi Anda diindeks.
**Tip**  
Jika atribut pencarian di objek sumber data Anda mengandung sebagian besar nilai yang sama, itu dapat mengakibatkan konsumsi data lebih lambat. Sebaiknya buat atribut penelusuran yang unik di objek sumber data Anda.
+ **Stempel waktu objek data: Stempel** waktu objek data digunakan untuk menyelesaikan konflik profil saat Resolusi Identitas diaktifkan untuk mengkonsolidasikan profil serupa. Ketika dua atau lebih profil serupa memiliki catatan yang bertentangan, catatan dari profil dengan stempel waktu yang terbaru diperbarui akan digunakan.

  Anda dapat memilih atribut dalam objek Anda untuk referensi ketika objek Anda terakhir diperbarui.

### Langkah 4: Tinjau dan buat
<a name="step4-how-to-review"></a>

Setelah pemetaan data dibuat, Anda dapat memilih **Tambahkan integrasi sumber data** untuk menggunakan jenis objek ini. 

![\[Antarmuka Profil Pelanggan Amazon Connect yang menampilkan contoh detail pemetaan data dan status integrasi.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)


# Tentang pemetaan tujuan di Amazon Connect
<a name="about-mapping-destinations"></a>

Tujuan pemetaan adalah pemetaan Anda dari sumber ke definisi standar yang sudah ditentukan di Amazon Connect.

Tabel berikut mencantumkan tujuan pemetaan yang didukung.


| Objek sumber | Tujuan: Pelanggan, Produk, Pesanan, Kasus | 
| --- | --- | 
|  S3  | Setiap  | 
|  Rekening Tenaga Penjualan  | Pelanggan  | 
|  Salesforce-Kontak  | Pelanggan  | 
|  Aset Tenaga Penjualan  | Produk  | 
|  Pengguna ZenDesk  | Pelanggan  | 
|  Memimpin pasar  | Pelanggan  | 
|  ServiceNow-sys\$1user  | Pelanggan  | 
|  Segmen-Identifikasi  | Pelanggan  | 
|  Segmen-Pelanggan  | Pelanggan  | 
|  Shopify-Pelanggan  | Pelanggan  | 
|  Shopify- DraftOrder  | Order  | 
|  Tiket Zendesk  | Kasus  | 
|  ServiceNow-tugas  | Kasus  | 
|  Insiden ServiceNow  | Kasus  | 

# Persyaratan pemetaan tipe objek di Profil Pelanggan
<a name="object-type-mapping-requirements"></a>

Informasi berikut harus ada dalam pemetaan tipe objek Anda sehingga Profil Pelanggan dapat memproses data yang masuk: 
+ Definisi semua bidang dalam objek tertelan yang harus dipetakan ke profil standar, atau digunakan untuk menetapkan data ke profil. Ini memberi tahu Profil Pelanggan bidang mana dalam objek **sumber** tertelan yang harus dipetakan ke bidang tertentu dalam objek profil standar.
+ Bidang mana di objek sumber dari data kustom Anda yang harus diindeks dan bagaimana caranya. 

  Ketika data sumber dicerna oleh Profil Pelanggan, bidang yang diindeks menentukan:
  + Profil mana yang dimiliki objek tertentu.
  + Objek mana yang terkait satu sama lain dan harus ditempatkan di profil yang sama. Misalnya, nomor akun atau ID kontak dalam catatan kontak. 
  + Nilai apa yang dapat digunakan untuk menemukan profil. Misalnya, nama kontak dapat diindeks. Ini akan memungkinkan agen untuk menemukan semua profil milik pelanggan dengan nama tertentu. 

## Persyaratan utama
<a name="key-requirements"></a>

Anda harus mendefinisikan setidaknya satu kunci. Profil Pelanggan menggunakan kunci ini untuk memetakan objek profil kustom Anda ke profil.

Pemetaan objek profil kustom juga membutuhkan setidaknya satu kunci yang secara unik mengidentifikasi objek sehingga dapat diperbarui dengan menentukan nilai yang sama dari bidang ini (persyaratan ini dapat dipenuhi dengan satu kunci).

Setiap kunci dapat terdiri dari satu atau lebih bidang. 

## Persyaratan lapangan
<a name="field-requirements"></a>

Definisi bidang menentukan cara membaca nilai untuk nama bidang itu dari objek sumber. Definisi bidang juga menentukan jenis data apa yang disimpan di lapangan.

Nama tipe objek dapat berupa string numerik alfa atau karakter '-' dan '\$1', mereka juga tidak dapat memulai dengan karakter '\$1', yang digunakan untuk tipe objek standar yang dicadangkan.

# Detail definisi pemetaan tipe objek di Amazon Connect Customer Profiles
<a name="object-type-mapping-definition-details"></a>

Definisi pemetaan tipe objek memiliki dua bagian: definisi bidang dan definisi kunci. 

**Tip**  
Untuk mempelajari cara membuat pemetaan tipe objek, lihat posting blog ini: [Menyatukan dan mengatur informasi pelanggan dengan Profil Pelanggan Amazon Connect dengan konektor Amazon S3 yang sudah dibuat sebelumnya](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/). Atau, lihat video ini di YouTube: [Cara Mengintegrasikan Data Profil Pelanggan ke Pengalaman Pusat Kontak Anda](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s).

## Detail definisi bidang
<a name="field-definition-details"></a>

Definisi bidang mendefinisikan sumber, tujuan (target), dan jenis bidang. Contoh:

```
"Fields": {
        "{fieldName}": {
            "Source": "{source}",
            "Target": "{target}",
            "ContentType": "{contentType}"
        }, ...
    }, ...
```
+ `Source`: Ini bisa menjadi pengakses JSON untuk bidang atau makro Setang untuk menghasilkan nilai bidang. 

  Objek sumber yang diuraikan diberi nama ` _source` sehingga semua bidang di bidang sumber perlu diawali oleh string ini. Hanya `_source` objek yang didukung.

  Gunakan solusi makro Setang untuk menghasilkan konstanta dan menggabungkan beberapa bidang objek sumber ke dalam satu bidang. Ini berguna untuk pengindeksan.
+ `Target`: Menentukan di mana dalam tipe objek standar data bidang ini harus dipetakan.

  Mengisi profil standar memungkinkan Anda untuk menggunakan data yang dicerna dari sumber data apa pun dengan aplikasi yang dibangun di atas Profil Pelanggan tanpa pengetahuan khusus tentang format data yang dicerna. 

  Bidang ini bersifat opsional. Anda mungkin ingin mendefinisikan bidang semata-mata untuk tujuan memasukkannya ke dalam kunci. 

  Format bidang ini selalu merupakan pengakses JSON. Satu-satunya objek target yang didukung adalah`_profile`.
+ `ContentType`: Nilai-nilai berikut didukung STRING, NUMBER, PHONE\$1NUMBER, EMAIL\$1ADDRESS, NAME. Jika tidak `ContentType` ada yang ditentukan STRING diasumsikan. 

  `ContentType`digunakan untuk menentukan bagaimana mengindeks nilai sehingga agen dapat mencarinya. Misalnya, jika `ContentType` diatur ke PHONE\$1NUMBER, nomor telepon diproses sehingga agen dapat mencarinya dalam format apa pun: string “\$115551234567" cocok dengan “(555) -123-4567".

## Detail definisi utama
<a name="key-definition-details"></a>

Kunci berisi satu atau beberapa bidang yang bersama-sama mendefinisikan kunci yang dapat digunakan untuk mencari objek (atau profil milik mereka) menggunakan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API. Kuncinya juga dapat didefinisikan untuk mengidentifikasi profil secara unik atau mengidentifikasi objek itu sendiri secara unik.

```
"Keys": {
        "{keyName}": [{
            "StandardIdentifiers": [...],
            "FieldNames": [ "{fieldname}", ...]
        }], ...
    }, ...
```

Nama kunci bersifat global untuk domain. Jika Anda memiliki dua kunci, dengan nama yang sama dalam dua pemetaan tipe objek yang berbeda:
+ Kunci-kunci itu harus menempati namespace yang sama
+ Mereka dapat digunakan untuk berpotensi menghubungkan profil bersama antara objek yang berbeda. Jika mereka cocok antara objek, Profil Pelanggan menempatkan dua objek dalam profil yang sama. 

Untuk mengungkapkannya dengan cara lain: kunci harus memiliki nama kunci yang sama dalam domain jika, dan hanya jika, nilai yang sama berarti bahwa mereka terkait. Misalnya, nomor telepon yang ditentukan dalam satu jenis objek akan terkait dengan nomor telepon yang sama yang ditentukan dalam jenis objek lain. Pengidentifikasi internal yang ditentukan untuk objek yang diimpor dari Salesforce mungkin tidak terkait dengan objek lain yang diimpor dari Marketo, bahkan jika mereka memiliki nilai yang persis sama.

Definisi kunci digunakan dalam dua cara:
+ Di dalam Profil Pelanggan selama konsumsi, mereka digunakan untuk mencari tahu profil apa objek harus ditugaskan. 
+ Mereka memungkinkan Anda untuk menggunakan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk mencari nilai kunci dan menemukan profil. 

## Tombol pencarian default
<a name="object-type-mapping-default-search-keys"></a>

Kunci pencarian default, seperti `_phone` dan`_email`, telah ditentukan sebelumnya oleh template objek [Profil Standar](standard-profile-definition.md), [Aset Standar](standard-asset-definition.md), [Pesanan Standar](standard-order-definition.md), dan [Kasus Standar](standard-case-definition.md). Anda dapat menggunakan kunci pencarian default sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil.

# Pengidentifikasi standar untuk menyetel atribut pada kunci di Profil Pelanggan
<a name="standard-identifiers"></a>

Pengidentifikasi standar memungkinkan Anda untuk mengatur atribut pada kunci. Tentukan pengidentifikasi mana yang akan digunakan berdasarkan bagaimana Anda ingin data dicerna di profil. Misalnya, Anda menandai nomor telepon dengan profil pengenal. Ini berarti nomor telepon harus diperlakukan sebagai pengenal unik. Jika Profil Pelanggan mendapat dua kontak dengan nomor telepon yang sama, kontak akan digabungkan menjadi satu profil. 


| Nama pengenal | Deskripsi | 
| --- | --- | 
|  PREFERENSI UDARA  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi preferensi udara. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari preferensi udara apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  PEMESANAN UDARA  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi pemesanan udara. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari pemesanan udara apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  SEGMEN UDARA  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi segmen udara. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari segmen udara yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1PREFERENSI  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi preferensi hotel. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari preferensi hotel yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1STAY\$1REVENUE  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi pendapatan menginap hotel. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari pendapatan menginap hotel yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1RESERVASI  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi reservasi hotel. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari reservasi hotel yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  KESETIAAN  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi loyalitas. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari loyalitas apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOYALTY\$1TRANSACTION  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi transaksi loyalitas. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari setiap transaksi loyalitas yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOYALTY\$1PROMOTION  |  Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi promosi loyalitas. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari promosi loyalitas apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  UNIK  | Identifier ini harus ditentukan oleh tepat satu indeks untuk setiap jenis objek. Kunci ini digunakan untuk mengidentifikasi objek dari tipe objek secara unik untuk mengambilnya atau jika diperlukan memperbarui objek yang dikirimkan di kemudian hari.  Semua bidang yang membentuk kunci UNIK harus ditentukan saat mengirimkan objek baru atau ditolak.  | 
|  PROFIL  | Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi profil. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari profil apa pun yang memiliki kunci ini terkait dengannya.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOOKUP\$1ONLY  | Pengidentifikasi ini menunjukkan kunci tidak disimpan setelah menelan objek. Kuncinya hanya digunakan untuk menentukan profil selama konsumsi.  Nilai kunci tidak terkait dengan profil selama konsumsi, yang berarti tidak dapat digunakan untuk memungkinkan pencarian atau mencocokkan objek yang dicerna nanti dengan kunci yang sama.    Anda tidak dapat menentukan kunci sebagai pengenal dan `UNIQUE` `LOOKUP_ONLY` pengidentifikasi.   Anda hanya dapat menggunakan `PROFILE` bersama-sama dengan `LOOKUP_ONLY` jika setidaknya ada satu kunci lain yang memiliki `PROFILE` pengenal tanpa `NEW_ONLY` atau `LOOKUP_ONLY` pengidentifikasi. Satu-satunya pengecualian adalah `_profileId` kuncinya, yang dapat memiliki kombinasi `PROFILE` dan `LOOKUP_ONLY` pengenal sendiri.     | 
|  NEW\$1ONLY  | Jika profil belum ada sebelum objek dicerna, kuncinya dikaitkan dengan profil. Jika tidak, kunci hanya digunakan untuk mencocokkan objek dengan profil.     Anda tidak dapat menentukan kunci sebagai pengenal dan `UNIQUE` `NEW_ONLY` pengidentifikasi.   Anda hanya dapat menggunakan `PROFILE` bersama-sama dengan `NEW_ONLY` jika setidaknya ada satu kunci lain yang memiliki `PROFILE` pengenal tanpa `NEW_ONLY` atau `LOOKUP_ONLY` pengidentifikasi.     | 
|  SEKUNDER  | Selama pencocokan objek ke profil, Profil Pelanggan pertama-tama mencari semua kunci PROFIL yang tidak memiliki pengenal SEKUNDER. Ini dianggap pertama. Kunci SEKUNDER hanya dipertimbangkan jika tidak ada profil yang cocok ditemukan menggunakan tombol ini.  | 
|  ASET  | Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi aset. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari aset apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  PESANAN  | Pengenal ini berarti bahwa kunci ini secara unik mengidentifikasi pesanan. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari pesanan apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 
|  KASUS  | Identifier ini berarti bahwa kunci ini secara unik mengidentifikasi sebuah kasus. Ketika pengenal ini ditentukan, itu berarti bahwa selama konsumsi, Profil Pelanggan mencari kasus apa pun yang memiliki kunci ini terkait dengannya. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/standard-identifiers.html)  | 

## Pengidentifikasi yang kompatibel
<a name="standard-identifiers-compatibility"></a>

![\[Matriks menunjukkan pengidentifikasi dan nama kunci yang diizinkan dan dibatasi untuk tipe data yang berbeda.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)


# Bagaimana Profil Pelanggan memproses definisi kunci
<a name="how-profile-assignment-works"></a>

Ketika Profil Pelanggan menyerap pemetaan objek kustom, ia memproses definisi kunci. Diagram berikut menunjukkan bagaimana memproses pengidentifikasi standar dalam definisi kunci untuk menentukan profil mana yang akan ditetapkan objek. 

![\[Diagram alir yang menampilkan proses pemeriksaan kunci profil untuk menetapkan atau mengantri objek.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-template1.png)


# Bagaimana Profil Pelanggan menambahkan kunci ke indeks untuk pencarian
<a name="how-keys-are-added-index"></a>

Diagram berikut menunjukkan bagaimana Profil Pelanggan memproses pengidentifikasi standar untuk menentukan apakah akan mempertahankan kunci. 

![\[Diagram alur yang menunjukkan proses keputusan untuk mempertahankan kunci di Profil Pelanggan berdasarkan pencarian dan kriteria objek baru.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-template2.png)


Diagram alur menunjukkan langkah-langkah berikut:

1. Apakah kuncinya telah `LOOKUP_ONLY` ditentukan?
   + Jika Ya, jangan pertahankan kuncinya.

1. Jika Tidak, apakah kuncinya telah `NEW_ONLY` ditentukan?
   + Jika Tidak, simpan kunci dalam indeks untuk memungkinkannya digunakan untuk pencarian.

1. Jika Ya, apakah menelan objek menghasilkan pembuatan profil baru? 
   + Jika Ya, simpan kunci dalam indeks untuk memungkinkannya digunakan untuk pencarian.
   + Jika Tidak, jangan simpan kunci dalam indeks untuk pencarian masa depan.

# Pemetaan tipe objek untuk profil standar di Amazon Connect Customer Profiles
<a name="object-type-mapping-standard-profile"></a>

Topik di bagian ini memberikan definisi profil standar, dan pemetaan jenis objek dari aplikasi eksternal ke profil standar.

**Topics**
+ [Persyaratan AppFlow akses Amazon](appflow-access-requirements-profile.md)
+ [Persyaratan AppIntegrations akses Amazon](standard-profile-appintegrations-requirements.md)
+ [Persyaratan EventBridge akses Amazon di Profil Pelanggan](standard-profile-eventbridge-requirements.md)
+ [Definisi profil standar](standard-profile-definition.md)
+ [Memetakan objek Salesforce](mapping-salesforce-objects.md)
+ [Memetakan objek Zendesk](mapping-zendesk-objects.md)
+ [Memetakan objek Marketo](mapping-marketo-objects.md)
+ [Memetakan objek ServiceNow](mapping-servicenow-objects.md)
+ [Pemetaan objek Segmen](mapping-segment-objects.md)
+ [Pemetaan objek Shopify](mapping-shopify-objects.md)

# Persyaratan AppFlow akses Amazon di Profil Pelanggan
<a name="appflow-access-requirements-profile"></a>

Gunakan persyaratan AppFlow akses Amazon berikut untuk membuat dan menghapus Zendesk, Marketo, Salesforce, dan integrasi ServiceNow dengan Profil Pelanggan Amazon Connect:
+ Appflow: CreateFlow
+ Appflow: DeleteFlow

# Persyaratan AppIntegrations akses Amazon di Profil Pelanggan
<a name="standard-profile-appintegrations-requirements"></a>

Gunakan persyaratan AppIntegrations akses Amazon berikut untuk membuat dan menghapus integrasi Segmen dan Shopify dengan Profil Pelanggan Amazon Connect:


+ integrasi aplikasi: GetEventIntegration
+ integrasi aplikasi: ListEventIntegrationAssociations
+ integrasi aplikasi: CreateEventIntegrationAssociation
+ integrasi aplikasi: DeleteEventIntegrationAssociation

# Persyaratan EventBridge akses Amazon di Profil Pelanggan
<a name="standard-profile-eventbridge-requirements"></a>

Gunakan persyaratan EventBridge akses Amazon berikut untuk membuat dan menghapus integrasi Segmen dan Shopify dengan Profil Pelanggan Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Definisi profil standar di Amazon Connect Customer Profiles
<a name="standard-profile-definition"></a>

Tabel berikut mencantumkan semua bidang dalam objek profil standar Profil Pelanggan.


| Bidang profil standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  ProfileId  | String  | Pengidentifikasi unik dari profil pelanggan.  | 
|  AccountNumber  | String  | Nomor rekening unik yang telah Anda berikan kepada pelanggan. | 
|  AdditionalInformation  | String  | Setiap informasi tambahan yang relevan dengan profil pelanggan. | 
|  PartyType  | String  | Jenis profil yang digunakan untuk menggambarkan pelanggan. Nilai yang valid: INDIVIDU \$1 BISNIS \$1 LAINNYA | 
|  BusinessName  | String  | Nama bisnis pelanggan. | 
|  FirstName  | String  | Nama depan pelanggan. | 
|  MiddleName  | String  | Nama tengah pelanggan. | 
|  LastName  | String  | Nama belakang pelanggan. | 
|  BirthDate  | String  | Tanggal lahir pelanggan. | 
|  Gender  | String  | Jenis kelamin yang dengannya pelanggan mengidentifikasi. | 
|  PhoneNumber  | String  | Nomor telepon pelanggan, yang belum ditentukan sebagai nomor ponsel, rumah, atau bisnis. | 
|  MobilePhoneNumber  | String  | Nomor ponsel pelanggan. | 
|  HomePhoneNumber  | String  | Nomor telepon rumah pelanggan. | 
|  BusinessPhoneNumber  | String  | Nomor telepon bisnis pelanggan. | 
|  EmailAddress  | String  | Alamat email pelanggan, yang belum ditentukan sebagai alamat pribadi atau bisnis. | 
|  PersonalEmailAddress  | String  | Alamat email pribadi pelanggan. | 
|  BusinessEmailAddress  | String  | Alamat email bisnis pelanggan. | 
|  Alamat  | Alamat  | Alamat umum yang terkait dengan pelanggan yang tidak mengirim surat, pengiriman, atau penagihan. | 
|  ShippingAddress  | Alamat  | Alamat pengiriman pelanggan. | 
|  MailingAddress  | Alamat  | Alamat surat pelanggan. | 
|  BillingAddress  | Alamat  | Alamat penagihan pelanggan. | 
|  Atribut  | String-to-string peta  | Pasangan kunci-nilai atribut dari profil pelanggan. | 
|  ProfileType  | String  | Jenis profil. Nilai yang valid: PROFIL \$1 ACCOUNT\$1PROFILE  | 
|  EngagementPreferences  | EngagementPreferences  | Preferensi keterlibatan pelanggan atau akun. | 

Objek profil standar diindeks oleh kunci dalam tabel berikut.


| Nama indeks standar | Bidang profil standar | 
| --- | --- | 
| \$1telepon | PhoneNumber, MobilePhoneNumber, HomePhoneNumber, atau BusinessPhoneNumber | 
| \$1email | EmailAddress, PersonalEmailAddress, atau BusinessEmailAddress | 
| \$1akun | AccountNumber | 
| \$1ProfileID | ProfileId | 
| \$1Nama lengkap | "FirstName MiddleName LastName" | 

Misalnya, Anda dapat menggunakan `_phone` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang PhoneNumber,, MobilePhoneNumber HomePhoneNumber, atau BusinessPhoneNumber atributnya cocok dengan nilai penelusuran.

## Tipe data alamat
<a name="address-data-type"></a>


| Bidang profil standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  Alamat1  | String  | Baris pertama dari alamat pelanggan.  | 
|  Alamat2  | String  | Baris kedua dari alamat pelanggan.  | 
|  Alamat3  | String  | Baris ketiga dari alamat pelanggan.  | 
|  Alamat4  | String  | Baris keempat dari alamat pelanggan.  | 
|  Kota  | String  | Kota tempat pelanggan tinggal.  | 
|  Negara  | String  | Negara tempat pelanggan tinggal.  | 
|  Kabupaten  | String  | Kabupaten tempat pelanggan tinggal.  | 
|  PostalCode  | String  | Kode pos alamat pelanggan.  | 
|  Propinsi  | String  | Provinsi tempat pelanggan tinggal.  | 
|  Status  | String  | Keadaan di mana pelanggan tinggal.  | 

## EngagementPreferences tipe data
<a name="engagement-preferences-data-type"></a>


| Bidang profil standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  Email  |  Array ContactPreference objek  |  Daftar preferensi kontak terkait email.  | 
|  Telepon  |  Array ContactPreference objek  |  Daftar preferensi kontak terkait telepon.  | 

## ContactPreference tipe data
<a name="contact-preference-data-type"></a>


| Bidang profil standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  KeyName  |  String  |  Pengidentifikasi unik yang dapat dicari dari profil pelanggan.  | 
|  KeyValue  |  String  |  Nilai kunci yang digunakan untuk mencari profil berdasarkan KeyName.  | 
|  ProfileId  |  String  |  Pengidentifikasi unik dari profil pelanggan.  | 
|  ContactType  |  String  |  Jenis kontak yang digunakan untuk keterlibatan. Nilai yang Valid: PhoneNumber MobilePhoneNumber HomePhoneNumber \$1 BusinessPhoneNumber \$1 \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress  | 

# Memetakan objek Salesforce ke profil standar di Amazon Connect Customer Profiles
<a name="mapping-salesforce-objects"></a>

Topik ini mencantumkan bidang mana di objek Salesforce yang dipetakan ke bidang di objek profil standar di Profil Pelanggan.

## Objek Salesforce-Account
<a name="salesforceaccountobject"></a>

Berikut ini adalah daftar semua bidang dalam objek Salesforce-Account. Bidang dalam objek Salesforce-Account Anda dapat bervariasi tergantung pada konfigurasi instans Salesforce Anda.
+ Id
+ IsDeleted
+ MasterRecordId
+ Nama
+ Tipe
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.Kota
+ BillingAddress.Negara
+ BillingAddress.GeoCodeakurasi
+ BillingAddress.garis lintang
+ BillingAddress.bujur
+ BillingAddress.Kode pos
+ BillingAddress.negara
+ BillingAddress.jalan
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.kota
+ ShippingAddress.negara
+ ShippingAddress.garis lintang
+ ShippingAddress.bujur
+ ShippingAddress.Kode pos
+ ShippingAddress.negara
+ ShippingAddress.jalan
+ Telepon
+ Faks
+ AccountNumber
+ Website
+ PhotoUrl
+ Sic
+ Industri
+ AnnualRevenue
+ NumberOfEmployees
+ Kepemilikan
+ TickerSymbol
+ Deskripsi
+ Peringkat
+ Situs
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Gergaji ukir
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer

## Memetakan objek Salesforce-Account ke profil standar
<a name="mapping-salesforceaccountobject"></a>

Subset bidang dalam peta objek Salesforce-Account ke objek profil standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Salesforce-Account ke profil standar. (Tabel mencakup pemetaan untuk instance Salesforce yang telah dikonfigurasi untuk menyertakan bidang Person.)


| Bidang sumber Salesforce-Account | Bidang target profil standar | 
| --- | --- | 
|  Id  | Atribut. sfdcAccountId  | 
|  Nama  | BusinessName  | 
|  Telepon  | PhoneNumber  | 
|  BillingStreet  | BillingAddress.Alamat1  | 
|  BillingCity  | BillingAddress.Kota  | 
|  BillingState  | BillingAddress.Negara  | 
|  BillingCountry  | BillingAddress.Negara  | 
|  BillingPostalCode  | BillingAddress.PostalCode  | 
|  ShippingStreet  | ShippingAddress.Alamat1  | 
|  ShippingCity  | ShippingAddress.Kota  | 
|  ShippingState  | ShippingAddress.Negara  | 
|  ShippingCountry  | ShippingAddress.Negara  | 
|  ShippingPostalCode  | ShippingAddress.PostalCode  | 
|  IsPersonAccount  | PartyType  | 
|  PersonMobilePhone  | MobilePhoneNumber  | 
|  PersonHomePhone  | HomePhoneNumber  | 
|  PersonEmail  | PersonalEmailAddress  | 
|  PersonMailingAddress.Jalan  | MailingAddress.Alamat1  | 
|  PersonMailingAddress.Kota  | MailingAddress.Kota  | 
|  PersonMailingAddress.Negara  | MailingAddress.Negara  | 
|  PersonMailingAddress.Negara  | MailingAddress.Negara  | 
|  PersonMailingAddress.PostalCode  | MailingAddress.PostalCode  | 
|  PersonBirthDate  | BirthDate  | 
|  PersonOtherStreet  | Alamat.Alamat1  | 
|  PersonOtherCity  | Alamat.City  | 
|  PersonOtherState  | Alamat.State  | 
|  PersonOtherCountry  | Alamat.Negara  | 
|  PersonOtherPostalCode  | Alamat. PostalCode  | 
|  FirstName  | FirstName  | 
|  LastName  | LastName  | 
|  MiddleName  | MiddleName  | 
|  AccountNumber  | AccountNumber  | 

Data pelanggan Salesforce-Account dari objek Salesforce dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber Salesforce-Account | 
| --- | --- | 
|  \$1salesforceAccountId  | Id  | 

Misalnya, Anda dapat menggunakan `_salesforceAccountId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil. Anda dapat menemukan objek Salesforce-Account yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke`ProfileId`. `ObjectTypeName` `Salesforce-Account`

## Objek Salesforce-Contact
<a name="salesforcecontactobject"></a>

Berikut ini adalah daftar semua bidang dalam objek Salesforce-Contact.
+ Id
+ IsDeleted
+ MasterRecordId
+ Akuntd
+ LastName
+ FirstName
+ Salam
+ Nama
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.kota
+ OtherAddress.negara
+ OtherAddress.GeoCodeakurasi
+ OtherAddress.garis lintang
+ OtherAddress.Kode pos
+ OtherAddress.negara
+ OtherAddress.jalan
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.kota
+ MailingAddress.negara
+ MailingAddress.GeoCodeakurasi
+ MailingAddress.garis lintang
+ MailingAddress.bujur
+ MailingAddress.Kode pos
+ MailingAddress.negara
+ MailingAddress.jalan
+ Telepon
+ Faks
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ Email
+ judul
+ Departemen
+ AssistantName
+ LeadSource
+ Tanggal Lahir
+ Deskripsi
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ CURequestTanggal Terakhir
+ CUUpdateTanggal Terakhir
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Gergaji ukir
+ JigawContactId
+ CleanStatus
+ IndividualId

## Memetakan objek Salesforce-Contact ke profil standar
<a name="mapping-salesforcecontactobject"></a>

Subset bidang dalam peta objek Salesforce-Contact ke objek profil standar di Profil Pelanggan. Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Salesforce-Contact ke objek profil standar.


| Bidang sumber Salesforce-Contact | Bidang target profil standar | 
| --- | --- | 
|  Id  | Atribut. sfdcContactId  | 
|  AccountId  | Atribut. sfdcAccountId  | 
|  LastName  | LastName  | 
|  FirstName  | FirstName  | 
|  MiddleName  | MiddleName  | 
|  OtherStreet  | Alamat.Alamat1  | 
|  OtherCity  | Alamat.City  | 
|  OtherState  | Alamat.State  | 
|  OtherCountry  | Alamat.Negara  | 
|  OtherPostalCode  | Alamat. PostalCode  | 
|  MailingStreet  | MailingAddress.Alamat1  | 
|  MailingCity  | MailingAddress.Kota  | 
|  MailingState  | MailingAddress.Negara  | 
|  MailingCountry  | MailingAddress.Negara  | 
|  MailingPostalCode  | MailingAddress.PostalCode  | 
|  Telepon  | PhoneNumber  | 
|  HomePhone  | HomePhoneNumber  | 
|  MobilePhone  | MobilePhoneNumber  | 
|  Email  | EmailAddress  | 
|  Tanggal Lahir  | BirthDate  | 

Data pelanggan Salesforce-Contact dari objek Salesforce dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber Salesforce-Contact | 
| --- | --- | 
|  \$1salesforceContactId  | Id  | 
|  \$1salesforceAccountId  | AccountId  | 

Misalnya, Anda dapat menggunakan `_salesforceAccountId` dan `_salesforceContactId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil. Anda dapat menemukan objek Salesforce-Contact yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke`ProfileId`. `ObjectTypeName` `Salesforce-Contact`

# Memetakan objek Zendesk ke profil standar di Amazon Connect Customer Profiles
<a name="mapping-zendesk-objects"></a>

Topik ini mencantumkan bidang mana di objek Zendesk yang dipetakan ke bidang di profil standar di Profil Pelanggan.

## Objek pengguna ZenDesk
<a name="zendeskusersobject"></a>

Berikut ini adalah daftar semua bidang dalam objek ZenDesk-Users.
+ id
+ url
+ external\$1id
+ Email
+ aktif
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ detail
+ last\$1login\$1at
+ tempat
+ locale\$1id
+ moderator
+ catatan
+ hanya\$1private\$1comments
+ default\$1group\$1id
+ telepon
+ shared\$1phone\$1number
+ foto
+ restricted\$1agent
+ peran
+ bersama
+ tag
+ tanda tangan
+ tergantung
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ diverifikasi
+ laporan\$1csv
+ dibuat\$1at
+ updated\$1at

## Memetakan pengguna Zendesk ke profil standar
<a name="mapping-zendeskusersobject"></a>

Subset dari bidang dalam peta objek ZenDesk-Users ke profil standar di Profil Pelanggan. Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek ZenDesk-Users ke profil standar.


| Bidang sumber pengguna ZenDesk | Bidang target profil standar | 
| --- | --- | 
|  id  | Atribut. ZendeskUserId  | 
|  external\$1id  | Atribut. ZendeskExternalId  | 
|  Email  | EmailAddress  | 
|  telepon  | PhoneNumber  | 

Data pelanggan pengguna Zendesk dari objek Zendesk dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks berikut. 


| Nama Indeks Standar | Bidang sumber pengguna ZenDesk | 
| --- | --- | 
|  \$1zendeskUserId  | Id  | 
|  \$1zendeskExternalId  | external\$1id  | 

Misalnya, Anda dapat menggunakan `_zendeskUserId` dan `_zendeskExternalId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil pelanggan Amazon Connect. Anda dapat menemukan objek ZenDesk-Users yang terkait dengan profil pelanggan tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Zendesk-users`

# Memetakan objek Marketo ke profil standar di Amazon Connect Customer Profiles
<a name="mapping-marketo-objects"></a>

Topik ini mencantumkan bidang mana di objek Marketo yang dipetakan ke bidang di objek profil standar di Profil Pelanggan.

## Objek marketo-lead
<a name="marketo-objects"></a>

Berikut ini adalah daftar semua bidang dalam objek Marketo-leads
+ id
+ FirstName
+ Nama terakhir
+ MiddleName
+ Email
+ telepon
+ MobilePhone
+ BillingStreet
+ BillingCity
+ BillingState
+ Negara Penagihan
+ billingPostalCode
+ alamat
+ kota
+ status
+ negeri
+ kode pos
+ gender
+ dateOfBirth

## Pemetaan Market-mengarah ke profil standar
<a name="mapping-marketo-leads-object"></a>

Subset bidang di peta objek Marketo-lead ke profil standar.


| Bidang sumber marketo-lead | Bidang target profil standar | 
| --- | --- | 
|  id  | Atribut. MarketoLeadId  | 
|  sfdcAccountId  | Atribut. sfdcAccountId  | 
|  sfdcContactId  | Atribut. sfdcContactId  | 
|  FirstName  | FirstName  | 
|  Nama terakhir  | LastName  | 
|  MiddleName  | MiddleName  | 
|  Email  | EmailAddress  | 
|  telepon  | PhoneNumber  | 
|  MobilePhone  | MobilePhoneNumber  | 
|  MobilePhone  | MobilePhoneNumber  | 
|  BillingStreet  | BillingAddress.Alamat1  | 
|  BillingCity  | BillingAddress.Kota  | 
|  BillingState  | BillingAddress.Negara  | 
|  Negara Penagihan  | BillingAddress.Negara  | 
|  billingPostalCode  | BillingAddress.PostalCode  | 
|  alamat  | Alamat.Alamat1  | 
|  kota  | Alamat.City  | 
|  status  | Alamat.State  | 
|  negeri  | Alamat.Negara  | 
|  kode pos  | Alamat. PostalCode  | 
|  gender  | Gender  | 
|  dataOfBirth  | BirthDate  | 

Data pelanggan Marketo-lead dari Marketo dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber marketo-lead | 
| --- | --- | 
|  \$1marketoLeadId  | id  | 
|  \$1salesforceAccountId  | sfdcAccountId  | 
|  \$1salesforceContactId  | sfdcContactId  | 

Misalnya, Anda dapat menggunakan`_marketoLeadId`,`_salesforceAccountId`, dan `_salesforceContactId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil pelanggan Amazon Connect. Anda dapat menemukan objek Marketo-leads yang terkait dengan profil pelanggan tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Marketo-leads`

# Memetakan ServiceNow objek ke objek profil standar di Amazon Connect Customer Profiles
<a name="mapping-servicenow-objects"></a>

Topik ini mencantumkan bidang mana dalam ServiceNow objek yang dipetakan ke bidang di objek profil standar di Amazon Connect Customer Profiles.

## ServiceNow-sys\$1user objek
<a name="servicenow-sys-user-object"></a>

Berikut ini adalah daftar semua bidang dalam objek ServiceNow-sys\$1user
+ sys\$1id
+ aktif
+ gedung
+ calendar\$1integration
+ kota
+ perusahaan
+ cost\$1center
+ negeri
+ date\$1format
+ default\$1perspective
+ departemen
+ edu\$1status
+ Email
+ karyawan\$1number
+ enable\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ pengantar
+ last\$1login
+ last\$1login\$1device
+ last\$1login\$1time
+ last\$1name
+ last\$1password
+ ldap\$1server
+ lokasi
+ locked\$1out
+ manajer
+ middle\$1name
+ mobile\$1phone
+ name
+ pemberitahuan
+ password\$1needs\$1reset
+ telepon
+ foto
+ preferred\$1language
+ peran
+ jadwal
+ sumber
+ status
+ jalan
+ 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
+ format waktu\$1
+ time\$1zone
+ title
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip

## Memetakan ServiceNow-sys\$1Users ke objek profil standar
<a name="mapping-servicenow-sys-user-object"></a>

Subset dari bidang dalam peta objek ServiceNow-SYS\$1USERS ke objek profil standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek ServiceNow-SYS\$1USERS ke profil standar.


| Bidang sumber ServiceNow-sys\$1Users | Bidang target profil pelanggan | 
| --- | --- | 
|  sys\$1id  | Atribut. ServiceNowSystemId  | 
|  first\$1name  | FirstName  | 
|  last\$1name  | LastName  | 
|  middle\$1name  | MiddleName  | 
|  gender  | Gender  | 
|  Email  | EmailAddress  | 
|  telepon  | PhoneNumber  | 
|  home\$1phone  | HomePhoneNumber  | 
|  mobile\$1phone  | MobilePhoneNumber  | 
|  jalan  | Alamat.Alamat1  | 
|  kota  | Alamat.City  | 
|  status  | Alamat.State  | 
|  negeri  | Alamat.Negara  | 
|  zip  | Alamat. PostalCode  | 

Data pelanggan ServiceNow-sys\$1user dari objek Servicenow dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber ServiceNow-sys\$1user | 
| --- | --- | 
|  \$1 serviceNowSystem Id  | sys\$1id  | 

Misalnya, Anda dapat menggunakan `_serviceNowSystemId` dan `_serviceNowIncidentId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil pelanggan Amazon Connect. Anda dapat menemukan objek ServiceNow-sys\$1user yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke. `ProfileId` `ObjectTypeName` `Servicenow-sys_user`

# Memetakan objek Segmen ke objek profil standar di Amazon Connect Customer Profiles
<a name="mapping-segment-objects"></a>

Topik ini mencantumkan bidang mana dalam objek Segmen yang dipetakan ke bidang di objek profil standar di Profil Pelanggan Amazon Connect.

## Segmen-Identifikasi objek
<a name="segment-identify-object"></a>

Berikut ini adalah daftar semua bidang dalam objek Segmen-Identifikasi.
+ userId
+ bidang umum - lihat [Spesifikasi: Bidang Umum](https://segment.com/docs/connections/spec/common/) dalam dokumentasi Segmen
+ Segmen sifat yang dicadangkan - lihat [Karakter](https://segment.com/docs/connections/spec/identify/#traits) dalam dokumentasi Segmen
+ traits.address.street 
+ traits.address.city
+ traits.address.state
+ Traits.Address.PostalCode
+ traits.address.country
+ sifat-sifat.usia
+ sifat-sifat.avatar
+ sifat-sifat.ulang tahun
+ traits.company.name
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ Sifat-sifat.createdat
+ sifat-sifat.deskripsi
+ sifat-sifat.email
+ Traits.firstName
+ sifat-sifat.gender
+ traits.id
+ Traits.lastName
+ sifat-sifat.name
+ traits.phone
+ traits.title
+ sifat-sifat.nama pengguna
+ traits.website

## Memetakan Segmen-Identifikasi ke objek profil standar
<a name="mapping-segment-identify-object"></a>

Subset dari bidang dalam peta objek Segmen-Identifikasi ke objek profil standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Segmen-Identifikasi ke profil standar.


| Bidang sumber Segmen-Identifikasi | Bidang target profil standar | 
| --- | --- | 
|  | Bidang target profil standar | 
| userId | Atribut. SegmentUserId | 
| traits.company.name | BusinessName | 
| Traits.firstName | FirstName | 
| Traits.lastName | LastName | 
| sifat-sifat.ulang tahun | BirthDate | 
| sifat-sifat.gender | Gender | 
| traits.phone | PhoneNumber | 
| sifat-sifat.email | EmailAddress | 
| traits.address.street | Alamat.Alamat1 | 
| traits.address.city | Alamat.City | 
| traits.address.state | Alamat.State | 
| traits.address.country | Alamat.Negara | 
| Traits.Address.PostalCode | Alamat. PostalCode | 

### Contoh
<a name="example-mapping-segment-identify-object"></a>

Contoh berikut menunjukkan cara memetakan bidang sumber ke bidang target.

```
"segmentUserId": {
    "Source": "_source.detail.event.detail.userId",
    "Target": "_profile.Attributes.SegmentUserId"
}
```

Data pelanggan Identifikasi Segmen dari objek Segment dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks berikut. 


| Nama Indeks Standar | Bidang sumber Segmen-Identifikasi | 
| --- | --- | 
|  \$1segmentUserId  |  userId  | 

Misalnya, Anda dapat menggunakan `_segmentUserId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil pelanggan Amazon Connect. Anda dapat menemukan objek Segment-Identifikasi yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Segment-Identify`

# Memetakan objek Shopify ke objek profil standar di Amazon Connect Customer Profiles
<a name="mapping-shopify-objects"></a>

Topik ini mencantumkan bidang mana di objek Shopify yang dipetakan ke bidang di objek profil standar di Amazon Connect Customer Profiles.

## Objek Shopify-Pelanggan
<a name="shopify-identify-object"></a>

Berikut ini adalah daftar semua bidang dalam objek Shopify-Customer.


+ menerima\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ alamat
+ mata uang
+ dibuat\$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
+ Email
+ 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
+ not
+ orders\$1count
+ telepon
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1at
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ status
+ tag
+ bebas pajak
+ tax\$1exemptions
+ total\$1spent
+ updated\$1at
+ email terverifikasi\$1

## Memetakan objek Shopify-Customer ke profil standar
<a name="mapping-shopify-customer-object"></a>

Subset bidang di peta objek Shopify-Customer ke objek profil standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Shopify-Customer ke profil standar.


| Bidang sumber Shopify-Pelanggan | Bidang target profil standar | 
| --- | --- | 
| id | Atribut. ShopifyCustomerId | 
| email | EmailAddress | 
| first\$1name | FirstName | 
| last\$1name | LastName | 
| note | AdditionalInformation | 
| phone | PhoneNumber | 
| default\$1address.address1 | Alamat.Alamat1 | 
| default\$1address.address2 | Alamat.Alamat2 | 
| default\$1address.city | Alamat.City | 
| default\$1address.province | Alamat.Provinsi | 
| default\$1address.country | Alamat.Negara | 
| default\$1address.zip | Alamat. PostalCode | 

### Contoh
<a name="example-mapping-shopify-customer-object"></a>

Contoh berikut menunjukkan cara memetakan bidang sumber ke bidang target.

```
"shopifyCustomerId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_profile.Attributes.ShopifyCustomerId"
}
```

Data pelanggan Shopify-Customer dari objek Shopify dikaitkan dengan profil pelanggan Amazon Connect menggunakan indeks berikut.


| Nama Indeks Standar | Bidang sumber Shopify-Pelanggan | 
| --- | --- | 
| \$1shopifyCustomerId | id | 

Misalnya, Anda dapat menggunakan `_shopifyCustomerId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API untuk menemukan profil pelanggan Amazon Connect. Anda dapat menemukan objek Shopify-Customer yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke`ProfileId`. `ObjectTypeName` `Shopify-Customer`

# Pemetaan tipe objek untuk pesanan standar di Amazon Connect Customer Profiles
<a name="object-type-mapping-standard-order"></a>

Topik di bagian ini memberikan definisi urutan standar, dan pemetaan jenis objek dari aplikasi eksternal ke urutan standar.

**Topics**
+ [Persyaratan AppIntegrations akses Amazon](standard-order-appintegrations-requirements.md)
+ [Persyaratan EventBridge akses Amazon](standard-order-eventbridge-requirements.md)
+ [Definisi pesanan standar](standard-order-definition.md)
+ [Pemetaan objek Shopify](mapping-shopify-objects-standard-order.html.md)

# Persyaratan AppIntegrations akses Amazon
<a name="standard-order-appintegrations-requirements"></a>

Gunakan persyaratan AppIntegrations akses Amazon berikut untuk membuat dan menghapus integrasi Shopify dengan Profil Pelanggan Amazon Connect:
+ integrasi aplikasi: GetEventIntegration
+ integrasi aplikasi: ListEventIntegrationAssociations
+ integrasi aplikasi: CreateEventIntegrationAssociation
+ integrasi aplikasi: DeleteEventIntegrationAssociation

# Persyaratan EventBridge akses Amazon
<a name="standard-order-eventbridge-requirements"></a>

Gunakan persyaratan EventBridge akses Amazon berikut untuk membuat dan menghapus integrasi Shopify dengan Profil Pelanggan Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Profil Pelanggan bidang objek pesanan standar
<a name="standard-order-definition"></a>

Tabel berikut mencantumkan semua bidang dalam objek pesanan standar Profil Pelanggan.


| Bidang pesanan standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| OrderId | String | Pengidentifikasi unik dari pesanan standar. | 
| CustomerEmail | String | Alamat email pelanggan. | 
| CustomerPhone | String | Nomor telepon pelanggan. | 
| CreatedDate | String | Tanggal pesanan dibuat. | 
| UpdatedDate | String | Tanggal pesanan diperbarui. | 
| ProcessedDate | String | Tanggal pesanan diproses. | 
| ClosedDate | String | Tanggal pesanan ditutup. | 
| CancelledDate | String | Tanggal pesanan dibatalkan. | 
| CancelReason | String | Alasan pembatalan pesanan. | 
| Nama | String | Nama pesanan. | 
| AdditionalInformation | String | Setiap informasi tambahan yang relevan dengan pesanan. | 
| Gateway | String | Gateway pembayaran pesanan. | 
| Status | String | Status pesanan. | 
| StatusCode | String | Kode status pesanan. Nilai yang valid: DRAFT \$1 DIAKTIFKAN | 
| StatusUrl | String | URL status pesanan. | 
| CreditCardNumber | String | Kartu kredit pelanggan bertahan empat digit. | 
| CreditCardCompany | String | Perusahaan kartu kredit pelanggan. | 
| FulfillmentStatus | String | Status pemenuhan pesanan. | 
| TotalPrice | String | Harga total pesanan. | 
| TotalTax | String | Total pajak pesanan. | 
| TotalDiscounts | String | Total diskon pesanan. | 
| TotalItemsPrice | String | Harga total item pesanan. | 
| TotalShippingPrice | String | Total harga pengiriman pesanan. | 
| TotalTipReceived | String | Total tip pesanan diterima. | 
| Mata Uang | String | Mata uang pesanan. | 
| TotalWeight | String | Berat total pesanan. | 
| BillingAddress | OrderAddress | Alamat penagihan pelanggan. | 
| ShippingAddress | OrderAddress | Alamat pengiriman pelanggan. | 
| OrderItems | OrderItem daftar | Barang pesanan. | 
| Atribut | String-to-string peta | Pasangan kunci-nilai atribut dari urutan standar. | 

Objek urutan standar diindeks oleh kunci dalam tabel berikut.


| Nama indeks standar | Bidang pesanan standar | 
| --- | --- | 
| \$1OrderId | OrderId | 

Misalnya, Anda dapat menggunakan `_orderId` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang memiliki urutan yang OrderId cocok dengan nilai pencarian. Anda dapat menemukan objek urutan standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) dengan `ProfileId` dan `ObjectTypeName` disetel ke`_order`.

## OrderAddress tipe data
<a name="orderaddress-data-type"></a>


| Bidang pesanan standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama yang terkait dengan alamat pesanan. | 
| Alamat1 | String | Baris pertama dari alamat pesanan. | 
| Alamat2 | String | Baris kedua dari alamat pesanan. | 
| Alamat3 | String | Baris ketiga dari alamat pesanan. | 
| Alamat4 | String | Baris keempat dari alamat pesanan. | 
| Kota | String | Kota alamat pesanan. | 
| Kabupaten | String | Kabupaten alamat pesanan. | 
| Status | String | Keadaan alamat pesanan. | 
| Propinsi | String | Provinsi alamat pesanan. | 
| Negara | String | Negara alamat pesanan. | 
| PostalCode | String | Kode pos alamat pesanan. | 

## OrderItem tipe data
<a name="orderitem-data-type"></a>


| Bidang pesanan standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| judul | String | Judul item pesanan. | 
| Harga | String | Harga barang pesanan. | 
| Kuantitas | String | Jumlah item pesanan. | 

# Memetakan objek Shopify ke urutan standar di Amazon Connect Customer Profiles
<a name="mapping-shopify-objects-standard-order.html"></a>

Topik ini mencantumkan bidang mana di objek Shopify yang dipetakan ke bidang dalam objek urutan standar di Profil Pelanggan.

## Shopify- objek DraftOrder
<a name="shopify-draftorder-object.html"></a>

Untuk daftar semua bidang dalam objek Shopify- lihat DraftOrder [ DraftOrder Objek dalam dokumentasi](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) Shopify.

## Memetakan DraftOrder objek Shopify- ke urutan standar
<a name="shopify-draftorder-object-standardorder.html"></a>

Subset dari bidang di Shopify- peta DraftOrder objek ke objek urutan standar di Profil Pelanggan.

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari DraftOrder objek Shopify- ke urutan standar.

 `StatusCode`Itu `ACTIVATED` jika `order_status_url` ada di sumbernya. Jika tidak, `StatusCode` adalah`DRAFT`.


|  Shopify- bidang sumber DraftOrder  |  Bidang target pesanan standar  | 
| --- | --- | 
| id | Atribut. ShopifyOrderId | 
| customer.id | Atribut. ShopifyCustomerId | 
| not | AdditionalInformation | 
| Email | CustomerEmail | 
| mata uang | Mata Uang | 
| dibuat\$1at | CreatedDate | 
| updated\$1at | UpdatedDate | 
| name | Nama | 
| status | Status | 
| order\$1status\$1url | StatusCode | 
| billing\$1address.address1 | BillingAddress.Alamat1 | 
| billing\$1address.address2 | BillingAddress.Alamat2 | 
| billing\$1address.city | BillingAddress.Kota | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provinsi | 
| billing\$1address.country | BillingAddress.Negara | 
| billing\$1address.name | BillingAddress.Nama | 
| shipping\$1address.address1 | ShippingAddress.Alamat1 | 
| shipping\$1address.address2 | ShippingAddress.Alamat2 | 
| shipping\$1address.city | ShippingAddress.Kota | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provinsi | 
| shipping\$1address.country | ShippingAddress.Negara | 
| shipping\$1address.name | ShippingAddress.Nama | 
| invoice\$1url | StatusUrl | 
| total\$1price | TotalPrice | 
| total\$1pajak | TotalTax | 
| line\$1items [] .title | OrderItems[] .Judul | 
| line\$1items [] .harga | OrderItems[] .Harga | 
| line\$1items [] .kuantitas | OrderItems[] .Kuantitas | 

### Contoh
<a name="example-shopify-draftorder-object-standardorder.html"></a>

Contoh berikut menunjukkan cara memetakan bidang sumber ke bidang target.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

Data DraftOrder pelanggan Shopify- dari objek Shopify dikaitkan dengan pesanan standar Amazon Connect menggunakan indeks berikut.


| Nama Indeks Standar  | Shopify- bidang sumber DraftOrder  | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Misalnya, Anda dapat menggunakan `_shopifyOrderId` sebagai `ObjectFilter.KeyName` dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan urutan standar. Anda dapat menemukan Shopify- DraftOrder objek yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Shopify-DraftOrder`

## Objek Shopify-Order
<a name="shopify-order-object.html"></a>

Untuk daftar semua bidang dalam objek Shopify-Order lihat objek Order dalam dokumentasi [Shopify](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object).

## Memetakan objek Shopify-Order ke pesanan standar
<a name="mapping-shopify-order-object-standarorder.html"></a>

Subset dari bidang di peta objek Shopify-Order ke objek pesanan standar di Profil Pelanggan.

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Shopify-Order ke urutan standar.

`StatusCode`Itu `ACTIVATED` jika `order_status_url` ada di sumbernya. Jika tidak, `StatusCode` adalah`DRAFT`.


| Bidang sumber Shopify-Order | Bidang target pesanan standar | 
| --- | --- | 
| id | Atribut. ShopifyOrderId | 
| customer.id | Atribut. ShopifyCustomerId | 
| batal\$1at | CancelledDate | 
| pembatalan\$1alasan | CancelReason | 
| tertutup\$1at | ClosedDate | 
| dibuat\$1at | CreatedDate | 
| mata uang | Mata Uang | 
| Email | CustomerEmail | 
| financial\$1status | Status | 
| order\$1status\$1url | StatusCode | 
| pemenuhan\$1status | FulfillmentStatus | 
| pintu gerbang | Gateway | 
| name | Nama | 
| not | AdditionalInformation | 
| order\$1status\$1url | StatusUrl | 
| telepon | CustomerPhone | 
| diproses\$1at | ProcessedDate | 
| total\$1diskon | TotalDiscounts | 
| total\$1line\$1items\$1price | TotalItemsPrice | 
| total\$1price | TotalPrice | 
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice | 
| total\$1pajak | TotalTax | 
| total\$1tip\$1received | TotalTipReceived | 
| total\$1weight | TotalWeight | 
| updated\$1at | UpdatedDate | 
| billing\$1address.address1 | BillingAddress.Alamat1 | 
| billing\$1address.address2 | BillingAddress.Alamat2 | 
| billing\$1address.city | BillingAddress.Kota | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provinsi | 
| billing\$1address.country | BillingAddress.Negara | 
| billing\$1address.name | BillingAddress.Nama | 
| payment\$1details.credit\$1card\$1number | CreditCardNumber | 
| payment\$1details.credit\$1card\$1company | CreditCardCompany | 
| shipping\$1address.address1 | ShippingAddress.Alamat1 | 
| shipping\$1address.address2 | ShippingAddress.Alamat2 | 
| shipping\$1address.city | ShippingAddress.Kota | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provinsi | 
| shipping\$1address.country | ShippingAddress.Negara | 
| shipping\$1address.name | ShippingAddress.Nama | 
| line\$1items [] .title | OrderItems[] .Judul | 
| line\$1items [] .harga | OrderItems[] .Harga | 
| line\$1items [] .kuantitas | OrderItems[] .Kuantitas | 

### Contoh
<a name="example-shopify-draftorder-object-standardorder.html"></a>

Contoh berikut menunjukkan cara memetakan bidang sumber ke bidang target.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

Data pelanggan Shopify-Order dari objek Shopify dikaitkan dengan pesanan standar Amazon Connect menggunakan indeks berikut.


| Nama Indeks Standar | Bidang sumber Shopify-Order | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Misalnya, Anda dapat menggunakan `_shopifyOrderId` sebagai `ObjectFilter.KeyName` dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan urutan standar. Anda dapat menemukan objek Shopify-Order yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke`ProfileId`. `ObjectTypeName` `Shopify-Order`

# Pemetaan tipe objek untuk catatan komunikasi standar
<a name="object-type-mapping-standard-communiction-record"></a>

Topik di bagian ini memberikan definisi catatan komunikasi standar, dan pemetaan jenis objek dari acara kampanye ke catatan komunikasi standar.

**Topics**
+ [Profil Pelanggan bidang objek catatan komunikasi standar](customer-profiles-standard-communication-record-object-fields.md)
+ [Memetakan objek Kampanye ke catatan komunikasi standar di Amazon Connect Customer Profiles](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)

# Profil Pelanggan bidang objek catatan komunikasi standar
<a name="customer-profiles-standard-communication-record-object-fields"></a>

 Tabel berikut mencantumkan semua bidang dalam objek catatan komunikasi standar Profil Pelanggan. 


|  Bidang CommunicationRecord standar  |  Jenis data  |  Deskripsi  | 
| --- | --- | --- | 
|  CommunicationRecordId  |  String  |  Pengidentifikasi unik dari catatan komunikasi standar.  | 
|  Channel  |  String  |  Metode yang digunakan untuk menghubungi pusat kontak Anda. Misalnya: SUARA, OBROLAN, EMAIL  | 
|  ConnectInstanceArn  |  String  |  ARN dari instance AWS Connect.  | 
|  CreatedDate  |  String  |  Stempel waktu yang menunjukkan kapan catatan komunikasi dibuat.  | 
|  UpdatedDate  |  String  |  Stempel waktu yang menunjukkan kapan catatan komunikasi terakhir diperbarui.  | 
|  LastEventType  |  String  |  Jenis acara dari acara terakhir dicerna untuk komunikasi ini.  | 
|  Kampanye  |  Kampanye  |  Detail tentang kampanye yang terkait dengan komunikasi ini.  | 
|  Titik akhir  |  Titik akhir  |  Informasi tentang titik akhir yang digunakan untuk komunikasi ini.  | 
|  Peristiwa  |  Peta<String, Event>  |  Peta peristiwa di mana kuncinya adalah jenis acara seperti email yang dikirimkan, dibuka, atau diklik. Ini melacak peristiwa terakhir dari setiap jenis peristiwa unik yang terjadi selama komunikasi ini.  | 
|  Atribut  |  Peta<String, String>  |  Pasangan kunci-nilai atribut dari catatan komunikasi standar.  | 

 Objek rekaman komunikasi standar diindeks oleh kunci dalam tabel berikut. 


|  Nama indeks standar  |  Bidang catatan komunikasi standar  | 
| --- | --- | 
|  \$1communicationRecordId  |  CommunicationRecordId  | 

 Misalnya, Anda dapat menggunakan `_communicationRecordId` sebagai nama kunci dengan [SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API untuk menemukan profil yang memiliki catatan komunikasi yang `CommunicationRecordId` cocok dengan nilai pencarian. Anda dapat menemukan `communicationRecord` objek standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke`_communicationRecord`. 

## Tipe data kampanye
<a name="campaign-data-type"></a>


|  Field  |  Jenis data  |  Deskripsi  | 
| --- | --- | --- | 
|  CampaignId  |  String  |  ID unik untuk kampanye keluar.  | 
|  CampaignName  |  String  |  Nama kampanye keluar.  | 
|  CampaignRunId  |  String  |  ID unik untuk menjalankan kampanye tertentu.  | 
|  CampaignActivityId  |  String  |  ID unik aktivitas dalam kampanye.  | 
|  SegmentArn  |  String  |  ARN dari segmen pengguna.  | 

## Tipe data titik akhir
<a name="endpoint-data-type"></a>


|  Field  |  Jenis data  |  Deskripsi  | 
| --- | --- | --- | 
|  EndpointAddress  |  String  |  Alamat titik akhir (misalnya, alamat email, nomor telepon).  | 
|  EndpointType  |  String  |  Jenis titik akhir seperti email default atau email bisnis.  | 

## Tipe data acara
<a name="event-data-type"></a>


|  Field  |  Jenis data  |  Deskripsi  | 
| --- | --- | --- | 
|  UpdatedDate  |  String  |  Stempel waktu yang menunjukkan kapan peristiwa komunikasi terjadi.  | 
|  EventId  |  String  |  Pengidentifikasi unik untuk setiap acara komunikasi.  | 
|  EventType  |  String  |  Jenis acara komunikasi spesifik.  | 
|  Atribut  |  Peta<String, String>  |  Pasangan kunci-nilai atribut khusus untuk jenis acara.  | 

# Memetakan objek Kampanye ke catatan komunikasi standar di Amazon Connect Customer Profiles
<a name="mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles"></a>

 Topik ini mencantumkan bidang mana dalam objek Kampanye yang dipetakan ke bidang dalam objek catatan komunikasi standar di Profil Pelanggan. 

## Objek Kampanye-Email
<a name="campaign-email-object"></a>

 Untuk daftar semua bidang dalam objek Campaign-Email, lihat [objek Email](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html) di dokumentasi Amazon SES. 

**Memetakan objek Campaign-Email ke catatan komunikasi standar**

 Subset bidang dalam peta objek Campaign-Email ke objek catatan komunikasi standar di Profil Pelanggan. 

 Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Campaign-Email ke catatan komunikasi standar. 


|  Bidang sumber Kampanye-Email  |  Bidang target catatan komunikasi standar  | 
| --- | --- | 
|  campaign\$1event\$1id  |  Atribut. LastCampaignEventId  | 
|  outbound\$1request\$1id  |  Atribut. OutboundCampaignRequestId  | 
|  campaign\$1message\$1id  |  Atribut. CampaignMessageId  | 
| channel.name  |  Channel  | 
|  saluran.subtipe  |  Atribut. ChannelSubType  | 
|  endpoint\$1address  |  Titik akhir. EndpointAddress  | 
|  endpoint\$1type  |  Titik akhir. EndpointType  | 
|  instance\$1arn  |  ConnectInstanceArn  | 
|  nama\$1kampanye\$1  |  Kampanye. CampaignName  | 
|  campaign\$1id  |  Kampanye. CampaignId  | 
|  campaign\$1run\$1id  |  Kampanye. CampaignRunId  | 
|  campaign\$1activity\$1id  |  Kampanye. CampaignActivityId  | 
|  segment\$1arn  |  Kampanye. SegmentArn  | 
|  outbound\$1request\$1creation\$1timestamp  |  CreatedDate  | 
|  campaign\$1event\$1timestamp  |  UpdatedDate  | 
|  campaign\$1event\$1type  |  LastEventType  | 
|  campaign\$1event\$1timestamp  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate  | 
|  campaign\$1event\$1id  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventId  | 
|  campaign\$1event\$1type  |  Acara. \$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  |  Acara. RenderingFailure.Atribut. TemplateName  | 
|  Email.renderingFailure.ErrorMessage  |  Acara. RenderingFailure.Atribut. ErrorMessage  | 
|  Email.deliveryDelay.DelayType  |  Acara. DeliveryDelay.Atribut. DelayType  | 
|  email.keluhan. complaintFeedbackType  |  Events.Complaint.Attributes. ComplaintFeedbackType  | 
|  email.keluhan. complaintSubType  |  Events.Complaint.Attributes. ComplaintSubType  | 
|  Email.mail.commonHeaders.subject  |  Atribut.Subjek  | 

## Objek kampanye-SMS
<a name="campaign-sms-object"></a>

 Untuk daftar semua bidang dalam objek Campaign-SMS lihat [Objek SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) dalam dokumentasi SMS Pesan Pengguna AWS Akhir. 

**Memetakan objek Campaign-SMS ke catatan komunikasi standar**

 Subset dari bidang dalam peta objek Campaign-SMS ke objek catatan komunikasi standar di Profil Pelanggan. 

 Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Campaign-SMS ke catatan komunikasi standar. 


|  Bidang sumber kampanye-SMS  |  Bidang target catatan komunikasi standar  | 
| --- | --- | 
|  campaign\$1event\$1id  |  Atribut. LastCampaignEventId  | 
|  outbound\$1request\$1id  |  Atribut. OutboundCampaignRequestId  | 
|  campaign\$1message\$1id  |  Atribut. CampaignMessageId  | 
| channel.name  |  Channel  | 
|  saluran.subtipe  |  Atribut. ChannelSubType  | 
|  endpoint\$1address  |  Titik akhir. EndpointAddress  | 
|  endpoint\$1type  |  Titik akhir. EndpointType  | 
|  instance\$1arn  |  ConnectInstanceArn  | 
|  nama\$1kampanye\$1  |  Kampanye. CampaignName  | 
|  kampanye.campaign\$1id  |  Kampanye. CampaignId  | 
|  kampanye.campaign\$1run\$1id  |  Kampanye. CampaignRunId  | 
|  campaign\$1activity\$1id  |  Kampanye. CampaignActivityId  | 
|  segment\$1arn  |  Kampanye. SegmentArn  | 
|  outbound\$1request\$1creation\$1timestamp  |  CreatedDate  | 
|  campaign\$1event\$1timestamp  |  UpdatedDate  | 
|  campaign\$1event\$1type  |  LastEventType  | 
|  campaign\$1event\$1timestamp  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate  | 
|  campaign\$1event\$1id  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventId  | 
|  campaign\$1event\$1type  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventType  | 
|  sms.messageType  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. MessageType  | 
|  sms.MessageStatus  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. MessageStatus  | 
|  sms. messageStatusDescription  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. MessageStatusDescription  | 
|  sms. totalMessagePrice  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. TotalMessagePrice  | 
|  sms. totalCarrierFee  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. TotalCarrierFee  | 
|  sms. isoCountryCode  |  Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. IsoCountryCode  | 

## Objek Campaign-Telephony
<a name="campaign-telephony-object"></a>

Untuk daftar semua bidang dalam objek Campaign-Telephony, lihat [objek Suara dalam dokumentasi SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) Pesan Pengguna AWS Akhir.

**Memetakan objek Campaign-Telephony ke catatan komunikasi standar**

Subset bidang dalam peta objek Campaign-Telephony ke objek catatan komunikasi standar di Profil Pelanggan.

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Campaign-Telephony ke catatan komunikasi standar.


| Bidang sumber Kampanye-Telepon | Bidang target catatan komunikasi standar | 
| --- | --- | 
| campaign\$1event\$1id | Atribut. LastCampaignEventId | 
| outbound\$1request\$1id | Atribut. OutboundCampaignRequestId | 
| campaign\$1message\$1id | Atribut. CampaignMessageId | 
| channel.name | Channel | 
| saluran.subtipe | Atribut. ChannelSubType | 
| endpoint.endpoint\$1address | Titik akhir. EndpointAddress | 
| endpoint.endpoint\$1type | Titik akhir. EndpointType | 
| instance\$1arn | ConnectInstanceArn | 
| kampanye.campaign\$1name | Kampanye. CampaignName | 
| kampanye.campaign\$1id | Kampanye. CampaignId | 
| kampanye.campaign\$1run\$1id | Kampanye. CampaignRunId | 
| campaign.campaign\$1activity\$1id | Kampanye. CampaignActivityId | 
| kampanye.segment\$1arn | Kampanye. SegmentArn | 
| outbound\$1request\$1creation\$1timestamp | CreatedDate | 
| campaign\$1event\$1timestamp | UpdatedDate | 
| campaign\$1event\$1type | LastEventType | 
| campaign\$1event\$1timestamp | Acara. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate | 
| campaign\$1event\$1id | Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventId | 
| campaign\$1event\$1type | Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventType | 
| Voice.agentInfo. connectedToAgentStempel waktu | Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. ConnectedToAgentTimestamp | 
| suara. customerVoiceActivity. greetingEndTimestamp | Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. GreetingEndTimestamp | 
| suara. answeringMachineDetectionStatus | Acara. \$1\$1campaign\$1event\$1type\$1\$1 .Atribut. AnsweringMachineDetectionStatus | 
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | 

## Objek Kampanye-Orkestrasi
<a name="campaign-orchestration-object"></a>

**Memetakan objek Orkestrasi Kampanye ke catatan komunikasi standar**

Subset dari bidang dalam peta objek Campaign-Orchestration ke objek catatan komunikasi standar di Profil Pelanggan.

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Campaign-Orchestration ke catatan komunikasi standar.


| Bidang sumber Kampanye-Orkestrasi | Bidang target catatan komunikasi standar | 
| --- | --- | 
| campaign\$1event\$1id | Atribut. LastCampaignEventId | 
| channel.name | Channel | 
| saluran.subtipe | Atribut. ChannelSubType | 
| instance\$1arn | ConnectInstanceArn | 
| kampanye.campaign\$1name | Kampanye. CampaignName | 
| kampanye.campaign\$1id | Kampanye. CampaignId | 
| kampanye.campaign\$1run\$1id | Kampanye. CampaignRunId | 
| campaign.campaign\$1activity\$1id | Kampanye. CampaignActivityId | 
| kampanye.segment\$1arn | Kampanye. SegmentArn | 
| campaign\$1event\$1timestamp | UpdatedDate | 
| campaign\$1event\$1type | LastEventType | 
| campaign\$1event\$1timestamp | Acara. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate | 
| campaign\$1event\$1id | Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventId | 
| campaign\$1event\$1type | Acara. \$1\$1campaign\$1event\$1type\$1\$1. EventType | 
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | 

## Contoh
<a name="example"></a>

 Contoh berikut menunjukkan cara memetakan bidang sumber ke bidang target: 

```
"channel": {
    "source": "_source.engagement.channel.name",
    "target": "_communicationRecord.Channel"
}
```

# Pemetaan tipe objek untuk aset standar di Profil Pelanggan
<a name="object-type-mapping-standard-asset"></a>

Topik di bagian ini memberikan definisi aset standar, dan pemetaan jenis objek dari aplikasi eksternal ke aset standar.

**Topics**
+ [Persyaratan AppFlow akses Amazon](appflow-access-requirements-asset.md)
+ [Definisi aset standar](standard-asset-definition.md)
+ [Memetakan objek Salesforce ke aset standar](mapping-salesforce-objects-to-asset.md)

# Persyaratan AppFlow akses Amazon di Profil Pelanggan
<a name="appflow-access-requirements-asset"></a>

Gunakan persyaratan AppFlow akses Amazon berikut untuk membuat dan menghapus integrasi Salesforce dengan Profil Pelanggan Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`

# Definisi aset standar di Amazon Connect Customer Profiles
<a name="standard-asset-definition"></a>

Tabel berikut mencantumkan semua bidang dalam objek aset standar Profil Pelanggan.


| Bidang aset standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  AssetId  | String  | Pengidentifikasi unik dari aset standar.  | 
|  AssetName  | String  | Nama asetnya.  | 
|  SerialNumber  | String  | Nomor seri aset.  | 
|  ModelNumber  | String  | Nomor model aset.  | 
|  ModelName  | String  | Nama model aset.  | 
|  produkSKU  | String  | Unit penyimpanan stok aset.  | 
|  PurchaseDate  | String  | Tanggal pembelian aset.  | 
|  UsageEndDate  | String  | Tanggal akhir penggunaan aset.  | 
|  Status  | String  | Status aset.  | 
|  Harga  | String  | Harga aset.  | 
|  Kuantitas  | String  | Kuantitas aset.  | 
|  Deskripsi  | String  | Deskripsi aset.  | 
|  AdditionalInformation  | String  | Setiap informasi tambahan yang relevan dengan aset.  | 
|  DataSource  | String  | Sumber data aset.  | 
|  Atribut  | String-to-string peta  | Pasangan nilai kunci atribut dari aset standar.  | 

Objek aset standar diindeks oleh kunci dalam tabel berikut.


| Nama indeks standar | Bidang aset standar | 
| --- | --- | 
| \$1Assetid | AssetId | 
| \$1AssetName | AssetName | 
| \$1SerialNumber | SerialNumber | 

Misalnya, Anda dapat menggunakan `_assetName` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang memiliki aset yang AssetName cocok dengan nilai pencarian. Anda dapat menemukan objek aset standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) dengan `ProfileId` dan `ObjectTypeName` disetel ke`_asset`.

# Memetakan objek Salesforce ke aset standar di Profil Pelanggan
<a name="mapping-salesforce-objects-to-asset"></a>

Topik ini mencantumkan bidang mana di objek Salesforce yang dipetakan ke bidang dalam objek aset standar di Profil Pelanggan. 

## Objek Salesforce-Asset
<a name="salesforceaccountobject-asset"></a>

Berikut ini adalah daftar semua bidang dalam objek Salesforce-Asset. 
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Nama
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Status
+ Harga
+ Kuantitas
+ Deskripsi
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate

## Memetakan objek Salesforce-Asset ke aset standar
<a name="mapping-salesforceaccountobject"></a>

Subset bidang dalam peta objek Salesforce-Asset ke objek aset standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek Salesforce-Asset ke aset standar. 


| Bidang sumber Saleforce-Asset | Bidang target aset standar | 
| --- | --- | 
|  Id  | Atribut. sfdcAssetId  | 
|  ContactId  | Atribut. sfdcContactId  | 
|  AccountId  | Atribut. sfdcAccountId  | 
|  SerialNumber  | SerialNumber  | 
|  StockKeepingUnit  | produkSKU  | 
|  UsageEndDate  | UsageEndDate  | 
|  Status  | Status  | 
|  Harga  | Harga  | 
|  Kuantitas  | Kuantitas  | 
|  Deskripsi  | Deskripsi  | 

Data pelanggan Salesforce-Asset dari objek Salesforce dikaitkan dengan aset standar Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber Salesforce-Asset | 
| --- | --- | 
|  \$1salesforceAssetId  | Id  | 
|  \$1salesforceContactId  | ContactId  | 
|  \$1salesforceAccountId  | AccountId  | 

Misalnya, Anda dapat menggunakan `_salesforceAssetId` dan `_salesforceAccountId` sebagai `ObjectFilter.KeyName` dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan aset standar. Anda dapat menemukan objek Salesforce-Asset yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan dan disetel ke`ProfileId`. `ObjectTypeName` `Salesforce-Asset` 

# Pemetaan tipe objek untuk kasus standar di Profil Pelanggan
<a name="object-type-mapping-standard-case"></a>

Topik di bagian ini memberikan definisi kasus standar, dan pemetaan tipe objek dari aplikasi eksternal ke kasus standar.

**Topics**
+ [Persyaratan AppFlow akses Amazon](appflow-access-requirements-case.md)
+ [Definisi kasus standar](standard-case-definition.md)
+ [Memetakan objek Zendesk](mapping-zendesk-objects-case.md)
+ [Memetakan objek ServiceNow](mapping-servicenow-objects-standard-case.md)

# Persyaratan AppFlow akses Amazon di Profil Pelanggan
<a name="appflow-access-requirements-case"></a>

Gunakan persyaratan AppFlow akses Amazon berikut untuk membuat dan menghapus Zendesk dan ServiceNow integrasi dengan Profil Pelanggan Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`

# Profil Pelanggan bidang objek kasus standar
<a name="standard-case-definition"></a>

Tabel berikut mencantumkan semua bidang dalam objek kasus standar Profil Pelanggan.


| Bidang kasus standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
|  CaseId  | String  | Pengidentifikasi unik dari kasus standar.  | 
|  judul  | String  | Judul kasus  | 
|  Ringkasan  | String  | Ringkasan kasus ini.  | 
|  Status  | String  | Status kasus ini.  | 
|  Alasan  | String  | Alasan kasusnya.  | 
|  CreatedBy  | String  | Pencipta kasus.  | 
|  CreatedDate  | String  | Tanggal kasus dibuat.  | 
|  UpdatedDate  | String  | Tanggal kasus diperbarui.  | 
|  ClosedDate  | String  | Tanggal kasus ditutup.  | 
|  AdditionalInformation  | String  | Setiap informasi tambahan yang relevan dengan kasus ini.  | 
|  DataSource  | String  | Sumber data kasus.  | 
|  Atribut  | String-to-string peta  | Pasangan kunci-nilai atribut dari kasus standar.  | 

Objek kasus standar diindeks oleh kunci dalam tabel berikut.


| Nama indeks standar | Bidang kasus standar | 
| --- | --- | 
| \$1CaseID | CaseId | 

Misalnya, Anda dapat menggunakan `_caseId` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang memiliki case yang CaseId cocok dengan nilai pencarian. Anda dapat menemukan objek kasus standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) dengan `ProfileId` dan `ObjectTypeName` disetel ke`_case`.

# Memetakan objek Zendesk ke casing standar di Amazon Connect Customer Profiles
<a name="mapping-zendesk-objects-case"></a>

Topik ini mencantumkan bidang mana di objek Zendesk yang dipetakan ke bidang dalam kasus standar di Profil Pelanggan.

## Objek tiket Zendesk
<a name="zendeskticketsobject"></a>

Berikut ini adalah daftar semua bidang dalam objek ZenDesk-tiket.
+ id
+ url
+ jenis
+ subjek
+ raw\$1subjek
+ deskripsi
+ Prioritas
+ status
+ penerima
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organisasi\$1id
+ group\$1id
+ kolaborator\$1ids
+ email\$1cc\$1id
+ follower\$1id
+ forum\$1topic\$1id
+ masalah\$1id
+ has\$1insiden
+ due\$1at
+ tag
+ melalui kanal
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1id
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachment
+ is\$1publik
+ dibuat\$1at
+ updated\$1at

## Memetakan objek tiket ZenDesk ke kasing standar
<a name="mapping-zendeskticketsobject-case"></a>

Subset dari bidang dalam peta objek ZenDesk-tickets ke kasus standar di Profil Pelanggan. Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek ZenDesk-tickets ke kasus standar.


| Bidang sumber tiket Zendesk | Bidang target kasus standar | 
| --- | --- | 
|  requester\$1id  | Atribut. ZendeskUserId  | 
|  id  | Atribut. ZendeskTicketId  | 
|  subjek  | judul  | 
|  deskripsi  | Ringkasan  | 
|  status  | Status  | 
|  requester\$1id  | CreatedBy  | 
|  dibuat\$1at  | CreatedDate  | 
|  updated\$1at  | UpdatedDate  | 

Data pelanggan ZenDesk-tickets dari objek Zendesk dikaitkan dengan kasus standar Amazon Connect menggunakan indeks berikut. 


| Nama Indeks Standar | Bidang sumber tiket Zendesk | 
| --- | --- | 
|  \$1zendeskUserId  | requester\$1id  | 
|  \$1zendeskTicketId  | id  | 

Misalnya, Anda dapat menggunakan `_zendeskUserId` dan `_zendeskTicketId` sebagai `ObjectFilter.KeyName` dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan kasus standar. Anda dapat menemukan objek ZenDesk-tickets yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Zendesk-tickets` 

# Memetakan ServiceNow objek ke casing standar di Amazon Connect Customer Profiles
<a name="mapping-servicenow-objects-standard-case"></a>

Topik ini mencantumkan bidang mana dalam ServiceNow objek yang dipetakan ke bidang dalam kasus standar di Amazon Connect Customer Profiles.

## Objek ServiceNow-task
<a name="servicenow-task-object"></a>

Berikut ini adalah daftar semua bidang dalam objek ServiceNow-Task. 
+ sys\$1id
+ aktif
+ aktivitas\$1due
+ additional\$1assignee\$1list
+ persetujuan
+ persetujuan\$1sejarah
+ persetujuan\$1set
+ ditugaskan\$1ke
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ kalender\$1durasi\$1
+ tertutup\$1at
+ ditutup\$1oleh
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ komentar
+ komentar\$1and\$1work\$1notes
+ perusahaan
+ contact\$1type
+ kontrak
+ korelasi\$1display
+ aktif
+ korelasi\$1id
+ pengiriman\$1plan
+ delivery\$1task
+ deskripsi
+ due\$1date
+ eskalasi
+ diharapkan\$1mulai
+ tindak lanjut\$1up
+ group\$1list
+ dampak
+ pengetahuan
+ lokasi
+ dibuat\$1sla
+ number
+ dibuka\$1di
+ opened\$1by.display\$1value
+ memesan
+ induk
+ Prioritas
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ status
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ aktif
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1work
+ upon\$1approval
+ upon\$1tolak
+ urgensi
+ user\$1masukan
+ watch\$1list
+ kerja\$1akhir
+ catatan kerja
+ work\$1notes\$1list
+ work\$1start

## Memetakan ServiceNow-task ke kasus standar
<a name="mapping-servicenow-task-case"></a>

Subset bidang dalam peta objek ServiceNow-task ke kasus standar di Profil Pelanggan. 

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek ServiceNow-task ke kasus standar. 


| Bidang sumber tugas ServiceNow- | Bidang target kasus standar | 
| --- | --- | 
|  sys\$1id  | Atribut. ServiceNowTaskId  | 
|  opened\$1by.link  | Atribut. ServiceNowSystemUserId  | 
|  short\$1description  | judul  | 
|  deskripsi  | Ringkasan  | 
|  status  | Status  | 
|  sys\$1created\$1by  | CreatedBy  | 
|  sys\$1created\$1on  | CreatedDate  | 
|  sys\$1updated\$1on  | UpdatedDate  | 

Data pelanggan ServiceNow-task dari Servicenow dikaitkan dengan kasus standar Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber tugas ServiceNow- | 
| --- | --- | 
|  \$1 serviceNowTask Id  | sys\$1id  | 
|  \$1 serviceNowSystem Id  | open\$1by.link  | 

Misalnya, Anda dapat menggunakan `_serviceNowTaskId` dan `_serviceNowSystemId` sebagai `ObjectFilter.KeyName` dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan kasus standar. Anda dapat menemukan objek ServiceNow-task yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Servicenow-task`

## Objek insiden ServiceNow
<a name="servicenowincident-object"></a>

Berikut ini adalah daftar semua bidang dalam objek ServiceNow-Incident. 
+ sys\$1id
+ business\$1stc
+ kalender\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ kategori
+ disebabkan oleh
+ child\$1incidents
+ close\$1kode
+ hold\$1reason
+ status\$1insiden
+ memberitahukan
+ parent\$1incident
+ masalah\$1id
+ dibuka kembali
+ dibuka kembali\$1waktu
+ reopen\$1count
+ terselesaikan\$1at
+ terselesaikan\$1by.link
+ terselesaikan\$1by.value
+ rfc
+ kepelikan
+ subkategori

## Memetakan ServiceNow-Incident ke kasus standar
<a name="mapping-servicenowincident-case"></a>

Subset bidang dalam peta objek ServiceNow-Incident ke kasus standar di Profil Pelanggan.

Tabel berikut mencantumkan bidang mana yang dapat dipetakan dari objek ServiceNow-Incident ke kasus standar. 


| Bidang sumber Servicenow-Incident | Bidang target kasus standar | 
| --- | --- | 
| sys\$1id  |  Atribut\$1 ServiceNowIncidentId  | 
| caller\$1id.link  |  Atribut\$1 ServiceNowSystemUserId  | 
| insident\$1status  |  Status  | 
| caller\$1id.link  |  CreatedBy  | 
| terselesaikan\$1at  |  ClosedDate  | 
| kategori  |  Alasan  | 

Data pelanggan ServiceNow-Incident dari objek Servicenow dikaitkan dengan kasus standar Amazon Connect menggunakan indeks dalam tabel berikut. 


| Nama Indeks Standar | Bidang sumber Servicenow | 
| --- | --- | 
| \$1 serviceNowIncident Id  |  sys\$1id  | 
| \$1 serviceNowSystem Id  |  caller\$1id.link  | 

Misalnya, Anda dapat menggunakan `_serviceNowIncidentId` dan `_serviceNowSystemId` sebagai ObjectFilter. KeyName dengan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API untuk menemukan kasus standar. Anda dapat menemukan objek ServiceNow-insident yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API dengan `ProfileId` dan `ObjectTypeName` disetel ke. `Servicenow-incident`

# Pemetaan tipe objek untuk preferensi udara standar
<a name="object-type-mapping-standard-air-preference"></a>

Topik di bagian ini memberikan definisi preferensi udara standar.

**Topics**
+ [Profil Pelanggan bidang objek preferensi udara standar](standard-air-preference-object-fields.md)

# Profil Pelanggan bidang objek preferensi udara standar
<a name="standard-air-preference-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek preferensi udara standar Profil Pelanggan.


**Preferensi udara**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| PreferenceId | String | Pengidentifikasi unik dari preferensi udara standar | 
| Nama | String | Nama preferensi | 
| CreatedDate | String | Tanggal ketika preferensi dibuat | 
| CreatedBy | String | Pengidentifikasi pencipta | 
| UpdatedDate | String | Tanggal pembaruan terakhir | 
| UpdatedBy | String | Pengidentifikasi orang yang terakhir diperbarui | 
| StartDate | String | Tanggal mulai preferensi | 
| EndDate | String | Tanggal akhir preferensi | 
| Status | String | Status preferensi saat ini | 
| ReferenceId | String | Id ke objek direferensikan | 
| ReferenceType | String | Jenis objek yang direferensikan | 
| TravelType | String | Jenis perjalanan (misalnya, penerbangan langsung) | 
| Transfer | String | Jenis transfer yang disukai | 
| ArrivalAirport | String | Bandara kedatangan yang disukai | 
| ArrivalTerminal | String | Terminal bandara kedatangan pilihan | 
| DepartureAirport | String | Bandara keberangkatan pilihan | 
| DepartureTerminal | String | Terminal bandara keberangkatan pilihan | 
| HomeAirport | String | Bandara asal | 
| CheckInChannel | String | Mode checkin | 
| CheckInChannelDevice | String | Perangkat yang digunakan untuk checkin | 
| Bahasa | Bahasa | Detail tentang bahasa pilihan untuk komunikasi | 
| Kursi | Kursi | Detail pemilihan kursi | 
| Perjalanan | Perjalanan | Preferensi perjalanan | 
| Aksesibilitas | Aksesibilitas | Detail tentang permintaan aksesibilitas | 
| Asuransi | Asuransi | Detail tentang asuransi | 
| Minat | Minat | Detail tentang minat | 
| Loyalitas | Loyalitas | Detail tentang loyalitas | 
| Bersantap | Bersantap | Preferensi makan | 
| MediaEntertainment | MediaEntertainment | Preferensi media dan hiburan | 
| PaymentForm | PaymentForm | Preferensi metode pembayaran | 
| PetInfo | PetInfo | Detail hewan peliharaan | 
| SpecialRequest | SpecialRequest | Detail Permintaan Khusus | 
| TicketDistribution | TicketDistribution | Preferensi Distribusi Tiket | 
| Pemasaran | Pemasaran | Preferensi pemasaran | 
| Medis | Medis | Preferensi pada medis | 
| Bagasi | Bagasi | Preferensi pada bagasi | 
| ContactDetail | ContactDetail | Detail tentang kontak dalam preferensi | 
| ContactDetailAddress | ContactDetailAddress | Alamat untuk detail kontak | 
| ContactDetailCommunication | ContactDetailCommunication | Preferensi pada komunikasi | 
| Atribut | Peta<String, String> | Pasangan nilai kunci atribut preferensi udara | 

Objek preferensi udara standar diindeks oleh kunci dalam tabel berikut.


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1airPreferenceId | PreferenceId | 
| \$1airReferenceId | ReferenceId | 

Misalnya, Anda dapat menggunakan `_airPreferenceId` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang memiliki preferensi udara yang PreferenceId cocok dengan nilai pencarian. Anda dapat menemukan objek AirPreference standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) dengan `ProfileId` dan `ObjectTypeName` disetel ke`_airPreference`.


**ContactDetail tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis kontak (misalnya pribadi, darurat) | 
| PreferenceLevel | String | Tingkat prioritas kontak ini | 
| PhoneNumber | String | Nomor telepon | 
| Hubungan | String | Hubungan dengan profil | 
| EmailAddress | String | Alamat Email | 
| EmailLanguage | String | Bahasa pilihan untuk komunikasi email detail kontak | 
| PhoneLanguage | String | Bahasa pilihan untuk komunikasi telepon detail kontak | 


**ContactDetailAddress tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis alamat untuk kontak | 
| Alamat1 | String | Baris pertama dari alamat kontak. | 
| Alamat2 | String | Baris kedua dari alamat kontak. | 
| Alamat3 | String | Baris ketiga dari alamat kontak. | 
| Alamat4 | String | Baris keempat dari alamat kontak. | 
| Kota | String | Kota alamat kontak. | 
| Negara | String | Negara alamat kontak. | 
| Kabupaten | String | Kabupaten dari alamat kontak. | 
| PostalCode | String | Pos alamat kontak. | 
| Propinsi | String | Provinsi alamat kontak. | 
| Status | String | Keadaan alamat kontak. | 


**ContactDetailCommunication tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Metode | String | Metode komunikasi (misalnya, SMS, Email) | 
| PreferenceLevel | String | Tingkat preferensi untuk metode komunikasi | 


**Tipe data bahasa**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| PhoneLanguage | String | Bahasa pilihan untuk komunikasi telepon | 
| EmailLanguage | String | Bahasa pilihan untuk komunikasi email | 
| InPersonLanguage | String | Bahasa yang disukai untuk komunikasi langsung | 
| PreferenceLevel | String | Tingkat preferensi bahasa | 


**Tipe data kursi**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| PreferenceLevel | String | Prioritas preferensi kursi | 
| Arahan | String | Arah kursi yang dipilih (misalnya, depan, belakang) | 
| Lokasi | String | Lokasi kursi Pilihan (mis., Jendela, lorong) | 
| Posisi | String | Posisi Kursi (misalnya, kiri, kanan) | 
| Baris | String | Baris kursi yang diinginkan | 
| ClassOfService | String | Kelas perjalanan (misalnya, Ekonomi, Bisnis) | 
| NeighborFree | String | Preferensi untuk kursi tanpa tetangga | 
| Bayi | String | Preferensi untuk kursi bayi | 
| ExtraSeat | String | Preferensi untuk kursi tambahan | 


**Tipe data perjalanan**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| MaxConnections | String | Koneksi maksimum yang diizinkan | 
| PreferredAirline | String | Maskapai penerbangan pilihan | 
| UpgradeAuction | String | Keikutsertaan untuk lelang peningkatan | 
| FlightTime | String | Waktu Penerbangan yang Diutamakan | 
| FlightMaxDuration | String | Durasi perjalanan maksimum yang disukai | 


**Jenis data aksesibilitas**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Kursi roda | String | Info aksesibilitas kursi roda | 
| Kamar mandi | String | Info aksesibilitas kamar mandi | 
| Bantuan | String | Informasi bantuan | 
| DisabilityType | String | Informasi tentang disabilitas | 
| SupportAnimal | String | Support informasi hewan | 
| ProximityToFacilities | String | Membutuhkan kedekatan dengan fasilitas | 


**Jenis data asuransi**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Penyedia asuransi atau nama paket | 
| PreferenceLevel | String | Tingkat preferensi untuk asuransi | 


**Jenis data minat**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Bidang minat tertentu | 
| PreferenceLevel | String | Prioritas kepentingan ini | 


**Jenis data loyalitas**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama Program Loyalitas | 
| MembershipId | String | ID keanggotaan dalam program loyalitas | 
| PreferenceLevel | String | Tingkat preferensi program loyalitas | 


**Tipe data makan**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| MealType | String | Jenis makanan yang disukai | 
| FavoriteCuisine | String | Jenis masakan favorit | 
| Minuman | String | Minuman pilihan | 
| DietaryRestriction | String | Pembatasan diet | 
| AllergyInfo | String | Detail tentang alergi | 
| PreferenceLevel | String | Tingkat preferensi makan | 


**Tipe data media dan hiburan**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama hiburan pilihan | 
| PreferenceLevel | String | Tingkat preferensi untuk media/hiburan | 


**PaymentForm tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama metode pembayaran | 
| Tipe | String | Jenis pembayaran (misalnya, kartu kredit, PayPal) | 
| PreferenceLevel | String | Tingkat preferensi metode pembayaran | 
| UsageContext | String | Dimana metode pembayaran digunakan | 


**PetInfo tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis hewan peliharaan | 
| PreferenceLevel | String | Tingkat preferensi mengenai hewan peliharaan | 


**SpecialRequest tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis permintaan khusus | 
| Nama | String | Nama atau deskripsi permintaan | 
| PreferenceLevel | String | Tingkat prioritas permintaan | 


**TicketDistribution tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| PreferenceLevel | String | Tingkat preferensi untuk distribusi tiket | 
| Metode | String | Metode pengiriman tiket (misalnya, email, fisik) | 
| TicketTime | String | Waktu yang lebih disukai untuk pengiriman tiket | 


**Jenis data pemasaran**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| ChannelType | String | Jenis saluran pemasaran (misalnya, SMS, Email) | 
| OptIn | String | Status keikutsertaan untuk pemasaran | 
| Frekuensi | String | Frekuensi komunikasi pemasaran | 
| StartDate | String | Tanggal mulai preferensi pemasaran | 
| EndDate | String | Tanggal akhir preferensi pemasaran | 


**Tipe data medis**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Oksigen | String | (Maskapai yang disediakan, milik penumpang, konsentrator, dll) | 
| MedicalEquipment | String | Detail tentang peralatan medis (misalnya, mesin CPAP, konsentrator oksigen). | 
| Bantuan | String | Menentukan apakah penumpang memerlukan bantuan medis umum selama perjalanan (misalnya, dukungan dalam penerbangan, bantuan pengobatan). | 
| Tandu | String | Jika pelancong membutuhkan tandu selama penerbangan, biasanya digunakan untuk kasus transportasi medis. | 
| WheelChair | String | Detail kursi roda (tidak tumpah, sel basah, tidak bergerak,, tangga Bantuan, disediakan maskapai penerbangan RampNeeded, dll) | 


**Tipe data bagasi**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Hewan | String | Menunjukkan jika pelancong bepergian dengan hewan penolong atau hewan peliharaan, dan termasuk spesifikasi atau batasan yang relevan. (InHold, Kabin) | 
| BaggageType | String | Menentukan jenis penanganan bagasi yang disukai (misalnya, barang bawaan saja, bagasi terdaftar, berukuran besar). | 
| Bantuan | String | Menunjukkan apakah pelancong memerlukan bantuan untuk membawa atau mengelola bagasi mereka, seperti layanan porter bandara atau bantuan bagasi tepi jalan. | 
| PreferenceLevel | String | Tingkat preferensi untuk bidang Bagasi | 

# Pemetaan tipe objek untuk preferensi hotel standar
<a name="object-type-mapping-standard-hotel-preference"></a>

Topik di bagian ini memberikan definisi preferensi hotel standar.

**Topics**
+ [Profil Pelanggan bidang objek preferensi hotel standar](standard-hotel-preference-object-fields.md)

# Profil Pelanggan bidang objek preferensi hotel standar
<a name="standard-hotel-preference-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek preferensi hotel standar Profil Pelanggan.


**Preferensi Hotel**  

| Bidang standar HotelPreference | Jenis data | Deskripsi | 
| --- | --- | --- | 
| PreferenceId | String | Pengidentifikasi unik dari preferensi hotel standar | 
| Nama | String | Nama preferensi | 
| CreatedDate | String | Tanggal preferensi dibuat | 
| CreatedBy | String | Pengidentifikasi pencipta | 
| UpdatedDate | String | Tanggal pembaruan terakhir | 
| UpdatedBy | String | Pengidentifikasi orang yang terakhir diperbarui | 
| StartDate | String | Tanggal mulai preferensi | 
| EndDate | String | Tanggal akhir preferensi | 
| Status | String | Status preferensi saat ini | 
| Merokok | String | Preferensi merokok | 
| CleaningTime | String | Waktu pembersihan | 
| CheckInType | String | Jenis check-in | 
| CheckOutType | String | Jenis check-out | 
| ReferenceId | String | Id ke objek direferensikan | 
| ReferenceType | String | Jenis objek yang direferensikan | 
| Lokasi | Lokasi | Preferensi pada lokasi kamar hotel | 
| Tempat tidur | Tempat tidur | Preferensi tempat tidur | 
| Tur | Tur | Preferensi tur | 
| ContactDetail | ContactDetail | Detail tentang kontak dalam preferensi | 
| ContactDetailAddress | ContactDetailAddress | Alamat untuk detail kontak | 
| ContactDetailCommunication | ContactDetailCommunication | Preferensi pada komunikasi | 
| Bahasa | Bahasa | Preferensi bahasa | 
| CarRental | CarRental | Preferensi sewa mobil | 
| Aksesibilitas | Aksesibilitas | Preferensi aksesibilitas | 
| Minat | Minat | Detail minat | 
| Loyalitas | Loyalitas | Preferensi loyalitas | 
| Bersantap | Bersantap | Preferensi makan | 
| MediaEntertainment | MediaEntertainment | Preferensi media dan hiburan | 
| PaymentForm | PaymentForm | Preferensi formulir pembayaran | 
| PetInfo | PetInfo | Preferensi info hewan peliharaan | 
| SpecialRequest | SpecialRequest | Detail tentang permintaan khusus | 
| Pemasaran | Pemasaran | Preferensi pemasaran | 
| Medis | Medis | Preferensi medis | 
| Bagasi | Bagasi | Preferensi bagasi | 
| Atribut | Peta<String, String> | Pasangan nilai kunci atribut preferensi hotel | 

Objek preferensi hotel standar diindeks oleh kunci dalam tabel berikut.


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1hotelPreferenceId | PreferenceId | 
| \$1hotelReferenceId | ReferenceId | 

Misalnya, Anda dapat menggunakan `_hotelPreferenceId` sebagai nama kunci dengan [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) untuk menemukan profil yang memiliki preferensi hotel yang PreferenceId cocok dengan nilai pencarian. Anda dapat menemukan objek HotelPreference standar yang terkait dengan profil tertentu dengan menggunakan [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) dengan `ProfileId` dan `ObjectTypeName` disetel ke`_hotelPreference`.


**ContactDetail tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis kontak (misalnya pribadi, darurat) | 
| PreferenceLevel | String | Tingkat prioritas kontak ini | 
| PhoneNumber | String | Nomor telepon | 
| Hubungan | String | Hubungan dengan profil | 
| EmailAddress | String | Alamat Email | 
| EmailLanguage | String | Bahasa pilihan untuk komunikasi email detail kontak | 
| PhoneLanguage | String | Bahasa pilihan untuk komunikasi telepon detail kontak | 


**ContactDetailAddress tipe data**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis alamat untuk kontak | 
| Alamat1 | String | Baris pertama dari alamat kontak. | 
| Alamat2 | String | Baris kedua dari alamat kontak. | 
| Alamat3 | String | Baris ketiga dari alamat kontak. | 
| Alamat4 | String | Baris keempat dari alamat kontak. | 
| Kota | String | Kota alamat kontak. | 
| Negara | String | Negara alamat kontak. | 
| Kabupaten | String | Kabupaten dari alamat kontak. | 
| PostalCode | String | Kode pos dari alamat kontak. | 
| Provinsi | String | Provinsi alamat kontak. | 
| Status | String | Keadaan alamat kontak. | 


**ContactDetailCommunication tipe data**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Metode | String | Metode komunikasi | 
| PreferenceLevel | String | Tingkat preferensi untuk metode komunikasi | 
| Frekuensi | String | Frekuensi komunikasi | 


**Tipe data bahasa**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| PhoneLanguage | String | Bahasa telepon pilihan | 
| EmailLanguage | String | Bahasa email pilihan | 


**CarRental tipe data**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Vendor | String | Vendor rental mobil pilihan | 
| VehicleType | String | Jenis kendaraan pilihan | 
| PreferenceLevel | String | Tingkat preferensi untuk penyewaan mobil | 


**Tipe data lokasi**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| PreferredFloor | String | Preferensi untuk lantai kamar | 
| ElevatorProximity | String | Preferensi untuk kedekatan dengan lift | 
| QuietZone | String | Preferensi untuk zona tenang | 
| LobbyProximity | String | Preferensi untuk kedekatan dengan lobi | 
| Tampilan | String | Pemandangan yang diinginkan dari kamar | 
| RoomType | String | Tipe kamar pilihan | 
| PreferenceLevel | String | Tingkat preferensi untuk lokasi | 


**Jenis data tempat tidur**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| BedType | String | Jenis tempat tidur pilihan | 
| MattressType | String | Jenis kasur pilihan | 
| PillowType | String | Jenis bantal pilihan | 
| NumberOfPillows | String | Jumlah bantal yang disukai | 
| BeddingMaterial | String | Bahan tempat tidur | 
| Alergi | String | Preferensi tempat tidur terkait alergi | 


**Tipe data tur**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Kota | String | Kota pilihan untuk tur | 
| Budaya | String | Minat wisata budaya | 
| Petualangan | String | Minat wisata petualangan | 
| Hiburan malam | String | Minat wisata kehidupan malam | 
| GuideLanguage | String | Bahasa pilihan untuk pemandu wisata | 
| StartTime | String | Waktu mulai yang disukai untuk tur | 
| GroupSize | String | Ukuran grup pilihan untuk tur | 
| PreferenceLevel | String | Pentingnya preferensi tur | 


**Jenis data aksesibilitas**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Kursi roda | String | Info aksesibilitas kursi roda | 
| Kamar mandi | String | Info aksesibilitas kamar mandi | 
| Bantuan | String | Informasi bantuan | 
| DisabilityType | String | Informasi tentang disabilitas | 
| SupportAnimal | String | Support informasi hewan | 
| ProximityToFacilities | String | Membutuhkan kedekatan dengan fasilitas | 


**Jenis data minat**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| NameOfInterest | String | Nama yang diminati | 
| PreferenceLevel | String | Tingkat preferensi untuk bunga | 


**Jenis data loyalitas**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| LoyaltyName | String | Nama program loyalitas | 
| MembershipId | String | ID keanggotaan loyalitas | 
| PreferenceLevel | String | Tingkat preferensi loyalitas | 
| PriorityServices | String | Preferensi layanan prioritas | 


**Tipe data makan**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| MealType | String | Jenis makanan yang disukai | 
| FavoriteCuisine | String | Preferensi masakan favorit | 
| Minuman | String | Preferensi minuman | 
| DietaryRestriction | String | Pembatasan diet | 
| AllergyInfo | String | Informasi alergi | 
| PreferenceLevel | String | Tingkat preferensi makan | 


**MediaEntertainment tipe data**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama media atau hiburan pilihan | 
| PreferenceLevel | String | Tingkat preferensi untuk media atau hiburan | 


**PaymentForm tipe data**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama yang terkait dengan metode pembayaran | 
| Tipe | String | Jenis metode pembayaran | 
| PreferenceLevel | String | Tingkat preferensi metode pembayaran | 
| UsageContext | String | Konteks di mana formulir pembayaran digunakan | 


**PetInfo tipe data**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis hewan peliharaan | 
| PreferenceLevel | String | tingkat preferensi untuk hewan peliharaan | 


**Jenis data Permintaan Khusus**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis permintaan khusus | 
| Nama | String | Nama permintaan khusus | 
| PreferenceLevel | String | Tingkat preferensi permintaan | 


**Jenis data pemasaran**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| ChannelType | String | Jenis saluran pemasaran (misalnya, SMS, Email) | 
| OptIn | String | Status keikutsertaan untuk pemasaran | 
| Frekuensi | String | Frekuensi komunikasi pemasaran | 
| StartDate | String | Tanggal mulai preferensi pemasaran | 
| EndDate | String | Tanggal akhir preferensi pemasaran | 


**Tipe data medis**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Oksigen | String | Preferensi pasokan oksigen | 
| MedicalEquipment | String | Detail tentang peralatan medis | 
| Bantuan | String | Jenis bantuan medis yang diperlukan | 
| Tandu | String | Persyaratan tamu tandu | 
| WheelChair | String | Jenis kursi roda dan bantuan yang dibutuhkan | 


**Tipe data bagasi**  

| Bidang standar HotelPreference | Tipe | Deskripsi | 
| --- | --- | --- | 
| Sepeda | String | Kebutuhan bagasi sepeda | 
| BaggageType | String | Detail bagasi (mis. Besar) | 
| Kurir | String | Preferensi bagasi terkait kurir | 
| Rapuh | String | Preferensi item rapuh | 
| Tingkat Preferensi | String | Tingkat preferensi bagasi | 

# Pemetaan tipe objek untuk pemesanan udara standar
<a name="object-type-mapping-standard-air-booking"></a>

Topik di bagian ini memberikan definisi pemesanan udara standar.

**Topics**
+ [Profil Pelanggan bidang objek pemesanan udara standar](standard-air-booking-object-fields.md)

# Profil Pelanggan bidang objek pemesanan udara standar
<a name="standard-air-booking-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek pemesanan udara standar Profil Pelanggan.


**AirBooking**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| BookingId | String | Pengenal unik pemesanan udara standar | 
| ContextId | String | Pengenal khusus konteks untuk melacak sumber reservasi | 
| PreferenceRef | String | Pengenal yang mereferensikan objek Preferensi untuk pemesanan | 
| BookingName | String | Nama yang terkait dengan pemesanan | 
| PassengerIndex | String | Indeks untuk penumpang dalam pemesanan | 
| TravellerId | String | Pengenal unik untuk wisatawan yang terkait dengan pemesanan | 
| GroupBooking | String | Menunjukkan jika pemesanan untuk grup | 
| NumberOfPassengers | String | Jumlah total penumpang dalam pemesanan | 
| NumberOfAdults | String | Jumlah total orang dewasa dalam pemesanan | 
| NumberOfChildren | String | Jumlah total anak dalam pemesanan | 
| ProcessedDate | String | Tanggal pemesanan diproses | 
| CreatedDate | String | Tanggal pemesanan dibuat | 
| CreatedBy | String | Identitas pencipta | 
| UpdatedDate | String | Tanggal pembaruan terakhir | 
| UpdatedBy | String | Pengenal siapa yang terakhir memperbarui pemesanan | 
| Status | String | Status pemesanan saat ini | 
| PriorityStatus | String | Tingkat prioritas pemesanan | 
| ReservationStatus | String | Status reservasi pemesanan | 
| MarketingCode | String | Kode yang mewakili sumber pemasaran atau kampanye | 
| MarketingName | String | Nama kampanye pemasaran | 
| TravelAgent | String | Agen perjalanan yang terkait dengan pemesanan | 
| TravelAgency | String | Nama biro perjalanan perusahaan | 
| TravelCorpNumber | String | Nomor pelanggan perusahaan | 
| Pemesan | String | Menunjukkan jika orang tersebut adalah orang yang melakukan pemesanan | 
| AdditionalInformation | String | Info freeform tambahan | 
| Email | String | Email kontak untuk pembaruan hari perjalanan | 
| PhoneNumber | String | Hubungi telepon untuk pembaruan hari perjalanan | 
| CancelledDate | String | Tanggal pembatalan pemesanan (jika ada) | 
| Diplomat | String | Menunjukkan status diplomatik | 
| Anak | String | Menunjukkan jika penumpang adalah anak-anak | 
| Nonaktif | String | Menunjukkan status disabilitas | 
| Oksigen | String | Menunjukkan kebutuhan akan dukungan oksigen | 
| PetOnly | String | Pemesanan hanya untuk mengangkut hewan peliharaan | 
| CancellationCharge | String | Biaya pembatalan jika berlaku. 0 berarti tidak ada biaya | 
| Dapat dikembalikan | String | Detail tentang pengembalian dana pemesanan | 
| Persediaan | Persediaan | Detail inventaris untuk pemesanan | 
| Loyalitas | Loyalitas | Detail loyalitas untuk pemesanan | 
| Channel | Channel | Detail saluran untuk pemesanan | 
| Pembayaran | Pembayaran | Detail pembayaran untuk pemesanan | 
| BillingAddress | Alamat | Detail alamat penagihan untuk pemesanan | 
| Harga | Harga | Detail harga pemesanan | 
| PaymentStatus | PaymentStatus | Status pembayaran pemesanan | 
| Atribut | Peta<String, String> | Atribut kustom atau ekstensi | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1airBookingId | BookingId | 
| \$1airPreferenceRef | PreferenceRef | 


**Jenis data loyalitas**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| ProgramName | String | Nama program loyalitas | 
| MembershipId | String | Nomor keanggotaan program loyalitas | 
| Tingkat | String | Tingkat tingkat keanggotaan loyalitas | 


**Jenis data Saluran**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| CreationChannelId | String | ID saluran yang digunakan untuk membuat pemesanan | 
| LastUpdatedChannelId | String | ID channel yang digunakan untuk memperbarui pemesanan | 
| Metode | String | Metode yang digunakan melalui saluran (misalnya, web, aplikasi, telepon) | 


**Jenis data pembayaran**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis metode pembayaran (misalnya, kartu, voucher) | 
| CreditCardToken | String | Kartu token untuk referensi aman | 
| CreditCardType | String | Jenis kartu kredit yang digunakan | 
| CreditCardExpiration | String | Tanggal kedaluwarsa kartu | 
| Cvv | String | Nomor CVV | 
| NameOnCreditCard | String | Nama pemegang kartu | 
| RoutingNumber | String | Nomor routing bank (jika ada) | 
| AccountNumber | String | Nomor rekening bank (jika ada) | 
| VoucherId | String | Voucher yang digunakan untuk pembayaran | 
| DiscountCode | String | Kode diskon promosi diterapkan | 
| DiscountPercent | String | Persentase discount diterapkan untuk pembayaran | 


**Jenis data Alamat Penagihan**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Alamat1 | String | Baris pertama dari alamat pelanggan. | 
| Alamat2 | String | Baris kedua dari alamat pelanggan. | 
| Alamat3 | String | Baris ketiga dari alamat pelanggan. | 
| Alamat4 | String | Baris keempat dari alamat pelanggan. | 
| Kota | String | Kota alamat pelanggan. | 
| Negara | String | Negara alamat pelanggan. | 
| Kabupaten | String | Kabupaten alamat pelanggan. | 
| PostalCode | String | Kode pos alamat pelanggan. | 
| Provinsi | String | Provinsi alamat pelanggan. | 
| Status | String | Keadaan alamat pelanggan. | 


**Tipe data harga**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| TotalPrice | String | Total Harga pemesanan | 
| BasePrice | String | Harga dasar pemesanan | 
| TravellerPrice | String | Harga yang dibayarkan per traveler | 
| DiscountAmount | String | Diskon berlaku untuk tarif dasar | 
| Mata Uang | String | Mata uang di mana pembayaran dilakukan | 


**Jenis data Status Pembayaran**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| PaidAt | String | Stempel waktu saat pembayaran selesai | 
| AwaitingPayment | String | Menunjukkan pembayaran tertunda | 
| RequiredBy | String | Tanggal jatuh tempo pembayaran | 


**Tipe data inventaris**  

| Bidang AirBooking Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Kursi | String | Jumlah total kursi dalam pemesanan | 

# Pemetaan tipe objek untuk segmen udara standar
<a name="object-type-mapping-standard-air-segment"></a>

Topik di bagian ini memberikan definisi segmen udara standar.

**Topics**
+ [Profil Pelanggan bidang objek segmen udara standar](standard-air-segment-object-fields.md)

# Profil Pelanggan bidang objek segmen udara standar
<a name="standard-air-segment-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek segmen udara standar Profil Pelanggan.


**Segmen Udara**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| SegmentId | String | Pengidentifikasi unik dari segmen udara standar | 
| BookingRef | String | Pengidentifikasi referensi pemesanan | 
| SegmentName | String | Nama/deskripsi segmen | 
| PassengerIndex | String | Nomor indeks penumpang | 
| SegmentIndex | String | Nomor indeks segmen | 
| SeatSelection | String | Detail pemilihan kursi | 
| NumberOfPassengers | String | Jumlah total penumpang | 
| NumberOfLegs | String | Jumlah kaki penerbangan | 
| Tingkat | String |  tier/status Tingkat penumpang | 
| asal | String | Kode bandara keberangkatan | 
| OriginCountryCode | String | Kode keberangkatan negara | 
| Dest | String | Kode bandara tujuan | 
| DestCountryCode | String | Kode negara tujuan | 
| ProcessedDate | String | Tanggal saat segmen diproses | 
| CreatedDate | String | Tanggal ketika catatan dibuat | 
| CreatedBy | String | Pengguna yang membuat catatan | 
| UpdatedDate | String | Tanggal ketika catatan terakhir diperbarui | 
| UpdatedBy | String | Pengguna yang terakhir memperbarui catatan | 
| Status | String | Status segmen saat ini | 
| FlightNumber | String | Nomor penerbangan | 
| Pembawa | String | Kode operator operasi | 
| CarrierType | String | Jenis pembawa | 
| IsInternational | String | Menunjukkan jika penerbangan internasional | 
| IsEticket | String | Menunjukkan jika tiket elektronik | 
| IsArmed | String | Menunjukkan jika penumpang bersenjata | 
| LapInfant | String | Detail bayi pangkuan | 
| Hewan peliharaan | String | Menunjukkan jika bepergian dengan hewan peliharaan | 
| PrisonerOrGuard | String | Menunjukkan status tahanan atau penjaga | 
| Anak | String | Menunjukkan jika penumpang adalah anak-anak | 
| Menikah | String | Menunjukkan apakah segmen sudah menikah | 
| CheckinEligible | String | Menunjukkan kelayakan check-in | 
| InEligibleReason | String | Alasan jika tidak memenuhi syarat untuk check-in | 
| UnEscortedMinor | String | Menunjukkan status minor tanpa pendamping | 
| PremiumAccess | String | Menunjukkan pembelian akses premium | 
| MissingData | String | Menunjukkan data yang hilang | 
| CurrentClassOfService | String | Kelas layanan saat ini | 
| BookedClassOfService | String | Kelas layanan yang awalnya dipesan | 
| CodeShare | String | Menunjukkan penerbangan codeshare | 
| ReverseCodeShare | String | Menunjukkan codeshare terbalik | 
| MarketCarrierCode | String | Kode operator pemasaran | 
| OpCarrierCode | String | Kode operator operasi | 
| InConnection | String | Detail koneksi masuk | 
| OutConnection | String | Detail koneksi keluar | 
| MilesToEarn | String | Miles yang akan diperoleh | 
| Durasi | String | Durasi penerbangan | 
| DurationTimeUnit | String | Satuan waktu untuk durasi | 
| Jarak | String | Jarak penerbangan | 
| DistanceUnit | String | Satuan untuk pengukuran jarak | 
| SellType | String | Menunjukkan apakah ini adalah penjualan paksa | 
| GoShow | String | Menunjukkan apakah ini adalah go show | 
| Tidak mampu | String | Menunjukkan jika penumpang tidak mampu | 
| Upgrade | String | Menunjukkan apakah penerbangan ditingkatkan | 
| Diturunkan | String | Menunjukkan apakah penerbangan diturunkan | 
| BaggageInsurance | String | asuransi bagasi | 
| MaxAllowedBaggage | String | Tas maksimum yang diizinkan | 
| BaggageQuantity | String | Jumlah tas | 
| BaggageFee | String | Total Biaya Bagasi | 
| Kedatangan | Port | Detail kedatangan untuk Segmen | 
| Keberangkatan | Port | Detail keberangkatan untuk Segmen | 
| Kursi | Kursi | Detail kursi | 
| Prioritas | Prioritas | Detail prioritas | 
| Dok | Dok | Informasi dokumen yang menyertainya untuk perjalanan | 
| Bagasi | Daftar Bagasi | Detail bagasi | 
| Hewan peliharaan | Daftar Hewan Peliharaan | Detail hewan peliharaan | 
| OtherServices | OtherService Daftar | Detail layanan lainnya | 
| Atribut | Peta<String, String> | Atribut tambahan | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1airSegmentId | SegmentId | 
| \$1airBookingRef | BookingRef | 


**Tipe data bagasi**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Id | String | Pengenal bagasi | 
| TagNumber | String | Nomor tag bagasi | 
| DepartureDate | String | Tanggal keberangkatan | 
| BaggageType | String | Jenis bagasi | 
| Bobot | String | Berat bagasi | 
| Panjangnya | String | Panjang bagasi | 
| Lebar | String | Lebar bagasi | 
| Tinggi | String | Ketinggian bagasi | 
| PriorityBagDrop | String | Layanan drop tas prioritas | 
| PriorityBagReturn | String | Layanan pengembalian tas prioritas | 
| HandsFreeBaggage | String | Layanan bagasi hands-free | 
| Biaya | String | Biaya bagasi | 
| IsGateBag | String | Menunjukkan bagasi cek gerbang | 
| IsHeavy | String | Menunjukkan bagasi berat | 


**Tipe data kursi**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| SeatNumber | String | Nomor kursi | 
| SeatZone | String | Zona kursi | 
| SeatType | String | Jenis kursi | 
| Harga | String | Harga Seat | 
| NeighborFree | String | Menunjukkan jika kursi tetangga gratis | 
| UpgradeAuction | String | Menunjukkan ketersediaan peningkatan lelang | 
| Available | String | Menunjukkan ketersediaan kursi | 
| ExtraSeat | String | Menunjukkan kursi tambahan | 
| AdditionalInformation | String | Informasi kursi tambahan | 


**Tipe data port**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Lokasi | String | Nama lokasi | 
| Kode | String | Kode bandara | 
| Terminal | String | Terminal bandara | 
| Negara | String | Negara bandara | 
| Date | String | Date | 
| Waktu | String | Time | 
| EstimatedTime | String | Perkiraan waktu | 
| ScheduledTime | String | Waktu yang dijadwalkan | 


**Tipe data prioritas**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| TransactionId | String | Pengidentifikasi transaksi | 
| PriorityServiceType | String | Jenis layanan prioritas | 
| LoungeAccess | String | Menunjukkan akses lounge | 
| Harga | String | Harga layanan prioritas | 
| AdditionalInformation | String | Informasi prioritas tambahan | 


**Tipe data hewan peliharaan**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Spesies | String | Spesies hewan peliharaan | 
| Berkembang biak | String | Jenis hewan peliharaan | 
| Bobot | String | Berat hewan peliharaan | 
| WeightUnit | String | Satuan berat pengukuran | 
| TransportType | String | Jenis transportasi hewan peliharaan | 


**OtherService tipe data**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| ServiceType | String | Jenis layanan | 
| Deskripsi | String | Deskripsi layanan | 
| Harga | String | Harga layanan | 


**Tipe data dokumen**  

| Bidang AirSegment Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| DocType | String | Jenis dokumen | 
| DocTypeNeeded | String | Menunjukkan jika dokumen diperlukan | 
| Kebangsaan | String | Kewarganegaraan pada dokumen | 
| DateOfBirth | String | Tanggal lahir | 
| AppId | String | Pengidentifikasi aplikasi | 
| AgentId | String | Pengidentifikasi agen | 
| VerifiedDateTime | String | Waktu verifikasi dokumen | 

# Pemetaan tipe objek untuk reservasi hotel standar
<a name="object-type-mapping-standard-hotel-reservation"></a>

Topik di bagian ini memberikan definisi reservasi hotel standar.

**Topics**
+ [Profil Pelanggan bidang objek reservasi hotel standar](standard-hotel-reservation-object-fields.md)

# Profil Pelanggan bidang objek reservasi hotel standar
<a name="standard-hotel-reservation-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek reservasi hotel standar Profil Pelanggan.


**Reservasi Hotel**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| ReservationId | String | Pengenal unik reservasi hotel stanndard | 
| ConfirmationNumber | String | Nomor konfirmasi yang diberikan oleh hotel atau mesin pemesanan | 
| PreferenceRef | String | Pengidentifikasi yang mereferensikan objek Preferensi untuk reservasi | 
| Status | String | Status reservasi saat ini (misalnya, dikonfirmasi, dibatalkan) | 
| TripType | String | Tujuan atau sifat perjalanan (misalnya, rekreasi, bisnis) | 
| BrandCode | String | Kode yang mewakili merek hotel | 
| HotelCode | String | Kode mengidentifikasi hotel tertentu | 
| PhoneNumber | String | Hubungi nomor telepon untuk reservasi | 
| EmailAddress | String | Hubungi alamat email untuk reservasi | 
| GroupId | String | ID yang menautkan reservasi ke pemesanan grup | 
| ContextId | String | Pengenal khusus konteks untuk melacak sumber reservasi | 
| ProcessedDate | String | Stempel waktu saat reservasi diproses | 
| CreatedDate | String | Stempel waktu saat reservasi dibuat | 
| CreatedBy | String | Pengidentifikasi user/system yang membuat reservasi | 
| UpdatedDate | String | Stempel waktu saat reservasi terakhir diperbarui | 
| UpdatedBy | String | Pengenal user/system yang memperbarui reservasi | 
| AgentId | String | ID agen yang menangani pemesanan | 
| Pelayan | String | Menunjukkan jika profil adalah reserver | 
| SameDayRate | String | Menunjukkan apakah pemesanan dilakukan untuk hari yang sama | 
| Dapat dikembalikan | String | Menunjukkan jika pemesanan dapat dikembalikan | 
| CancellationCharge | String | Biaya pembatalan jika berlaku. 0 berarti tidak ada biaya | 
| TransactionId | String | Pengidentifikasi transaksi yang unik | 
| AmountPerNight | String | Jumlah biaya per malam untuk kamar | 
| AdditionalNote | String | Catatan atau instruksi khusus | 
| NumberOfNights | String | Jumlah malam dalam reservasi | 
| NumberOfGuests | String | Jumlah total tamu dalam reservasi | 
| TotalAmountBeforeTax | String | Total biaya sebelum pajak | 
| TotalAmountAfterTax | String | Total biaya setelah pajak | 
| Periksa | CheckOut | Detail checkout | 
| Loyalitas | Loyalitas | Detail loyalitas | 
| Ruang | Ruang | Detail kamar | 
| CheckIn | CheckIn | Detail check-in | 
| Pembayaran | Pembayaran | Detail pembayaran | 
| Mata Uang | Mata Uang | Rincian mata uang | 
| Pembatalan | Pembatalan | Detail pembatalan | 
| Channel | Channel | Detail saluran | 
| RatePlan | RatePlan | Rincian rencana nilai | 
| Tamu | Tamu | Detail tamu | 
| Layanan | Daftar Layanan | Daftar layanan | 
| Atribut | Peta<String, String> | Atribut tambahan | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1hotelReservationId | ReservationId | 
| \$1hotelPreferenceRef | PreferenceRef | 


**Checkout tipe data**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Awal | String | Checkout awal dijadwalkan atau diminta | 
| Terlambat | String | Checkout terlambat dijadwalkan atau diminta | 
| Mandiri | String | Self checkout dijadwalkan atau diminta | 
| Date | String | Tanggal checkout reservasi | 


**Jenis data loyalitas**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| ProgramName | String | Nama program loyalitas | 
| MembershipId | String | ID Anggota dalam program loyalitas | 
| Tingkat | String | Tingkat atau level loyalitas | 


**Tipe data kamar**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| TypeCode | String | Kode untuk tipe/kategori kamar | 
| TypeName | String | Nama tipe kamar | 
| TypeDesc | String | Deskripsi tipe kamar | 
| Bilangan | String | Nomor kamar yang ditetapkan | 
| Kapasitas | String | Kapasitas maksimum ruangan | 
| AccessibilityType | String | Fitur aksesibilitas | 
| SmokingAllowed | String | Menunjukkan jika merokok diperbolehkan di dalam ruangan | 


**CheckIn tipe data**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Date | String | Tanggal check-in reservasi | 
| DigitalKey | String | Menunjukkan jika kunci ruang digital dikeluarkan | 
| Awal | String | Menunjukkan apakah check-in lebih awal diminta | 
| Terlambat | String | Menunjukkan jika check-in terlambat diminta | 
| RoomKeys | String | Jumlah kunci kamar yang dikeluarkan | 
| UserSelectedRoom | String | Benar jika tamu memilih kamar mereka sendiri | 


**Jenis data pembayaran**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis metode pembayaran (misalnya, kredit, debit, voucher) | 
| CreditCardToken | String | Nomor kartu kredit tokenized | 
| CreditCardType | String | Jenis kartu kredit (misalnya, Visa, Amex) | 
| CreditCardExpiration | String | Tanggal kedaluwarsa kartu kredit | 
| Cvv | String | Nilai verifikasi kartu | 
| NameOnCreditCard | String | Nama tercetak pada kartu kredit | 
| RoutingNumber | String | Nomor perutean bank | 
| AccountNumber | String | Nomor rekening bank | 
| VoucherId | String | Pengidentifikasi voucher jika digunakan | 
| DiscountCode | String | Kode diskon terapan | 
| DiscountPercent | String | Persentase discount diterapkan | 


**Jenis data mata uang**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Kode | String | Kode ISO untuk mata uang (mis., USD) | 
| Nama | String | Nama lengkap mata uang (mis., Dolar AS) | 
| Simbol | String | Simbol mata uang (mis., \$1) | 


**Jenis data pembatalan**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Alasan | String | Alasan pembatalan | 
| Komentar | String | Catatan pembatalan tambahan | 


**Jenis data Saluran**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| CreationChannelId | String | ID untuk saluran tempat reservasi dilakukan | 
| LastUpdatedChannelId | String | ID untuk saluran yang terakhir memperbarui reservasi | 
| Metode | String | Metode yang digunakan untuk pemesanan (misalnya, web, aplikasi seluler) | 


**RatePlan tipe data**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Kode | String | Kode Identifier dari paket tarif yang dipesan | 
| Nama | String | Nama paket tarif yang dipesan | 
| Deskripsi | String | Deskripsi rencana tarif | 


**Jenis data layanan**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| ServiceType | String | Jenis layanan (misalnya, spa, sarapan) | 
| Deskripsi | String | Deskripsi layanan | 
| Biaya | String | Biaya layanan | 


**Tipe data tamu**  

| Bidang HotelReservation Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Dewasa | String | Jumlah tamu dewasa | 
| Anak-anak | String | Jumlah tamu anak | 

# Pemetaan tipe objek untuk loyalitas standar
<a name="object-type-mapping-standard-loyalty"></a>

Topik di bagian ini memberikan definisi loyalitas standar.

**Topics**
+ [Profil Pelanggan bidang objek loyalitas standar](standard-loyalty-object-fields.md)

# Profil Pelanggan bidang objek loyalitas standar
<a name="standard-loyalty-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek loyalitas standar Profil Pelanggan.


**Loyalitas**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| LoyaltyId | String | Pengidentifikasi unik dari loyalitas standar | 
| ProgramId | String | Pengidentifikasi untuk program loyalitas | 
| MembershipId | String | Pengidentifikasi alternatif dalam program | 
| ProgramName | String | Nama program loyalitas | 
| Kelompok | String | Kelompok atau kategori program loyalitas | 
| Channel | String | Saluran di mana program loyalitas diakses | 
| CreatedDate | String | Tanggal akun loyalitas dibuat | 
| EnrollmentDate | String | Tanggal pelanggan terdaftar dalam program | 
| CreatedBy | String | Pengguna atau sistem yang membuat akun loyalitas | 
| UpdatedDate | String | Tanggal akun loyalitas terakhir diperbarui | 
| LastUpdatedBy | String | Pengguna atau sistem yang terakhir memperbarui akun loyalitas | 
| UpgradeDate | String | Tanggal saat tingkat terakhir ditingkatkan | 
| RenewalDate | String | Tanggal perpanjangan keanggotaan loyalitas | 
| AdditionalInformation | String | Informasi tambahan apa pun | 
| EmailAddress | String | Alamat email pelanggan | 
| EmailAddressVerified | String | Bendera yang menunjukkan apakah email diverifikasi | 
| PhoneNumber | String | Nomor telepon pelanggan | 
| PhoneNumberVerified | String | Bendera yang menunjukkan apakah nomor telepon diverifikasi | 
| Status | String | Status akun loyalitas saat ini | 
| Tingkat | Tingkat | Detail tingkat | 
| Poin | Poin | Detail poin | 
| PointExpirations | PointExpiration Daftar | Detail kedaluwarsa titik | 
| Pembayaran | Pembayaran | Detail pembayaran | 
| PaymentInformation | PaymentInformation | Detail Informasi Pembayaran | 
| BillingAddress | Alamat Loyalitas | Detail alamat | 
| Atribut | Peta<String, String> | Atribut tambahan tidak tercakup | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1LoyaltyID | LoyaltyId | 
| \$1loyaltyMembershipId | membershipId | 


**Jenis data Alamat Loyalitas**  

| Bidang AirPreference standar | Jenis data | Deskripsi | 
| --- | --- | --- | 
| Alamat1 | String | Baris pertama dari alamat pelanggan. | 
| Alamat2 | String | Baris kedua dari alamat pelanggan. | 
| Alamat3 | String | Baris ketiga dari alamat pelanggan. | 
| Alamat4 | String | Baris keempat dari alamat pelanggan. | 
| Kota | String | Kota tempat pelanggan tinggal. | 
| Negara | String | Negara tempat pelanggan tinggal. | 
| Kabupaten | String | Kabupaten tempat pelanggan tinggal. | 
| PostalCode | String | Kode pos alamat pelanggan. | 
| Provinsi | String | Provinsi tempat pelanggan tinggal. | 
| Status | String | Keadaan di mana pelanggan tinggal. | 


**Tipe data tingkat**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| CurrentTier | String | Tingkat loyalitas pelanggan saat ini | 
| NextTier | String | Tingkat berikutnya yang mungkin untuk pelanggan | 
| PointsToNextTier | String | Poin yang dibutuhkan untuk mencapai tingkat berikutnya | 


**Tipe data poin**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Poin.Unit | String | Satuan pengukuran untuk poin | 
| Poin. Seumur Hidup | String | Total poin seumur hidup yang diperoleh | 
| Poin.Balance | String | Saldo poin saat ini | 
| Poin.Ditebus | String | Total poin yang ditukarkan | 


**PointExpiration tipe data**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Poin | String | Poin kedaluwarsa | 
| Date | String | Tanggal kedaluwarsa untuk poin | 


**Jenis data pembayaran**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis pembayaran | 
| CreditCardToken | String | Referensi kartu kredit tokenized | 
| CreditCardType | String | Jenis kartu kredit (misalnya, Visa) | 
| CreditCardExpiration | String | Tanggal kedaluwarsa kartu kredit | 
| Cvv | String | Nilai verifikasi kartu | 
| NameOnCreditCard | String | Nama pada kartu | 
| RoutingNumber | String | Nomor perutean bank | 
| AccountNumber | String | Nomor rekening bank | 
| VoucherId | String | Pengidentifikasi voucher | 


**PaymentInformation tipe data**  

| Bidang loyalitas standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| Jadwal | String | Jadwal pembayaran | 
| LastPaymentDate | String | Tanggal pembayaran terakhir | 
| NextPaymentDate | String | Tanggal pembayaran berikutnya | 
| NextBillAmount | String | Jumlah untuk tagihan berikutnya | 
| CurrencyCode | String | Kode mata uang (mis., USD) | 
| CurrencyName | String | Nama lengkap mata uang | 
| CurrencySymbol | String | Simbol mata uang (mis., \$1) | 

# Pemetaan tipe objek untuk transaksi loyalitas standar
<a name="object-type-mapping-standard-loyalty-transaction"></a>

Topik di bagian ini memberikan definisi transaksi loyalitas standar.

**Topics**
+ [Profil Pelanggan bidang objek transaksi loyalitas standar](standard-loyalty-transaction-object-fields.md)

# Profil Pelanggan bidang objek transaksi loyalitas standar
<a name="standard-loyalty-transaction-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek transaksi loyalitas standar Profil Pelanggan.


**Transaksi Loyalitas**  

| Bidang Loyalti Transaksi Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| TransactionId | String | Pengidentifikasi unik dari transaksi loyalitas standar. | 
| TransactionName | String | Nama atau label transaksi. | 
| TransactionType | String | Jenis transaksi (misalnya, dapatkan, tukarkan, sesuaikan). | 
| ProgramRef | String | Referensi ke program loyalitas terkait. | 
| MembershipRef | String | Referensi ke keanggotaan loyalitas yang digunakan dalam transaksi. | 
| PromotionRef | String | Referensi untuk promosi yang mempengaruhi transaksi ini. | 
| CreatedDate | String | Tanggal transaksi dibuat. | 
| TransactionDate | String | Tanggal transaksi terjadi. | 
| Industri | String | Industri yang terkait dengan transaksi (misalnya, maskapai penerbangan, hotel). | 
| Lokasi | String | Lokasi dimana transaksi terjadi. | 
| CreatedBy | String | Identifier untuk siapa yang membuat transaksi. | 
| UpdatedDate | String | Tanggal terakhir transaksi diperbarui. | 
| UpdatedBy | String | Pengidentifikasi siapa yang terakhir memperbarui transaksi. | 
| Status | String | Status transaksi saat ini. | 
| AccrualType | String | Metode akrual (manual, otomatis, dll.). | 
| Kategori | String | Kategori transaksi (misalnya, penerbangan, menginap di hotel). | 
| Channel | String | Saluran tempat transaksi dimulai (misalnya, online, di dalam toko). | 
| ProductId | String | Pengidentifikasi produk atau layanan yang terkait dengan transaksi. | 
| Jumlah | String | Jumlah yang dibelanjakan atau ditransaksikan dalam transaksi. | 
| OriginValue | String | Nilai asli sebelum konversi atau offset apa pun. | 
| OriginValueCurrency | String | Mata uang dari nilai transaksi asli. | 
| OriginValueOffset | String | Penyesuaian nilai asli untuk promosi, pengembalian uang, dll. | 
| PointsEarned | String | Total poin yang diperoleh dari transaksi ini. | 
| PointOffset | String | Poin disesuaikan (misalnya, bonus, penalti). | 
| QualifyingPointsEarned | String | Poin yang diperhitungkan dalam kualifikasi tingkat. | 
| TierBefore | String | Tingkat pelanggan sebelum transaksi. | 
| TierAfter | String | Tingkat pelanggan setelah transaksi. | 
| Merek | String | Merek yang terkait dengan transaksi. | 
| Deskripsi | String | Deskripsi naratif transaksi. | 
| AdditionalInformation | String | Freeform informasi tambahan terkait transaksi. | 
| PaymentMethod | String | Metode pembayaran yang digunakan (misalnya, kartu, voucher). | 
| PointTransfer | PointTransfer | Detail transfer poin | 
| Atribut | Peta<String, String> | Atribut tambahan. | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1loyaltyTransactionId | TransactionId | 


**PointTransfer tipe data**  

| Bidang Loyalti Transaksi Standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| TransferId | String | Identifier untuk transaksi transfer. | 
| SourceProgramId | String | ID program loyalitas sumber. | 
| DestinationProgrmId | String | ID program loyalitas tujuan. | 
| SourceMembershipId | String | ID keanggotaan dalam program sumber. | 
| DestinationMembershipId | String | ID Keanggotaan dalam program tujuan. | 
| PointsTransferred | String | Poin dikurangkan dari program sumber. | 
| PointsReceived | String | Poin dikreditkan ke program tujuan. | 

# Pemetaan tipe objek untuk promosi loyalitas standar
<a name="object-type-mapping-standard-loyalty-promotion"></a>

Topik di bagian ini memberikan definisi promosi loyalitas standar.

memakai

**Topics**
+ [Profil Pelanggan bidang objek promosi loyalitas standar](standard-loyalty-promotion-object-fields.md)

# Profil Pelanggan bidang objek promosi loyalitas standar
<a name="standard-loyalty-promotion-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek promosi loyalitas standar Profil Pelanggan.


**Promosi Loyalitas**  

| Bidang Loyalti Standar Promosi | Tipe | Deskripsi | 
| --- | --- | --- | 
| PromotionId | String | Pengidentifikasi unik dari promosi loyalitas standar. | 
| PromotionName | String | Tampilkan nama promosi. | 
| PromotionType | String | Jenis atau kategori promosi (misalnya, bonus, peningkatan tingkat, voucher). | 
| ProgramType | String | Menunjukkan jenis program loyalitas yang terkait dengan promosi. | 
| ProgramRef | String | ID referensi ke program loyalitas terkait. | 
| PartnerId | String | ID referensi dari organisasi mitra yang terlibat dalam promosi. | 
| PartnerNumber | String | Pengenal atau nomor yang terkait dengan mitra. | 
| Tingkat | String | Tingkat tingkat ditargetkan atau dipengaruhi oleh promosi. | 
| StartDate | String | Ketika promosi menjadi aktif. | 
| EnrolledDate | String | Tanggal pengguna terdaftar dalam promosi. | 
| EndDate | String | Saat promosi berakhir. | 
| Jumlah | String | Nilai moneter atau poin terkait dengan promosi. | 
| Periode | String | Periode waktu promosi (misalnya, mingguan, bulanan, berbasis kampanye). | 
| Status | String | Status promosi saat ini (misalnya, aktif, kedaluwarsa, selesai). | 
| CreatedDate | String | Tanggal catatan promosi dibuat. | 
| CreatedBy | String | Pengguna atau sistem yang membuat catatan promosi. | 
| UpdatedDate | String | Tanggal terakhir catatan promosi diperbarui. | 
| UpdatedBy | String | Pengguna atau sistem yang terakhir memperbarui promosi. | 
| CampaignRef | String | Referensi eksternal untuk kampanye yang lebih luas milik promosi ini. | 
| AdditionalInformation | String | Catatan lain-lain atau salinan pemasaran tentang promosi. | 
| TriggerLimit | TriggerLimit | Detail batas pemicu | 
| Penggunaan | Penggunaan | Detail penggunaan | 
| Aturan | Aturan | Rincian aturan promosi | 
| Insentif | Insentif | Detail insentif promosi | 
| Atribut | Peta<String, String> | Metadata tambahan atau nilai khusus program. | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1loyaltyPromotionId | PromotionId | 


**Aturan tipe data**  

| Bidang Loyalti Standar Promosi | Tipe | Deskripsi | 
| --- | --- | --- | 
| Nama | String | Nama aturan dalam aturan promosi. | 
| Deskripsi | String | Deskripsi aturan dalam aturan promosi. | 


**Tipe data insentif**  

| Bidang Loyalti Standar Promosi | Tipe | Deskripsi | 
| --- | --- | --- | 
| Tipe | String | Jenis insentif (mis., BonusPoints, voucher, TierUpgrade). | 
| Nilai | String | Nilai insentif, seperti jumlah poin atau nilai voucher. | 
| Unit | String | Unit untuk nilai insentif (misalnya, poin,%, USD). | 


**TriggerLimit tipe data**  

| Bidang Loyalti Standar Promosi | Tipe | Deskripsi | 
| --- | --- | --- | 
| Kali | String | Berapa kali promosi dapat dipicu. | 
| Interval | String | Interval untuk batas pemicu. | 


**Jenis data penggunaan**  

| Bidang Loyalti Standar Promosi | Tipe | Deskripsi | 
| --- | --- | --- | 
| UsageProgressPercent | String | Persentase kemajuan dari penggunaan promosi. | 
| UsageCompleted | String | Jumlah penggunaan yang selesai. | 
| UsageTarget | String | Target jumlah penggunaan. | 

# Pemetaan tipe objek untuk Objek Web Analytics
<a name="standard-loyalty-promotion-object-mapping-web-analytics"></a>


**WebAnalytics Skema Objek Standar**  

| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  Atribut Acara  | 
|  EventId  |  String  |  Pengidentifikasi unik untuk acara analisis web.  | 
|  EventType  |  String  | Jenis acara analisis web, seperti - Tampilan Halaman, pengiriman formulir, klik tombol, sTarik arus utama\$1 u0000interaksi earch bar, permintaan kesalahan aplikasi, interaksi keranjang, pembelian, gulir, dll. | 
|  EventTimestamp  |  Bilangan  |  Stempel waktu milidetik epoch dari acara tersebut.  | 
|  EventDuration  |  Bilangan  |  EventDuration mewakili jumlah waktu yang dihabiskan pengguna selama interaksi tertentu, diukur dalam hitungan detik. Kasus penggunaan umum meliputi: Waktu yang dihabiskan untuk melihat produk, Panjang sesi penelusuran di halaman tertentu, Waktu yang dihabiskan untuk fitur, dll.  | 
|  EventValue  |  Bilangan  |  EventValue adalah atribut numerik yang mewakili nilai atau pentingnya suatu peristiwa interaksi. Kasus penggunaan umum meliputi: Jumlah pembelian untuk acara transaksi, Nilai peringkat untuk peringkat produk, Persentase penyelesaian untuk penayangan video, dll.  | 
|  Atribut Sesi  | 
|  Session.ID  |  String  |  Pengidentifikasi unik untuk sesi tersebut.  | 
|  Sesi. StartTimestamp  |  Bilangan  |  Epoch milidetik menunjukkan stempel waktu awal sesi.  | 
|  Atribut Halaman/Layar  | 
|  Halaman.Judul  |  String  |  Judul App/Screen Nama Web untuk aplikasi seluler.  | 
|  Page.Lokasi  |  String  |  URL dari halaman Web. Untuk seluler, bisa berupa deep link atau rute ke layar.  | 
|  Page.Referrer  |  String  |  Layar/halaman sebelumnya.  | 
|  Page.Kategori  |  String  |  Pengelompokan logis dari suatu screen/page. Might be useful to group nested URLs/app lokasi.  | 
|  Elemen HTML/DOM  | 
|  Element.Id  |  String  |  HTML Elemen Id  | 
|  Element.Type  |  String  |  Jenis Elemen - Tombol, Tautan Jangkar, Dll.  | 
|  Element.Kelas  |  String  |  CSS Styling Kelas dari Elemen  | 
|  Element.Teks  |  String  |  Teks elemen (Berguna untuk tombol, placeholder bidang input, dll).  | 
|  Elemen. AltText  |  String  |  AltText dari elemen HTML (umumnya digunakan untuk gambar).  | 
|  Element.Sumber  |  String  |  Sumber video, gambar, dll.  | 
|  Formulir  | 
|  Formul.Id  |  String  |  Pengenal Unik untuk formulir masukan  | 
|  Formulir.Nama  |  String  |  Nama Formulir  | 
|  Bentuk.Panjang  |  String  |  Jumlah kolom input dalam bentuk.  | 
|  Formulir. ValidationErrors  |  Bilangan  |  Jumlah kesalahan validasi dalam formulir.  | 
|  Formulir. FieldsCompleted  |  Bilangan  |  Jumlah bidang yang diselesaikan.  | 
|  Formulir. FieldsRequired  |  Bilangan  |  Jumlah bidang yang dibutuhkan.  | 
|  Pencarian  | 
|  Search.Query  |  String  |  Query string yang digunakan dalam input  | 
|  Cari. TotalMatchingResults  |  Bilangan  |  Jumlah total hasil pencarian.  | 
|  Cari. ResultsPerPage  |  Bilangan  |  Jumlah hasil yang ditampilkan per halaman.  | 
|  Cari. CurrentResultsPage  |  Bilangan  |  Halaman hasil saat ini yang dilihat pengguna.  | 
|  Cari. FilterExpression  |  String  |  Setiap ekspresi filter tambahan yang digunakan.  | 
|  Cari. SortCriteria  |  String  |  Kriteria untuk menyortir hasil pencarian. Misalnya - Relevansi, Harga, dll.  | 
|  Cari. SortOrder  |  String  |  Urutkan urutan untuk hasil Pencarian - Ascending/Menurun.  | 
|  Daftar Barang/Barang  | 
|  Item  |  Item  |  Item terfokus dalam suatu acara, menunjukkan, item yang ditambahkan ke keranjang, item yang dilihat, dll.  | 
|  ItemsList  |  Daftar <Item>  |  Daftar item yang terfokus dalam suatu acara, menunjukkan, barang yang dibeli, item dalam keranjang, hasil pencarian item, dll.  | 
|  Tayangan Barang  | 
|  AdditionalItemImpressions  |  Daftar <Item>  |  Daftar tayangan Item Tambahan  | 
|  Keranjang  | 
|  Keranjang.id  |  String  |  Pengenal unik untuk keranjang.  | 
|  Keranjang. ItemsCount  |  Bilangan  |  Jumlah item di keranjang.  | 
|  Keranjang.Mata Uang  |  String  |  Mata uang untuk nilai keranjang.  | 
|  Keranjang.Nilai  |  Bilangan  |  Nilai moneter item di keranjang.  | 
|  Informasi Pesanan  | 
|  OrderId  |  String  |  Pengidentifikasi unik untuk pesanan. Kami hanya akan menyimpan pengenal pesanan di sini, informasi lain yang terkait dengan pesanan akan disimpan di objek pesanan standar.  | 
|  Perangkat  | 
|  DeviceId  |  String  |  Pengidentifikasi unik perangkat pengguna.  | 
|  Atribut Gulir  | 
|  Gulir. DepthPercentage  |  String  |  Persentase kedalaman Gulir Vertikal. Ini membantu memahami seberapa jauh pengguna menggulir halaman web.  | 
|  scroll.positionX  |  Bilangan  |  Posisi Gulir Horizontal dalam piksel dari kiri.  | 
|  Scroll.Positiony  |  Bilangan  |  Posisi Gulir Vertikal dalam piksel dari atas.  | 
|  Kesalahan  | 
|  Kesalahan.Deskripsi  |  String  |  Deskripsi singkat tentang kesalahan.  | 
|  Error.Type  |  String  |   Error/Server Kesalahan Masukan Pengguna.  | 
|  Pengguna  | 
|  User.ID  |  String  |  Pengidentifikasi unik pengguna  | 
|  Pengguna. AnonymousId  |  String  |  Anonim UserId. Ini akan menjadi UniqueID yang ditetapkan untuk pengguna saat mereka tidak masuk.  | 
|  Pengguna. IsReturning  |  String  |  Nilai Boolean yang menunjukkan jika pengguna meninjau kembali.  | 
|  Pengguna. IsLoggedIn  |  String  |  Nilai Boolean yang menunjukkan jika pengguna login.  | 
|  Lokasi aktivitas  | 
|  Lokasi.Negara  |  String  |  Negara aktivitas pengguna.  | 
|  Location.State  |  String  |  Status aktivitas pengguna.  | 
|  Lokasi.Provinsi  |  String  |  Provinsi aktivitas pengguna.  | 
|  Lokasi.Kabupaten  |  String  |  Kabupaten aktivitas pengguna.  | 
|  Lokasi.Kota  |  String  |  Kota aktivitas pengguna.  | 
|  Lokasi.Lintang  |  String  |  Koordinat lokasi aktivitas pengguna  | 
|  Lokasi.Bujur  |  String  |  Koordinat lokasi aktivitas pengguna  | 
|  Atribut Aplikasi  | 
|  Aplikasi.Nama  |  String  |  Nama aplikasi.  | 
|  Aplikasi.Versi  |  String  |  Jika perangkatnya Seluler, kita dapat menangkap Versi Aplikasi di sini. Pengguna juga dapat mempertimbangkan untuk menggunakan ini untuk A/B pengujian populasi atau atribut eksperimen.  | 
|  Application.Environment  |  String  |  Lingkungan aplikasi, seperti - Beta, Gamma, Prod.  | 
|  Atribut Kustom  | 
|  Atribut  |  Peta<String, String>  |  Setiap atribut kustom atau metadata untuk ditambahkan ke acara.  | 


**WebAnalytics Skema Objek Barang**  

| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  Id  |  String  |  Pengenal Unik untuk item tersebut.  | 
|  judul  |  String  |  Judul Item.  | 
|  Kategori  |  String  |  Kategori item.  | 
|  Nilai  |  String  |  Nilai moneter dari item tersebut.  | 
|  Mata Uang  |  String  |  Mata uang barang.  | 
|  Kuantitas  |  Bilangan  |  Kuantitas barang.  | 
|  ImpressionType  |  String  |  String mengidentifikasi jenis tayangan untuk suatu peristiwa. Misalnya - Unggulan, Disponsori, Pilihan teratas, dll.  | 
|  ImpressionId  |  String  |  Pengidentifikasi string untuk mengidentifikasi tayangan secara unik.  | 


**Skema Objek Standar Perangkat**  

| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  DeviceId  |  String  |  Pengidentifikasi unik untuk perangkat.  | 
|  Tipe  |  String  |  Jenis perangkat (misalnya, desktop, seluler)  | 
|  Model  |  String  |  Model perangkat, seperti - Macbook Pro/Air, IPhone 16, dll.  | 
|  Pabrikan  |  String  |  Produsen perangkat.  | 
|  OperatingSystem  |  String  |  Menunjukkan Windows MacOs,, iOS, Android.  | 
|  OperatingSystemVersion  |  String  |  Versi OS  | 
|  ScreenWidth  |  Bilangan  |  Lebar Layar ViewPort  | 
|  ScreenHeight  |  Bilangan  |  Ketinggian Layar ViewPort  | 
|  Peramban  |  String  |  Nama Browser yang berinteraksi dengan pengguna.  | 
|  BrowserVersion  |  String  |  Versi Browser  | 
|  Lokal  |  String  |  Perangkat atau Aplikasi lokal.  | 
|  Atribut  |  Peta<String, String>  |  Atribut Kustom apa pun untuk Perangkat.  | 

# Pemetaan tipe objek untuk Katalog Item
<a name="standard-loyalty-promotion-object-mapping-item-catalog"></a>


| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  Id  | String | Pengenal Unik untuk Item dalam Katalog. | 
|  Nama  | String | Nama Barang | 
|  Kode  | String | Kode item katalog | 
|  Tipe  | String | Jenis item katalog | 
|  Kategori  | String | Kategori item dalam Katalog | 
|  Deskripsi  | String | Deskripsi barang | 
|  AdditionalInformation  | String | Informasi tambahan apa pun yang relevan dengan item tersebut. | 
|  ImageLink  | String | Tautan ke gambar Item | 
|  Tautan  | String | URL barang | 
|  Harga  | String | Harga Barang | 
|  CreatedAt  | Panjang | Stempel waktu Epoch tempat Item dibuat | 
|  UpdatedAt  | Panjang | Stempel waktu Epoch yang Item telah diperbarui | 
| Atribut | Peta<String, String> | Atribut Item Tambahan | 

**catatan**  
Anda hanya dapat menghapus jenis objek domain melalui APIs. Anda dapat menghapus integrasi katalog item setelah semua pemberi rekomendasi dihapus terlebih dahulu. Ini mencegah masalah ketergantungan data.  
**Langkah-langkah untuk menghapus:**  
1. Hapus semua rekomendasi yang ada di domain Anda  
2. Arahkan ke integrasi katalog item.  
3. Pilih opsi hapus.

# Pemetaan tipe objek untuk pendapatan menginap hotel standar
<a name="object-type-mapping-standard-hotel-stay-revenue"></a>

Topik di bagian ini memberikan definisi pendapatan menginap hotel standar.

**Topics**
+ [Profil Pelanggan bidang objek pendapatan menginap hotel standar](standard-hotel-stay-revenue-object-fields.md)

# Profil Pelanggan bidang objek pendapatan menginap hotel standar
<a name="standard-hotel-stay-revenue-object-fields"></a>

Tabel berikut mencantumkan semua bidang dalam objek standar pendapatan menginap hotel Profil Pelanggan.


**Pendapatan Menginap di Hotel**  

|  hotelStayRevenue Bidang standar | Tipe | Deskripsi | 
| --- | --- | --- | 
| StayRevenueId | String | Pengenal unik dari pendapatan menginap hotel standar. | 
| CurrencyCode | String | Kode ISO untuk mata uang (mis., USD) | 
| CurrencyName | String | Nama lengkap mata uang (mis., Dolar AS) | 
| CurrencySymbol | String | Simbol mata uang (mis., \$1) | 
| ReservationId | String | Pengenal unik untuk reservasi hotel | 
| GuestId | String | Pengenal unik untuk tamu | 
| LastUpdatedOn | String | Stempel waktu pembaruan terakhir ke catatan tinggal | 
| CreatedOn | String | Stempel waktu kapan catatan tinggal dibuat | 
| LastUpdatedBy | String | Pengidentifikasi user/system yang terakhir memperbarui catatan tinggal | 
| CreatedBy | String | Pengidentifikasi user/system yang membuat catatan tinggal | 
| StartDate | String | Tanggal mulai menginap di hotel | 
| HotelCode | String | Kode mengidentifikasi hotel tertentu | 
| Tipe | String | Jenis pendapatan (misalnya, tarif kamar, tidak terduga, pajak) | 
| Deskripsi | String | Deskripsi item pendapatan | 
| Jumlah | String | Jumlah item pendapatan | 
| ProcessedDate | String | Tanggal pendapatan diproses | 
| Status | String | Status item pendapatan | 
| Atribut | Peta<String, String> | Metadata tambahan atau nilai khusus program. | 


**Bidang Indeks Standar**  

| Nama indeks standar | Bidang catatan preferensi standar | 
| --- | --- | 
| \$1 hotelStayRevenue Id | StayRevenueId | 

# Properti tambahan dari jenis objek di Profil Pelanggan
<a name="additional-properties-object-types"></a>

Tipe properti mendefinisikan kunci mana yang harus digunakan untuk mengenkripsi data apa pun dari jenis objek.

Ada opsi yang menentukan apakah profil baru dapat dibuat dengan menelan objek ini. Biasanya ketika objek dicerna yang tidak dapat dicocokkan dengan profil yang ada, profil baru dibuat selama opsi ini benar. Jika tidak benar maka objek yang dicerna dibuat dan ditulis ke antrian huruf mati domain.

Ini juga berisi berapa lama data jenis objek ini harus disimpan di Profil Pelanggan. 

**catatan**  
Retensi pada objek individu diatur pada saat konsumsi data. Mengubah retensi untuk jenis objek tertentu hanya berlaku untuk data baru yang dicerna. Itu tidak berlaku untuk data yang ada yang sudah tertelan.

**catatan**  
Jika objek ini cocok dengan profil yang ada, itu tidak akan menimpa bidang yang diisi secara manual melalui panggilan API atau Ruang Kerja Agen, untuk mencegah konsumsi otomatis menimpa yang manual.  
Misalnya, misalkan profil dibuat dengan FirstName “John” secara manual oleh agen di Ruang Kerja Agen. Data pemetaan objek ke FirstName bidang Profil Standar dicerna. Jika objek ini terkait dengan profil, itu tidak akan menimpa FirstName “John”.

# Profil yang disimpulkan
<a name="inferred-profiles"></a>

Ketika profil dibuat oleh konsumsi objek yang tidak memiliki bidang, objek profil standar dari profil baru ini kosong. Objek profil standar kosong ini adalah **profil yang disimpulkan**. 

Saat membuat profil yang disimpulkan, dua bidang berikut diisi dalam objek standar dari objek profil, jika tersedia.
+ Jika ada bidang yang ditentukan dengan jenis konten `EMAIL_ADDRESS` di objek yang dicerna maka nilai ini akan diisi ke dalam `EmailAddress` bidang profil standar.
+ Jika ada bidang dengan jenis konten `PHONE_NUMBER` di objek yang dicerna maka nilai ini akan diisi ke dalam `PhoneNumber` bidang profil standar.

Nilai untuk bidang ini diisi ke dalam profil standar bahkan jika bidang tidak memiliki target yang ditentukan dalam definisi bidang.

Untuk mempelajari lebih lanjut tentang jenis templat Rekaman Kontak, serta cara menyesuaikan templat yang digunakan pada domain Anda, lihat[Contoh penggunaan templat catatan kontak](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples).

# Templat catatan kontak di Amazon Connect Customer Profiles
<a name="ctr-contact-record-template"></a>

Rekaman Kontak berfungsi sebagai objek profil yang menangkap meta-data penting dari berbagai peristiwa kontak, seperti panggilan telepon atau obrolan. Ini memainkan peran penting dalam mendokumentasikan dan menganalisis interaksi dengan pelanggan. 

Saat peristiwa kontak berlangsung, ada tiga templat default berbeda yang dapat diterapkan ke domain Anda. Template ini berfungsi sebagai opsi konfigurasi, yang mengatur bagaimana peristiwa kontak ditangani dalam sistem. Setiap template mendefinisikan aturan dan tindakan tertentu, memungkinkan Anda untuk menyesuaikan pemrosesan peristiwa kontak sesuai dengan kebutuhan bisnis Anda.

**Topics**
+ [Buat profil yang disimpulkan dan profil asosiasi otomatis (RKT-) NoInferred](#ctr-contact-record-template-no-inferred)
+ [Hanya profil asosiasi otomatis (RKT-) AutoAssociateOnly](#ctr-contact-record-template-auto-associate)
+ [Buat profil yang disimpulkan saja (CTR)](#ctr-contact-record-template-inferred-only)
+ [Contoh penggunaan templat catatan kontak](#ctr-contact-record-template-usage-examples)
+ [Cara memperbarui jenis Rekaman Kontak di AWS Console](#ctr-contact-record-template-usage-examples-console)
+ [Secara otomatis menambahkan nama dari kontak email ke profil](#add-email-names-to-profile)

## Buat profil yang disimpulkan dan profil asosiasi otomatis (RKT-) NoInferred
<a name="ctr-contact-record-template-no-inferred"></a>

**Deskripsi**

Ketika RKT- NoInferred template digunakan dan peristiwa kontak, seperti panggilan telepon terjadi, proses tertentu dimulai untuk menangani data. Awalnya, sistem menggunakan `_ctrContactId` kunci untuk mencari profil yang ada terkait dengan acara kontak. Jika profil yang cocok ditemukan, peristiwa kontak secara otomatis dikaitkan dengan profil tersebut. Namun, jika tidak ada profil yang ditemukan menggunakan `_ctrContactId` kunci, sistem melanjutkan untuk mencari profil menggunakan kunci sekunder yang disebut`_phone`. Kunci ini digunakan untuk menemukan profil yang ada berdasarkan nomor telepon yang terkait dengan peristiwa kontak. Ketika profil yang cocok ditemukan, peristiwa kontak secara otomatis dikaitkan dengan profil itu.

Dalam kasus di mana `_ctrContactId` kunci maupun kunci tidak menghasilkan profil yang ada, sistem membuat profil baru yang disimpulkan. `_phone` Profil yang disimpulkan ini kemudian diisi dengan meta-data dari peristiwa kontak, memastikan bahwa informasi ditangkap dan disimpan dalam sistem.

Proses ini memastikan penanganan peristiwa kontak yang efisien, mempromosikan asosiasi otomatis dengan profil yang ada dan memungkinkan pembuatan profil yang disimpulkan bila perlu. Dengan memanfaatkan mekanisme ini, organisasi dapat menyimpan catatan komprehensif interaksi pelanggan dan secara efektif mengelola data peristiwa kontak mereka dalam sistem.

Disarankan untuk menggunakan NoInferred RKT-template sebagai perilaku default karena keuntungannya yang signifikan, terutama dalam mengurangi profil duplikat

![\[Diagram NoInferred templat CTR Rekam Kontak.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)


## Hanya profil asosiasi otomatis (RKT-) AutoAssociateOnly
<a name="ctr-contact-record-template-auto-associate"></a>

**Deskripsi**

AutoAssociateOnly RKT-template berfungsi mirip dengan CTR- NoInferred template dengan satu perbedaan penting: itu tidak membuat profil yang disimpulkan ketika tidak ada profil yang ada dapat ditemukan untuk asosiasi otomatis.

Ketika peristiwa kontak, seperti panggilan telepon, berlangsung, AutoAssociateOnly RKT- template menggunakan `_ctrContactId` kunci untuk mencari profil yang ada yang cocok. Jika profil ditemukan, acara kontak secara otomatis dikaitkan dengan profil tersebut.

Namun, jika tidak ada profil yang ditemukan menggunakan `_ctrContactId` kunci, template menggunakan mekanisme pencarian sekunder menggunakan `_phone` kunci. Ini mencari profil yang ada yang terkait dengan nomor telepon yang sama dengan acara kontak. Jika profil yang cocok ditemukan, peristiwa kontak dikaitkan secara otomatis dengan profil tersebut.

Tujuan menggunakan AutoAssociateOnly RKT-template adalah untuk mengaktifkan asosiasi otomatis dengan profil yang ada sambil mempertahankan kontrol ketat atas pembuatan profil. Berbeda dengan CTR- NoInferred template, template ini mencegah pembuatan profil yang disimpulkan ketika tidak ada kecocokan yang ditemukan. Ini memastikan bahwa profil hanya dibuat secara manual, memberikan organisasi dengan tingkat kontrol dan akurasi yang lebih tinggi dalam manajemen profil.

Dengan memanfaatkan RKT- AutoAssociateOnly template, organisasi dapat memanfaatkan asosiasi otomatis sambil mematuhi aturan khusus mengenai pembuatan profil. Pendekatan ini memungkinkan penanganan peristiwa kontak yang efisien dan kontrol yang tepat atas ekosistem profil, memastikan representasi data yang akurat dan memfasilitasi manajemen pelanggan yang efisien.

![\[Diagram AutoAssociateOnly templat CTR Rekam Kontak.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)


## Buat profil yang disimpulkan saja (CTR)
<a name="ctr-contact-record-template-inferred-only"></a>

**Deskripsi**

Template CTR hanya bergantung pada `_ctrContactId` kunci untuk mencari profil yang ada, dan secara otomatis mengaitkan acara kontak dengan profil jika kecocokan ditemukan. Namun, dalam kasus di mana tidak ada profil yang ditemukan, template membuat profil yang disimpulkan dan mengisinya dengan meta-data peristiwa kontak.

Meskipun perilaku ini memastikan bahwa peristiwa kontak ditangkap bahkan ketika tidak ada profil yang sudah ada sebelumnya, hal itu berpotensi menghasilkan pembuatan banyak profil yang disimpulkan. Kelimpahan profil yang disimpulkan ini dapat menyebabkan masalah profil duplikat dalam sistem.

Untuk mengatasi masalah ini dan mempromosikan praktik manajemen profil yang lebih baik, kami sangat menyarankan untuk menggunakan RKT- NoInferred template sebagai opsi default. Dengan menggunakan RKT- NoInferred template, sistem menghilangkan pembuatan profil yang disimpulkan, sehingga mengurangi terjadinya profil duplikat. Template ini memungkinkan penanganan peristiwa kontak yang lebih efisien dan efisien, menghasilkan integritas dan akurasi data yang lebih baik.

Dengan mengadopsi NoInferred RKT-template sebagai pilihan default, organisasi dapat mengoptimalkan proses manajemen profil mereka, meminimalkan duplikasi data, dan memastikan representasi interaksi pelanggan yang lebih andal.

![\[Diagram templat CTR Rekaman Kontak.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)


## Contoh penggunaan templat catatan kontak
<a name="ctr-contact-record-template-usage-examples"></a>

**Amazon Connect situs web admin**
+ Di situs web Amazon Connect admin, saat membuat domain baru, Anda memiliki opsi untuk memilih perilaku RKPT yang diinginkan. Ini dapat dilakukan melalui opsi tombol radio yang tersedia di bagian **Pembuatan profil dan asosiasi otomatis**. Demikian pula, ketika memilih domain yang ada, opsi tombol radio akan mencerminkan perilaku yang sebelumnya terkait dengan domain itu.
+ Saat mengedit domain yang saat ini diaktifkan, halaman detail Domain akan menampilkan perilaku yang saat ini diterapkan di bagian **Pembuatan profil dan asosiasi otomatis**. Dengan memilih tombol **Edit** di header bagian ini, Anda akan diarahkan ke halaman **Edit** **Pembuatan Profil dan asosiasi otomatis**. Di sini, Anda dapat memilih perilaku yang berbeda sesuai dengan kebutuhan Anda.
+ **Atau, jika Anda melihat pemetaan CTR dari halaman pemetaan **data**, Anda dapat memilih tombol Ubah template.** Tindakan ini juga akan membawa Anda ke halaman **Edit** **pembuatan Profil dan asosiasi otomatis**, di mana Anda dapat memilih perilaku berbeda yang sesuai dengan kebutuhan Anda.

Opsi ini memberi Anda fleksibilitas dalam mengelola perilaku RKPT untuk domain Anda, memungkinkan Anda untuk dengan mudah menyesuaikan dan memodifikasi pengaturan berdasarkan preferensi spesifik Anda atau persyaratan bisnis yang berkembang.

**AWS CLI**
+ Untuk menggunakan **RKT- NoInferred** template, jalankan perintah berikut pada CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ Untuk menggunakan **RKT- AutoAssociateOnly** template, jalankan perintah berikut pada CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ Untuk menggunakan template **CTR**, jalankan perintah berikut pada CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `

**API**

Untuk informasi tentang penggunaan API, lihat [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)

## Cara memperbarui jenis Rekaman Kontak di AWS Console
<a name="ctr-contact-record-template-usage-examples-console"></a>

1. Di konsol Profil Pelanggan, pilih **Lihat Detail** di bagian **domain Profil Pelanggan**.  
![\[Pilih Lihat detail di bagian domain Profil Pelanggan\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)

1. Pada halaman **Detail domain**, pilih **Edit** di bagian **Pembuatan profil dan asosiasi otomatis**.  
![\[Pilih Edit di bagian Pembuatan profil dan asosiasi otomatis.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)

1. Pilih perilaku Rekaman Kontak yang diinginkan yang ingin Anda terapkan ke Domain Anda dan pilih **Simpan**.  
![\[Pilih perilaku Rekaman Kontak yang diinginkan yang ingin Anda terapkan ke Domain Anda dan pilih Simpan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)

## Secara otomatis menambahkan nama dari kontak email ke profil
<a name="add-email-names-to-profile"></a>

Anda dapat mengatur alur untuk mengisi nama dari kontak email ke profil pelanggan. Gunakan [Profil pelanggan](customer-profiles-block.md) blok, dikonfigurasi untuk menggunakan tindakan [Perbarui profil](customer-profiles-block.md#customer-profiles-block-properties-update-profile). 

# Kaitkan Rekaman Kontak dengan satu profil yang ditemukan menggunakan kunci \$1phone di Profil Pelanggan
<a name="auto-associate-profile-using-phone-profile-key"></a>

Anda dapat secara otomatis mengaitkan Catatan Kontak dengan satu profil yang ditemukan menggunakan `_phone` kunci.

**Contoh**

Di domain, profil berikut dibuat oleh `CreateProfile` API:

```
            {
                "FirstName": "John",
                "LastName": "Doe",
                "PhoneNumber": "+11234567890"
            }
```

Ketika panggilan diterima dari `PhoneNumber` \$111234567890 menggunakan templat RKPT default, Catatan Kontak tidak akan secara otomatis dikaitkan dengan profil di atas kecuali agen telah secara manual mengaitkan Catatan Kontak dengan penelepon yang sama ke profil di atas. Jika Catatan Kontak tidak terkait secara manual atau otomatis, Profil Pelanggan akan membuat profil yang disimpulkan dengan informasi dari Catatan Kontak.

Untuk secara otomatis mengaitkan profil di atas dengan catatan kontak tanpa intervensi agen manual, Anda dapat menggunakan RKPT- NoInferred template. Ketika panggilan diterima dari `PhoneNumber` \$111234567890 menggunakan NoInferred template CTR-, Catatan Kontak akan secara otomatis dikaitkan dengan profil di atas menggunakan kunci profil. `_phone`

Ada dua skenario di mana Profil Pelanggan *tidak* akan dapat secara otomatis mengaitkan Catatan Kontak ke profil:
+ Jika lebih dari satu profil ditemukan menggunakan kunci `_phone` profil, Profil Pelanggan tidak dapat mengaitkan Catatan Kontak ke profil unik dan permintaan akan ditolak.
+ Jika tidak ada profil yang ditemukan untuk kunci `_phone` profil, Profil Pelanggan akan membuat profil yang disimpulkan.

Untuk menggunakan CTR- NoInferred template untuk mengganti template CTR default, jalankan perintah berikut pada CLI:

`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`

Untuk kembali ke perilaku default, jalankan perintah berikut pada CLI:

`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`

# Contoh pemetaan tipe objek di Amazon Connect Customer Profiles
<a name="examples-object-type-mappings"></a>

## Pemetaan tipe objek yang menghasilkan profil
<a name="profile-generating-example"></a>

Contoh berikut menunjukkan data yang mengisi profil standar.

Berikut ini adalah objek yang masuk:

```
{
  "account": 1234,
  "email": "john@examplecorp.com",
  "address": {
     "address1": "Street",
     "zip": "Zip",
     "city": "City"
  },
  "firstName": "John",
  "lastName": "Doe"
}
```

Kode berikut menunjukkan bahwa pemetaan objek masuk ke objek profil standar dan pengindeksan`PersonalEmailAddress`,, dan `fullName``accountId`, yang merupakan kunci unik.

```
{
    "Fields": {
        "accountId": {
            "Source": "_source.account",
            "Target": "_profile.AccountNumber",
            "ContentType": "NUMBER"
        },
        "shippingAddress.address1": {
            "Source": "_source.address.address1",
            "Target": "_profile.ShippingAddress.Address1"
        },
        "shippingAddress.postalCode": {
            "Source": "_source.address.zip",
            "Target": "_profile.ShippingAddress.PostalCode"
        },
        "shippingAddress.city": {
            "Source": "_source.address.city",
            "Target": "_profile.ShippingAddress.City"
        },
        "personalEmailAddress": {
            "Source": "_source.email",
            "Target": "_profile.PersonalEmailAddress",
            "ContentType": "EMAIL_ADDRESS"
        },
        "fullName": {
            "Source": "{{_source.firstName}} {{_source.lastName}}"
        },
        "firstName": {
            "Source": "_source.firstName",
            "Target": "_profile.FirstName"
        },
        "lastName": {
            "Source": "_source.lastName",
            "Target": "_profile.LastName"
        }
    },
    "Keys": {
        "_email": [
            {
                "FieldNames": ["personalEmailAddress"]
            }
        ],
        "_fullName": [
            {
                "FieldNames": ["fullName"]
            }
        ],
        "_account": [
            {
                "StandardIdentifiers": ["PROFILE","UNIQUE"],
                "FieldNames": ["accountId"]
            }
        ]
    }
}
```

Perhatikan bahwa `email` dan `fullname` diindeks, tetapi mereka tidak digunakan untuk mencari profil. Akun adalah kunci unik. Diperlukan untuk menentukan objek. Setiap kali objek dengan ID akun yang sama dicerna, objek tersebut akan menimpa objek sebelumnya dengan ID akun yang sama.

Beberapa bidang diisi dalam objek profil standar (lihat bidang yang telah `Target` ditentukan).

## Pemetaan tipe objek yang tidak mengisi profil standar
<a name="ticket-issue-example"></a>

Contoh ini menunjukkan kasus penggunaan yang lebih rumit. Ini menelan data yang terkait dengan profil tetapi tidak selalu mengisi objek profil standar.

Berikut ini adalah objek yang masuk:

```
{
  "email": "john@examplecorp.com",
  "timestamp": "2010-01-01T12:34:56Z",
  "subject": "Whatever this is about",
  "body": "Body of ticket"
}
```

Berikut ini adalah salah satu cara pemetaan data ini:

```
{
    "Fields": {
        "email": {
            "Source": "_source.email",
            "ContentType": "EMAIL_ADDRESS"
        },
        "timestamp": {
            "Source": "_source.timestamp"
        }
    },
    "Keys": {
        "_email": [
            {
                "StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "ticketEmail": [
            {
                "StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "uniqueTicket": [
            {
                "StandardIdentifiers": ["UNIQUE"],
                "FieldNames": ["email","timestamp"]
            }
        ]
    }
}
```

Contoh ini menyerap data dan, pada pencarian pertama, ia menelan alamat email. 
+ Jika alamat email cocok dengan satu profil, itu digunakan untuk melampirkan data ke profil tertentu. Pengenal unik untuk tiket terdiri dari email dan stempel waktu karena tidak ada pengenal unik lainnya.
+ Jika tidak ada profil dengan email yang ditentukan, profil baru dibuat dengan satu bidang `EmailAddress` diisi. Objek yang tertelan dilampirkan ke profil baru yang **disimpulkan** ini. Dua kunci yang dapat dicari yang dapat menemukan profil adalah `_email` dan. `uniqueTicket`
+ Jika ada lebih dari satu profil dengan alamat email yang ditentukan, profil baru dibuat dengan satu bidang `EmailAddress` diisi dan objek dilampirkan ke profil baru ini. Profil ini dibuat dengan `ticketEmail` kunci yang ditentukan, selain `_email` dan`uniqueTicket`. Setiap tiket berikutnya dari email tersebut ditugaskan ke **profil baru yang disimpulkan** ini. Alasan untuk ini adalah bahwa ` _email` kuncinya mengacu pada tiga profil dan dengan demikian dibuang, namun `ticketEmail` kuncinya hanya mengacu pada satu profil (yang baru disimpulkan) dan masih valid.
+ Dalam kasus di mana **profil baru yang disimpulkan** dibuat, `EmailAddress` bidang diisi dari objek pertama yang membuatnya.

# Jenis objek profil implisit di Amazon Connect Customer Profiles
<a name="implicit-profile-object-types"></a>

Anda dapat menggunakan jenis objek apa pun yang cocok dengan nama ID templat (seperti yang dikembalikan oleh [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API) tanpa mendefinisikannya secara eksplisit. Jenis objek akan sama persis dengan definisi definisi template dari jenis objek ini. Jika tipe objek eksplisit didefinisikan, itu menggantikan yang implisit. 

Jenis objek implisit disertakan dalam [ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html)API atau dikembalikan oleh [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html)operasi, tetapi masih dapat dihapus jika Anda ingin menghapus semua data yang tertelan dari tipe objek tersebut.

# Pemetaan data bertenaga AI generatif di Amazon Connect
<a name="genai-powered-data-mapping"></a>

Amazon Connect Profil Pelanggan menyediakan kemampuan pemetaan data pelanggan bertenaga AI generatif yang secara signifikan mengurangi waktu yang dibutuhkan untuk membuat profil terpadu, memungkinkan Anda membantu memberikan pengalaman pelanggan yang lebih personal.

Dengan kemampuan ini, ketika administrator pusat kontak menambahkan data pelanggan dari 70\$1 konektor data tanpa kode yang tersedia seperti Adobe Analytics, Salesforce, atau Amazon Simple Storage Service (S3) Amazon Connect , Profil Pelanggan akan menganalisis data dari sumber-sumber ini untuk secara otomatis menentukan cara mengatur dan menggabungkan data yang ada dalam format berbeda di seluruh sumber yang berbeda ke dalam profil terpadu di. Amazon Connect Administrator pusat kontak dapat meninjau dan menyelesaikan pengaturan profil pelanggan, sehingga mereka dapat memberikan agen informasi pelanggan yang relevan dan secara dinamis mempersonalisasi dan chatbots untuk meningkatkan kepuasan pelanggan IVRs dan produktivitas agen.

Pemetaan data pelanggan bertenaga AI generatif tersedia di wilayah berikut:
+ AS Timur (Virginia Utara)
+ AS Barat (Oregon)
+ Africa (Cape Town)
+ Asia Pasifik (Singapura)
+ Asia Pasifik (Sydney)
+ Asia Pasifik (Tokyo)
+ Asia Pasifik (Seoul)
+ Kanada (Pusat)
+ Eropa (Frankfurt)
+ Eropa (London)

## Siapkan pemetaan data bertenaga AI generatif
<a name="set-up-genai-powered-data-mapping"></a>

1. Buka konsol Profil Amazon Connect Pelanggan.

1. Pada tab **Integrasi sumber data**, pilih **Tambahkan integrasi sumber data**.

1. Siapkan koneksi. Pilih sumber data dari drop-down yang memiliki semua konektor yang didukung tersedia.  
![\[Pilih sumber data dari drop-down yang memiliki semua konektor yang didukung tersedia.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)

1. Data peta. Pilih opsi untuk menghasilkan pemetaan data secara otomatis, atau pilih templat pemetaan yang sudah ada atau buat dari awal..  
![\[Data peta. Pilih opsi untuk menghasilkan pemetaan data secara otomatis, atau pilih templat pemetaan yang sudah ada atau buat dari awal.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)

1. Tinjau ringkasan pemetaan. Tinjau ringkasan hasil pemetaan yang dibuat secara otomatis yang menunjukkan semua atribut pelanggan. Lakukan pengeditan pada kunci konsumsi dan konfirmasikan sebelum memulai konsumsi data. Untuk informasi lebih lanjut tentang pemetaan lapangan dan kunci, lihat. [Detail definisi pemetaan tipe objek di Amazon Connect Customer Profiles](object-type-mapping-definition-details.md)  
![\[Tinjau ringkasan pemetaan. Tinjau ringkasan hasil pemetaan yang dibuat secara otomatis yang menunjukkan semua atribut pelanggan. Lakukan pengeditan pada kunci konsumsi dan konfirmasikan sebelum memulai konsumsi data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)

## Cara kerjanya
<a name="genai-powered-data-mapping-how-it-works"></a>

Sistem ini bekerja dalam empat fase. Pada tahap pertama, Profil Pelanggan mengambil atribut sumber dan, jika tersedia, sampel data dari sumber data Anda, selanjutnya menentukan jenis objek yang paling tepat untuk target. Untuk sumber data Amazon S3, file CSV pertama yang ditemukan di bucket dan awalan Amazon S3 yang dipilih akan digunakan sebagai data sampel. Untuk sumber data lainnya, Profil Pelanggan mengambil atribut sumber melalui AppFlow. Pada fase kedua, model bahasa besar (LLM) dimanfaatkan untuk memproses lebih lanjut setiap atribut khusus dan memetakannya ke atribut profil pelanggan standar. LLM digunakan lagi pada fase ketiga untuk memilih atribut yang sesuai yang dapat berfungsi sebagai kunci, seperti pengidentifikasi pelanggan. Akhirnya pada fase keempat, detektor format stempel waktu mem-parsing stempel waktu untuk mempertahankan urutan kronologis catatan yang tepat. Sistem ini mampu menghasilkan pemetaan hingga 120 atribut dalam waktu kurang dari 20 detik setelah menggabungkan hasil prediksi.

## Pemecahan masalah pemetaan data bertenaga AI generatif
<a name="genai-powered-data-mapping-troubleshooting"></a>

Bagian berikut menampilkan kemungkinan pesan kesalahan yang mungkin Anda temui. Ini juga memberikan penyebab dan resolusi untuk setiap masalah.

### Kesalahan: Tidak dapat mengurai string objek ke JSON
<a name="genai-powered-data-mapping-parse-object-error"></a>

String objek dalam permintaan bukan JSON yang valid. Tinjau string objek dalam permintaan dan verifikasi bahwa itu adalah JSON yang valid.

### Kesalahan: Nilai pada 'objek' gagal memenuhi kendala: Anggota harus memiliki panjang kurang dari atau sama dengan 5
<a name="genai-powered-data-mapping-failed-constraint-error"></a>

Ada terlalu banyak objek dalam permintaan. Hingga lima objek diizinkan dalam permintaan. Kurangi jumlah benda menjadi lima atau kurang.

### Kesalahan: Batas 120 atribut yang dilanggar
<a name="genai-powered-data-mapping-breached-limit"></a>

Hingga 120 atribut diperbolehkan dalam objek JSON, termasuk atribut JSON bersarang. Hapus beberapa atribut yang tidak perlu dipetakan dari objek JSON.

![\[Hingga 120 atribut diperbolehkan dalam objek JSON, termasuk atribut JSON bersarang. Hapus beberapa atribut yang tidak perlu dipetakan dari objek JSON.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)


### Peringatan: Kami tidak dapat menemukan **kunci unik**, yang membedakan data Anda. Kami tidak dapat menemukan **kunci profil**, yang mengidentifikasi profil Anda.
<a name="genai-powered-data-mapping-unique-key-warning"></a>

Model tidak dapat menemukan tipe objek yang valid dari objek yang diberikan. Ubah input atau gunakan pendekatan pemetaan manual seperti yang disarankan.

![\[Model tidak dapat menemukan tipe objek yang valid dari objek yang diberikan. Ubah input atau gunakan pendekatan pemetaan manual seperti yang disarankan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)


# Batas data Profil Pelanggan Amazon Connect
<a name="customer-profiles-data-limits"></a>

Profil Pelanggan Amazon Connect memungkinkan Anda menyesuaikan orientasi data dengan menetapkan batas konsumsi data pada berbagai jenis data pelanggan yang Anda gunakan untuk membuat profil terpadu. Menetapkan batasan pada pemetaan data memungkinkan Anda memprioritaskan berapa banyak data yang akan dikonsumsi di seluruh pemetaan. Batas maksimum default di semua pemetaan per profil adalah 1000.

**catatan**  
Batas data adalah perkiraan dan mungkin sedikit berbeda, dengan kemungkinan penyimpangan beberapa unit di kedua arah selama periode konsumsi tinggi pada satu profil.

## Cara mengkonfigurasi batas data Profil Pelanggan
<a name="customer-profiles-data-limits-configure"></a>

1. Buka konsol Profil Amazon Connect Pelanggan.

1. Pilih tab **Batas data** untuk mengonfigurasi batas objek data.  
![\[Arahkan ke tab Batas Data untuk mengonfigurasi batas objek data.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)

1. Arahkan kursor ke batas objek data yang diinginkan dan pilih ikon edit.  
![\[Arahkan kursor ke batas objek data yang diinginkan dan pilih ikon edit.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)

1. Masukkan batas dan pilih ikon tanda centang untuk menyimpan atau memperbarui batas.  
![\[Gambar menunjukkan batas baru yang dimasukkan dan menyoroti ikon tanda centang yang digunakan untuk menyimpan atau memperbarui batas Anda.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)

## Cara menghapus batas data Profil Pelanggan
<a name="customer-profiles-data-limits-clear"></a>

1. Pilih tombol radio untuk objek data yang batasnya ingin Anda hapus. Anda kemudian akan dapat memilih **Clear limit**.  
![\[Sorot tombol radio di sebelah kiri objek data pada halaman batas data. Memilih tombol radio di sini memungkinkan Anda mengaktifkan tombol hapus untuk batas data objek.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)

1. Ketik *konfirmasi* untuk menghapus nilai batas objek data yang Anda pilih.  
![\[Kotak pop-up yang meminta Anda mengonfirmasi bahwa Anda ingin menghapus nilai batas objek data. Anda mengonfirmasi tindakan pembersihan dengan mengetik “konfirmasi” di semua huruf kecil..\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)