الفئة: NonceManager

NonceManager

class   public

يدير هذا الصف قيمة nonce وعملية الإبلاغ عن الأحداث لجلسة واحدة لتشغيل المحتوى. يجب استدعاء طرق دورة حياة جلسة تشغيل المحتوى، بما في ذلك sendAdClick وsendTouch وsendPlaybackStart وsendPlaybackEnd، عند حدوث هذه الأحداث المعنية، وذلك لتفعيل تحقيق الربح الآلي.

الطُرق

getNonce

عام

تعرض الدالة getNonce() القيمة string

المرتجعات

string تم إنشاء قيمة الاستخدام لمرة واحدة لهذا الحساب الإداري عند تحميله. لن تتغيّر هذه القيمة أبدًا لمثيل NonceManager معيّن. تكون قيمة الرقم العشوائي صالحة فقط لجلسة تشغيل محتوى واحدة لمدة 6 ساعات كحدّ أقصى.

sendAdClick

عام

تعرض الدالة sendAdClick() القيمة void

يُعلم خوادم إعلانات Google بأنّه تمّ النقر على أحد الإعلانات أثناء جلسة تشغيل المحتوى المحدّدة.

المرتجعات

void 

sendAdImpression

عام

تعرض الدالة sendAdImpression() القيمة void

يجب استدعاء هذه الدالة عند عرض الإطار الأول من الإعلان الذي تم طلبه باستخدام الرقم العشوائي الذي أنشأه هذا المدير.

منهي العمل به
استخدِم `sendPlaybackStart` و `sendPlaybackEnd` بدلاً من ذلك.
المرتجعات

void 

sendAdTouch

عام

تعرض الدالة sendAdTouch(userInteractionEvent) القيمة void

يُعلم خوادم إعلانات Google بأنّ المستخدم نقر على الإعلان أو تفاعل معه بطريقة أخرى غير النقر للوصول إلى الموقع الإلكتروني (مثل تخطّي الإعلان أو كتم صوته أو النقر عليه وما إلى ذلك) خلال جلسة تشغيل المحتوى المحدّدة.

المَعلمة

userInteractionEvent

cast.framework.events.Event

حدث تفاعل المستخدم الذي يتم تنشيطه بواسطة حزمة تطوير البرامج Cast.

يجب ألا تكون القيمة فارغة.
المرتجعات

void 

sendPlaybackEnd

عام

تعرض الدالة sendPlaybackEnd() القيمة void

يُعلم خوادم إعلانات Google بأنّ جلسة تشغيل المحتوى المحدّد قد انتهت. يجب استدعاء هذا الحدث عند انتهاء التشغيل (مثلاً، عندما يصل المشغّل إلى نهاية البث، أو عندما يخرج المستخدم من التشغيل في منتصفه، أو عندما يغادر المستخدم الصفحة، أو عند الانتقال إلى عنصر المحتوى التالي في إعداد قائمة تشغيل).

تنهي هذه الطريقة عمليات طلب غير متزامن إلى خوادم Google تم بدؤها في sendPlaybackStart.

المرتجعات

void 

sendPlaybackStart

عام

تعرض الدالة sendPlaybackStart() القيمة void

يُعلم خوادم إعلانات Google بأنّه تم بدء تشغيل جلسة تشغيل المحتوى المحدّد. يجب استدعاء هذا الإجراء عند "بدء مشغّل الفيديو". وقد يكون ذلك استجابةً لإجراء بدأه المستخدم (النقر للتشغيل) أو إجراء بدأته الصفحة (التشغيل التلقائي).

ستبدأ هذه الطريقة طلبات غير متزامنة إلى خوادم Google لجمع الإشارات اللازمة لمراقبة حركة المرور غير الصالحة ورصدها.

المرتجعات

void