Skip to main content
Stream Blueprint mengirimkan usage event ke Dodo Payments dengan jumlah byte yang dikonsumsi pelanggan dari sebuah stream. Meter Sum pada bytes menjumlahkan bandwidth setiap pelanggan, sehingga Anda dapat menagihnya. Blueprint ini tersedia dalam paket npm @dodopayments/ingestion-blueprints sebagai trackStreamBytes().

​
Kasus Penggunaan

Stream Blueprint cocok untuk skenario berikut:

Video Platforms

Tagih pelanggan berdasarkan konsumsi bandwidth video dan kualitas streaming.

Music Streaming

Lacak penggunaan audio streaming per pengguna untuk tingkatan langganan.

Live Events

Pantau konsumsi live stream dan kenakan biaya berdasarkan penggunaan bandwidth.

Real-Time Data

Lacak transfer data real-time untuk aplikasi IoT dan telemetri.
Gunakan untuk platform video dan audio streaming, layanan live streaming, serta aplikasi data real-time.

​
Mulai Cepat

Untuk melacak penggunaan streaming, instal paket, buat meter, lalu kirimkan jumlah byte yang dikonsumsi setiap pelanggan.
1

Install the SDK

Instal paket Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Buat API key Dodo Payments di Developer → API Keys pada dashboard Dodo Payments, lalu simpan di environment variable DODO_PAYMENTS_API_KEY. Gunakan test mode key selama proses pengembangan. Test mode key hanya berfungsi dengan test_mode.
3

Create a Meter

Di dashboard Dodo Payments, buka Products → Meters lalu klik Create Meter. Atur field berikut:
  • Meter Name: nama deskriptif, seperti Stream Bandwidth.
  • Event Name: stream_consumption, atau nama pilihan Anda. Nama tersebut harus sama persis dengan eventName dalam kode Anda (peka huruf besar-kecil).
  • Aggregation Type: Sum, untuk menjumlahkan byte yang dialirkan.
  • Over Property: bytes, untuk menagih berdasarkan penggunaan bandwidth.
  • Measurement Unit: unit yang ditampilkan pada invoice, seperti bytes.
4

Track Stream Usage

Panggil trackStreamBytes() dengan customer dan jumlah byte yang dikonsumsi:

​
Konfigurasi

​
Konfigurasi Ingestion

Teruskan opsi berikut ke new Ingestion():
​
string
wajib
API key Dodo Payments Anda dari dashboard.
​
string
Mode environment: test_mode atau live_mode. Default-nya adalah test_mode. Sebaliknya, Dodo Payments SDKs menggunakan default live_mode, jadi tetapkan live_mode secara eksplisit di production.
​
string
wajib
Nama event yang sesuai dengan Event Name meter Anda (peka huruf besar-kecil).

​
Opsi Track Stream Bytes

Teruskan opsi berikut ke trackStreamBytes():
​
string
wajib
ID customer Dodo Payments yang akan ditagih untuk stream, misalnya cus_123.
​
number
Jumlah byte yang dikonsumsi dalam stream. Wajib diisi untuk billing berbasis bandwidth. Jika Anda menghilangkannya, event tidak memiliki nilai bytes, tetapi tetap dihitung dalam meter Count.
​
object
Metadata opsional tentang stream, seperti jenis stream, kualitas, atau ID sesi. Setiap nilai harus berupa string, number, atau boolean.

​
Praktik Terbaik

Lacak berdasarkan Chunk: Untuk stream yang panjang, lacak konsumsi dalam beberapa chunk, bukan menunggu hingga seluruh stream selesai.
Setiap panggilan ke trackStreamBytes() mengirimkan event terpisah, dan meter Sum menjumlahkan semua chunk tersebut.
Penghitungan Byte yang Akurat: Jika Anda menagih total bandwidth, sertakan semua overhead, seperti header dan overhead protokol, dalam jumlah byte Anda.
Terakhir diubah pada 26 September 2026