تحويل أحداث الاستخدام الخام إلى كميات قابلة للفوترة مع التجميع والتصفية.
تحوّل العدادات الأحداث الأولية إلى كميات قابلة للفوترة. وهي تعمل على تصفية الأحداث وتطبيق دوال التجميع (Count وSum وMax وLast) لحساب الاستخدام لكل عميل.
تسمية الوحدة المستخدمة في الفواتير والتقارير. أمثلة: calls وtokens وGB وhours.
3
Filtering (Optional)
أضف شروطاً لتصفية الأحداث التي يتم احتسابها:
منطق AND: يجب أن تتطابق جميع الشروط
منطق OR: يمكن أن تتطابق أي شرط
عوامل المقارنة المتاحة: يساوي، لا يساوي، أكبر من، أكبر من أو يساوي، أقل من، أقل من أو يساوي، يتضمن، لا يتضمن.فعّل التصفية، واختر المنطق الذي تريده، ثم أضف الشروط باستخدام مفتاح خاصية وعامل مقارنة وقيمة.
بشكل افتراضي، تفرض العدادات رسومًا على العملاء لكل وحدة بالدولار (أو بالعملة التي ضبطتها). ويمكنك بدلًا من ذلك إعداد العداد للخصم من رصيد ائتمان العميل، بحيث يستهلك الاستخدام أرصدة بدلًا من إنشاء رسم مالي.
يتطلب الخصم المستند إلى الائتمان وجود Credit Entitlement مرتبط بالمنتج نفسه. أنشئ استحقاق الائتمان أولًا، ثم اربطه بالعداد.
أنشئ أولًا استحقاق ائتمان في Products → Credits. حدّد الوحدة (مثل “API Calls” و”Tokens”) والدقة وإعدادات دورة الحياة (تاريخ الانتهاء والترحيل وتجاوز الحد).اطّلع على دليل الفوترة المستندة إلى الاعتمادات للحصول على تعليمات مفصلة.
2
Create or Edit a Usage-Based Product
اذهب إلى منتجك المستند إلى الاستخدام وافتح قسم تكوين Meter.
3
Add a Meter
انقر على زر + لإرفاق عداد. قم بتكوين اسم الحدث، نوع التجميع، ووحدة القياس كالمعتاد.
4
Enable 'Bill Usage in Credits'
فعّل Bill usage in Credits في إعدادات العداد لإظهار إعدادات الائتمان:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
عدد وحدات الاستخدام المطلوبة لخصم اعتماد واحد. على سبيل المثال:
1 = كل حدث عداد يخصم اعتمادًا واحدًا
100 = 100 حدث عداد يخصمان اعتمادًا واحدًا
1000 = 1,000 مكالمة API تستهلك اعتمادًا واحدًا
5
Free Threshold and Credits
ينطبق Free Threshold على العدادات التي تتم فوترتها بالمال، وليس على العدادات التي تتم فوترتها بالأرصدة. عندما تتم فوترة العداد بالأرصدة، تُحتسب كل وحدة ضمن خصم الائتمان.مثال: مع ضبط meter-units-per-credit على 1، يُخصم من العميل الذي يجري 2,500 مكالمة API عدد 2,500 رصيد.
معالجة العامل في الخلفية — يجلب عامل كل دقيقة الأحداث الجديدة منذ آخر نقطة تحقق.
خصم الأرصدة — يُحوّل الاستخدام المُجمّع إلى أرصدة باستخدام معدل meter_units_per_credit، ثم يُخصم بترتيب FIFO (استهلاك المنح التي ينتهي أجلها أولًا).
تتبّع التجاوز — إذا وصل الرصيد إلى الصفر، يُسجّل الاستخدام اللاحق كتجاوز ويُعالج وفقًا للسلوك المُعدّ (إعفاؤه عند إعادة الضبط، أو فوترته في الفاتورة التالية، أو ترحيله كعجز). لا تحظر Dodo Payments الاستخدام عند نفاد الرصيد. ولإيقاف الوصول عند الوصول إلى الصفر، تحقّق من الرصيد في تطبيقك.
يُنفّذ خصم الائتمان بشكل غير متزامن (كل دقيقة تقريبًا). وقد يحدث تأخير قصير بين استيعاب الحدث وخصم الرصيد. صمّم تطبيقك للتعامل مع هذا التأخير، ولا تعتمد على عمليات التحقق من الرصيد في الوقت الفعلي للتحكم في الوصول إلى الطلبات الفردية.
يمكنك ربط عدة عدادات باستحقاق الائتمان نفسه ضمن المنتج نفسه. وتخصم جميع العدادات من رصيد مشترك واحد.مثال: منصة ذكاء اصطناعي تضم عدادين:
text.generation — رصيد واحد لكل 1,000 رمز مميز
image.generation — 10 أرصدة لكل صورة
كلاهما يخصم من نفس تجمع “اعتمادات الذكاء الاصطناعي”. يرى العميل رصيدًا موحدًا واحدًا في بوابته.
استخدم معدلات meter_units_per_credit مختلفة عبر العدادات للتعبير عن التكاليف النسبية. العمليات المكلفة (توليد الصور) تستهلك وحدات عداد أقل لكل اعتماد من العمليات الرخيصة (استكمال النص).
List Customer Ledger
اطّلع على السجل الكامل لخصم الاعتمادات لعميل.
Get Customer Balance
تحقق من رصيد الاعتمادات الحالي لعميل عبر واجهة برمجة التطبيقات.
