View a markdown version of this page

Membuat definisi atribut terhitung Connect Customer Customer Profiles kustom - Pelanggan Amazon Connect
Langkah 1: Buat file JSONLangkah 2: Panggil CreateCalculatedAttributeDefinition

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

Membuat definisi atribut terhitung Connect Customer Customer Profiles kustom

Menggunakan Customer Profiles CreateCalculatedAttributeDefinition API, Anda dapat secara terprogram membuat atribut terhitung sendiri berdasarkan jenis objek kustom.

Dalam topik ini kami menunjukkan cara membuat atribut yang dihitung menggunakan file JSON khusus.

Langkah 1: Buat file JSON

Buat file JSON dengan konten berikut:


{
"DomainName": "your-domain-name", 
   "CalculatedAttributeName": "your-calculated-attribute-name",
   "UseHistoricalData": true,
   "DisplayName": "your-display-name",
   "Description": "your-description",
   "AttributeDetails": {
"Attributes": [
         {
            "Name": "your-attribute-name"
         }
       ],
       "Expression": "{your-object-type.your-attribute-name}"
   },
    "Statistic": "your-statistic",
    "Conditions": {
       "Range": {
        "ValueRange"
        {
            "Start": your-range-start
            "End": your-range-end
        },
        "TimestampSource": "{your-object-type.your-timestamp-source}",          
        "Unit": "days"
        },
        "ObjectCount":  your-object-count,
        "Threshold": {
           "Value": "your-threshold-value",
           "Operator": "your-threshold-operator"
        }
   }  
}

Untuk menyesuaikan JSON dengan nilai-nilai Anda sendiri, ikuti panduan ini:

  • Atribut: Ini harus berisi nama bidang dari tipe objek yang ingin Anda gunakan untuk atribut yang dihitung. Dua atribut yang direferensikan dalam daftar ini didukung.

  • Ek spresi: Ekspresi matematika dasar untuk dilakukan antar atribut didukung. Jika Anda hanya memiliki satu atribut, bidang ini seharusnya{ObjectTypeName.AttributeName}, jika tidak, jika Anda memiliki ekspresi matematika dalam pikiran, bidang ini harus berisi kedua atribut.

  • Statistik: Ini adalah operasi yang dilakukan saat Anda memanggil salah satu API hitung yang benar-benar melakukan operasi agregasi. Sebagian besar cukup jelas, tetapi kami telah menambahkan penjelasan untuk yang tidak.

    Statistik yang didukung

    • FIRST_OCCURRENCEmengembalikan atribut yang ditentukan dalam ekspresi objek tertelan paling awal.

    • LAST_OCCURRENCEmengembalikan atribut yang ditentukan dalam ekspresi objek yang dicerna terbaru.

    • COUNTmengembalikan hitungan dari data yang dipilih.

    • SUMmengembalikan jumlah dari data yang dipilih.

    • MINIMUMmengembalikan minimum dari data yang dipilih.

    • MAXIMUMmengembalikan maksimum dari data yang dipilih.

    • AVERAGEmengembalikan rata-rata dari data yang dipilih.

    • MAX_OCCURRENCEmengembalikan nilai yang paling sering terjadi yang ditentukan dalam ekspresi.

  • Rentang:

    • Unit: Saat ini hanya mendukung unit DAYS.

    • ValueRange: Tentukan angka positif di ValueRange bidang Awal atau Akhir untuk menunjukkan berapa hari yang lalu untuk memulai, dan angka negatif untuk menunjukkan berapa hari di masa depan untuk memulai.

    • TimestampSource: Ekspresi yang menentukan bidang di objek JSON Anda dari mana tanggal harus diurai. Ekspresi harus mengikuti struktur\ "{ObjectTypeName. <Location of timestamp field in JSON pointer format>}\”. Misalnya; jika tipe objek Anda adalah MyType dan JSON sumber adalah{"generatedAt": {"timestamp": "1737587945945"}}, maka TimestampSource seharusnya"{MyType.generatedAt.timestamp}".

  • ObjectCount: Menunjukkan berapa banyak objek yang harus didasarkan pada perhitungan atribut yang dihitung.

  • Ambang batas: Jika alih-alih nilai atribut yang dihitung tepat, Anda malah ingin mengetahui apakah itu, misalnya, lebih besar dari nilai tertentu, Anda dapat menggunakan ambang batas.

    Nilai ambang batas dapat berupa string apa saja, dan operator ambang berikut didukung.

    • GREATER_THAN

    • LESS_THAN

    • EQUAL_TO

    • NOT_EQUAL_TO

  • UseHistoricalData: Apakah data historis yang dicerna sebelum Atribut Dihitung dibuat harus disertakan dalam perhitungan.

Langkah 2: Panggil CreateCalculatedAttributeDefinition API

Setelah Anda membuat dan menyesuaikan file JSON dengan nilai-nilai Anda, panggil CreateCalculatedAttributeDefinition API, seperti yang ditunjukkan pada contoh berikut:

aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name

Anda juga dapat menggunakan titik akhir berikut:

https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes