Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Merekam peristiwa interaksi aksi waktu nyata
Peristiwa *interaksi tindakan* adalah interaksi antara pengguna dan *tindakan*. Misalnya, pengguna yang mendaftar dalam program keanggotaan atau mengajukan permohonan kartu kredit.
Jika Anda menggunakan resep kustom PERSONALIZED\$1ACTIONS, rekam peristiwa interaksi tindakan real-time saat pelanggan Anda berinteraksi dengan rekomendasi tindakan. Ini membangun data interaksi Anda dan membuat data Anda tetap segar. Ini juga memberi tahu Amazon Personalisasi tentang minat pengguna Anda saat ini, yang dapat meningkatkan relevansi rekomendasi. Hanya resep kustom PERSONALIZED\$1ACTIONS yang menggunakan data interaksi tindakan.
Anda merekam peristiwa interaksi tindakan dengan operasi [PutActionInteractions](API_UBS_PutActionInteractions.md) API. Amazon Personalize menambahkan data ini ke kumpulan data [interaksi Tindakan di grup kumpulan data](action-interactions-datasets.md) Anda.
Peristiwa interaksi tindakan harus memiliki atribut tipe peristiwa, yang dapat berupa salah satu dari berikut ini:
+ Diambil - Rekam peristiwa yang *diambil* saat pengguna mengambil tindakan yang disarankan.
+ Tidak Diambil - Rekam peristiwa yang *Tidak Diambil* saat pengguna Anda membuat pilihan yang disengaja untuk tidak mengambil tindakan setelah melihatnya. Misalnya, jika mereka memilih *Tidak* ketika Anda menunjukkan tindakan kepada mereka. Peristiwa yang *Tidak Diambil* dapat menunjukkan bahwa pelanggan tidak tertarik dengan tindakan tersebut.
+ *Dilihat* — Rekam peristiwa yang Dilihat saat Anda menunjukkan tindakan kepada pengguna sebelum mereka membuat pilihan untuk mengambil atau tidak mengambil tindakan. Amazon Personalize menggunakan *Lihat* peristiwa untuk mempelajari minat pengguna Anda. Misalnya, jika pengguna melihat tindakan tetapi tidak menerimanya, pengguna ini mungkin tidak tertarik dengan tindakan ini di masa mendatang.
Anda dapat merekam peristiwa real-time menggunakan AWS SDKs, atau AWS Command Line Interface (AWS CLI). Jika Anda merekam dua peristiwa dengan stempel waktu yang sama persis dan properti yang identik, Amazon Personalize hanya menyimpan salah satu acara.
**Topics**
+ [Persyaratan untuk merekam peristiwa interaksi tindakan](#recording-action-interaction-requirements)
+ [Menemukan ID pelacak peristiwa interaksi tindakan Anda](action-interaction-tracker-id.md)
+ [Merekam peristiwa interaksi aksi tunggal](record-single-action-interaction.md)
+ [Merekam beberapa peristiwa interaksi aksi](recording-multiple-action-interactions.md)
## Persyaratan untuk merekam peristiwa interaksi tindakan
Untuk merekam peristiwa interaksi aksi waktu nyata, Anda memerlukan yang berikut ini:
+ Grup kumpulan data yang menyertakan`Action interactions dataset`, yang bisa kosong. Untuk informasi tentang membuat grup kumpulan data dan kumpulan data, lihat. [Mengimpor data pelatihan ke Amazon Personalize dataset](import-data.md)
+ ID pelacak acara Anda. Anda menentukan ID ini dalam PutActionInteractions operasi. Saat Anda membuat kumpulan data interaksi Tindakan, Amazon Personalize secara otomatis membuat pelacak peristiwa interaksi tindakan untuk Anda. Untuk informasi selengkapnya, lihat [Menemukan ID pelacak peristiwa interaksi tindakan Anda](action-interaction-tracker-id.md).
+ Panggilan untuk [PutActionInteractions](API_UBS_PutActionInteractions.md) operasi.
# Menemukan ID pelacak peristiwa interaksi tindakan Anda
Saat Anda membuat kumpulan data interaksi Tindakan, Amazon Personalize secara otomatis membuat pelacak peristiwa interaksi *tindakan* untuk Anda. Anda menentukan ID pelacak dalam operasi PutActionInteractions API. Amazon Personalize menggunakannya untuk mengarahkan data baru ke kumpulan data *interaksi Tindakan di grup kumpulan data* Anda.
Anda dapat menemukan ID pelacak peristiwa di halaman detail kumpulan data interaksi Tindakan di konsol Amazon Personalize. Dan Anda dapat menemukan ID dengan memanggil operasi DescribeDataset API. Kode Python berikut mencetak ID pelacakan untuk kumpulan data interaksi Tindakan.
```
import boto3
personalize = boto3.client(service_name='personalize')
response = personalize.describe_dataset(
datasetArn="Action interactions dataset ARN"
)
print(response['trackingId'])
```
# Merekam peristiwa interaksi aksi tunggal
Setelah membuat kumpulan data Interaksi aksi, Anda siap merekam peristiwa interaksi tindakan dengan [PutActionInteractions](API_UBS_PutActionInteractions.md) operasi tersebut. Kode berikut menunjukkan `PutActionInteractions` operasi yang melewati acara TAKEN. Anda dapat merekam acara ini ketika Anda menunjukkan rekomendasi pengguna dari Amazon Personalize dan mereka mengambil tindakan, seperti mengajukan permohonan kartu kredit Anda.
`actionInteractions`Ini adalah array ActionInteraction objek. Ini `trackingId` berasal dari pelacak peristiwa Amazon Personalize yang dibuat saat Anda membuat kumpulan data interaksi Action. Untuk informasi selengkapnya, lihat [Menemukan ID pelacak peristiwa interaksi tindakan Anda](action-interaction-tracker-id.md).
Aplikasi Anda menghasilkan unik `sessionId` ketika pengguna pertama kali mengunjungi situs web Anda atau menggunakan aplikasi Anda. Anda harus menggunakan hal yang sama `sessionId` di semua acara sepanjang sesi. Amazon Personalize menggunakan `sessionId` untuk mengaitkan peristiwa dengan pengguna sebelum mereka masuk (bersifat anonim). Untuk informasi selengkapnya, lihat [Merekam acara untuk pengguna anonim](recording-events.md#recording-anonymous-user-events).
`sentAt`Parameter`userId`,`actionId`, dan dipetakan ke bidang USER\$1ID, ACTION\$1ID, EVENT\$1TYPE, dan TIMESTAMP dari kumpulan data interaksi Tindakan.
**Kumpulan data interaksi Tindakan yang sesuai**
```
USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE
user123, action-xyz, 1543631760, TAKEN
```
**Contoh kode**
------
#### [ AWS CLI ]
```
aws personalize-events put-action-interactions \
--tracking-id 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--action-interactions '[{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543631760,
"eventType": "TAKEN",
"actionId": "action-xyz"}]'
```
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
response = personalize_events.put_action_interactions(
trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
actionInteractions=[{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1543631760,
'eventType': 'Taken',
'actionId': 'action-xyz'
}]
)
```
------
# Merekam beberapa peristiwa interaksi aksi
Kode berikut menunjukkan cara merekam beberapa peristiwa interaksi tindakan untuk pengguna yang sama dengan SessionId yang sama.
**Kumpulan data interaksi Tindakan yang sesuai**
```
USER_ID, ACTION_ID, EVENT_TYPE, TIMESTAMP
user123, action123, Taken, 1543531139
user123, action345, Not Taken, 1543531139
```
------
#### [ AWS CLI ]
```
aws personalize-events put-action-interactions \
--tracking-id 6ddfe6b7-cd83-4dd4-b09d-4c35ecbacfe1 \
--action-interactions '[{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543531139,
"eventType": "Taken",
"actionId": "action123"
},
{
"userId": "user123",
"sessionId": "abcdefg",
"timestamp": 1543531139,
"eventType": "Not Taken",
"actionId": "action345"}]'
```
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
response = personalize_events.put_action_interactions(
trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
actionInteractions=[{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1697848587,
'eventType': 'Taken',
'actionId': 'action123'
},
{
'userId': 'user123',
'sessionId': 'abcdefg',
'timestamp': 1697848622,
'eventType': 'Not Taken',
'actionId': 'action345'
}]
)
```
------