فئة NonceManager


يدير هذا الصف غير المكرّر وإعداد التقارير عن الأحداث المرتبطة به لجلسة تشغيل محتوى واحدة. يجب استدعاء طرق دورة حياة جلسة تشغيل المحتوى، بما في ذلك sendAdClick وsendAdTouch وsendPlaybackStart وsendPlaybackEnd عند وقوع هذه الأحداث المعنيّة من أجل تفعيل تحقيق الربح آليًا.
الطُرق
getNonce
sendAdClick
يُعلم هذا الإجراء خوادم Google الإعلانية بأنّه تم النقر على الإعلان خلال جلسة تشغيل المحتوى المحدّدة.
sendAdImpression
تمّت إزالة هذا العمود. يُعلم هذا الإجراء خوادم إعلانات Google بأنّه يتم عرض الإطار الأول من الإعلان الذي تم طلبه باستخدام رقم خاص أنشأه هذا المدير.
sendAdTouch
يُعلم هذا الإجراء خوادم Google الإعلانية بأنّه تم النقر على الإعلان أو لمسه من قِبل المستخدم، وليس النقر للانتقال إلى الموقع الإلكتروني (على سبيل المثال، النقر على "تخطّي" أو "كتم الصوت" أو "النقر" أو غير ذلك) خلال جلسة تشغيل المحتوى المحدّدة.
sendPlaybackEnd
يُعلم هذا الإجراء خوادم Google الإعلانية بأنّه تم إيقاف تشغيل المحتوى لجلسة تشغيل المحتوى المحدّدة.
sendPlaybackStart
يُعلم هذا الإجراء خوادم Google الإعلانية بأنّه تم بدء تشغيل المحتوى لجلسة تشغيل المحتوى المحدّدة.

الطُرق


getNonce

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

sendAdClick

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

sendAdImpression

sendAdImpression(): void
يُعلم خوادم إعلانات Google بأنّه يتم عرض الإطار الأول من الإعلان الذي تم طلبه باستخدام الرقم الخاص الذي أنشأه هذا المدير.

sendAdTouch

sendAdTouch(clickOrTouchEvent: MouseEvent | TouchEvent): void
يُعلم هذا الإجراء خوادم Google الإعلانية بأنّه تم النقر على الإعلان أو لمسه من قِبل المستخدم، وليس النقر للانتقال إلى الموقع الإلكتروني (على سبيل المثال، النقر على "تخطّي" أو "كتم الصوت" أو "النقر" أو غير ذلك) خلال جلسة تشغيل المحتوى المحدّدة.
المعلمات
clickOrTouchEvent: MouseEvent | TouchEvent حدث اللمس أو حدث ناتج عن النقر في المتصفّح الذي تم تنشيطه لتفاعل المستخدم.

sendPlaybackEnd

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

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

sendPlaybackStart

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

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