تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
NonceManager
classعلني
يدير nonce وتقارير الأحداث الخاصة بها لجلسة تشغيل محتوى واحدة.
يجب استدعاء طرق مراحل نشاط جلسات تشغيل المحتوى، بما في ذلك sendAdClick
وsendAdTouch وsendPlaybackStart وsendPlaybackEnd،
عند وقوع هذه الأحداث ذات الصلة لتفعيل تحقيق الربح الآلي.
الطُرق
getNonce
علني
تُرجع getNonce() سلسلة.
المرتجعات
string الرقم الخاص الذي تم إنشاؤه لهذا الحساب الإداري عند تحميله.
لن تتغيّر هذه القيمة أبدًا لمثيل NonceManager محدَّد. وهذه القيمة غير الخاصة صالحة فقط لجلسة تشغيل محتوى واحدة وبمدة 6 ساعات كحد أقصى.
sendAdClick
علني
يعيد SendAdClick() إرجاعًا فارغًا
يُعلِم خوادم إعلانات Google بحدوث نقرة على أحد الإعلانات خلال جلسة تشغيل المحتوى المحدّدة.
المرتجعات
void
sendAdImpression
علني
يعيد SendAdimpression() الفاقد.
يجب طلبها عند عرض الإطار الأول من الإعلان المطلوب
مع الرقم الذي أنشأه هذا المدير.
منهي العمل به
استخدِم "sendالتشغيلStart" و "sendPlaybackEnd" بدلاً من ذلك.
المرتجعات
void
sendAdTouch
علني
يعيد SendAdTouch(clickOrTouchEvent) إبطالًا
تُعلِم خوادم إعلانات Google بأنّ المستخدم يلمس أو ينقر على الإعلان ما لم يتم النقر على الإعلان (على سبيل المثال، التخطّي والتجاهل والنقر وغير ذلك)
خلال جلسة تشغيل المحتوى المحدّدة.
المَعلمة
clickOrTouchEvent
(MouseEvent غير فارغ أو حدث TouchEvent غير فارغ)
حدث اللمس أو النقر في المتصفّح الذي تم
تنشيطه لتفاعل المستخدِم.
المرتجعات
void
sendPlaybackEnd
علني
ينتج عن_إرسال_تشغيل End() قيمة فارغة
لإرسال إشعار إلى خوادم إعلانات Google التي تعمل لجلسة تشغيل المحتوى المحدّد. ويجب استدعاء هذا الإجراء عند انتهاء التشغيل (على سبيل المثال،
عندما يصل المشغّل إلى نهاية البث أو عندما يغادر المستخدم
في منتصف البث أو عندما يغادر المستخدم الصفحة أو عندما يتقدّم إلى
عنصر المحتوى التالي في إعدادات قائمة التشغيل).
تُنهي هذه الطريقة الطلبات غير المتزامنة إلى خوادم Google التي بدأت في
sendPlaybackStart.
المرتجعات
void
sendPlaybackStart
علني
يُرجع SendتشغيلStart() القيمة الفارغة.
لإرسال إشعار إلى خوادم إعلانات Google التي تبدأ جلسة تشغيل المحتوى المحدّد. يجب أن يتم استدعاؤه عند كتابة "تشغيل مشغّل الفيديو". وقد يكون ذلك استجابة لإجراء أجراه المستخدم (النقر للتشغيل) أو إجراء بدأه المستخدم في الصفحة (تشغيل تلقائي).
ستؤدي هذه الطريقة إلى بدء مكالمات غير متزامنة مع خوادم Google لجمع
الإشارات اللازمة لرصد الزيارات غير المتزامنة ورصدها.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Programmatic Access Libraries automatically collect data like IP address, user interactions, diagnostics, and device identifiers for advertising and analytics.\u003c/p\u003e\n"],["\u003cp\u003eThis data is shared for purposes of advertising, analytics, and fraud prevention and is encrypted during transmission using TLS protocol.\u003c/p\u003e\n"],["\u003cp\u003eApp developers can control the collection of Android advertising IDs and explore features like Limited Ads for data management.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are responsible for disclosing data collection and usage practices in the Google Play Data safety section based on their app's specific implementation and features used.\u003c/p\u003e\n"],["\u003cp\u003eThis page focuses on the latest version of the Programmatic Access Libraries; developers should update to the latest version and review this page regularly to ensure accurate disclosures.\u003c/p\u003e\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`sendAdTouch`, `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\n nonce value is only valid for a single content playback session up to a\n 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(clickOrTouchEvent) returns void\n\nNotifies Google ad servers that a user touch or click on the ad other than\na clickthrough (for example, skip, mute, tap, and more.) has occurred\nduring the given content playback session.\n\n| #### Parameter ||\n|-------------------|------------------------------------------------------------------------------------------------------------------------|\n| clickOrTouchEvent | (non-null MouseEvent or non-null TouchEvent) The browser touch or click event that was fired for the user interaction. |\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 (for example,\nwhen the player reaches end of stream, or when the user exits playback\nmid-way, or when the user leaves the page, or when advancing to the next\ncontent item in 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`"]]
