Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menerapkan versi solusi Amazon Personalize dengan kampanye
Untuk rekomendasi real-time dengan sumber daya khusus, setelah selesai[Membuat versi solusi secara manual](creating-a-solution-version.md), Anda siap untuk menerapkan versi solusi Anda dengan kampanye.
*Kampanye* menyebarkan versi solusi (model terlatih) dengan kapasitas transaksi yang disediakan untuk menghasilkan rekomendasi waktu nyata. Setelah membuat kampanye, Anda menggunakan operasi [GetRecommendations](API_RS_GetRecommendations.md) atau [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API untuk mendapatkan rekomendasi. Jika Anda mendapatkan rekomendasi item batch atau segmen pengguna, Anda tidak perlu membuat kampanye. Untuk informasi selengkapnya, lihat [Mendapatkan rekomendasi item batch](getting-batch-recommendations.md) atau [Mendapatkan segmen pengguna batch](getting-user-segments.md).
Saat membuat kampanye, Anda dapat mengonfigurasi hal berikut:
+ Anda dapat mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda. Untuk mengetahui informasi selengkapnya, lihat [Pembaruan kampanye otomatis](#create-campaign-automatic-latest-sv-update).
+ Anda dapat mengaktifkan metadata item dalam rekomendasi. Untuk informasi selengkapnya, lihat [Metadata item dalam rekomendasi](#create-campaign-return-metadata).
+ Anda dapat menentukan transaksi minimum yang disediakan per detik untuk kampanye. Ini adalah throughput transaksi dasar untuk kampanye yang disediakan oleh Amazon Personalize. Ini menetapkan biaya penagihan minimum untuk kampanye saat sedang aktif. Untuk informasi selengkapnya, lihat [Minimum transaksi yang disediakan per detik dan auto-scaling](#min-tps-auto-scaling).
Anda dapat membuat kampanye dengan konsol Amazon Personalize, AWS Command Line Interface (AWS CLI), atau. AWS SDKs Jika ingin mengubah setelan kampanye yang ada, seperti mengaktifkan metadata dalam rekomendasi, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat [Memperbarui konfigurasi kampanye Amazon Personalize](update-campaigns.md).
Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat [harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
**Topics**
+ [Pembaruan kampanye otomatis](#create-campaign-automatic-latest-sv-update)
+ [Minimum transaksi yang disediakan per detik dan auto-scaling](#min-tps-auto-scaling)
+ [Metadata item dalam rekomendasi](#create-campaign-return-metadata)
+ [Membuat kampanye (konsol)](#create-campaign-console)
+ [Membuat kampanye (AWS CLI)](#create-campaign-cli)
+ [Membuat kampanye (AWS SDKs)](#create-campaign-sdk)
## Pembaruan kampanye otomatis
Saat membuat kampanye, Anda dapat mengaktifkan pembaruan kampanye otomatis. Dengan pembaruan otomatis, kampanye secara otomatis memperbarui untuk menerapkan versi solusi terbaru yang terlatih secara otomatis atau manual dari solusi Anda. Ini memudahkan Anda untuk menjaga kampanye Anda tetap terkini.
Misalnya, jika solusi Anda menggunakan [pelatihan otomatis](solution-config-auto-training.md) untuk membuat versi solusi baru setiap tujuh hari, kampanye Anda akan diperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk setiap pelatihan mingguan. Jika Anda tidak menggunakan pembaruan kampanye otomatis, Anda harus memperbarui kampanye secara manual untuk menerapkan model terlatih terbaru.
+ Untuk mengaktifkan pembaruan kampanye otomatis saat Anda membuat kampanye dengan konsol Amazon Personalisasi, pilih **Perbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda di detail** **Kampanye**. Anda dapat menemukan stempel waktu untuk pembaruan terbaru di halaman detail kampanye.
Untuk informasi selengkapnya, lihat [Membuat kampanye (konsol)](#create-campaign-console).
+ Untuk mengaktifkan pembaruan kampanye otomatis saat Anda menggunakan operasi [CreateCampaign](API_CreateCampaign.md) API, untuk `SolutionVersionArn` parameter, tentukan Nama Sumber Daya Amazon (ARN) solusi Anda dalam `SolutionArn/$LATEST` format. Di`campaignConfig`, atur `enableMetadataWithRecommendations` ke`true`.
Untuk mendapatkan stempel waktu pembaruan kampanye terbaru, Anda dapat menggunakan operasi [DescribeCampaign](API_DescribeCampaign.md) API dan memeriksa `latestCampaignUpdate` detail dalam respons.
Untuk contoh kode yang menunjukkan cara mengaktifkan pembaruan otomatis, lihat [Membuat kampanye (AWS CLI)](#create-campaign-cli) atau[Membuat kampanye (AWS SDKs)](#create-campaign-sdk).
## Minimum transaksi yang disediakan per detik dan auto-scaling
**penting**
Tinggi `minProvisionedTPS` akan meningkatkan biaya Anda. Sebaiknya mulai dengan 1 untuk `minProvisionedTPS` (default). Lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, dan tingkatkan `minProvisionedTPS` seperlunya.
Saat membuat kampanye Amazon Personalize, Anda dapat menentukan transaksi minimum yang disediakan per detik (`minProvisionedTPS`) untuk kampanye. Ini adalah throughput transaksi dasar untuk kampanye yang disediakan oleh Amazon Personalize. Ini menetapkan biaya penagihan minimum untuk kampanye saat sedang aktif. Transaksi adalah satu `GetRecommendations` atau `GetPersonalizedRanking` permintaan. `minProvisionedTPS`Defaultnya adalah 1.
Jika TPS Anda meningkat lebih dari itu`minProvisionedTPS`, Amazon Personalize secara otomatis menskalakan kapasitas yang disediakan ke atas dan ke bawah, tetapi tidak pernah di bawah. `minProvisionedTPS` Ada penundaan waktu singkat sementara kapasitas meningkat yang dapat menyebabkan hilangnya transaksi. Ketika lalu lintas Anda berkurang, kapasitas kembali ke`minProvisionedTPS`.
Anda dikenakan biaya untuk TPS minimum yang disediakan atau, jika permintaan Anda melebihi, TPS yang `minProvisionedTPS` sebenarnya. TPS sebenarnya adalah jumlah permintaan rekomendasi yang Anda buat. Sebaiknya mulai dengan yang rendah`minProvisionedTPS`, lacak penggunaan Anda menggunakan CloudWatch metrik Amazon, lalu tingkatkan `minProvisionedTPS` seperlunya.
Untuk informasi selengkapnya tentang biaya kampanye, lihat [harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
## Metadata item dalam rekomendasi
**penting**
Jika Anda menggunakan resep User-Personalization-v 2 atau Personalized-Ranking-v 2, Anda tidak dikenakan biaya tambahan untuk metadata. Untuk semua resep lain dan semua kasus penggunaan domain, Anda dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat [Harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
Ketika Anda mendapatkan rekomendasi, Anda dapat meminta Amazon Personalize menyertakan metadata item dalam hasil rekomendasi. Dalam permintaan Anda, Anda dapat memilih kolom dari kumpulan data Item untuk disertakan. Amazon Personalize mengembalikan data ini untuk setiap item dalam respons rekomendasi.
Anda dapat menggunakan metadata untuk memperkaya rekomendasi di antarmuka pengguna, seperti menambahkan genre film ke komidi putar. Atau Anda dapat menggunakannya untuk menilai kualitas rekomendasi secara visual. Jika Anda menggunakan AI generatif di aplikasi, Anda dapat menyambungkan metadata ke prompt AI untuk menghasilkan konten yang lebih relevan. Untuk informasi selengkapnya tentang menggunakan Amazon Personalize dengan AI generatif, lihat. [Amazon Personalisasi dan AI generatif](personalize-with-gen-ai.md)
### Mengaktifkan metadata
Untuk menambahkan metadata ke rekomendasi, Anda harus memiliki kumpulan data Item dengan kolom metadata. Anda tidak harus menggunakan metadata dalam pelatihan. Untuk informasi tentang membuat kumpulan data, lihat[Membuat skema dan dataset](data-prep-creating-datasets.md). Untuk informasi yang memperbarui data, lihat[Memperbarui data dalam kumpulan data setelah pelatihan](updating-datasets.md).
Jika Anda menggunakan resep User-Personalization-v 2 atau Personalized-Ranking-v 2, kampanye baru secara otomatis memiliki opsi untuk menyertakan metadata item dengan hasil rekomendasi. Anda tidak mengaktifkan metadata secara manual untuk kampanye Anda. Untuk semua resep dan kasus penggunaan domain lainnya, Anda harus mengaktifkan opsi metadata:
+ **Untuk mengaktifkan metadata dengan konsol Amazon Personalize, saat Anda membuat kampanye, **pilih Metadata pengembalian item di hasil rekomendasi di** detail Kampanye.** Untuk informasi selengkapnya, lihat [Membuat kampanye (konsol)](#create-campaign-console).
+ Untuk mengaktifkan metadata dengan AWS SDKs atau AWS CLI, gunakan operasi [CreateCampaign](API_CreateCampaign.md) API dan dalam `campaignConfig` set `enableMetadataWithRecommendations` ke. `true` Untuk informasi selengkapnya, lihat [Membuat kampanye (AWS CLI)](#create-campaign-cli) atau [Membuat kampanye (AWS SDKs)](#create-campaign-sdk).
## Membuat kampanye (konsol)
**penting**
Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat [harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
Setelah status versi solusi Aktif, Anda siap menerapkannya dengan kampanye Amazon Personalize.
**Untuk membuat kampanye (konsol)**
1. Buka konsol Amazon Personalize di [https://console.aws.amazon.com/personalize/rumah](https://console.aws.amazon.com/personalize/home) dan masuk ke akun Anda.
1. Pilih grup kumpulan data dengan versi solusi yang ingin Anda terapkan.
1. Di panel navigasi, di bawah **Sumber daya khusus**, pilih **Kampanye**.
1. Pada halaman **Kampanye**, pilih **Buat kampanye**.
1. Pada halaman **Buat kampanye baru**, untuk **detail Kampanye**, berikan informasi berikut:
+ **Nama kampanye** — Masukkan nama kampanye. Teks yang Anda masukkan di sini muncul di dasbor Kampanye dan halaman detail.
+ **Solusi** — Pilih solusi yang baru saja Anda buat.
+ **Perbarui secara otomatis untuk menggunakan versi solusi terbaru solusi Anda** — Pilih opsi ini agar kampanye secara otomatis menggunakan versi solusi aktif terbaru. Jika Anda tidak memilih ini, Anda harus memperbarui kampanye secara manual setiap kali Anda ingin menerapkan versi solusi baru. Untuk informasi selengkapnya, lihat [Pembaruan kampanye otomatis](#create-campaign-automatic-latest-sv-update).
+ **ID versi solusi** - Jika Anda tidak menggunakan pembaruan kampanye otomatis untuk menggunakan versi solusi terbaru, pilih ID versi solusi yang ingin Anda gunakan.
+ **Transaksi minimum yang disediakan per detik (disebut minProvisionedTPS di APIs)** - Tetapkan transaksi minimum yang disediakan per detik yang didukung Amazon Personalize. Nilai tinggi akan meningkatkan biaya Anda. Kami menyarankan Anda memulai dengan 1 (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan `minProvisionedTPS` seperlunya. Untuk informasi selengkapnya, lihat [Minimum transaksi yang disediakan per detik dan auto-scaling](#min-tps-auto-scaling).
+ **Kembalikan metadata item dalam hasil rekomendasi** — Pilih opsi ini jika Anda ingin opsi menyertakan metadata dengan hasil rekomendasi. Jika diaktifkan, Anda dapat menentukan kolom dari kumpulan data Item saat Anda mendapatkan rekomendasi. Untuk informasi selengkapnya, lihat [Metadata item dalam rekomendasi](#create-campaign-return-metadata).
1. Jika Anda menggunakan resep Personalisasi Pengguna, dalam **konfigurasi Kampanye**, Anda dapat secara opsional memasukkan nilai untuk **bobot Eksplorasi dan batas usia** item **Eksplorasi**. Untuk informasi selengkapnya, lihat [Personalisasi Pengguna](native-recipe-new-item-USER_PERSONALIZATION.md).
1. Untuk **Tag**, secara opsional tambahkan tag apa pun. Untuk informasi selengkapnya tentang menandai sumber daya Amazon Personalize, lihat. [Menandai Amazon Personalisasi sumber daya](tagging-resources.md)
1. Pilih **Buat kampanye**.
1. Pada halaman detail kampanye, ketika status kampanye **Aktif**, Anda dapat menggunakan kampanye untuk mendapatkan rekomendasi dan merekam tayangan. Untuk informasi selengkapnya, lihat [Mendapatkan rekomendasi dari Amazon Personalize](getting-recommendations.md).
Kampanye siap ketika statusnya AKTIF. Jika Anda melatih ulang versi solusi Anda, atau jika Anda ingin mengubah setelan kampanye, Anda harus memperbarui kampanye Anda. Untuk informasi selengkapnya, lihat [Memperbarui konfigurasi kampanye Amazon Personalize](update-campaigns.md).
## Membuat kampanye (AWS CLI)
**penting**
Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat [harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
Setelah versi solusi Anda Aktif, Anda siap untuk menerapkannya dengan kampanye Amazon Personalize. Untuk membuat kampanye dengan AWS CLI, Anda menggunakan `create-campaign` perintah.
Contoh kode berikut menunjukkan cara membuat kampanye. Ini menyebarkan versi solusi terbaru dari solusi yang menggunakan resep User-Personalization. Kampanye yang dibuatnya secara otomatis diperbarui untuk menggunakan versi solusi masa depan. Kode menggunakan konfigurasi berikut:
+ Ini mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk solusi Anda: `solution-version-arn` Ini dalam `{{solution ARN}}/$LATEST` format, dan `syncWithLatestSolutionVersion` sedang`True`. Untuk menggunakan kode, ganti `solution ARN` dengan Amazon Resource Name (ARN) solusi Anda.
Untuk menonaktifkan otomatis`syncWithLatestSolutionVersion`, tentukan hanya versi solusi ARN (tanpa`/$LATEST`), dan atur `syncWithLatestSolutionVersion` ke. `False`
+ Ini menetapkan `enableMetadataWithRecommendations` opsi untuk`True`. Ini memungkinkan opsi permintaan rekomendasi untuk menyertakan metadata item dari kumpulan data Item dengan hasil rekomendasi. Untuk menonaktifkan opsi ini, atur ke`False`. Untuk informasi selengkapnya, lihat [Metadata item dalam rekomendasi](#create-campaign-return-metadata).
+ Ini diatur `min-provisioned-tps` ke 1 (default). Sebaiknya mulai dengan 1 untuk `minProvisionedTPS` (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan `minProvisionedTPS` seperlunya. Untuk informasi selengkapnya, lihat [Minimum transaksi yang disediakan per detik dan auto-scaling](#min-tps-auto-scaling).
Untuk daftar lengkap semua parameter, lihat[CreateCampaign](API_CreateCampaign.md).
```
aws personalize create-campaign \
--name {{campaign-name}} \
--solution-version-arn {{solution-arn}}/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"
```
Kampanye siap ketika statusnya AKTIF. Untuk mendapatkan status saat ini, panggil [DescribeCampaign](API_DescribeCampaign.md) dan periksa apakah `status` bidangnya`ACTIVE`.
Jika Anda melatih ulang versi solusi dan kampanye Anda tidak diperbarui secara otomatis untuk menggunakan versi solusi terbaru, atau jika ingin mengubah setelan kampanye, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat [Memperbarui konfigurasi kampanye Amazon Personalize](update-campaigns.md).
Amazon Personalize memberi Anda operasi untuk mengelola kampanye seperti [ListCampaigns](API_ListCampaigns.md) mencantumkan kampanye yang telah Anda buat. Anda dapat menghapus kampanye dengan menelepon[DeleteCampaign](API_DeleteCampaign.md). Jika Anda menghapus kampanye, versi solusi yang merupakan bagian dari kampanye tidak akan dihapus.
Setelah Anda membuat kampanye, Anda dapat menggunakannya untuk membuat rekomendasi. Untuk informasi selengkapnya, lihat [Mendapatkan rekomendasi dari Amazon Personalize](getting-recommendations.md).
## Membuat kampanye (AWS SDKs)
**penting**
Anda dikenakan biaya kampanye saat kampanye aktif. Untuk menghindari biaya yang tidak perlu, pastikan untuk menghapus kampanye ketika Anda selesai. Untuk informasi tentang biaya kampanye, lihat [harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).
Setelah versi solusi Anda Aktif, Anda siap untuk menerapkannya dengan kampanye Amazon Personalize. Untuk membuat kampanye dengan AWS SDKs, Anda menggunakan operasi [CreateCampaign](API_CreateCampaign.md) API.
Contoh kode berikut menunjukkan cara membuat kampanye. Kode ini menerapkan versi solusi terbaru dari solusi yang menggunakan resep User-Personalization. Kampanye yang dibuatnya secara otomatis diperbarui untuk menggunakan versi solusi masa depan. Kode menggunakan konfigurasi berikut:
+ Ini mengonfigurasi kampanye untuk memperbarui secara otomatis untuk menggunakan versi solusi terbaru untuk solusi Anda: `solutionVersionArn` Ini dalam `{{solution ARN}}/$LATEST` format, dan `syncWithLatestSolutionVersion` sedang`True`. Untuk menggunakan kode, ganti `solution ARN` dengan Amazon Resource Name (ARN) versi solusi Anda.
Untuk menonaktifkan otomatis`syncWithLatestSolutionVersion`, tentukan hanya versi solusi ARN (tanpa`/$LATEST`), dan atur `syncWithLatestSolutionVersion` ke. `False`
+ Ini menetapkan `enableMetadataWithRecommendations` opsi untuk`True`. Ini memungkinkan opsi permintaan rekomendasi untuk menyertakan metadata item dari kumpulan data Item dengan hasil rekomendasi. Untuk menonaktifkan opsi ini, atur ke`False`. Untuk informasi selengkapnya, lihat [Metadata item dalam rekomendasi](#create-campaign-return-metadata).
+ Ini diatur `minProvisionedTPS` ke 1 (default). Kami menyarankan Anda memulai dengan 1 untuk `minProvisionedTPS` (default). Lacak penggunaan Anda dengan menggunakan CloudWatch metrik Amazon, dan tingkatkan `minProvisionedTPS` seperlunya. Untuk informasi selengkapnya, lihat [Minimum transaksi yang disediakan per detik dan auto-scaling](#min-tps-auto-scaling).
Untuk daftar lengkap semua parameter, lihat[CreateCampaign](API_CreateCampaign.md).
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize = boto3.client('personalize')
response = personalize.create_campaign(
name = '{{campaign name}}',
solutionVersionArn = '{{solution ARN}}/$LATEST',
minProvisionedTPS = {{1}},
campaignConfig = {"syncWithLatestSolutionVersion": {{True}}, "enableMetadataWithRecommendations": {{True}}}
)
arn = response['campaignArn']
description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])
```
------
#### [ SDK for JavaScript v3 ]
```
// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
"@aws-sdk/client-personalize";
// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });
// set the campaign parameters
export const createCampaignParam = {
solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
name: "NAME" /* required */,
minProvisionedTPS: 1 /* optional */,
campaignConfig: { /* optional */
syncWithLatestSolutionVersion: true,
enableMetadataWithRecommendations: true,
},
};
export const run = async () => {
try {
const response = await personalizeClient.send(
new CreateCampaignCommand(createCampaignParam)
);
console.log("Success", response);
return response; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
------
Kampanye siap ketika statusnya AKTIF. Untuk mendapatkan status saat ini, panggil[DescribeCampaign](API_DescribeCampaign.md), dan periksa apakah `status` bidangnya`ACTIVE`.
Jika Anda melatih ulang versi solusi secara manual, atau jika ingin mengubah setelan kampanye, Anda harus memperbarui kampanye. Untuk informasi selengkapnya, lihat [Memperbarui konfigurasi kampanye Amazon Personalize](update-campaigns.md).
Amazon Personalize memberi Anda operasi untuk mengelola kampanye seperti [ListCampaigns](API_ListCampaigns.md) mencantumkan kampanye yang telah Anda buat. Anda dapat menghapus kampanye dengan menelepon[DeleteCampaign](API_DeleteCampaign.md). Jika Anda menghapus kampanye, versi solusi yang merupakan bagian dari kampanye tidak akan dihapus.
Setelah Anda membuat kampanye, gunakan untuk membuat rekomendasi. Lihat informasi yang lebih lengkap di [Mendapatkan rekomendasi dari Amazon Personalize](getting-recommendations.md).