Acara SMS

Jika saluran SMS diaktifkan untuk suatu proyek, Amazon Pinpoint dapat mengalirkan data peristiwa tentang pengiriman pesan SMS untuk proyek tersebut. Acara SMS yang dihasilkan oleh operator dapat memakan waktu hingga 72 jam untuk diterima dan tidak boleh digunakan untuk menentukan apakah ada keterlambatan pengiriman pesan keluar. Setelah 72 jam, jika Amazon Pinpoint belum menerima acara terakhir dari operator, layanan akan secara otomatis mengembalikan record_status TIDAK DIKETAHUI karena kami tidak tahu apa yang terjadi pada pesan itu. Sebelum Anda dapat melihat acara Anda, Anda harus mengatur streaming acara, lihatMenyiapkan streaming acara. Saat menyiapkan streaming acara, Anda menentukan tujuan untuk data acara Anda untuk disimpan dan kemudian Anda dapat menggunakan tujuan untuk mengambil data acara Anda untuk dilihat.

Contoh

Objek JSON untuk acara SMS berisi data yang ditunjukkan dalam contoh berikut.

{
  "event_type": "_SMS.SUCCESS",
  "event_timestamp": 1553104954322,
  "arrival_timestamp": 1553104954064,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "123456789012"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
    "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
    "origination_phone_number": "[phone]",
    "destination_phone_number": "[phone]",
    "record_status": "DELIVERED",
    "iso_country_code": "US",
    "treatment_id": "0",
    "number_of_message_parts": "1",
    "message_id": "1111-2222-3333",
    "message_type": "Transactional",
    "campaign_id": "52dc44b35c4742c98c5935269example"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}

Atribut acara SMS

Bagian ini mendefinisikan atribut yang disertakan dalam data aliran peristiwa yang dihasilkan Amazon Pinpoint saat Anda mengirim pesan SMS.

Peristiwa
Atribut	Deskripsi
event_type	Jenis peristiwa. Kemungkinan nilainya adalah: _SMS.BUFFERED — Pesan masih dalam proses dikirim ke penerima. _SMS.SUCCESS — Pesan berhasil diterima oleh pengangkut/dikirim ke penerima. _SMS.FAILURE - Amazon Pinpoint tidak dapat mengirimkan pesan ke penerima. Untuk mempelajari lebih lanjut tentang kesalahan yang mencegah pesan terkirim, lihatattributes.record_status. _SMS.OPTOUT — Pelanggan menerima pesan dan membalas dengan mengirimkan kata kunci opt-out (biasanya “STOP”).
event_timestamp	Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik.
arrival_timestamp	Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik.
event_version	Versi skema acara JSON. Tip Periksa versi ini di aplikasi pemrosesan acara Anda sehingga Anda tahu kapan harus memperbarui aplikasi sebagai respons terhadap pembaruan skema.
application	Informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel Aplikasi.
client	Informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel Klien.
device	Informasi tentang perangkat yang melaporkan acara tersebut. Untuk informasi selengkapnya, lihat tabel Perangkat. Untuk acara SMS, objek ini kosong.
session	Untuk acara SMS, objek ini kosong.
attributes	Atribut yang terkait dengan acara tersebut. Untuk peristiwa yang dilaporkan oleh salah satu aplikasi Anda, objek ini dapat menyertakan atribut khusus yang ditentukan oleh aplikasi. Untuk peristiwa yang dibuat saat Anda mengirim kampanye, objek ini berisi atribut yang terkait dengan kampanye. Untuk peristiwa yang dihasilkan saat Anda mengirim pesan transaksional, objek ini berisi informasi yang terkait dengan pesan itu sendiri. Untuk informasi selengkapnya, lihat tabel Atribut.
metrics	Metrik tambahan yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel Metrik.
awsAccountId	ID AWS akun yang digunakan untuk mengirim pesan.

Aplikasi

Menyertakan informasi tentang proyek Amazon Pinpoint yang terkait dengan peristiwa tersebut dan, jika berlaku, SDK yang digunakan untuk melaporkan peristiwa tersebut.

Atribut	Deskripsi
app_id	ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.
sdk	SDK yang digunakan untuk melaporkan peristiwa tersebut. Jika Anda mengirim pesan SMS transaksional dengan memanggil Amazon Pinpoint API secara langsung atau menggunakan konsol Amazon Pinpoint, objek ini kosong.

Atribut

Termasuk informasi tentang atribut yang terkait dengan acara tersebut.

Atribut	Deskripsi
sender_request_id	ID unik yang terkait dengan permintaan untuk mengirim pesan SMS.
campaign_activity_id	ID unik aktivitas dalam kampanye.
origination_phone_number	Nomor telepon tempat pesan itu dikirim.
destination_phone_number	Nomor telepon yang Anda coba kirimi pesan.
record_status	Informasi tambahan tentang status pesan. Nilai yang mungkin termasuk: SUKSES/DISAMPAIKAN — Pesan berhasil disampaikan. PENDING — Pesan belum dikirim ke perangkat penerima. TIDAK VALID — Nomor telepon tujuan tidak valid. UNREACHABLE — Perangkat penerima saat ini tidak dapat dijangkau atau tidak tersedia. Misalnya, perangkat mungkin dimatikan, atau mungkin terputus dari jaringan. Anda dapat mencoba mengirim pesan lagi nanti. Tidak diketahui - Terjadi kesalahan yang mencegah pengiriman pesan. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. BLOCKED — Perangkat penerima memblokir pesan SMS dari nomor originasi. CARRIER_UNREACHABLE — Masalah dengan jaringan seluler penerima mencegah pesan dikirim. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. SPAM — Operator seluler penerima mengidentifikasi konten pesan sebagai spam dan pengiriman pesan yang diblokir. INVALID_MESSAGE - Isi pesan SMS tidak valid dan tidak dapat dikirimkan. CARRIER_BLOCKED — Operator penerima telah memblokir pengiriman pesan ini. Ini sering terjadi ketika operator mengidentifikasi isi pesan sebagai tidak diminta atau berbahaya. TTL_EXPIRED — Pesan SMS tidak dapat dikirimkan dalam jangka waktu tertentu. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. MAX_PRICE_EXCEEDED — Mengirim pesan akan mengakibatkan biaya yang melebihi kuota belanja SMS bulanan untuk akun Anda. Anda dapat meminta kenaikan kuota ini dengan menyelesaikan prosedur dalam Meminta kenaikan kuota belanja SMS bulanan Anda di Panduan Pengguna Amazon Pinpoint. OPTED_OUT — Pesan SMS tidak dikirim karena penerima memilih untuk tidak menerima pesan dari Anda. NO_QUOTA_LEFT_ON_ACCOUNT — Tidak ada cukup kuota pengeluaran yang tersisa di akun Anda untuk mengirim pesan. Anda dapat meminta kenaikan kuota ini dengan menyelesaikan prosedur dalam Meminta kenaikan kuota belanja SMS bulanan Anda di Panduan Pengguna SMS Amazon Pinpoint. NO_ORIGINATION_IDENTITY_AVAILABLE_TO_SEND — Akun Anda tidak berisi nomor telepon yang dapat digunakan untuk mengirim pesan ke tujuan. DESTINATION_COUNTRY_NOT_SUPPORTED — Negara tujuan diblokir. Untuk semua negara yang didukung, lihat Negara dan wilayah yang didukung (saluran SMS) di Panduan Pengguna SMS Amazon Pinpoint. ACCOUNT_IN_SANDBOX — Akun Anda berada di kotak pasir dan hanya dapat mengirim ke nomor tujuan yang diverifikasi. Anda dapat memverifikasi nomor tujuan di konsol Amazon Pinpoint atau memulai proses untuk memindahkan akun dari kotak pasir, lihat Memindahkan dari kotak pasir SMS Amazon Pinpoint ke produksi di Panduan Pengguna SMS Amazon Pinpoint. RATE_EXCEEDED - Anda mencoba mengirim pesan terlalu cepat dan dibatasi. Anda perlu memperlambat tingkat panggilan Anda. Untuk detail tentang batasan kami, lihat batas Bagian Pesan per Detik (MPS) di Panduan Pengguna SMS Amazon Pinpoint. INVALID_ORIGINATION_IDENTITY - Identitas originasi yang disediakan tidak valid. ORIGINATION_IDENTITY_DOES_NOT_EXIST — Identitas originasi yang disediakan tidak ada. INVALID_DLT_PARAMETERS — Parameter DLT tidak valid (diperlukan untuk tujuan di India) disediakan. INVALID_PARAMETERS — Parameter tidak valid disediakan. ACCESS_DENIED — Akun Anda diblokir dari mengirim pesan. Hubungi dukungan pelanggan untuk mengetahui penyebabnya dan menyelesaikan masalah. INVALID_KEYWORD - Kata kunci yang disediakan tidak valid. Kata kunci bisa dalam format yang salah atau tidak diatur di akun Anda. INVALID_SENDER_ID - ID Pengirim yang disediakan tidak valid. ID Pengirim bisa dalam format atau panjang yang salah. INVALID_POOL_ID - ID Pool yang disediakan tidak valid. ID Pool bisa dalam format yang salah atau bukan milik akun Anda. SENDER_ID_NOT_SUPPORTED_FOR_DESTINATION — Negara tujuan tidak mendukung ID Pengirim. Anda harus menggunakan nomor telepon atau identitas originasi lain untuk mengirim. INVALID_PHONE_NUMBER - Nomor telepon originasi yang disediakan tidak valid. Nomor telepon bisa dalam format atau panjang yang salah.
iso_country_code	Negara yang terkait dengan nomor telepon penerima, ditampilkan dalam format ISO 3166-1 alpha-2.
treatment_id	ID perlakuan pesan, jika pesan dikirim dalam kampanye A/B.
treatment_id	Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk pesan SMS transaksional, nilai ini adalah 0.
number_of_message_parts	Jumlah bagian pesan yang dibuat Amazon Pinpoint untuk mengirim pesan. Jika Anda mengirim pesan yang melebihi batas ini, Amazon Pinpoint secara otomatis membagi pesan menjadi bagian-bagian yang lebih kecil. Kami menagih Anda berdasarkan jumlah bagian pesan yang Anda kirim.
message_id	ID unik yang dihasilkan Amazon Pinpoint saat menerima pesan.
message_type	Jenis pesan. Nilai yang mungkin adalah Promosi dan Transaksional. Anda menentukan nilai ini saat membuat kampanye, atau saat Anda mengirim pesan transaksional menggunakan SendMessagesoperasi di Amazon Pinpoint API.
campaign_id	ID unik kampanye Amazon Pinpoint yang mengirim pesan.

Klien

Menyertakan informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut.

Atribut	Deskripsi
client_id	Untuk peristiwa yang dihasilkan oleh aplikasi, nilai ini adalah ID unik klien aplikasi yang diinstal pada perangkat. ID ini secara otomatis dihasilkan oleh AWS Mobile SDK for iOS dan AWS Mobile SDK for Android. Untuk peristiwa yang dihasilkan saat Anda mengirim kampanye dan pesan transaksional, nilai ini sama dengan ID titik akhir yang Anda kirimi pesan tersebut.
cognito_id	ID unik yang ditetapkan ke klien aplikasi di kumpulan identitas Amazon Cognito yang digunakan oleh aplikasi Anda.

Perangkat

Termasuk informasi tentang perangkat yang melaporkan acara tersebut.

Atribut	Deskripsi
locale	Perangkat lokal.
make	Perangkat membuat, seperti Apple atauSamsung.
model	Model perangkat, sepertiiPhone.
platform	Platform perangkat, seperti ios atauandroid.

Metrik

Termasuk informasi tentang metrik yang terkait dengan acara.

Atribut	Deskripsi
price_in_millicents_usd	Jumlah yang kami bebankan kepada Anda untuk mengirim pesan. Harga ini ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah645, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = $0,00645). catatan Properti ini tidak muncul untuk pesan dengan event_type _SMS.BUFFERED.