الانتقال إلى المحتوى الرئيسي

حالات الاستخدام

استكشف السيناريوهات الشائعة المدعومة من مخطط البث:

Video Platforms

فوِّت العملاء بناءً على استهلاك عرض النطاق لفيديوهات وجودة البث.

Music Streaming

راقب استخدام بث الصوت لكل مستخدم حسب مستويات الاشتراك.

Live Events

راقب استهلاك البث المباشر وفرض رسوم على استخدام عرض النطاق.

Real-Time Data

تعقب نقل البيانات في الوقت الفعلي لتطبيقات إنترنت الأشياء والقياسات عن بعد.
مثالي لمنصات بث الفيديو/الصوت وخدمات البث المباشر وتطبيقات البيانات في الوقت الفعلي.

البداية السريعة

تتبع بايتات البث المستهلكة من قبل عملائك:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

3

Create a Meter

أنشئ عدادًا في لوحة تحكم Dodo Payments Dashboard:
  • Event Name: stream_consumption (أو الاسم الذي تفضله)
  • Aggregation Type: sum لتتبع إجمالي البايتات التي تم بثها
  • Over Property: bytes للفوترة بناءً على استخدام عرض النطاق
4

Track Stream Usage

import { Ingestion, trackStreamBytes } from '@dodopayments/ingestion-blueprints';

const ingestion = new Ingestion({
  apiKey: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
  eventName: 'stream_consumption'
});

// Track video stream consumption
await trackStreamBytes(ingestion, {
  customerId: 'customer_123',
  bytes: 10485760, // 10MB
  metadata: {
    stream_type: 'video',
  }
});

التكوين

تكوين الإدخال

apiKey
string
مطلوب
مفتاح واجهة برمجة تطبيقات Dodo Payments الخاص بك من لوحة التحكم.
environment
string
مطلوب
وضع البيئة: test_mode أو live_mode.
eventName
string
مطلوب
اسم الحدث الذي يطابق تكوين العداد الخاص بك.

خيارات تتبع بايتات البث

customerId
string
مطلوب
معرّف العميل لنسب الفوترة.
bytes
number
عدد البايتات المستهلكة في البث. مطلوب للفوترة بناءً على عرض النطاق.
metadata
object
بيانات وصفية اختيارية عن البث مثل نوع البث والجودة ومعرّف الجلسة، إلخ.

أفضل الممارسات

التتبع حسب القطع: بالنسبة للبث الطويل، تتبّع الاستهلاك على شكل قطع بدلًا من الانتظار حتى ينتهي البث بأكمله.
العد الدقيق للبايتات: تأكد من أن عدد البايتات يشمل كل الحمل الزائد (الرؤوس، وحمل البروتوكول) إذا كنت تفوّت على إجمالي عرض النطاق.