Menambahkan konten yang dipersonalisasi ke templat pesan

Untuk mengirimkan konten dinamis dan dipersonalisasi dalam pesan yang menggunakan templat, tambahkan variabel pesan ke templat pesan. Variabel pesan adalah placeholder yang mengacu pada atribut tertentu yang dibuat oleh Anda atau Amazon Pinpoint untuk menyimpan informasi tentang pengguna Anda. Setiap atribut biasanya sesuai dengan karakteristik pengguna, seperti nama depan pengguna atau kota tempat mereka tinggal. Dengan menambahkan variabel pesan ke templat, Anda dapat menggunakan atribut ini untuk mengirimkan konten khusus ke setiap penerima pesan yang menggunakan templat.

Jika template berisi variabel pesan, Amazon Pinpoint menggantikan setiap variabel dengan nilai atribut saat ini yang sesuai untuk setiap penerima. Hal ini dilakukan setiap kali mengirim pesan yang menggunakan template. Ini berarti Anda dapat mengirim konten yang dipersonalisasi ke setiap penerima tanpa membuat beberapa versi pesan atau templat pesan yang disesuaikan. Anda juga dapat merasa yakin bahwa pesan tersebut berisi informasi terbaru yang Anda miliki untuk penerima.

Misalnya, jika proyek Anda adalah aplikasi kebugaran untuk pelari dan menyertakan atribut untuk nama depan setiap pengguna, aktivitas pilihan, dan catatan pribadi, Anda dapat menggunakan variabel teks dan pesan berikut dalam templat:

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

Saat Anda mengirim pesan yang menggunakan templat, Amazon Pinpoint menggantikan variabel dengan nilai saat ini dari setiap atribut untuk setiap penerima. Contoh berikut menunjukkan ini.

Contoh 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

Contoh 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

Jika nilai atribut tidak ada untuk penerima, Amazon Pinpoint dapat mengganti variabel dengan nilai default yang Anda tentukan untuk variabel tersebut. Misalnya, jika pengguna aplikasi kebugaran Anda belum memilih aktivitas pilihan mereka, Anda dapat menggunakannya running sebagai nilai default untuk {{User.UserAttributes.Activity}} variabel tersebut. Dalam hal ini, Amazon Pinpoint menggantikan variabel seperti yang ditunjukkan pada contoh berikut:

Contoh 1

Hi Jane, congratulations on your new running record of 1:42:17!

Contoh 2

Hi John, congratulations on your new running record of 20:52!

Jika Anda tidak menentukan nilai default dan nilai tidak ada untuk penerima, Amazon Pinpoint menghilangkan semua teks untuk variabel saat mengirim pesan ke penerima tersebut. Sebagai contoh:

Hi Mary, congratulations on your new record of 20:52!

Sebagai praktik terbaik, kami menyarankan Anda menentukan nilai default untuk setiap variabel yang Anda sertakan dalam template.

Menambahkan variabel pesan

Anda dapat menambahkan atribut pesan ke templat baru yang Anda buat atau ke templat yang sudah ada. Jika Anda menambahkan variabel ke template yang ada, Amazon Pinpoint tidak selalu menerapkan perubahan pada pesan yang menggunakan template dan belum dikirim, seperti pesan kampanye yang dijadwalkan untuk dikirim di lain waktu. Hal ini tergantung pada versi template yang Anda tambahkan variabel dan bagaimana Anda mengkonfigurasi pesan yang menggunakan template. Untuk informasi selengkapnya, lihat Mengelola versi template pesan.

catatan

Template pesan dalam aplikasi tidak mendukung penggunaan variabel pesan.

Untuk menambahkan variabel pesan ke template pesan

1. Buka konsol Amazon Pinpoint di https://console.aws.amazon.com/pinpoint/.

2. Di panel navigasi, pilih Template pesan.

3. Pada halaman template Pesan, lakukan salah satu hal berikut:

   • Untuk membuat template baru dan menambahkan variabel pesan ke dalamnya, pilih Buat template. Kemudian, pada halaman templat, masukkan nama untuk templat dan, secara opsional, deskripsi templat.

   • Untuk menambahkan variabel pesan ke template yang ada, pilih template yang ingin Anda tambahkan variabel. Kemudian, pada halaman template, pilih Edit. Di bawah Detail templat, gunakan pemilih versi untuk memilih versi templat yang ingin Anda gunakan sebagai titik awal. Jika Anda memilih versi terbaru, Anda dapat menyimpan perubahan langsung ke versi template tersebut. Jika tidak, Anda dapat menyimpan perubahan Anda sebagai versi baru dari template.

4. Di bagian detail pesan, tentukan di mana Anda ingin menambahkan variabel pesan. Anda dapat menambahkan variabel ke badan semua jenis template. Untuk templat pemberitahuan email dan push, Anda juga dapat menambahkan variabel ke subjek atau judul pesan.

5. Di Pencari atribut, perluas bagian untuk jenis atribut yang ingin Anda tambahkan variabel pesan. Anda dapat memilih dari jenis atribut berikut:

   Atribut standar

   Ini adalah atribut yang dibuat Amazon Pinpoint secara otomatis untuk proyek apa pun. Ini berarti Anda dapat menggunakannya dalam pesan yang Anda kirim untuk proyek apa pun. Untuk informasi rinci tentang masing-masing atribut ini, lihatAtribut yang didukung.

   Untuk menambahkan variabel untuk atribut standar, pilih atribut dari daftar.

   Atribut khusus

   Ini adalah atribut yang Anda buat secara opsional untuk masing-masing proyek. Karena atribut ini mungkin tidak tersedia untuk beberapa proyek Anda, Amazon Pinpoint mungkin tidak dapat mengganti variabel dengan nilai untuk setiap penerima pesan yang menggunakan templat. Untuk membantu Anda menghindari masalah ini, Amazon Pinpoint menyediakan opsi untuk membantu Anda memilih atribut yang ada untuk proyek tertentu atau semua proyek Anda.

   Untuk menambahkan atribut kustom:

   1. Pilih atribut Kustom, lalu pilih Muat atribut kustom. Di jendela yang muncul, Amazon Pinpoint mencantumkan semua proyek yang Anda buat. Saat Anda memilih setiap proyek, atribut yang umum untuk proyek yang dipilih ditampilkan di panel navigasi sebelah kanan. Jika tidak ada atribut yang ditampilkan, maka tidak ada atribut umum di antara proyek-proyek tersebut.

   2. Lakukan salah satu hal berikut ini:

      • Untuk menggunakan semua atribut yang umum untuk proyek yang dipilih, pilih Muat atribut kustom.

      • Jika Anda ingin menggunakan atribut tertentu dari daftar, masukkan bagian mana pun dari nama atribut di bidang pencarian. Atribut yang cocok dengan tampilan teks yang dimasukkan. Pilih Muat atribut kustom saat atribut yang ingin Anda gunakan ditampilkan. Pencari atribut menampilkan atribut kustom yang baru ditambahkan.

        catatan

        Anda tidak dapat menambahkan atribut umum dari kumpulan proyek yang berbeda, Anda juga tidak dapat memodifikasi bagian Atribut kustom dari pencari Atribut. Jika Anda perlu membuat perubahan pada atribut kustom, pilih X untuk menghapus pencari Atribut, lalu mulai lagi.

   3. Di pencari Atribut, pilih atribut yang ingin Anda tambahkan variabelnya.

   Atribut yang direkomendasikan

   Ini adalah atribut yang Anda buat secara opsional untuk akun saat mengonfigurasi Amazon Pinpoint untuk mengambil rekomendasi yang dipersonalisasi dari model pemberi rekomendasi. Untuk informasi tentang menggunakan model pemberi rekomendasi, lihatModel Machine Learning. Anda dapat menambahkan variabel untuk jenis atribut ini ke templat email, templat pemberitahuan push, dan templat SMS. Anda tidak dapat menambahkannya ke templat suara.

   Untuk menambahkan variabel untuk atribut yang direkomendasikan, pilih atribut dari daftar. Jika pencari Atribut tidak mencantumkan atribut yang direkomendasikan, Anda harus terlebih dahulu menghubungkan template ke model pemberi rekomendasi.

   Untuk menambahkan atribut yang direkomendasikan:

   1. Pilih model Connect.

   2. Pilih model yang ingin Anda ambil rekomendasi saat Anda mengirim pesan yang menggunakan templat.

   3. Pilih model Connect.

6. Bila Anda memilih atribut dari pencari Atribut, Amazon Pinpoint membuat variabel pesan untuk atribut dan menyalinnya ke clipboard Anda. Tempel variabel di lokasi yang Anda inginkan. Jika Anda memiliki daftar atribut yang panjang, masukkan teks pencarian untuk mempersempit daftar. Pilih X untuk menghapus kolom pencarian.

   Setelah Anda menempelkan variabel, Amazon Pinpoint menampilkannya sebagai nama atribut terkait, terlampir dalam dua set kurung kurawal — misalnya,. {{User.UserAttributes.FirstName}}

7. Ulangi langkah 4 hingga 6 untuk setiap variabel pesan yang ingin Anda tambahkan.

8. Untuk menentukan nilai default untuk variabel pesan, perluas bagian Nilai atribut Default. Kemudian, dalam daftar variabel, masukkan nilai default yang ingin Anda gunakan untuk variabel tersebut.

   catatan

   Kami menyarankan Anda melakukan ini untuk setiap variabel dalam template. Jika tidak, Amazon Pinpoint mungkin tidak dapat mengirim pesan yang menggunakan templat atau pesan mungkin ditampilkan dengan cara yang tidak terduga atau tidak diinginkan.

9. Setelah selesai, lakukan salah satu hal berikut:

   • Jika Anda menambahkan variabel pesan ke template baru, pilih Buat.

   • Jika Anda menambahkan variabel pesan ke template yang ada dan Anda ingin menyimpan perubahan Anda sebagai versi baru dari template, pilih Simpan sebagai versi baru.

   • Jika Anda menambahkan variabel pesan ke template yang ada dan Anda ingin menyimpan perubahan Anda sebagai pembaruan ke versi terbaru dari template, pilih Perbarui versi. Opsi ini hanya tersedia jika Anda membuka versi terbaru dari template di langkah 3.

Atribut yang didukung

Setiap proyek dapat memiliki atribut standar dan atribut khusus. Atribut standar adalah atribut yang dibuat Amazon Pinpoint secara otomatis untuk proyek apa pun. Atribut khusus adalah atribut yang Anda buat secara opsional untuk sebuah proyek. Ada tiga jenis atribut khusus:

• Atribut pengguna — Atribut ini menggambarkan pengguna — misalnya, nama depan, nama belakang, dan tanggal lahir pengguna. Pengguna adalah individu yang memiliki ID pengguna unik untuk sebuah proyek.

• Atribut titik akhir - Atribut ini menjelaskan titik akhir tertentu untuk pengguna. Titik akhir adalah tujuan yang dapat Anda kirimi pesan—seperti alamat email, nomor telepon, atau perangkat seluler. Setiap pengguna dapat dikaitkan dengan satu atau lebih titik akhir. Misalnya, jika Anda berkomunikasi dengan pengguna melalui email, SMS, dan telepon, pengguna dapat dikaitkan dengan tiga titik akhir—satu untuk alamat email pengguna, satu lagi untuk nomor ponsel pengguna, dan satu lagi untuk nomor telepon rumah (telepon rumah) pengguna.

• Atribut metrik — Atribut ini adalah metrik numerik yang dilaporkan aplikasi Anda ke Amazon Pinpoint untuk titik akhir individual, seperti jumlah sesi untuk aplikasi seluler atau jumlah item yang tersisa di keranjang.

• Atribut Pinpoint — Atribut ini adalah pengenal unik untuk aplikasi, kampanye, atau perjalanan Anda.

Selain atribut kustom dan standar yang Anda atau Amazon Pinpoint buat untuk proyek Anda, Amazon Pinpoint mendukung atribut yang direkomendasikan. Atribut yang direkomendasikan adalah atribut yang menyimpan sementara rekomendasi yang dipersonalisasi untuk pengguna atau titik akhir. Amazon Pinpoint mengambil rekomendasi ini dari model pemberi rekomendasi yang Anda konfigurasikan untuk digunakan. Atribut yang disarankan tidak terkait dengan proyek tertentu. Sebaliknya, mereka terkait dengan akun Amazon Pinpoint Anda. Untuk informasi tentang menggunakan model pemberi rekomendasi, lihatModel Machine Learning.

Anda dapat menggunakan atribut standar, kustom, atau direkomendasikan dalam variabel pesan. Tabel berikut menunjukkan teks yang muncul dalam variabel pesan untuk setiap atribut yang didukung, dan menjelaskan setiap atribut. Dalam tabel, custom_attribute menunjukkan teks yang muncul dalam variabel untuk atribut kustom. Dalam kasus tersebut, ganti custom_attribute dengan nama atribut kustom. Misalnya, jika proyek Anda menyimpan nama depan pengguna dalam atribut pengguna kustom bernama FirstName dan Anda menambahkan variabel untuk atribut itu, teks untuk variabel tersebut adalah{{User.UserAttributes.FirstName}}.

Atribut	Deskripsi
Address	Alamat tujuan untuk pesan atau pemberitahuan push yang Anda kirim ke titik akhir—misalnya, alamat email, nomor telepon, atau token perangkat.
Pinpoint.ApplicationId	Pengidentifikasi unik untuk aplikasi.
Attributes.custom_attribute	Sebuah atribut endpoint kustom yang menjelaskan endpoint.
Pinpoint.CampaignId	Pengidentifikasi unik untuk kampanye.
ChannelType	Saluran yang akan digunakan saat mengirim pesan atau pemberitahuan push ke titik akhir. Sebagai contoh: APNS— Untuk titik akhir yang dapat menerima pemberitahuan push yang Anda kirim melalui saluran layanan Pemberitahuan Push Apple (APN) ke aplikasi yang berjalan di perangkat iOS. EMAIL— Untuk titik akhir yang dapat menerima pesan email. GCM— Untuk titik akhir yang dapat menerima pemberitahuan push yang Anda kirim melalui saluran Firebase Cloud Messaging (FCM) ke aplikasi yang berjalan di perangkat Android. SMS— Untuk titik akhir yang dapat menerima pesan teks SMS. VOICE— Untuk titik akhir yang dapat menerima pesan suara.
CreationDate	Tanggal dan waktu ketika titik akhir ditambahkan ke proyek, dalam format ISO 8601. Misalnya, 2019-06-30T11:45:25.220Z untuk 11:45 UTC 30 Juni 2019.
Demographic.AppVersion	Nomor versi aplikasi yang terkait dengan titik akhir.
Demographic.Locale	Lokal titik akhir, dalam format berikut: kode ISO 639-1 alpha-2, diikuti oleh garis bawah (_), diikuti oleh nilai alfa-2 ISO 3166-1. Misalnya, en_US adalah bahasa Inggris lokal untuk Amerika Serikat.
Demographic.Make	Produsen perangkat endpoint, seperti apple atausamsung.
Demographic.Model	Nama model atau nomor perangkat titik akhir, seperti iPhone atauSM-G900F.
Demographic.ModelVersion	Versi model perangkat endpoint.
Demographic.Platform	Sistem operasi pada perangkat endpoint, seperti ios atauandroid.
Demographic.PlatformVersion	Versi sistem operasi pada perangkat endpoint.
Demographic.Timezone	Zona waktu titik akhir, sebagai nilai database tz. Misalnya, America/Los_Angeles untuk Waktu Pasifik (Amerika Utara).
EffectiveDate	Tanggal dan waktu ketika titik akhir terakhir diperbarui, dalam format ISO 8601. Misalnya, 2019-08-23T10:54:35.220Z untuk 10:54 UTC 23 Agustus 2019.
EndpointId	Pengidentifikasi unik untuk titik akhir.
EndpointStatus	Apakah akan mengirim pesan atau pemberitahuan push ke titik akhir:ACTIVE, mengirim pesan ke titik akhir; atau,INACTIVE, jangan mengirim pesan ke titik akhir.
Id	Pengidentifikasi unik untuk titik akhir.
Pinpoint.JourneyId	Pengenal unik untuk perjalanan.
Location.City	Kota tempat titik akhir berada.
Location.Country	Kode dua karakter, dalam format ISO 3166-1 alpha-2, untuk negara atau wilayah tempat titik akhir berada. Misalnya, US untuk Amerika Serikat.
Location.Latitude	Koordinat lintang lokasi titik akhir, dibulatkan ke satu tempat desimal.
Location.Longitude	Koordinat bujur dari lokasi titik akhir, dibulatkan ke satu tempat desimal.
Location.PostalCode	Kode pos atau ZIP untuk area di mana titik akhir berada.
Location.Region	Nama wilayah, seperti negara bagian atau provinsi, tempat titik akhir berada.
Metrics.custom_attribute	Metrik numerik khusus yang dilaporkan aplikasi Anda ke Amazon Pinpoint untuk titik akhir.
OptOut	Apakah pengguna memilih untuk tidak menerima pesan dan pemberitahuan push dari Anda:ALL, pengguna memilih keluar dan tidak ingin menerima pesan atau pemberitahuan push apa pun; atau,NONE, pengguna belum memilih keluar dan ingin menerima semua pesan dan pemberitahuan push.
RecommendationItems	Atribut standar yang direkomendasikan yang menyimpan satu rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi teks yang disediakan langsung oleh model pemberi rekomendasi.
RecommendationItems.[#]	Atribut standar yang direkomendasikan yang menyimpan daftar terurut 2—5 rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi teks yang disediakan langsung oleh model pemberi rekomendasi. Placeholder numerik (. [#]) menunjukkan bahwa atribut berisi beberapa nilai. Variabel pesan untuk atribut ini dapat merujuk ke nilai tertentu dalam daftar.
Recommendations.custom_attribute	Atribut yang direkomendasikan khusus yang menyimpan satu rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi konten yang disediakan oleh model pemberi rekomendasi dan disempurnakan oleh AWS Lambda fungsi.
Recommendations.custom_attribute.[#]	Atribut yang direkomendasikan khusus yang menyimpan beberapa rekomendasi untuk titik akhir atau pengguna. Atribut ini berisi konten yang disediakan oleh model pemberi rekomendasi dan disempurnakan oleh AWS Lambda fungsi. Placeholder numerik (. [#]) menunjukkan bahwa atribut berisi beberapa nilai. Variabel pesan untuk atribut ini dapat merujuk ke salah satu nilai tersebut secara khusus.
RequestId	Pengidentifikasi unik untuk permintaan terbaru untuk memperbarui titik akhir.
User.UserAttributes.custom_attribute	Atribut pengguna kustom yang menjelaskan pengguna.
User.UserId	Pengidentifikasi unik untuk pengguna.