دمج Reward و Interstitial
المتطلبات
- وجود تطبيق مصغر Telegram
- معرفة مكان عرض الإعلان، إذا لم تكن تعرف، فراجع أمثلة دمج الإعلانات
- وجود
blockId، إذا لم يكن لديك، فراجع قسم الحصول على blockId
التثبيت
لديك خياران لدمج AdsGram SDK.
إدراج السكريبت
ضع السكريبت sad.min.js في وسم <head> باستخدام هذا الكود:
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>التثبيت عبر npm لـ React و Vue.
مزيد من المعلومات حول الدمج من الحزم في وثائق React و Vue.
npm install @adsgram/reactnpm install @adsgram/vueتهيئة AdsGram SDK
const AdController = window.Adsgram.init({ blockId: "your-block-id" });مهم
التهيئة مطلوبة فقط لصيغتي Rewarded و Interstitial. أما صيغة Task فلا تحتاج إلى تهيئة.
لأمثلة دمج صيغة Task، راجع دمج Task.
مزيد من المعلومات حول دالة init يمكنك العثور عليها في قسم مرجع API.
your-block-id — تحصل عليه من حسابك على https://partner.adsgram.ai
تعليمات مفصلة حول كيفية الحصول على blockId يمكنك العثور عليها في قسم الحصول على blockId
عرض banner
- صيغة Rewarded، والتي تعني أنه يجب عليك منح المستخدم مكافأة عندما يشاهد الإعلان حتى النهاية.
مزيد من المعلومات حول متطلبات عرض الإعلان. - صيغة Interstitial، والتي تعني أنه يمكن للمستخدم تخطي الإعلان قبل النهاية.
مزيد من المعلومات حول متطلبات عرض الإعلان.
معلومات
أدناه أمثلة على الكود لصيغة Rewarded. هذه الأمثلة تنطبق أيضاً على صيغة Interstitial. الفرق الوحيد هو أن وعد AdController.show() يتم حله للإعلانات التي تمت مشاهدتها حتى النهاية وتلك التي تم إغلاقها. المثال البسيط يمكنك العثور عليه هنا
في معظم الحالات، يُستخدم الكود أدناه داخل معالج النقر.
لأمثلة الكود مع vanilla js و React و Unity تحقق من قسم أمثلة الكود.
AdController.show().then((result) => {
// شاهد المستخدم الإعلان حتى النهاية أو أغلقه في صيغة interstitial
// الكود الخاص بك لمكافأة المستخدم في صيغة rewarded
}).catch((result) => {
// حصل المستخدم على خطأ أثناء تشغيل الإعلان
// لا تفعل شيئاً أو افعل ما تريد
})AdController.show().then((result: ShowPromiseResult) => {
// شاهد المستخدم الإعلان حتى النهاية أو أغلقه في صيغة interstitial
// الكود الخاص بك لمكافأة المستخدم في صيغة rewarded
}).catch((result: ShowPromiseResult) => {
// حصل المستخدم على خطأ أثناء تشغيل الإعلان أو تخطى الإعلان
// لا تفعل شيئاً أو افعل ما تريد
})يحتوي result على الأنواع التالية:
interface ShowPromiseResult {
done: boolean; // صحيح إذا شاهد المستخدم حتى النهاية أو أغلقه في صيغة interstitial، خلاف ذلك خطأ
description: string; // وصف الحدث
state: 'load' | 'render' | 'playing' | 'destroy'; // حالة banner
error: boolean; // صحيح إذا تم إصدار الحدث بسبب خطأ، خلاف ذلك خطأ
}معلومات
يتم حل showPromise إذا شاهد المستخدم الإعلان حتى النهاية أو أغلقه في صيغة interstitial، وإلا يتم رفضه.
نصيحة
قم بربط الوعد بـ finally إذا كنت بحاجة إلى إضافة أي إجراء إضافي بعد انتهاء تشغيل الإعلان أو تخطيه أو حدوث خطأ.
تهانينا، لقد عرضت إعلانك الأول باستخدام AdsGram!
مزيد من المعلومات
- أمثلة دمج الكود لـ React و Unity و vanilla js
- إذا واجهت مشاكل في الدمج تحقق من قسم استكشاف الأخطاء
- مرجع AdController api المتقدم يمكنك العثور عليه في قسم مرجع API
- إذا كنت تستخدم Typescript تحقق من قسم Typescript