Mengimpor segmen

Dengan Amazon Pinpoint, Anda dapat menentukan segmen pengguna dengan mengimpor file yang berisi informasi tentang pengguna yang termasuk dalam segmen tersebut. Mengimpor segmen berguna jika Anda menentukan segmen pengguna di luar Amazon Pinpoint tetapi Anda ingin melibatkan pengguna Anda dengan kampanye Amazon Pinpoint.

Tidak seperti segmen dinamis yang Anda buat dengan pembuat segmen di konsol, segmen yang diimpor adalah kumpulan titik akhir atau ID pengguna yang tidak berubah:

Titik Akhir

Tujuan yang dapat Anda kirimi pesan, seperti alamat email, pengenal perangkat seluler, atau nomor ponsel. Definisi titik akhir dapat menyertakan atribut yang menggambarkan pengguna atau perangkat yang Anda kirimi pesan. Ini juga dapat menyertakan ID pengguna.

Anda dapat menentukan segmen dengan mengimpor daftar definisi titik akhir. Amazon Pinpoint membuat segmen, dan memperbarui titik akhir apa pun yang sebelumnya Anda tambahkan ke Amazon Pinpoint dengan informasi baru.

ID Pengguna

ID yang mewakili pengguna individu di audiens Anda. ID ini harus ditetapkan ke satu atau beberapa titik akhir. Misalnya, jika seseorang menggunakan aplikasi Anda di lebih dari satu perangkat, aplikasi Anda dapat menetapkan ID pengguna orang tersebut ke titik akhir untuk setiap perangkat.

Anda dapat menentukan segmen dengan mengimpor ID pengguna hanya jika Anda telah menambahkan titik akhir yang terkait dengan ID pengguna ke Amazon Pinpoint.

Segmen yang diimpor terdiri dari titik akhir, ID pengguna, atau kombinasi keduanya. Saat Anda menggunakan Amazon Pinpoint untuk mengirim pesan ke segmen, tujuan potensial meliputi:

• Setiap titik akhir yang Anda cantumkan dalam file yang diimpor.

• Setiap titik akhir yang terkait dengan setiap ID pengguna yang Anda cantumkan dalam file yang diimpor.

Saat membuat segmen baru, Anda dapat menggunakan segmen yang diimpor sebagai segmen dasar. Anda kemudian dapat menerapkan filter ke segmen dasar untuk menyempurnakannya sesuai dengan kebutuhan Anda.

Pertimbangan segmen yang diimpor

Pertimbangkan faktor-faktor berikut saat Anda membuat segmen yang diimpor:

• Saat Anda membuat kampanye, Anda harus memilih segmen. Saat Anda memilih segmen dinamis, Amazon Pinpoint memberikan perkiraan ukuran segmen tersebut. Namun, ketika Anda memilih segmen yang diimpor, Amazon Pinpoint tidak dapat memberikan perkiraan.

• Jika Anda membuat kampanye yang mengirim pesan saat peristiwa tertentu terjadi, Anda tidak dapat menggunakan segmen yang diimpor. Kampanye berbasis peristiwa hanya dapat menggunakan segmen dinamis. Untuk informasi selengkapnya tentang membuat segmen dinamis, lihatMembangun segmen.

File segmen

Anda menentukan titik akhir atau ID pengguna yang termasuk dalam segmen Anda dalam nilai yang dipisahkan koma (CSV) atau file JSON. Kemudian, Anda mengimpor file ke Amazon Pinpoint untuk membuat segmen.

Saat Anda mengimpor segmen, ingat hal berikut:

• Amazon Pinpoint tidak dapat mengimpor file terkompresi.

• File yang Anda impor harus menggunakan pengkodean karakter UTF-8.

• Jika Anda mengimpor titik akhir baru, ChannelType atribut Address dan diperlukan.

• Jika Anda memperbarui titik akhir yang ada, Id atribut diperlukan untuk setiap titik akhir yang ingin Anda perbarui.

• Definisi titik akhir Anda hanya dapat menyertakan atribut tertentu. Untuk daftarnya, lihat Atribut yang didukung. Selain itu, nama atribut harus 50 atau lebih sedikit karakter. Nilai atribut harus 100 atau lebih sedikit karakter.

Contoh file segmen

Contoh file di bagian ini didasarkan pada data berikut:

Contoh nilai atribut endpoint
ChannelType	Alamat	Lokasi.Negara	Demografi.Platform	Demografis.Make	Pengguna. UserId
SMS	[phone]	CA	Android	LG	example-user-id-1
APN	1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f	AS	iOS	Apple	example-user-id-2
Email	[e-mail]	AS	iOS	Apple	example-user-id-2
GCM	4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c	CN	Android	Google	example-user-id-3
Email	[e-mail]	CN	Android	OnePlus	example-user-id-3

Setiap baris dalam tabel ini mewakili titik akhir individu. Perhatikan bahwa ID pengguna example-user-id-2 dan masing-masing example-user-id-3 ditetapkan ke dua titik akhir.

contoh File dengan definisi titik akhir

CSV

Anda dapat mengimpor titik akhir yang ditentukan dalam file CSV, seperti pada contoh berikut:

ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId
SMS,[phone],CA,Android,LG,example-user-id-1
APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2
EMAIL,[e-mail],US,iOS,Apple,example-user-id-2
GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3
EMAIL,[e-mail],CN,Android,OnePlus,example-user-id-3

Baris pertama adalah header, yang berisi atribut endpoint. Untuk daftar lengkap atribut yang mungkin, lihatAtribut yang didukung.

Baris berikutnya menentukan titik akhir dengan memberikan nilai untuk setiap atribut di header.

Untuk memasukkan koma atau tanda kutip ganda dalam suatu nilai, lampirkan nilainya dalam tanda kutip ganda, seperti dalam. "aaa,bbb"

File CSV tidak dapat berisi jeda baris atau tab. Jika file Anda berisi data dengan jeda baris atau tab, data dalam file mungkin tidak diimpor, atau proses impor mungkin gagal.

JSON

Anda dapat mengimpor titik akhir yang ditentukan dalam file JSON yang dibatasi baris baru. Dalam format ini, setiap baris adalah objek JSON lengkap yang berisi definisi titik akhir individual, seperti pada contoh berikut:

{"ChannelType":"SMS","Address":"[phone]","Location":{"Country":"CA"},"Demographic":{"Platform":"Android","Make":"LG"},"User":{"UserId":"example-user-id-1"}}
{"ChannelType":"APNS","Address":"1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"EMAIL","Address":"[e-mail]","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"GCM","Address":"4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"Google"},"User":{"UserId":"example-user-id-3"}}
{"ChannelType":"EMAIL","Address":"[e-mail]","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"OnePlus"},"User":{"UserId":"example-user-id-3"}}

Untuk daftar lengkap atribut yang mungkin, lihatAtribut yang didukung.

Mengimpor segmen

Ada dua cara untuk mengimpor segmen ke Amazon Pinpoint: Anda dapat mengunggah file langsung dari komputer Anda, atau Anda dapat mengimpor file yang disimpan dalam bucket Amazon S3.

Mengunggah file dari komputer Anda umumnya merupakan metode yang lebih mudah untuk mengimpor segmen, terutama jika Anda sudah memiliki data pelanggan di komputer Anda. Namun, Anda hanya dapat mengimpor 10 file sekaligus, dan Anda hanya dapat mengunggah file yang lebih kecil dari 1 gigabyte (GB).

Jika Anda perlu mengimpor lebih dari 10 file sekaligus, atau jika Anda perlu mengunggah file yang lebih besar dari 1 GB, maka Anda harus mengimpor file dari Amazon S3. Opsi impor Amazon S3 juga berguna jika Anda sudah memiliki proses yang mengirim file data pelanggan ke Amazon S3 untuk penyimpanan.

Bagian ini mencakup prosedur untuk mengimpor segmen dengan menggunakan kedua metode ini.

Mengimpor segmen dengan mengunggah file dari komputer Anda

Anda dapat membuat segmen dengan mengunggah hingga 10 file langsung dari komputer Anda. File yang Anda unggah dapat dalam format CSV atau JSON. Anda dapat mengunggah file dalam kombinasi format apa pun. Misalnya, Anda dapat mengunggah satu file JSON dan tiga file CSV.

Untuk mengimpor segmen

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

2. Pada halaman Semua proyek, pilih proyek yang ingin Anda tambahkan segmennya.

3. Di panel navigasi, pilih Segmen.

4. Pilih Buat segmen.

5. Di bawah Buat segmen, pilih Impor segmen.

6. Di bawah Metode impor, pilih Unggah file dari komputer Anda.

7. Di bawah File yang akan diimpor, pilih Pilih file. Pilih file atau file yang ingin Anda impor.

   catatan

   Anda juga dapat menyeret file dari file explorer komputer Anda dan menjatuhkannya langsung di area Drop files here.

8. Saat mengunggah file ke Amazon Pinpoint, Anda harus memberikan nama segmen untuk setiap file yang Anda impor. Di bawah Nama segmen, masukkan nama segmen untuk setiap file yang ingin Anda impor.

   Secara default, Amazon Pinpoint menyediakan nama segmen yang sama dengan nama file yang diimpor, tetapi tanpa ekstensi nama file. Anda dapat mengubah nilai default ini ke nama apa pun.

   

   catatan

   Anda dapat menggunakan nama yang sama untuk beberapa segmen. Jika Anda melakukannya, Amazon Pinpoint membuat segmen yang berbeda untuk setiap file, dan menetapkan ID unik untuk setiap file. Tanggal pembuatan juga sedikit berbeda untuk setiap file yang Anda impor. Anda dapat menggunakan faktor-faktor ini untuk membedakan antara segmen yang memiliki nama yang sama.

9. Setelah selesai, pilih Buat segmen.

Mengimpor segmen dari file yang disimpan di Amazon S3

Sebelum Anda menggunakan prosedur ini untuk mengimpor segmen, Anda harus terlebih dahulu membuat bucket Amazon S3 dan mengunggah file Anda ke bucket tersebut. Anda dapat mengatur file untuk segmen yang berbeda ke dalam folder terpisah. Saat Amazon Pinpoint mengimpor titik akhir atau ID pengguna untuk segmen, Amazon Pinpoint menyertakan file dalam semua folder dan subfolder yang termasuk dalam lokasi Amazon S3 yang Anda tentukan.

Untuk pengenalan cara membuat bucket dan mengunggah objek, lihat Apa itu Amazon S3? di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Amazon Pinpoint hanya dapat mengimpor satu format file (CSV atau JSON) per segmen, sehingga jalur Amazon S3 yang Anda tentukan hanya boleh berisi file dari satu jenis.

Untuk mengimpor segmen

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

2. Pada halaman Semua proyek, pilih proyek yang ingin Anda tambahkan segmennya.

3. Di panel navigasi, pilih Segmen.

4. Pilih Buat segmen.

5. Di bawah Buat segmen, pilih Impor segmen.

6. Untuk nama Segmen, masukkan nama untuk segmen Anda agar mudah dikenali nanti.

7. Untuk URL Amazon S3, masukkan lokasi bucket Amazon S3 yang berisi file untuk segmen Anda. Alamat ember harus dalam format berikut:

   s3://bucket-name/folder-name

   Amazon Pinpoint mengimpor file dari jalur yang Anda tentukan, dan dari subfolder apa pun di jalur tersebut.

8. Untuk peran IAM, selesaikan salah satu langkah berikut:

   • Jika Anda ingin Amazon Pinpoint membuat peran yang memungkinkannya membaca dari bucket Amazon S3, pilih Buat peran secara otomatis. Kemudian, untuk peran IAM, masukkan nama untuk peran yang Anda buat.

   • Jika Anda telah membuat peran IAM yang memungkinkan Amazon Pinpoint membaca dari bucket Amazon S3, pilih Pilih peran yang ada. Kemudian, untuk peran IAM, pilih peran yang berisi izin yang sesuai.

   Jika Anda ingin membuat peran IAM sendiri, lihat peran IAM untuk mengimpor titik akhir atau segmen di Panduan Pengembang Amazon Pinpoint. Setelah Anda membuat peran, tentukan di konsol Amazon Pinpoint.

9. Di bawah Jenis file apa yang Anda impor, pilih JavaScript Object Notation (JSON) atau Comma-Separated Values (CSV), tergantung pada format file yang Anda upload ke Amazon S3.

10. Pilih Buat segmen.

Atribut yang didukung

Tabel di bagian ini mencantumkan dan menjelaskan atribut yang dapat Anda tentukan dalam definisi titik akhir yang Anda impor ke Amazon Pinpoint. Jika Anda mengimpor segmen menggunakan file CSV, header dalam file harus cocok dengan nama yang ditampilkan di kolom Atribut.

Untuk file JSON, periode dalam nama atribut menunjukkan bahwa nama yang mengikuti periode adalah objek yang bersarang di objek induk dengan nama yang sama dengan nilai sebelum periode. Misalnya, file JSON yang berisi Demographic.Model atribut Demographic.Make dan memiliki struktur berikut:

{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}

Struktur JSON lengkap sangat mirip dengan contoh permintaan titik akhir di Referensi API Amazon Pinpoint. Namun, tidak semua atribut dalam skema permintaan Endpoint didukung saat Anda mengimpor segmen, termasuk EndpointStatus dan. EffectiveDate

Agar bidang kustom memiliki beberapa nilai di CSV, Anda perlu mereplikasi header dan menyimpan satu nilai per header. Sebagai contoh:

...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20

Anda dapat mengganti nama atribut yang ditampilkan seperti custom_attribute dengan nilai apa pun. Misalnya, jika Anda ingin menyimpan nama depan dan belakang pengguna dalam atribut bernama FirstName danLastName, Anda dapat membuat atribut khusus bernama User.UserAttributes.FirstName danUser.UserAttributes.LastName, masing-masing. Nama atribut dapat berisi hingga 50 karakter. Nilai atribut dapat berisi hingga 100 karakter. Nama atribut peka huruf besar/kecil.

Di JSON atribut kustom perlu diformat di. "Attributes":{"Ride":["Bus"]}

Atribut	Deskripsi
Address	Alamat tujuan unik untuk pesan atau pemberitahuan push yang Anda kirim ke titik akhir—misalnya, alamat email, nomor telepon, atau token perangkat. catatan Jika alamat titik akhir adalah nomor telepon, Anda harus menentukannya dalam format E.164. Untuk informasi lebih lanjut tentang format E.164, lihat E.164 di Wikipedia.
Attributes.custom_attribute	Atribut kustom yang menjelaskan titik akhir. Anda dapat menggunakan jenis atribut ini sebagai kriteria pemilihan saat Anda membuat segmen. Anda dapat mengganti custom_attribute dengan nilai apa pun.
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.
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 atau SM-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). catatan Zona waktu berikut tidak lagi didukung dan secara otomatis dipetakan ulang ke zona waktu yang didukung. Zona waktu Zona waktu yang dipetakan ulang Canada/East-Saskatchewan America/Managua US/Pacific-New America/Los_Angeles
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.
Id	Pengidentifikasi unik untuk titik akhir.
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 kustom yang dilaporkan aplikasi Anda ke Amazon Pinpoint untuk titik akhir—misalnya, jumlah sesi atau jumlah item yang tersisa dalam troli—untuk digunakan untuk tujuan segmentasi. Anda dapat mengganti custom_attribute dengan nilai apa pun. Nilai kustom ini hanya bisa numerik. Karena numerik, Amazon Pinpoint dapat melakukan operasi aritmatika, seperti rata-rata atau jumlah, pada mereka.
OptOut	Menunjukkan apakah pengguna memilih untuk tidak menerima pesan dan pemberitahuan push dari Anda. Nilai yang dapat diterima adalah:ALL, pengguna memilih keluar dan tidak ingin menerima pesan atau pemberitahuan push apa pun; atauNONE,, pengguna belum memilih keluar dan ingin menerima semua pesan dan pemberitahuan push.
RequestId	Pengidentifikasi unik untuk permintaan terbaru untuk memperbarui titik akhir.
User.UserAttributes.custom_attribute	Atribut kustom yang menggambarkan pengguna. Anda dapat mengganti custom_attribute dengan nilai apa pun, seperti FirstName atauAge.
User.UserId	Pengidentifikasi unik untuk pengguna.

Anda dapat membuat sebanyak 250 atribut kustom untuk endpoint dan pengguna di setiap proyek. Untuk informasi selengkapnya, lihat Kuota Amazon Pinpoint dalam Panduan Developer Amazon Pinpoint.