> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# خطط الإدخال

> أنماط إدخال الأحداث الجاهزة للاستخدام لحالات الاستخدام الشائعة مع أمثلة على الشيفرة.

خطط الإدخال هي أنماط مسبقة البناء لتتبع الاستخدام في السيناريوهات الشائعة. بدلاً من محاولة معرفة هياكل الأحداث وتكوينات العدادات من الصفر، ابدأ بخطة مثبتة وقم بتخصيصها لاحتياجاتك.

## ما هي الخطط؟

تتضمن كل خطة:

* **توصيات هيكل الحدث**: تسمية الأحداث المثلى وتصميم البيانات الوصفية
* **تكوين العداد**: أنواع التجميع المقترحة والفلاتر
* **أمثلة على الشيفرة**: أمثلة تنفيذية تعمل بعدة لغات
* **أفضل الممارسات**: نصائح للدقة والأداء وتحسين التكاليف

<Tip>
  توفر المخططات الزمنية ساعات من الإعداد وتساعدك على تجنب الأخطاء الشائعة. ابدأ بمخطط، ثم عدّله وفقًا لمتطلباتك الخاصة.
</Tip>

## لماذا تستخدم الخطط؟

<CardGroup cols={3}>
  <Card title="Faster Setup" icon="rocket">
    اجعل تتبع الاستخدام يعمل في دقائق بدلًا من ساعات. انسخ أنماطًا مثبتة بدلًا من التصميم من الصفر.
  </Card>

  <Card title="Best Practices Built In" icon="shield-check">
    تجنب الأخطاء الشائعة من خلال هياكل الأحداث المختبرة، والبيانات الوصفية المناسبة، وخيارات التجميع المثلى.
  </Card>

  <Card title="Production Ready" icon="code">
    يعتمد الكود النموذجي على تطبيقات من العالم الحقيقي. أضف مفاتيح واجهة برمجة التطبيقات الخاصة بك وانطلق.
  </Card>
</CardGroup>

## الخطط المتاحة

اختر الخطة التي تتناسب مع حالة الاستخدام الخاصة بك:

<CardGroup cols={1}>
  <Card title="LLM Blueprint" icon="brain-circuit" href="/developer-resources/ingestion-blueprints/llm">
    تتبع استخدام رموز الذكاء الاصطناعي عبر OpenAI وAnthropic وGroq وGemini وVercel AI SDK وغيرها.

    **مثالي لـ**: روبوتات الدردشة الذكية، مولدات الشيفرة، أدوات إنشاء المحتوى، التطبيقات المدعومة بالذكاء الاصطناعي.

    **ما ستقوم بتتبعه**: رموز الإدخال، رموز الإخراج، استخدام النماذج، عدد الطلبات.
  </Card>

  <Card title="API Gateway Blueprint" icon="cloud" href="/developer-resources/ingestion-blueprints/api-gateway">
    قِس طلبات واجهة برمجة التطبيقات على مستوى البوابة مع دعم تصفية النقاط النهائية وتحديد المعدل.

    **مثالي لـ**: واجهات برمجة التطبيقات REST، خدمات GraphQL، مزودي الويب هوك، المنصات التي تركز على API.

    **ما ستقوم بتتبعه**: عدد الطلبات، استخدام النقاط النهائية، طرق HTTP، أوقات الاستجابة.
  </Card>

  <Card title="Object Storage Blueprint" icon="box-archive" href="/developer-resources/ingestion-blueprints/object-storage">
    تتبع عمليات تحميل الملفات، واستهلاك التخزين، وعرض النطاق الترددي لخدمات التخزين السحابي.

    **مثالي لـ**: استضافة الملفات، منصات الوسائط، خدمات النسخ الاحتياطي، إدارة الوثائق.

    **ما ستقوم بتتبعه**: البايتات المخزنة، تحميلات الملفات، التنزيلات، لقطات التخزين.
  </Card>

  <Card title="Stream Blueprint" icon="tower-broadcast" href="/developer-resources/ingestion-blueprints/stream">
    قِس عرض النطاق الترددي للبث للفيديو والصوت وتسليم البيانات في الوقت الحقيقي.

    **مثالي لـ**: بث الفيديو، منصات الصوت، البث المباشر، تدفقات البيانات في الوقت الحقيقي.

    **ما ستقوم بتتبعه**: عرض النطاق الترددي المستهلك، مدة البث، مستويات الجودة، التدفقات المتزامنة.
  </Card>

  <Card title="Time Range Blueprint" icon="clock" href="/developer-resources/ingestion-blueprints/time-range">
    الفوترة حسب الوقت المنقضي لموارد الحوسبة والوظائف بدون خادم والمهام الطويلة.

    **مثالي لـ**: المنصات بدون خادم، استضافة الحاويات، مثيلات الحوسبة، المعالجة الدفعة.

    **ما ستقوم بتتبعه**: زمن التنفيذ، ساعات الحوسبة، استدعاءات الوظائف، مدة المهمة.
  </Card>
</CardGroup>

## كيفية استخدام خطة

<Steps>
  <Step title="Choose your blueprint">
    اختر المخطط الذي يتوافق أفضل مع سيناريو الفوترة الخاص بك. تحتوي كل صفحة مخطط على أدلة تنفيذ مفصلة.
  </Step>

  <Step title="Review the event structure">
    افهم التسمية الموصى بها للأحداث وتصميم البيانات الوصفية. انسخ هيكل الحدث لحالتك.
  </Step>

  <Step title="Create the meter">
    اتبع تعليمات تكوين العداد الخاصة بالمخطط. استخدم نوع التجميع والفلاتر المقترحة.
  </Step>

  <Step title="Implement event sending">
    انسخ الكود النموذجي للغة/الإطار الذي تستخدمه. استبدل القيم النائبة بمفاتيح واجهة برمجة التطبيقات الفعلية ومعرّفات العملاء.
  </Step>

  <Step title="Test and verify">
    أرسل أحداثًا اختبارية وتأكد من ظهورها في لوحة عدادك مع التجميع الصحيح.
  </Step>

  <Step title="Customize as needed">
    عدّل المخطط وفقًا لمتطلباتك الخاصة—أضف بيانات وصفية مخصصة، عدّل الفلاتر، أو غيّر التسعير.
  </Step>
</Steps>

## مقارنة الخطط

لست متأكدًا من أي خطة تناسب احتياجاتك؟ إليك مقارنة سريعة:

| حالة الاستخدام               | الخطة          | التجميع                    | البيانات الوصفية الشائعة               |
| ---------------------------- | -------------- | -------------------------- | -------------------------------------- |
| تطبيق دردشة الذكاء الاصطناعي | LLM            | مجموع (الرموز)             | النموذج، رموز الإدخال، رموز الإخراج    |
| واجهة برمجة التطبيقات REST   | بوابة API      | عدد                        | النقطة النهائية، الطريقة، رمز الحالة   |
| تخزين الملفات                | تخزين الكائنات | مجموع (بايت)               | حجم الملف، نوع الملف، العملية          |
| منصة الفيديو                 | البث           | مجموع (عرض النطاق الترددي) | المدة، الجودة، معدل البت               |
| بدون خادم                    | نطاق الوقت     | مجموع (المدة)              | اسم الوظيفة، وقت التنفيذ بالمللي ثانية |

## تنفيذات مخصصة

لا ترى خطة لحالة الاستخدام الخاصة بك بالضبط؟ لا مشكلة:

1. **ابدأ بأقرب خطة**: اختر الأكثر تشابهًا مع احتياجاتك
2. **قم بتكييف هيكل الحدث**: عدل حقول البيانات الوصفية لتتناسب مع متطلباتك
3. **قم بتعديل تكوين العداد**: غير نوع التجميع أو الفلاتر حسب الحاجة
4. **اختبر بدقة**: تحقق من حسابات الفوترة مع الاستخدام النموذجي

<Info>
  جميع المخططات هي نقاط انطلاق. لا تتردد في مزج مفاهيم من مخططات مختلفة أو إنشاء تطبيقات مخصصة تمامًا.
</Info>

## تحتاج إلى مساعدة؟

إذا كنت غير متأكد من أي خطة تستخدمها أو تحتاج إلى مساعدة في التخصيص:

<CardGroup cols={2}>
  <Card title="Complete Tutorial" icon="code" href="/developer-resources/usage-based-billing-build-ai-image-generator">
    اتبع دليلنا الشامل لبناء مولد صور بالذكاء الاصطناعي مع فوتره الاستخدام.
  </Card>

  <Card title="Integration Guide" icon="book" href="/developer-resources/usage-based-billing-guide">
    دليل شامل يغطي جميع جوانب تنفيذ الفوترة القائمة على الاستخدام.
  </Card>
</CardGroup>