**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging.

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

# Streaming data peristiwa aplikasi melalui Kinesis dan Firehose menggunakan Amazon Pinpoint
<a name="event-streams"></a>

Di Amazon Pinpoint, *peristiwa* adalah tindakan yang terjadi saat pengguna berinteraksi dengan salah satu aplikasi Anda, saat Anda mengirim pesan dari kampanye atau perjalanan, atau saat Anda mengirim SMS transaksional atau pesan email. Misalnya, jika Anda mengirim pesan email, beberapa peristiwa terjadi:
+ Saat Anda mengirim pesan, peristiwa *kirim* terjadi.
+ Saat pesan mencapai kotak masuk penerima, peristiwa *terkirim* akan terjadi.
+ Ketika penerima membuka pesan, peristiwa *terbuka* terjadi. 

Anda dapat mengonfigurasi Amazon Pinpoint untuk mengirim informasi tentang peristiwa ke Amazon Kinesis. Platform Kinesis menawarkan layanan yang dapat Anda gunakan untuk mengumpulkan, memproses, dan menganalisis data dari AWS layanan secara real time. Amazon Pinpoint dapat mengirim data peristiwa ke Firehose, yang mengalirkan data ini ke penyimpanan AWS data seperti Amazon S3 atau Amazon Redshift. Amazon Pinpoint juga dapat mengalirkan data ke Kinesis Data Streams, yang menyerap dan menyimpan beberapa aliran data untuk diproses oleh aplikasi analitik.

Aliran peristiwa Amazon Pinpoint mencakup informasi tentang interaksi pengguna dengan aplikasi (aplikasi) yang Anda sambungkan ke Amazon Pinpoint. Ini juga mencakup informasi tentang semua pesan yang Anda kirim dari kampanye, melalui saluran apa pun, dan dari perjalanan. Ini juga dapat mencakup peristiwa kustom apa pun yang telah Anda tentukan. Terakhir, ini mencakup informasi tentang semua email transaksional dan pesan SMS yang Anda kirim.

**catatan**  
Amazon Pinpoint tidak mengalirkan informasi tentang pemberitahuan push transaksional atau pesan suara.

Bab ini memberikan informasi tentang pengaturan Amazon Pinpoint untuk mengalirkan data peristiwa ke Kinesis. Ini juga berisi contoh data peristiwa yang dialirkan Amazon Pinpoint.

**Topics**
+ [Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md)
+ [Aliran data acara aplikasi dari Amazon Pinpoint](event-streams-data-app.md)
+ [Aliran data acara kampanye dari Amazon Pinpoint](event-streams-data-campaign.md)
+ [Data acara perjalanan dari Amazon Pinpoint](event-streams-data-journey.md)
+ [Aliran data acara email dari Amazon Pinpoint](event-streams-data-email.md)
+ [Aliran data acara SMS dari Amazon Pinpoint](event-streams-data-sms.md)
+ [Menghapus aliran acara dari Amazon Pinpoint](event-streams-disable.md)

# Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose
<a name="event-streams-setup"></a>

Anda dapat mengatur Amazon Pinpoint untuk mengirim data peristiwa ke aliran Amazon Kinesis atau aliran pengiriman Amazon Data Firehose. Amazon Pinpoint dapat mengirim data acara untuk kampanye, perjalanan, dan email transaksional dan pesan SMS.

Bagian ini mencakup informasi tentang pengaturan streaming acara secara terprogram. Anda juga dapat menggunakan konsol Amazon Pinpoint untuk mengatur streaming acara. Untuk informasi tentang mengatur streaming acara menggunakan konsol Amazon Pinpoint, lihat [Pengaturan aliran peristiwa di Panduan](https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-event-streams.html) Pengguna *Amazon Pinpoint*.

## Prasyarat
<a name="event-streams-setup-prerequisites"></a>

Contoh di bagian ini memerlukan masukan berikut:
+ ID aplikasi aplikasi yang terintegrasi dengan Amazon Pinpoint dan melaporkan peristiwa. Untuk informasi tentang cara mengintegrasikan, lihat[Integrasikan Amazon Pinpoint dengan aplikasi Anda](integrate.md).
+ Nama Sumber Daya Amazon (ARN) dari aliran Kinesis atau aliran pengiriman Firehose di akun Anda. AWS Untuk informasi tentang cara membuat sumber daya ini, lihat [Membuat dan Mengelola Aliran](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) di Panduan Pengembang *Amazon Kinesis Data Streams atau Membuat aliran pengiriman Amazon Data Firehose di Panduan Pengembang* [*Amazon* Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html).
+ ARN dari peran AWS Identity and Access Management (IAM) yang mengizinkan Amazon Pinpoint untuk mengirim data ke aliran. Untuk informasi tentang membuat peran, lihat[Peran IAM untuk streaming acara ke Kinesis](permissions-streams.md).

## AWS CLI
<a name="event-streams-setup-cli"></a>

 AWS CLI Contoh berikut menggunakan [put-event-stream](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/put-event-stream.html)perintah. Perintah ini mengonfigurasi Amazon Pinpoint untuk mengirim peristiwa ke aliran Kinesis:

```
aws pinpoint put-event-stream \
--application-id projectId \
--write-event-stream DestinationStreamArn=streamArn,RoleArn=roleArn
```

## AWS SDK untuk Java
<a name="event-streams-setup-java"></a>

Contoh Java berikut mengonfigurasi Amazon Pinpoint untuk mengirim peristiwa ke aliran Kinesis:

```
public PutEventStreamResult createEventStream(AmazonPinpoint pinClient, 
        String appId, String streamArn, String roleArn) {
        
    WriteEventStream stream = new WriteEventStream()
            .withDestinationStreamArn(streamArn)
            .withRoleArn(roleArn);

    PutEventStreamRequest request = new PutEventStreamRequest()
            .withApplicationId(appId)
            .withWriteEventStream(stream);

    return pinClient.putEventStream(request);
}
```

Contoh ini membangun `WriteEventStream` objek yang menyimpan aliran Kinesis dan peran IAM. ARNs `WriteEventStream`Objek diteruskan ke `PutEventStreamRequest` objek untuk mengonfigurasi Amazon Pinpoint untuk mengalirkan peristiwa untuk aplikasi tertentu. `PutEventStreamRequest`Objek diteruskan ke `putEventStream` metode klien Amazon Pinpoint.

Anda dapat menetapkan aliran Kinesis ke beberapa aplikasi. Jika Anda melakukan ini, Amazon Pinpoint mengirimkan data peristiwa yang dikodekan dalam base64 dari setiap aplikasi ke aliran, yang memungkinkan Anda menganalisis data sebagai koleksi. Contoh metode berikut menerima daftar aplikasi (app) IDs, dan menggunakan metode contoh sebelumnya,`createEventStream`, untuk menetapkan aliran ke setiap aplikasi:

```
public List<PutEventStreamResult> createEventStreamFromAppList(
        AmazonPinpoint pinClient, List<String> appIDs, 
        String streamArn, String roleArn) {

    return appIDs.stream()
            .map(appId -> createEventStream(pinClient, appId, streamArn, 
                    roleArn))
            .collect(Collectors.toList());
}
```

Meskipun Anda dapat menetapkan satu aliran ke beberapa aplikasi, Anda tidak dapat menetapkan beberapa aliran ke satu aplikasi.

# Aliran data acara aplikasi dari Amazon Pinpoint
<a name="event-streams-data-app"></a>

Setelah mengintegrasikan aplikasi (aplikasi) dengan Amazon Pinpoint dan menyiapkan streaming peristiwa, Amazon Pinpoint akan mengambil aktivitas pengguna aplikasi, peristiwa kustom, dan data pengiriman pesan dari tujuan yang ditentukan selama penyiapan agar dapat dilihat. Untuk informasi tentang cara mengatur streaming acara sehingga Anda dapat melihat data acara, lihat[Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md).

## Contoh acara aplikasi
<a name="event-streams-data-app-example"></a>

Objek JSON untuk acara aplikasi berisi data yang ditampilkan dalam contoh berikut.

```
{
  "event_type": "_session.stop",
  "event_timestamp": 1487973802507,
  "arrival_timestamp": 1487973803515,
  "event_version": "3.0",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "package_name": "main.page",
    "sdk": {
      "name": "aws-sdk-mobile-analytics-js",
      "version": "0.9.1:2.4.8"
    },
    "title": "title",
    "version_name": "1.0",
    "version_code": "1"
  },
  "client": {
    "client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
    "cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
  },
  "device": {
    "locale": {
      "code": "en_US",
      "country": "US",
      "language": "en"
    },
    "make": "generic web browser",
    "model": "Unknown",
    "platform": {
      "name": "android",
      "version": "10.10"
    }
  },
  "session": {
    "session_id": "f549dea9-1090-945d-c3d1-e4967example",
    "start_timestamp": 1487973202531,
    "stop_timestamp": 1487973802507
  },
  "attributes": {},
  "metrics": {}
}
```

## Atribut acara aplikasi
<a name="event-streams-data-app-attributes"></a>

Bagian ini mendefinisikan atribut yang disertakan dalam contoh aliran peristiwa aplikasi sebelumnya.


| Atribut | Deskripsi | 
| --- | --- | 
| event\$1type |  Jenis peristiwa. Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-app.html)  | 
| event\$1timestamp | Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik. | 
| arrival\$1timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | 
| event\$1version |  Versi skema acara JSON.  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](#event-streams-data-app-attributes-application). | 
| client | Informasi tentang titik akhir yang melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel [Klien](#event-streams-data-app-attributes-client). | 
| device | Informasi tentang perangkat yang melaporkan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Perangkat](#event-streams-data-app-attributes-device). | 
| session | Informasi tentang sesi yang menghasilkan acara. Untuk informasi selengkapnya, lihat tabel [Sesi](#event-streams-data-app-attributes-session). | 
| attributes |  Atribut yang terkait dengan acara tersebut. Untuk peristiwa yang dilaporkan oleh aplikasi Anda, objek ini menyertakan atribut khusus yang Anda tentukan.  | 
| metrics | Metrik yang terkait dengan acara tersebut. Anda dapat mengonfigurasi aplikasi secara opsional untuk mengirim metrik khusus ke Amazon Pinpoint. | 

### Aplikasi
<a name="event-streams-data-app-attributes-application"></a>

Termasuk informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| app\$1id |  ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.  | 
| cognito\$1identity\$1pool\$1id |  ID Kumpulan Identitas Amazon Cognito yang terkait dengan titik akhir.  | 
| package\$1name |  Nama paket aplikasi, seperti`com.example.my_app`.  | 
| sdk |  Informasi tentang SDK yang digunakan untuk melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel [SDK](#event-streams-data-app-attributes-application-sdk).  | 
| title |  Nama aplikasi.  | 
| version\$1name |  Nama versi aplikasi, seperti`V2.5`.  | 
| version\$1code |  Nomor versi aplikasi, seperti`3`.  | 

#### SDK
<a name="event-streams-data-app-attributes-application-sdk"></a>

Termasuk informasi tentang SDK yang digunakan untuk melaporkan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| name | Nama SDK yang digunakan untuk melaporkan peristiwa tersebut. | 
| version | Versi SDK. | 

### Klien
<a name="event-streams-data-app-attributes-client"></a>

Termasuk informasi tentang titik akhir yang menghasilkan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| client\$1id | ID dari titik akhir. | 
| cognito\$1id | Token ID Amazon Cognito yang terkait dengan titik akhir. | 

### Perangkat
<a name="event-streams-data-app-attributes-device"></a>

Termasuk informasi tentang perangkat titik akhir yang menghasilkan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| locale |  Informasi tentang pengaturan bahasa dan wilayah untuk perangkat titik akhir. Untuk informasi selengkapnya, lihat tabel [Lokal](#event-streams-data-app-attributes-device-locale).  | 
| make | Pabrikan perangkat titik akhir. | 
| model | Pengidentifikasi model perangkat titik akhir. | 
| platform |  Informasi tentang sistem operasi pada perangkat titik akhir. Untuk informasi selengkapnya, lihat tabel [Platform](#event-streams-data-app-attributes-device-platform).  | 

#### Lokal
<a name="event-streams-data-app-attributes-device-locale"></a>

Menyertakan informasi tentang pengaturan bahasa dan wilayah untuk perangkat titik akhir.


| Atribut | Deskripsi | 
| --- | --- | 
| code | Pengenal lokal yang terkait dengan perangkat. | 
| country | Negara atau wilayah yang terkait dengan lokal perangkat. | 
| language | Bahasa yang terkait dengan lokal perangkat. | 

#### Platform
<a name="event-streams-data-app-attributes-device-platform"></a>

Termasuk informasi tentang sistem operasi pada perangkat titik akhir.


| Atribut | Deskripsi | 
| --- | --- | 
| name | Nama sistem operasi pada perangkat. | 
| version | Versi sistem operasi pada perangkat. | 

### Sesi
<a name="event-streams-data-app-attributes-session"></a>

Termasuk informasi tentang sesi yang menghasilkan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| session\$1id | ID unik yang mengidentifikasi sesi. | 
| start\$1timestamp | Tanggal dan waktu ketika sesi dimulai, ditampilkan sebagai waktu Unix dalam milidetik. | 
| stop\$1timestamp | Tanggal dan waktu ketika sesi berakhir, ditampilkan sebagai waktu Unix dalam milidetik. | 

# Aliran data acara kampanye dari Amazon Pinpoint
<a name="event-streams-data-campaign"></a>

Jika Anda menggunakan Amazon Pinpoint untuk mengirim kampanye melalui saluran, Amazon Pinpoint dapat mengalirkan data peristiwa tentang kampanye tersebut. Setelah menyiapkan streaming acara, Amazon Pinpoint akan mengambil data peristiwa aplikasi Anda untuk pesan email atau SMS yang Anda kirim dari kampanye dari tujuan yang Anda tentukan selama penyiapan untuk dilihat. Untuk informasi terperinci tentang data yang dialirkan Amazon Pinpoint untuk pesan email dan SMS, lihat dan. [Aliran data acara email dari Amazon Pinpoint](event-streams-data-email.md) [Aliran data acara SMS dari Amazon Pinpoint](event-streams-data-sms.md) Untuk informasi tentang cara mengatur streaming acara, lihat[Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md). 

## Contoh acara kampanye
<a name="event-streams-data-campaign-example"></a>

Objek JSON untuk acara kampanye berisi data yang ditampilkan dalam contoh berikut.

```
{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}
```

## Atribut acara kampanye
<a name="event-streams-data-campaign-attributes"></a>

Bagian ini mendefinisikan atribut yang disertakan dalam aliran acara kampanye.


| Atribut | Deskripsi | 
| --- | --- | 
| event\$1type |  Jenis peristiwa. Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| event\$1timestamp | Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik. | 
| arrival\$1timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | 
| event\$1version |  Versi skema acara JSON.  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](#event-streams-data-campaign-attributes-application). | 
| client | Informasi tentang titik akhir yang terkait dengan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel [Klien](#event-streams-data-campaign-attributes-client). | 
| device | Informasi tentang perangkat yang melaporkan acara tersebut. Untuk pesan kampanye dan transaksional, objek ini kosong. | 
| session | Informasi tentang sesi yang menghasilkan acara. Untuk kampanye, 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](#event-streams-data-campaign-attributes-attrs).  | 
| client\$1context | Berisi custom objek, yang berisi endpoint properti. endpointProperti berisi isi catatan titik akhir untuk titik akhir yang dikirimkan kampanye. | 
| awsAccountId |  ID AWS akun yang digunakan untuk mengirim pesan.  | 

### Aplikasi
<a name="event-streams-data-campaign-attributes-application"></a>

Termasuk informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| app\$1id |  ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.  | 
| sdk |  SDK yang digunakan untuk melaporkan peristiwa tersebut.   | 

### Atribut
<a name="event-streams-data-campaign-attributes-attrs"></a>

Termasuk informasi tentang kampanye yang menghasilkan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| treatment\$1id |  Jika pesan dikirim menggunakan kampanye A/B pengujian, nilai ini mewakili nomor perlakuan pesan. Untuk kampanye standar, nilai ini adalah`0`.  | 
| campaign\$1activity\$1id | ID unik yang dihasilkan Amazon Pinpoint saat peristiwa terjadi. | 
| delivery\$1type |  Metode pengiriman untuk kampanye. Jangan bingung atribut ini dengan `ChannelType` bidang yang ditentukan di bawah `endpoint` properti. `client_context` `ChannelType`Bidang ini biasanya didasarkan pada titik akhir yang pesan sedang dikirim. Untuk saluran yang hanya mendukung satu jenis titik akhir, `ChannelType` bidang `delivery_type` dan memiliki nilai yang sama. Misalnya, untuk saluran email, `ChannelType` bidang `delivery_type` dan memiliki nilai EMAIL yang sama.  Namun, kondisi ini tidak selalu berlaku untuk saluran yang mendukung berbagai jenis titik akhir, seperti saluran khusus. Anda dapat menggunakan saluran khusus untuk titik akhir yang berbeda, seperti EMAIL, SMS, KUSTOM, dan sebagainya. Dalam hal ini, `delivery_type` mengidentifikasi peristiwa pengiriman kustom, KUSTOM, dan `ChannelType` menentukan jenis titik akhir yang dikirimkan kampanye, seperti EMAIL, SMS, KUSTOM, dan sebagainya. Untuk informasi selengkapnya tentang membuat saluran khusus, lihat[Buat saluran khusus di Amazon Pinpoint menggunakan fungsi webhook atau Lambda](channels-custom.md). Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| campaign\$1id |  ID unik kampanye tempat pesan dikirim.  | 
| campaign\$1send\$1status | Menunjukkan status kampanye untuk titik akhir target. Nilai yang mungkin termasuk:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

### Klien
<a name="event-streams-data-campaign-attributes-client"></a>

Termasuk informasi tentang titik akhir yang ditargetkan oleh kampanye.


| Atribut | Deskripsi | 
| --- | --- | 
| client\$1id | ID titik akhir yang dikirimkan kampanye. | 

# Data acara perjalanan dari Amazon Pinpoint
<a name="event-streams-data-journey"></a>

Saat Anda mempublikasikan perjalanan, Amazon Pinpoint dapat mengalirkan data acara untuk email, SMS, push, dan pesan khusus yang Anda kirim dari perjalanan. Setelah mengatur streaming acara, Amazon Pinpoint akan mengambil data dari tujuan yang Anda tentukan selama penyiapan untuk dilihat. Untuk informasi terperinci tentang data yang dialirkan Amazon Pinpoint untuk pesan email dan SMS, lihat dan. [Aliran data acara email dari Amazon Pinpoint](event-streams-data-email.md) [Aliran data acara SMS dari Amazon Pinpoint](event-streams-data-sms.md) Untuk informasi tentang cara mengatur streaming acara, lihat[Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md).

## Contoh acara perjalanan
<a name="event-streams-data-journey-example"></a>

Objek JSON untuk acara perjalanan berisi data yang ditunjukkan dalam sampel berikut.

```
{
   "event_type":"_journey.send",
   "event_timestamp":1572989078843,
   "arrival_timestamp":1572989078843,
   "event_version":"3.1",
   "application":{
      "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "sdk":{

      }
   },
   "client":{
      "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample"
   },
   "device":{
      "platform":{

      }
   },
   "session":{

   },
   "attributes":{
      "journey_run_id":"edc9a0b577164d1daf72ebd15example",
      "journey_send_status":"SUCCESS",
      "journey_id":"546401670c5547b08811ac6a9example",
      "journey_activity_id":"0yKexample",
      "journey_activity_type": "EMAIL",
      "journey_send_status_message": "200", 
      "journey_send_status_code": "200"
   },
   "client_context":{
      "custom":{
         "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}"
      }
   },
   "awsAccountId":"123456789012"
}
```

## Atribut acara perjalanan
<a name="event-streams-data-journey-attributes"></a>

Bagian ini mendefinisikan atribut yang disertakan dalam data aliran peristiwa yang dihasilkan Amazon Pinpoint untuk perjalanan.


| Atribut | Deskripsi | 
| --- | --- | 
| event\$1type |  Jenis peristiwa. Untuk peristiwa perjalanan, nilai untuk atribut ini selalu`_journey.send`, yang menunjukkan bahwa Amazon Pinpoint mengeksekusi perjalanan.  | 
| event\$1timestamp | Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik. | 
| arrival\$1timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | 
| event\$1version |  Versi skema acara JSON.  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](#event-streams-data-journey-attributes-application). | 
| client | Informasi tentang titik akhir yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Klien](#event-streams-data-journey-attributes-client). | 
| device | Informasi tentang perangkat yang melaporkan acara tersebut. Untuk perjalanan, objek ini kosong. | 
| session | Informasi tentang sesi yang menghasilkan acara. Untuk perjalanan, objek ini kosong. | 
| attributes |  Atribut yang terkait dengan aktivitas perjalanan dan perjalanan yang menghasilkan acara. Untuk informasi selengkapnya, lihat tabel [Atribut](#event-streams-data-journey-attributes-attrs).  | 
| client\$1context | Berisi custom objek, yang berisi endpoint properti. endpointProperti berisi konten catatan titik akhir untuk titik akhir yang terkait dengan peristiwa tersebut. | 
| awsAccountId |  ID AWS akun yang digunakan untuk menjalankan perjalanan.  | 

### Aplikasi
<a name="event-streams-data-journey-attributes-application"></a>

Termasuk informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| app\$1id |  ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.  | 
| sdk |  SDK yang digunakan untuk melaporkan peristiwa tersebut.   | 

### Klien
<a name="event-streams-data-journey-attributes-client"></a>

Termasuk informasi tentang titik akhir yang terkait dengan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| client\$1id | ID dari titik akhir. | 

### Atribut
<a name="event-streams-data-journey-attributes-attrs"></a>

Termasuk informasi tentang perjalanan yang menghasilkan acara.


| Atribut | Deskripsi | 
| --- | --- | 
| journey\$1run\$1id |  ID unik dari perjalanan lari yang menghasilkan acara. Amazon Pinpoint menghasilkan dan menetapkan ID ini secara otomatis ke setiap perjalanan baru.  | 
| journey\$1send\$1status |  Menunjukkan status pengiriman pesan yang terkait dengan acara. Nilai yang mungkin termasuk: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-journey.html)  | 
| journey\$1id |  ID unik dari perjalanan yang menghasilkan acara.  | 
| journey\$1activity\$1id |  ID unik dari aktivitas perjalanan yang menghasilkan acara.  | 
| journey\$1activity\$1type |  Jenis kegiatan perjalanan acara. **Ini bisa berupa **EMAIL**, **SMS**, **PUSH**, **CONTACT\$1CENTER**, atau CUSTOM.**   **VOICE** bukan jenis aktivitas perjalanan yang didukung. `journey_activity_type`Bidang tidak ada saat disetel ke `journey_send_status` **QUIET\$1TIME\$1WAIT\$1FINISHED**.   | 
|  `journey_send_status_message`  | Deskripsi status acara kirim. | 
| journey\$1send\$1status\$1code | Kode status HTTP dari permintaan. | 

# Aliran data acara email dari Amazon Pinpoint
<a name="event-streams-data-email"></a>

Jika Anda menggunakan Amazon Pinpoint untuk mengirim email, Amazon Pinpoint dapat mengalirkan data acara tentang email tersebut. 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](event-streams-setup.md). Amazon Pinpoint mengalirkan data tentang jenis peristiwa berikut untuk pesan email:
+ Mengirim
+ Pengiriman
+ Pentalan
+ Aduan
+ Membuka
+ Klik
+ Penolakan
+ Berhenti berlangganan
+ Kegagalan rendering

Jenis acara ini dijelaskan secara rinci dalam[Atribut acara email](#event-streams-data-email-attributes).

Bergantung pada API dan pengaturan yang Anda gunakan untuk mengirim pesan email, Anda mungkin melihat jenis peristiwa tambahan atau data yang berbeda. Misalnya, jika Anda mengirim pesan menggunakan set konfigurasi yang mempublikasikan data peristiwa ke Amazon Kinesis, seperti yang disediakan oleh Amazon Simple Email Service (Amazon SES), data juga dapat menyertakan peristiwa untuk kegagalan rendering template. Untuk informasi tentang data tersebut, lihat [Pemantauan menggunakan penerbitan acara Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) di *Panduan Pengembang Layanan Email Sederhana Amazon*. Sebelum Anda dapat melihat acara Anda, Anda harus mengatur streaming acara, lihat[Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md). 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 acara email
<a name="event-streams-data-email-example"></a>

**Kirim email**  
Objek JSON untuk acara *pengiriman email* berisi data yang ditunjukkan dalam contoh berikut.

```
{
  "event_type": "_email.send",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622025,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "received"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "send": {}
      }
    }
  }
}
```

**Email terkirim**  
Objek JSON untuk acara yang *dikirim email* berisi data yang ditunjukkan dalam contoh berikut.

```
{
  "event_type": "_email.delivered",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622690,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "delivered"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "delivery": {
          "smtp_response": "250 ok:  Message 82080542 accepted",
          "reporting_mta": "a8-53.smtp-out.amazonses.com",
          "recipients": ["recipient@example.com"],
          "processing_time_millis": 1310
        }
      }
    }
  }
}
```

**Klik email**  
Objek JSON untuk acara *klik email* berisi data yang ditunjukkan dalam contoh berikut.

```
{
  "event_type": "_email.click",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618713751,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "https://aws.amazon.com/pinpoint/"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "click": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15",
          "link": "https://aws.amazon.com/pinpoint/"
        }
      }
    }
  }
}
```

**Email terbuka**  
Objek JSON untuk acara *terbuka email* berisi data yang ditunjukkan dalam contoh berikut.

```
{
  "event_type": "_email.open",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618712316,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "opened"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "open": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)"
        }
      }
    }
  }
}
```

## Atribut acara email
<a name="event-streams-data-email-attributes"></a>

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


| Atribut | Deskripsi | 
| --- | --- | 
| event\$1type |  Jenis peristiwa. Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| event\$1timestamp |  Waktu ketika pesan dikirim, ditampilkan sebagai waktu Unix dalam milidetik. Nilai ini biasanya sama untuk semua peristiwa yang dihasilkan untuk pesan.  | 
| arrival\$1timestamp |  Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik.  | 
| event\$1version |  Versi skema acara JSON.  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. Lihat tabel *Aplikasi* untuk informasi selengkapnya.  | 
| 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 email, objek ini kosong.  | 
| session | Untuk acara email, objek ini kosong. | 
| attributes |  Atribut yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel *Atribut*. Untuk peristiwa yang dilaporkan oleh salah satu aplikasi Anda, objek ini dapat menyertakan atribut khusus yang ditentukan oleh aplikasi. Untuk acara yang dibuat saat Anda mengirim pesan dari kampanye atau perjalanan, objek ini berisi atribut yang terkait dengan kampanye atau perjalanan. Untuk peristiwa yang dihasilkan saat Anda mengirim pesan transaksional, objek ini berisi informasi yang terkait dengan pesan itu sendiri.  | 
| client\$1context | Untuk acara email, objek ini berisi custom objek, yang berisi legacy\$1identifier atribut. Nilai untuk legacy\$1identifier atribut adalah ID proyek tempat pesan dikirim. | 
| facets |  Informasi tambahan tentang pesan, seperti header email. Lihat tabel *Facets* untuk informasi lebih lanjut.  | 
| awsAccountId |  ID AWS akun yang digunakan untuk mengirim pesan.  | 

### Aplikasi
<a name="event-streams-data-email-attributes-application"></a>

Termasuk informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| app\$1id |  ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut.  | 
| sdk |  SDK yang digunakan untuk melaporkan peristiwa tersebut. Jika Anda mengirim pesan email transaksional dengan memanggil Amazon Pinpoint API secara langsung atau menggunakan konsol Amazon Pinpoint, objek ini kosong.  | 

### Atribut
<a name="event-streams-data-email-attributes-attrs"></a>

Termasuk informasi tentang kampanye atau perjalanan yang menghasilkan acara.

#### Kampanye
<a name="event-streams-data-email-attributes-attrs-campaigns"></a>

Termasuk informasi tentang kampanye yang menghasilkan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| feedback |  Untuk `_email.click` peristiwa, nilai untuk atribut ini adalah URL tautan yang diklik penerima dalam pesan untuk menghasilkan acara. Untuk acara lain, nilai ini mewakili jenis acara, seperti`received`,`opened`, atau`clicked`.  | 
| treatment\$1id |  Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk kampanye standar dan pesan email transaksional, nilai ini adalah. `0`  | 
| campaign\$1activity\$1id | ID unik yang dihasilkan Amazon Pinpoint saat peristiwa terjadi. | 
| campaign\$1id |  ID unik kampanye yang mengirim pesan.  | 

#### Perjalanan
<a name="event-streams-data-email-attributes-attrs-journey"></a>

Termasuk informasi tentang perjalanan yang menghasilkan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| journey\$1run\$1id | ID unik dari perjalanan lari yang mengirim pesan. Amazon Pinpoint menghasilkan dan menetapkan ID ini secara otomatis ke setiap perjalanan baru. | 
| feedback |  Untuk `_email.click` peristiwa, nilai untuk atribut ini adalah URL tautan yang diklik penerima dalam pesan untuk menghasilkan acara. Untuk acara lain, nilai ini mewakili jenis acara, seperti`received`,`delivered`, atau`opened`.  | 
| journey\$1id | ID unik dari perjalanan yang mengirim pesan. | 
| journey\$1activity\$1id | ID unik dari aktivitas perjalanan yang mengirim pesan. | 

### Klien
<a name="event-streams-data-email-attributes-client"></a>

Pengenal unik klien yang ditargetkan oleh kampanye atau perjalanan.


| Atribut | Deskripsi | 
| --- | --- | 
| client\$1id | ID klien. Nilai adalah Endpoint ID untuk kampanye dan perjalanan, dan untuk pengiriman Transaksional, itu adalah UUID. | 

### Faset
<a name="event-streams-data-email-attributes-facets"></a>

Termasuk informasi tentang pesan dan jenis acara.


| Atribut | Deskripsi | 
| --- | --- | 
| email\$1channel |  Berisi `mail_event` objek, yang berisi dua objek:`mail`, dan objek yang sesuai dengan jenis acara.  | 

### Mail
<a name="event-streams-data-email-attributes-mail"></a>

Termasuk informasi tentang konten pesan email, dan metadata tentang pesan.


| Atribut | Deskripsi | 
| --- | --- | 
| message\$1id |  ID unik dari pesan. Amazon Pinpoint secara otomatis menghasilkan ID ini saat menerima pesan.  | 
| message\$1send\$1timestamp |  Tanggal dan waktu ketika pesan dikirim, dalam format yang ditentukan dalam [RFC 822](https://datatracker.ietf.org/doc/html/rfc822).  | 
| from\$1address |  Alamat email tempat pesan itu dikirim.  | 
| destination |  Array yang berisi alamat email tempat pesan dikirim.  | 
| headers\$1truncated |  Nilai Boolean yang menunjukkan apakah header email terpotong.  | 
| headers |  Objek yang berisi beberapa pasangan nama-nilai yang sesuai dengan header dalam pesan. Objek ini biasanya berisi informasi tentang header berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| common\$1headers |  Berisi informasi tentang beberapa header umum untuk pesan email. Informasi dapat mencakup tanggal ketika pesan dikirim, dan baris ke, dari, dan subjek pesan.  | 

# Aliran data acara SMS dari Amazon Pinpoint
<a name="event-streams-data-sms"></a>

Jika saluran SMS diaktifkan untuk suatu proyek, Amazon Pinpoint dapat mengalirkan data peristiwa tentang pengiriman pesan SMS untuk proyek tersebut. 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](event-streams-setup.md). 

**catatan**  
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 peristiwa terakhir dari operator, layanan secara otomatis mengembalikan record\$1status TIDAK DIKETAHUI, karena Amazon Pinpoint tidak tahu apa yang terjadi pada pesan itu.

## Contoh acara SMS
<a name="event-streams-data-sms-example"></a>

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": "+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"
    "customer_context": "{\"userId\":\"user-id-4\"}"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}
```

## Atribut acara SMS
<a name="event-streams-data-sms-attributes"></a>

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


**Peristiwa**  

| Atribut | Deskripsi | 
| --- | --- | 
| event\$1type |  Jenis peristiwa. Kemungkinan nilainya adalah: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| event\$1timestamp | Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik. | 
| arrival\$1timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | 
| event\$1version |  Versi skema acara JSON.  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](#event-streams-data-sms-attributes-application). | 
| client | Informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel [Klien](#event-streams-data-sms-attributes-client). | 
| device | Informasi tentang perangkat yang melaporkan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Perangkat](#event-streams-data-sms-attributes-device). 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](#event-streams-data-sms-attributes-attrs).  | 
| metrics |  Metrik tambahan yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Metrik](#event-streams-data-sms-attributes-metrics).  | 
| awsAccountId |  ID AWS akun yang digunakan untuk mengirim pesan.  | 

### Aplikasi
<a name="event-streams-data-sms-attributes-application"></a>

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


| Atribut | Deskripsi | 
| --- | --- | 
| app\$1id |  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
<a name="event-streams-data-sms-attributes-attrs"></a>

Termasuk informasi tentang atribut yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| sender\$1request\$1id | ID unik yang terkait dengan permintaan untuk mengirim pesan SMS. | 
| campaign\$1activity\$1id | ID unik dari aktivitas dalam kampanye. | 
| origination\$1phone\$1number |  Nomor telepon tempat pesan itu dikirim.  | 
| destination\$1phone\$1number |  Nomor telepon yang Anda coba kirimi pesan.  | 
| record\$1status |  Informasi tambahan tentang status pesan. Nilai yang mungkin termasuk: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| iso\$1country\$1code |  Negara yang terkait dengan nomor telepon penerima, ditampilkan dalam format ISO 3166-1 alpha-2.  | 
| treatment\$1id |  ID dari perlakuan pesan, jika pesan dikirim dalam kampanye A/B.  | 
| treatment\$1id |  Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk pesan SMS transaksional, nilai ini adalah 0.  | 
| number\$1of\$1message\$1parts |  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\$1id |  ID unik yang dihasilkan Amazon Pinpoint saat menerima pesan.  | 
| message\$1type |  Jenis pesan. Nilai yang mungkin adalah **Promosi** dan **Transaksional**. Anda menentukan nilai ini saat membuat kampanye, atau saat Anda mengirim pesan transaksional menggunakan [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)operasi di Amazon Pinpoint API.  | 
| campaign\$1id |  ID unik kampanye Amazon Pinpoint yang mengirim pesan.  | 
| customer\$1context | String JSON dari konten dari `Context` peta yang dikirim dalam operasi Amazon [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)Pinpoint. | 

### Klien
<a name="event-streams-data-sms-attributes-client"></a>

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


| Atribut | Deskripsi | 
| --- | --- | 
| client\$1id |  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\$1id | ID unik yang ditetapkan ke klien aplikasi di kumpulan identitas Amazon Cognito yang digunakan oleh aplikasi Anda. | 

### Perangkat
<a name="event-streams-data-sms-attributes-device"></a>

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
<a name="event-streams-data-sms-attributes-metrics"></a>

Menyertakan informasi tentang metrik yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| price\$1in\$1millicents\$1usd | Jumlah yang kami bebankan kepada Anda untuk mengirim pesan. Harga ini ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah`645`, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = \$10,00645).  Properti ini tidak muncul untuk pesan dengan `event_type` **\$1SMS.BUFFERED**.   | 

# Menghapus aliran acara dari Amazon Pinpoint
<a name="event-streams-disable"></a>

Jika Anda menetapkan aliran Kinesis ke aplikasi, Anda dapat menonaktifkan streaming acara untuk aplikasi itu. Amazon Pinpoint menghentikan streaming peristiwa ke Kinesis, tetapi Anda dapat melihat analisis peristiwa dengan menggunakan konsol Amazon Pinpoint.

## AWS CLI
<a name="event-streams-disable-cli"></a>

Gunakan [https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-event-stream.html](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-event-stream.html)perintah:

```
aws pinpoint delete-event-stream --application-id application-id
```

## AWS SDK untuk Java
<a name="event-streams-disable-java"></a>

Gunakan [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html)metode klien Amazon Pinpoint:

```
pinClient.deleteEventStream(new DeleteEventStreamRequest().withApplicationId(appId));
```