با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
NonceManager
عمومیکلاس
یک nonce و گزارش رویداد آن را برای یک جلسه پخش محتوا مدیریت می کند. روش‌های چرخه عمر جلسه پخش محتوا، از جمله sendAdClick ، sendTouch ، sendPlaybackStart ، و sendPlaybackEnd باید فراخوانی شوند زیرا این رویدادهای مربوطه رخ می‌دهند تا بتوان کسب درآمد از طریق برنامه را فعال کرد.
روش ها
getNonce
عمومی
getNonce() رشته را برمی گرداند
برمی گرداند
string Nonce ایجاد شده برای این مدیر هنگام بارگیری. این مقدار برای یک نمونه NonceManager هرگز تغییر نخواهد کرد. این مقدار nonce فقط برای یک جلسه پخش محتوا تا حداکثر مدت زمان 6 ساعت معتبر است.
sendAdClick
عمومی
sendAdClick() void را برمی گرداند
به سرورهای تبلیغات Google اطلاع می‌دهد که یک کلیک روی یک تبلیغ در طول جلسه پخش محتوا انجام شده است.
برمی گرداند
void
sendAdImpression
عمومی
sendAdImpression() void را برمی گرداند
باید زمانی فراخوانی شود که اولین فریم آگهی درخواست شده با نون تولید شده توسط این مدیر نمایش داده شود.
منسوخ شده است
به جای آن از «sendPlaybackStart» و «sendPlaybackEnd» استفاده کنید.
برمی گرداند
void
sendAdTouch
عمومی
sendAdTouch (userInteractionEvent) باطل را برمی‌گرداند
به سرورهای تبلیغات Google اطلاع می‌دهد که در جلسه پخش محتوا، کاربر به غیر از کلیک روی آگهی (مثلاً پرش، بی‌صدا کردن، ضربه زدن و غیره) روی آن کلیک کرده یا روی آن کلیک می‌کند.
پارامتر
userInteractionEvent
cast.framework.events.Event
رویداد تعامل کاربر توسط چارچوب Cast فعال شد.
مقدار نباید صفر باشد.
برمی گرداند
void
sendPlaybackEnd
عمومی
sendPlaybackEnd() void را برمی گرداند
به سرورهای تبلیغاتی Google اطلاع می دهد که پخش برای جلسه پخش محتوای داده شده به پایان رسیده است. زمانی که بازپخش پایان می‌یابد (مثلاً وقتی پخش‌کننده به پایان پخش می‌رسد، یا زمانی که کاربر در اواسط راه از پخش خارج می‌شود، یا زمانی که کاربر صفحه را ترک می‌کند، یا زمانی که به آیتم محتوای بعدی در تنظیمات فهرست پخش می‌رود) باید فراخوانی شود.
این روش تماس‌های ناهمزمان با سرورهای Google را که در sendPlaybackStart شروع شده‌اند، پایان می‌دهد.
برمی گرداند
void
sendPlaybackStart
عمومی
sendPlaybackStart() void را برمی گرداند
به سرورهای تبلیغات Google اطلاع می‌دهد که پخش برای جلسه پخش محتوا آغاز شده است. این باید در "شروع پخش کننده ویدئو" نامیده شود. این ممکن است در پاسخ به یک اقدام آغاز شده توسط کاربر (کلیک برای پخش) یا یک اقدام آغاز شده توسط صفحه (پخش خودکار) باشد.
این روش تماس‌های ناهمزمان با سرورهای Google را برای جمع‌آوری سیگنال‌های مورد نیاز برای نظارت و شناسایی IVT آغاز می‌کند.
تاریخ آخرین بهروزرسانی 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`"]]
