Aliran data acara kampanye dari Amazon Pinpoint - Amazon Pinpoint
Contoh acara kampanyeAtribut acara kampanye

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

Aliran data acara kampanye dari Amazon Pinpoint

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 untuk email atau SMS pesan yang dikirim dari kampanye dari tujuan yang ditentukan selama penyiapan agar dapat dilihat. Untuk informasi terperinci tentang data yang dialirkan Amazon Pinpoint untuk email dan SMS pesan, lihat dan. Aliran data acara email dari Amazon Pinpoint SMSaliran data acara dari Amazon Pinpoint Untuk informasi tentang cara mengatur streaming acara, lihat Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose .

Contoh acara kampanye

JSONObjek 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

Bagian ini mendefinisikan atribut yang disertakan dalam aliran acara kampanye.

Atribut Deskripsi
event_type

Jenis peristiwa. Kemungkinan nilainya adalah:

  • _campaign.send - Amazon Pinpoint mengeksekusi kampanye.

  • _campaign.opened_notification — Untuk kampanye pemberitahuan push, jenis acara ini menunjukkan bahwa penerima mengetuk notifikasi untuk membukanya.

  • _campaign.received_foreground — Untuk kampanye pemberitahuan push, jenis acara ini menunjukkan bahwa penerima menerima pesan sebagai pemberitahuan latar depan.

  • _campaign.received_background — Untuk kampanye pemberitahuan push, jenis acara ini menunjukkan bahwa penerima menerima pesan sebagai pemberitahuan latar belakang.

    catatan

    _campaign.opened_notification, _campaign.received_foreground, dan _campaign.received_background dikembalikan hanya jika Anda menggunakan. AWS Amplify Untuk informasi selengkapnya tentang mengintegrasikan aplikasi Anda dengan AWS Amplify. Lihat Hubungkan aplikasi frontend Anda ke Amazon AWS Pinpoint menggunakan Amplify.
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 titik akhir yang terkait dengan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel Klien.
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.
client_context 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

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

Atribut Deskripsi
app_id

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

SDKYang digunakan untuk melaporkan peristiwa tersebut.

Atribut

Termasuk informasi tentang kampanye yang menghasilkan acara tersebut.

Atribut Deskripsi
treatment_id

Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk kampanye standar, nilai ini adalah0.
campaign_activity_id ID unik yang dihasilkan Amazon Pinpoint saat peristiwa terjadi.
delivery_type

Metode pengiriman untuk kampanye. Jangan bingung atribut ini dengan ChannelType bidang yang ditentukan di bawah endpoint properti. client_context ChannelTypeBidang 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 yang samaEMAIL.

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, sepertiEMAIL,SMS,CUSTOM, dan sebagainya. Dalam hal ini, delivery_type mengidentifikasi peristiwa pengiriman kustomCUSTOM, dan ChannelType menentukan jenis titik akhir yang dikirimkan kampanye, seperti,, EMAIL SMSCUSTOM, dan sebagainya. Untuk informasi selengkapnya tentang membuat saluran khusus, lihatBuat saluran khusus di Amazon Pinpoint menggunakan fungsi webhook atau Lambda.

Kemungkinan nilainya adalah:

  • EMAIL

  • SMS

  • ADM

  • APNS

  • APNS_SANDBOX

  • APNS_VOIP

  • APNS_VOIP_SANDBOX

  • VOICE

  • GCM

  • BAIDU

  • PUSH

  • CUSTOM
campaign_id

ID unik kampanye tempat pesan dikirim.
campaign_send_status Menunjukkan status kampanye untuk titik akhir target. Nilai yang mungkin termasuk:

  • SUCCESS— Kampanye berhasil dikirim ke titik akhir.

  • FAILURE— Kampanye tidak dikirim ke titik akhir.

  • DAILY_ CAP — Kampanye tidak dikirim ke titik akhir karena jumlah maksimum pesan harian telah dikirim ke titik akhir.

  • EXPIRED— Kampanye tidak dikirim ke titik akhir karena pengirimannya akan melebihi durasi maksimum atau pengaturan tingkat pengiriman untuk kampanye.

  • QUIET_ TIME — Kampanye tidak dikirim ke titik akhir karena pembatasan waktu tenang.

  • HOLDOUT— Kampanye tidak dikirim ke titik akhir karena titik akhir adalah anggota grup penahanan.

  • DUPLICATE_ ADDRESS — Ada duplikat alamat titik akhir di segmen. Kampanye dikirim sekali ke alamat titik akhir.

  • QUIET_ TIME — Kampanye tidak dikirim ke titik akhir karena pembatasan waktu tenang.

  • CAMPAIGN_ CAP — Kampanye tidak dikirim ke titik akhir karena jumlah maksimum pesan telah dikirim ke titik akhir dari kampanye ini.

  • FAILURE_ PERMANENT — Kegagalan permanen terjadi saat mengirim ke titik akhir.

  • TRANSIENT_ FAILURE — Kegagalan sementara terjadi saat mengirim ke titik akhir.

  • THROTTLED— Mengirim dibatasi.

  • UNKNOWNKegagalan yang tidak diketahui.

  • HOOK_ FAILURE — Kait kampanye gagal.

  • CUSTOM_ DELIVERY _ FAILURE — Pengiriman kustom gagal.

  • RECOMMENDATION_ FAILURE — Rekomendasi gagal.

  • UNSUPPORTED_ CHANNEL — Saluran tidak didukung.

Klien

Termasuk informasi tentang titik akhir yang ditargetkan oleh kampanye.

Atribut Deskripsi
client_id ID titik akhir yang dikirimkan kampanye.