google.
توفّر مساحة الاسم google.ima إمكانية الوصول إلى فئات حزمة تطوير البرامج (SDK) والواجهات والتعداد والخصائص الخاصة بحزمة تطوير البرامج (SDK).
صفوف
إعلان
فئة إعلان يتم توسيعها حسب الصفوف التي تمثّل أنواع إعلانات مختلفة.
AdCuePoints
تمثل قائمة النقاط الأساسية جدولاً زمنيًا للفواصل الإعلانية. ويُرجى العِلم بأنّه لا يشمل الجدول الزمني الإعلانات الفردية في الفاصل الإعلاني.
AdDisplayContainer
يمثل هذا الصف حاوية لعرض الإعلانات. ستنشئ حزمة تطوير البرامج (SDK) تلقائيًا بُنى داخل معلّمة الحاويةElement لتضمين الإعلانات المعروضة على سطح الفيديو وإعلانات الفيديو.
عند إنشاء مثيل لهذه الفئة، يتم إنشاء إطار iframe في
ContainerElement وتحميل حزمة SDK الأساسية. يجب الاحتفاظ بإطار iframe هذا
حتى تعمل حزمة تطوير البرامج (SDK) بشكل صحيح. بعد تشغيل جميع الإعلانات
وعدم الحاجة إلى استخدام حزمة تطوير البرامج (SDK)، يمكنك استخدام طريقة destroy()
لإلغاء تحميل حزمة تطوير البرامج (SDK).
يجب أن تكون معلَمة الحاويةElement عنصرًا يمثّل جزءًا من DOM. ويجب وضع العنصر للعنصر بشكل صحيح لكي يتم عرض الإعلانات بشكل صحيح. نقترح عليك وضعه فوق مشغّل الفيديو للمحتوى وتغيير حجمه ليغطي مشغّل الفيديو بأكمله. ارجع إلى مستندات حزمة تطوير البرامج (SDK) للحصول على تفاصيل عن عمليات التنفيذ المقترَحة.
ملاحظة: من الضروري دائمًا استدعاء طريقة initialize() التي تم استدعاءها مباشرةً من خلال إجراء المستخدم (مثل النقر أو النقر).
خطأ
يعرض AdError المعلومات للمستخدم حول ما إذا كان قد حدث خطأ أثناء تحميل الإعلان أو تشغيله. يوفّر موصِّل errorType معلومات حول ما إذا كان الخطأ قد حدث أثناء تحميل الإعلان أو أثناء تشغيل الإعلان.
AdErrorEvent
يظهر هذا الحدث عند حدوث خطأ عند تحميل إعلان من خوادم Google أو DoubleClick. إنّ الأنواع التي يمكنك التسجيل فيها للفعالية هي AdsLoader وAdsManager.
AdEvent
ويتم عرض هذا النوع من الأحداث في الإعلان على شكل إشعار عند تغيُّر حالة الإعلان، وعند تفاعل المستخدمين مع الإعلان. على سبيل المثال، عند بدء تشغيل الإعلان والنقر عليه والمزيد. يمكنك التسجيل في الفعاليات المختلفة التي غيّرتها الولاية على AdsManager.
AdDataEvent
تم إيقاف هذا الصف نهائيًا. يمكنك استخدام AdsManager.getCuePoints() API. حدث إعلان معيّن يتضمن البيانات الوصفية.
AdPodInfo
وقد يكون الإعلان جزءًا من مجموعة من الإعلانات. يعرض هذا الكائن البيانات الوصفية المرتبطة بتلك المجموعة، مثل عدد الإعلانات في مجموعة الإعلانات المتسلسلة وموضع الإعلان داخل مجموعة الإعلانات المتسلسلة.
غالبًا ما تكون واجهة برمجة التطبيقات getTotalAds المضمّنة في هذا العنصر صحيحة، ولكن في بعض السيناريوهات، تمثّل أفضل تخمين حزمة SDK. راجِع
مستندات هذه الطريقة للحصول على مزيد من المعلومات.
بيانات AdProgress
يعرض هذا العنصر معلومات عن مستوى التقدّم الحالي أثناء تشغيل أحد الإعلانات.
AdsLoader
يسمح AdsLoader للعملاء بطلب الإعلانات من خوادم الإعلانات. لإجراء ذلك، على المستخدمين التسجيل في فعالية AdsManagerLoadedEvent ثم طلب الإعلانات.
AdsManager
توفّر للناشرين واجهة برمجة التطبيقات العامة المتاحة للجميع، كما تتواصل مع النُسخة الداخلية من "مدير الإعلانات".
AdsManagerLoadedEvent
يتم رفع هذا الحدث عند تحميل الإعلانات بنجاح من خوادم إعلانات Google أو DoubleClick من خلال AdsLoader. يمكنك التسجيل في هذه الفعالية على AdsLoader.
AdsRenderingSettings
تحديد المعلمات التي تتحكم في عرض الإعلانات.
AdsRequest
فئة لتحديد خصائص طلب الإعلان.
إعلان مصاحب
يمثّل إعلانًا مصاحبًا.
إعدادات CompanionAdSelection
يُستخدم عنصر CompanionAdSelectionSettings لتحديد معايير الاختيار عند استدعاء الدالة ima.Ad.getCompanionAds.
ImaSdkSettings
يحتوي هذا الصف على إعدادات على مستوى حزمة تطوير البرامج (SDK).
UniversalAdIdInfo
يعرض هذا الكائن معلومات عن رقم تعريف الإعلان العام المرتبط بتصميم الإعلان، بما في ذلك قيمة رقم تعريف الإعلان وسجلّ أرقام تعريف الإعلانات.
التعدادات
وضع OmidAccessMode
سلسلة
أوضاع الوصول المتاحة لحقل OMID للويب، والتي تتحكّم في مقدار وصول النص البرمجي لإثبات الملكية.
القيمة |
|
|---|---|
|
مقيَّدة |
إنّ النص البرمجي لإثبات الملكية هو وضع حماية ولا يمكن الوصول إلى صفحة تصميم الإعلان أو الناشر، ولا يمكنه تأكيد نطاق الناشر الذي يعرضه مباشرةً. |
|
النطاق |
وهذا النص البرمجي لإثبات الملكية هو وضع حماية ولا يمكن الوصول إلى صفحة تصميم الإعلان أو الناشر. ومع ذلك، يتم تحميل النص البرمجي بطريقة تتيح له تأكيد نطاق الناشر الذي يعرضه مباشرةً. |
|
كامل |
يملك النص البرمجي لإثبات الملكية إذن الوصول المباشر إلى تصميم الإعلان وصفحة الناشر. |
المورّد
عدد
تحديد مورّد إثبات الهوية (OMID) يتم إدراج المورّدين بترتيب أبجدي.
القيمة |
|
|---|---|
|
النتيجة |
|
|
تأكيد مزدوج |
|
|
|
|
|
نظرًا لتكامل الإعلانات |
|
|
الطقس |
|
|
MOAT |
|
|
نَلِيشَة |
|
|
يَزِيد |
|
|
نوع إعلان آخر |
المورِّد التلقائي المطلوب استخدامه عندما لا يتطابق عنوان URL للنص البرمجي مع أي مورّد آخر. |
UiElements
سلسلة
تعداد عناصر مختلفة لواجهة المستخدم يمكن ضبطها لعرضها أو إخفاؤها قد يتم تجاهل هذه الإعدادات في إعلانات AdSense وADX.
القيمة |
|
|---|---|
|
الإحالة |
تعرِض نص "الإعلان" في واجهة مستخدم الإعلان. يجب توفّر المفتاح لعرض موقّت العد التنازلي. |
|
COUNTDOWN |
يجب نسب العمل إلى إعلان لكي يتم عرض موقّت العد التنازلي. يجب أن تكون كلتا السمتَين |
وضع العرض
سلسلة
تعداد يحدد أوضاع عرض VPAID مختلفة للإعلانات.
القيمة |
|
|---|---|
|
عادي |
وضع مشاهدة الإعلان العادي. |
|
ملء الشاشة |
وضع عرض الإعلان بملء الشاشة تشير إلى مدير الإعلانات الذي يعتبره الناشر ترتيب AdDisplayContainer الحالي على أنه ملء الشاشة (على سبيل المثال، محاكاة وضع ملء الشاشة). ولا يؤدي ذلك إلى دخول مدير الإعلانات في وضع ملء الشاشة. |
- منهي العمل به
أماكن إقامة
وضع OmidAccessMode
سلسلة
أوضاع الوصول المتاحة لحقل OMID للويب، والتي تتحكّم في مقدار وصول النص البرمجي لإثبات الملكية.
القيمة |
|
|---|---|
|
مقيَّدة |
إنّ النص البرمجي لإثبات الملكية هو وضع حماية ولا يمكن الوصول إلى صفحة تصميم الإعلان أو الناشر، ولا يمكنه تأكيد نطاق الناشر الذي يعرضه مباشرةً. |
|
النطاق |
وهذا النص البرمجي لإثبات الملكية هو وضع حماية ولا يمكن الوصول إلى صفحة تصميم الإعلان أو الناشر. ومع ذلك، يتم تحميل النص البرمجي بطريقة تتيح له تأكيد نطاق الناشر الذي يعرضه مباشرةً. |
|
كامل |
يملك النص البرمجي لإثبات الملكية إذن الوصول المباشر إلى تصميم الإعلان وصفحة الناشر. |
المورّد
عدد
تحديد مورّد إثبات الهوية (OMID) يتم إدراج المورّدين بترتيب أبجدي.
القيمة |
|
|---|---|
|
النتيجة |
|
|
تأكيد مزدوج |
|
|
|
|
|
نظرًا لتكامل الإعلانات |
|
|
الطقس |
|
|
MOAT |
|
|
نَلِيشَة |
|
|
يَزِيد |
|
|
نوع إعلان آخر |
المورِّد التلقائي المطلوب استخدامه عندما لا يتطابق عنوان URL للنص البرمجي مع أي مورّد آخر. |
UiElements
سلسلة
تعداد عناصر مختلفة لواجهة المستخدم يمكن ضبطها لعرضها أو إخفاؤها قد يتم تجاهل هذه الإعدادات في إعلانات AdSense وADX.
القيمة |
|
|---|---|
|
الإحالة |
تعرِض نص "الإعلان" في واجهة مستخدم الإعلان. يجب توفّر المفتاح لعرض موقّت العد التنازلي. |
|
COUNTDOWN |
يجب نسب العمل إلى إعلان لكي يتم عرض موقّت العد التنازلي. يجب أن تكون كلتا السمتَين |
وضع العرض
سلسلة
تعداد يحدد أوضاع عرض VPAID مختلفة للإعلانات.
القيمة |
|
|---|---|
|
عادي |
وضع مشاهدة الإعلان العادي. |
|
ملء الشاشة |
وضع عرض الإعلان بملء الشاشة تشير إلى مدير الإعلانات الذي يعتبره الناشر ترتيب AdDisplayContainer الحالي على أنه ملء الشاشة (على سبيل المثال، محاكاة وضع ملء الشاشة). ولا يؤدي ذلك إلى دخول مدير الإعلانات في وضع ملء الشاشة. |
- منهي العمل به
الإعدادات
قائمة ImaSdkSettings غير فارغة
مثيل إعدادات Singleton العامة