Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Mixpanel
Mixpanel adalah platform analitik real-time yang kuat yang membantu perusahaan mengukur dan mengoptimalkan keterlibatan pengguna. Mixpanel adalah aplikasi yang digunakan untuk melacak perilaku pelanggan. Ini memungkinkan Anda untuk melacak bagaimana pengguna terlibat dengan produk Anda dan menganalisis data ini dengan laporan interaktif yang memungkinkan Anda menanyakan dan memvisualisasikan hasilnya hanya dengan beberapa klik. Sebagai pengguna Mixpanel, Anda dapat terhubung AWS Glue ke akun Mixpanel Anda. Kemudian, Anda dapat menggunakan Mixpanel sebagai sumber data dalam pekerjaan ETL Anda. Jalankan pekerjaan ini untuk mentransfer data antara Mixpanel dan AWS layanan atau aplikasi lain yang didukung.
**Topics**
+ [AWS Glue dukungan untuk Mixpanel](Mixpanel-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](mixpanel-configuring-iam-permissions.md)
+ [Mengkonfigurasi Mixpanel](mixpanel-configuring.md)
+ [Mengkonfigurasi koneksi Mixpanel](mixpanel-configuring-connections.md)
+ [Membaca dari entitas Mixpanel](mixpanel-reading-from-entities.md)
+ [Opsi koneksi Mixpanel](mixpanel-connection-options.md)
+ [Membuat akun Mixpanel dan mengonfigurasi aplikasi klien](mixpanel-create-account.md)
+ [Batasan](mixpanel-connector-limitations.md)
# AWS Glue dukungan untuk Mixpanel
AWS Glue mendukung Mixpanel sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Mixpanel.
**Didukung sebagai target?**
Tidak.
**Versi API Mixpanel yang didukung**
2.0
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode sebelumnya, sebagai alternatif, gunakan kebijakan IAM terkelola berikut:
+ [ AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [ AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Mixpanel
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari Mixpanel, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
+ Anda memiliki akun Mixpanel. Untuk informasi selengkapnya tentang membuat akun, lihat [Membuat akun Mixpanel](mixpanel-create-account.md).
+ Akun Mixpanel Anda diaktifkan untuk akses API. Akses API diaktifkan secara default untuk edisi Enterprise, Unlimited, Developer, dan Performance.
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Mixpanel Anda. Untuk koneksi tipikal, Anda tidak perlu melakukan hal lain di Mixpanel.
# Mengkonfigurasi koneksi Mixpanel
Mixpanel mendukung nama pengguna dan kata sandi untuk`BasicAuth`. Basic Authentication adalah metode otentikasi sederhana di mana klien memberikan kredensi langsung untuk mengakses sumber daya yang dilindungi. AWS Glue dapat menggunakan nama pengguna dan kata sandi untuk mengautentikasi APIs Mixpanel.
Untuk dokumentasi Mixpanel publik tentang `BasicAuth` alur, lihat Akun [Layanan Mixpanel](https://developer.mixpanel.com/reference/service-accounts).
Untuk mengkonfigurasi koneksi Mixpanel:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
+ Untuk Otentikasi Dasar, Rahasia harus berisi Rahasia Konsumen aplikasi yang terhubung dengan `USERNAME` dan `PASSWORD` sebagai kunci.
**catatan**
Ini adalah suatu keharusan untuk membuat rahasia per koneksi di AWS Glue.
1. Dalam AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih **Mixpanel**.
1. Berikan Mixpanel yang ingin Anda sambungkan. `INSTANCE_URL`
1. Pilih peran IAM yang AWS Glue dapat diasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih **opsi Jaringan** jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Mixpanel
**Prasyarat**
Anda harus memiliki objek Mixpanel, seperti`Funnels`,`Retention`, atau`Retention Funnels`, dari mana Anda ingin membaca data. Selain itu, Anda perlu mengetahui nama objek.
**Entitas yang didukung**
| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih \$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- |
| Corong | Ya | Tidak | Tidak | Ya | Tidak |
| Penyimpanan | Ya | Tidak | Tidak | Ya | Tidak |
| Segmentasi | Ya | Tidak | Tidak | Ya | Tidak |
| Jumlah Segmentasi | Ya | Tidak | Tidak | Ya | Tidak |
| Rata-rata Segmentasi | Ya | Tidak | Tidak | Ya | Tidak |
| Kohort | Ya | Tidak | Tidak | Ya | Tidak |
| Terlibat | Tidak | Ya | Tidak | Ya | Tidak |
| Peristiwa | Ya | Tidak | Tidak | Ya | Tidak |
| Acara Top | Ya | Tidak | Tidak | Ya | Tidak |
| Nama Acara | Ya | Tidak | Tidak | Ya | Tidak |
| Properti Acara | Ya | Tidak | Tidak | Ya | Tidak |
| Acara Properti Top | Ya | Tidak | Tidak | Ya | Tidak |
| Nilai Properti Acara | Ya | Tidak | Tidak | Ya | Tidak |
| Anotasi | Ya | Tidak | Tidak | Ya | Tidak |
| Profil Kegiatan Acara | Ya | Tidak | Tidak | Ya | Tidak |
**Contoh**
```
mixpanel_read = glueContext.create_dynamic_frame.from_options(
connection_type="mixpanel",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "/cohorts/list?project_id=2603353",
"API_VERSION": "2.0",
"INSTANCE_URL": "https://www.mixpanel.com/api/app/me"
}
```
**Entitas Mixpanel dan detail bidang**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/mixpanel-reading-from-entities.html)
# Opsi koneksi Mixpanel
Berikut ini adalah opsi koneksi untuk Mixpanel:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Object Anda di Mixpanel.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Versi Mixpanel Rest API yang ingin Anda gunakan. Misalnya: v2.0.
+ `SELECTED_FIELDS`(Daftar) — Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
# Membuat akun Mixpanel dan mengonfigurasi aplikasi klien
**Membuat akun Mixpanel**
1. Arahkan ke [halaman beranda Mixpanel/](https://mixpanel.com/).
1. Pada halaman beranda **Mixpanel**, pilih **Daftar** di sudut kanan atas halaman.
1. Pada halaman **Mari kita mulai**, selesaikan tindakan berikut:
+ Masukkan alamat email Anda di bidang yang ditunjuk.
+ Pilih kotak centang yang diperlukan untuk menyetujui persyaratan.
+ Pilih **Memulai** untuk melanjutkan.
Setelah berhasil diselesaikan, Anda akan menerima email verifikasi.
1. Periksa kotak masuk email Anda untuk pesan verifikasi, buka email, dan ikuti petunjuk untuk memverifikasi alamat email Anda.
1. Pada halaman verifikasi, pilih **Verifikasi Email** untuk menyelesaikan verifikasi email Anda.
1. Pada halaman **Nama Organisasi Anda**, masukkan nama organisasi Anda dan pilih **Berikutnya**.
1. Pada halaman **Proyek Pertama Anda**, masukkan detail proyek Anda dan pilih **Buat**.
1. Pada halaman berikutnya, pilih **Ayo Mulai** untuk menyelesaikan pembuatan akun Anda.
**Masuk ke akun Mixpanel**
1. Arahkan ke [halaman login Mixpanel/](https://mixpanel.com/login/).
1. Masukkan alamat email Anda dan pilih **Lanjutkan**.
1. Periksa kotak masuk email Anda untuk pesan verifikasi, buka email, dan ikuti petunjuk untuk memverifikasi alamat email Anda.
1. Pada halaman berikutnya, pilih **tombol Masuk** untuk masuk ke akun Anda.
**Membeli paket Mixpanel**
1. Pada halaman Mixpanel, pilih ikon **Pengaturan** yang terletak di sudut kanan atas halaman.
1. Dari daftar opsi, pilih **Rincian Paket dan Penagihan**.
1. Pada halaman **Rincian Paket dan Penagihan**, pilih **Tingkatkan atau Ubah**.
1. Di halaman berikutnya, pilih paket yang ingin Anda beli.
Ini melengkapi pembuatan akun dan merencanakan proses pembelian.
**Membuat nama pengguna dan rahasia klien (Untuk mendaftarkan aplikasi Anda)**
1. Pada halaman Mixpanel, pilih ikon **Pengaturan** yang terletak di sudut kanan atas halaman.
1. Dari daftar opsi, pilih **Pengaturan Proyek**.
1. Pada halaman **Pengaturan Proyek**, pilih **Akun Layanan** dan kemudian pilih **Tambahkan Akun Layanan**.
1. **Dari daftar tarik-turun **Akun Layanan**, pilih **layanan Akun atau masukkan nama yang akan dibuat**, tambahkan **Peran Proyek**, tentukan **kedaluwarsa**, dan pilih Tambah.**
**penting**
Setelah menyelesaikan langkah sebelumnya, halaman berikut menampilkan kunci rahasia akun layanan. Pastikan untuk menyimpan kunci rahasia akun layanan. Anda tidak akan dapat mengaksesnya lagi setelah titik ini.
# Batasan
Berikut ini adalah batasan untuk konektor Mixpanel:
+ Untuk `Segmentation Numeric` entitas, API Mixpanel menampilkan `400 (Bad Request)` kesalahan jika tidak ada data numerik yang ditemukan untuk filter wajib. Kami memperlakukan ini sebagai `OK` respons untuk mencegah kegagalan aliran.
+ Bidang queryable `limit` telah dihapus dari entitas yang didukung karena:
+ Itu menyebabkan kesalahan karena ditafsirkan sebagai fitur batas SDK
+ Filter tidak memiliki tujuan praktis
+ Fungsionalitas yang setara sekarang dicakup oleh implementasi fitur batas
+ Partisi berbasis lapangan tidak dapat didukung karena tidak adanya operator yang diperlukan (`>=`,,, `<=` `<``>`,`between`) untuk partisi dari platform SaaS. Meskipun mendukung `between` operator, bidang yang didukungnya operator ini tidak dapat diambil kembali. Oleh karena itu, kriteria untuk partisi berbasis lapangan tidak terpenuhi.
+ Karena tidak ada ketentuan untuk mendapatkan nilai 'offset' untuk entitas yang mendukung pagination, tidak mungkin untuk mendukung partisi berbasis rekaman untuk Mixpanel.
+ `Cohorts`entitas hanya mendukung `CreatedDate/Time` bidang dan tidak ada bidang untuk diidentifikasi `UpdatedDate/Time` sebagai hasilnya `DML_Status` tidak dapat diidentifikasi. Juga, tidak ada titik akhir untuk mengidentifikasi catatan yang dihapus. Oleh karena itu, CDC tidak dapat didukung.
+ Untuk menjalankan AWS Glue pekerjaan untuk entitas yang disebutkan di bawah ini, filter wajib diperlukan. Lihat tabel di bawah ini untuk nama entitas dan filter yang diperlukan.
**Nama entitas dan filter yang diperlukan**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/mixpanel-connector-limitations.html)