تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
NonceManager
classpublic
يدير هذا الصف قيمة 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 لجمع الإشارات اللازمة لمراقبة حركة المرور غير الصالحة ورصدها.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe NonceManager class manages a unique nonce and reports events for a single content playback session, enabling programmatic monetization.\u003c/p\u003e\n"],["\u003cp\u003eTo enable programmatic monetization, you must call specific lifecycle methods like \u003ccode\u003esendAdClick\u003c/code\u003e, \u003ccode\u003esendTouch\u003c/code\u003e, \u003ccode\u003esendPlaybackStart\u003c/code\u003e, and \u003ccode\u003esendPlaybackEnd\u003c/code\u003e when their corresponding events occur.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetNonce()\u003c/code\u003e provides a unique nonce for the session, valid for a single playback up to 6 hours.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esendPlaybackStart()\u003c/code\u003e and \u003ccode\u003esendPlaybackEnd()\u003c/code\u003e should be used to signal the start and end of content playback to Google ad servers, replacing the deprecated \u003ccode\u003esendAdImpression\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eOther methods like \u003ccode\u003esendAdClick\u003c/code\u003e and \u003ccode\u003esendAdTouch\u003c/code\u003e allow reporting of ad interactions for comprehensive monetization tracking.\u003c/p\u003e\n"]]],["The `NonceManager` class manages a unique nonce for a single content playback session, valid for up to 6 hours. Key actions include: retrieving the nonce via `getNonce()`; notifying ad server events with `sendAdClick()`, `sendAdTouch()`, and `sendAdImpression()`; and signaling the start and end of a playback session via `sendPlaybackStart()` and `sendPlaybackEnd()`. `sendPlaybackStart()` begins background monitoring while `sendPlaybackEnd()` concludes it.\n"],null,["# Class: NonceManager\n\nNonceManager\n============\n\nclass public\n\nManages a nonce and its event reporting for a single content playback\nsession.\nThe content playback session lifecycle methods, including `sendAdClick`,\n`sendTouch`, `sendPlaybackStart`, and `sendPlaybackEnd` must be called as\nthese respective events occur in order to enable programmatic monetization.\n\nMethods\n-------\n\n### getNonce\n\npublic\n\ngetNonce() returns string\n\nReturns\n\n: `string` The nonce generated for this manager when it was loaded.\n This value will never change for a given `NonceManager` instance. This nonce value is only valid for a single content playback session up to a maximum duration of 6 hours.\n\n### sendAdClick\n\npublic\n\nsendAdClick() returns void\n\nNotifies Google ad servers that a clickthrough on an ad has occurred during\nthe given content playback session.\n\nReturns\n\n: `void`\n\n### sendAdImpression\n\npublic\n\nsendAdImpression() returns void\n\nShould be called when the first frame of the ad that was requested with\nthe nonce generated by this manager is displayed.\n\nDeprecated\n: Use \\`sendPlaybackStart\\` and \\`sendPlaybackEnd\\` instead.\n\nReturns\n\n: `void`\n\n### sendAdTouch\n\npublic\n\nsendAdTouch(userInteractionEvent) returns void\n\nNotifies Google ad servers that a user touch or click on the ad other than\na clickthrough (e.g. skip, mute, tap, etc.) has occurred during the given\ncontent playback session.\n\n| #### Parameter ||\n|----------------------|-------------------------------------------------------------------------------------------------------------|\n| userInteractionEvent | cast.framework.events.Event The user interaction event fired by the Cast framework. Value must not be null. |\n\nReturns\n\n: `void`\n\n### sendPlaybackEnd\n\npublic\n\nsendPlaybackEnd() returns void\n\nNotifies Google ad servers that playback for the given content playback\nsession has ended. This should be called when playback ends (e.g. when the\nplayer reaches end of stream, or when the user exits playback mid-way, or\nwhen the user leaves the page, or when advancing to the next content item\nin a playlist setting).\n\nThis method ends the asynchronous calls to Google servers started in\n`sendPlaybackStart`.\n\nReturns\n\n: `void`\n\n### sendPlaybackStart\n\npublic\n\nsendPlaybackStart() returns void\n\nNotifies Google ad servers that playback for the given content playback\nsession has started. This should be called on \"video player start\". This\nmay be in response to a user-initiated action (click-to-play) or a page\ninitiated action (autoplay).\n\nThis method will start asynchronous calls to Google servers to collect\nsignals needed for IVT monitoring and detection.\n\nReturns\n\n: `void`"]]
