SMSaliran data acara dari Amazon Pinpoint - Amazon Pinpoint
SMScontoh acaraSMSatribut acara

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

SMSaliran data acara dari Amazon Pinpoint

Jika SMS saluran diaktifkan untuk proyek, Amazon Pinpoint dapat mengalirkan data peristiwa tentang pengiriman SMS pesan untuk proyek. Setelah mengatur streaming acara, Amazon Pinpoint mengambil data peristiwa dari tujuan yang Anda tentukan selama penyiapan untuk dilihat. Untuk informasi tentang cara mengatur streaming acara, lihat Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose .

catatan

SMSperistiwa yang dihasilkan oleh operator dapat memakan waktu hingga 72 jam untuk diterima dan tidak boleh digunakan untuk menentukan apakah ada penundaan pengiriman pesan keluar. Setelah 72 jam, jika Amazon Pinpoint belum menerima peristiwa terakhir dari operator, layanan secara otomatis mengembalikan UNKNOWN record_status, karena Amazon Pinpoint tidak tahu apa yang terjadi pada pesan itu.

SMScontoh acara

JSONObjek untuk suatu SMS peristiwa 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": "+12065550142",
    "destination_phone_number": "+14255550199",
    "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"
}

SMSatribut acara

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

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 JSON skema acara.

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 SMS acara, objek ini kosong.
session Untuk SMS acara, 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

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

Atribut Deskripsi
app_id

ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.
sdk

SDKYang digunakan untuk melaporkan peristiwa tersebut. Jika Anda mengirim SMS pesan transaksional dengan memanggil Amazon API Pinpoint 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 SMS pesan.
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:

  • SUCCESSFUL/DELIVERED— Pesan berhasil disampaikan.

  • PENDING— Pesan belum dikirim ke perangkat penerima.

  • INVALID— 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.

  • UNKNOWN— Terjadi kesalahan yang mencegah pengiriman pesan. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti.

  • BLOCKED— Perangkat penerima memblokir SMS pesan 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 SMS pesan 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 — SMS Pesan tidak dapat disampaikan dalam jangka waktu tertentu. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti.

  • MAX_ PRICE _ EXCEEDED — Mengirim pesan akan menghasilkan biaya yang melebihi kuota SMS pengeluaran bulanan untuk akun Anda. Anda dapat meminta kenaikan kuota ini dengan menyelesaikan prosedur dalam Meminta kenaikan kuota SMS pengeluaran bulanan Anda di Panduan Pengguna Amazon Pinpoint.

  • OPTED_ OUT — SMS Pesan tidak terkirim 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 SMS pengeluaran bulanan Anda di Panduan Pengguna Pesan SMS Pengguna AWS Akhir.

  • 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 (SMSsaluran) yang didukung di Panduan Pengguna Pesan SMS Pengguna AWS Akhir.

  • ACCOUNT_IN_ SANDBOX - Akun Anda ada 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 Tentang kotak pasirSMS/MMSdan Suara di Panduan Pengguna Pesan Pengguna AWS Akhir. SMS

  • RATE_ EXCEEDED — Anda mencoba mengirim pesan terlalu cepat dan terhambat. Anda perlu memperlambat tingkat panggilan Anda. Untuk detail tentang batasan kami, lihat batas Bagian Pesan per Detik (MPS) di Panduan Pengguna Pesan SMS Pengguna AWS Akhir.

  • INVALID_ ORIGINATION _ IDENTITY - Identitas originasi yang diberikan tidak valid.

  • ORIGINATION_ IDENTITY _ DOES _ NOT _ EXIST - Identitas originasi yang disediakan tidak ada.

  • INVALID_ DLT _ PARAMETERS — DLT Parameter 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 SMS pesan transaksional, nilai ini adalah 0.
number_of_message_parts

Jumlah bagian pesan yang dibuat Amazon Pinpoint untuk mengirim pesan.

Umumnya, SMS pesan hanya dapat berisi 160 GSM -7 karakter atau 67 GSM non-karakter, meskipun batasan ini dapat bervariasi menurut negara . 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.
customer_context

JSONSerangkaian konten dari Context peta yang dikirim dalam operasi Amazon Pinpoint SendMessages.

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.