H5 गेम में अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन दिखाना
इस उदाहरण में, Google पब्लिशर टैग (GPT) लाइब्रेरी का इस्तेमाल करके, गेमिंग इंटरस्टीशियल विज्ञापन दिखाया गया है. गेमिंग इंटरस्टीशियल, GPT से मैनेज किए जाने वाले फ़ुल-पेज विज्ञापन होते हैं. इन्हें मैन्युअल ट्रिगर के आधार पर, वेब-आधारित गेम खेलने वाले उपयोगकर्ताओं को दिखाया जाता है. गेमिंग इंटरस्टीशियल के बारे में ज़्यादा जानकारी के लिए, H5 गेमिंग इंटरस्टीशियल विज्ञापन दिखाना लेख पढ़ें.
गेमिंग इंटरस्टीशियल विज्ञापन दिखाने और उनसे इंटरैक्ट करने के लिए, यहां दिए गए GPT इवेंट का इस्तेमाल करें:
| इवेंट | ट्रिगर होता है, जब... |
|---|---|
GamingInterstitialSlotReady |
गेमिंग इंटरस्टीशियल विज्ञापन, उपयोगकर्ता को दिखाने के लिए तैयार है. इंटरस्टीशियल विज्ञापन दिखाने के लिए, दिए गए इवेंट ऑब्जेक्ट पर makeGameManualInterstitialVisible() को कॉल करें. |
GamingInterstitialSlotClosed |
उपयोगकर्ता ने पहले दिखाया गया गेमिंग इंटरस्टीशियल विज्ञापन बंद कर दिया. जब भी कोई गेमिंग इंटरस्टीशियल विज्ञापन बंद किया जाता है, तो कस्टम लॉजिक चलाने के लिए इस इवेंट का इस्तेमाल करें. |
गेम के स्ट्रक्चर
गेमिंग इंटरस्टीशियल विज्ञापन, फ़ुलस्क्रीन पर या आपके गेम के फ़्रेम में दिख सकते हैं. यह इस बात पर निर्भर करता है कि आपके गेम का स्ट्रक्चर कैसा है. ज़्यादा जानकारी के लिए, एच5 गेम के स्ट्रक्चर देखें.
सैंपल के तौर पर दिए गए उदाहरण में यह माना गया है कि H5 गेम, फ़ुलस्क्रीन स्ट्रक्चर का इस्तेमाल करके, सबसे ऊपर मौजूद विंडो में सीधे रेंडर होता है. इस स्थिति में, गेमिंग इंटरस्टीशियल विज्ञापन भी फ़ुलस्क्रीन में रेंडर होता है.
हालांकि, यह कोड किसी चाइल्ड फ़्रेम में डालने पर भी काम करता है. इसके लिए, iFrame/WebView स्ट्रक्चर का इस्तेमाल किया जाता है. गेमिंग इंटरस्टीशियल विज्ञापन को H5 गेम कैनवस में सीमित करने के लिए, गेम को iFrame में डालें, जैसा कि इस उदाहरण में दिखाया गया है:
<!doctype html>
<html>
<head>
<!-- The Google Publisher Tag here, if any, will only be responsible for serving ads outside of the H5 game. -->
<title>Page for this example H5 game</title>
<!-- Your <head> content here. -->
</head>
<body>
<span id="example-text">Example H5 game</span>
<!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->
<iframe src="https://www.example.com" title="Example game" allow="autoplay"></iframe>
</body>
</html>
इस्तेमाल की जानकारी
उपयोगकर्ता को बेहतर अनुभव देने के लिए, GPT सिर्फ़ उन पेजों पर गेमिंग इंटरस्टीशियल विज्ञापनों का अनुरोध करता है जिन पर यह फ़ॉर्मैट सही तरीके से काम करता है. इस पाबंदी की वजह से,
defineOutOfPageSlot()शायद कोई वैल्यू न दिखाए. आपको इस मामले की जांच करनी चाहिए, ताकि यह पक्का किया जा सके कि आपने कोई ग़ैर-ज़रूरी काम न किया हो.सिर्फ़ उन पेजों या एनवायरमेंट पर गेमिंग इंटरस्टीशियल विज्ञापनों का अनुरोध करें जहां आपको इंटरस्टीशियल विज्ञापन दिखाने हैं. गेमिंग इंटरस्टीशियल विज्ञापन, डेस्कटॉप, टैबलेट, और मोबाइल डिवाइसों पर दिखाए जा सकते हैं.
गेमिंग इंटरस्टीशियल विज्ञापन, अपने विज्ञापन स्लॉट जनरेट करते हैं. अन्य विज्ञापन टाइप के उलट, गेमिंग इंटरस्टीशियल विज्ञापनों के लिए
<div>तय करना ज़रूरी नहीं है. जब कोई विज्ञापन फ़िल हो जाता है, तो ये विज्ञापन अपने-आप अपना कंटेनर बनाते हैं और उसे पेज में डाल देते हैं.गेमिंग इंटरस्टीशियल विज्ञापनों का इस्तेमाल सिर्फ़ एक बार किया जा सकता है. गेमिंग इंटरस्टीशियल विज्ञापन स्लॉट को रीफ़्रेश नहीं किया जा सकता. इसके बजाय, आपको स्लॉट को मिटाकर फिर से बनाना होगा, जैसा कि लागू करने के सैंपल में दिखाया गया है.
गेमिंग इंटरस्टीशियल विज्ञापनों के लिए, फ़्रीक्वेंसी कैप तय होता है. फ़्रीक्वेंसी कैप की वजह से,
gamingInterstitialSlotReadyइवेंट हर 120 सेकंड में एक से ज़्यादा बार ट्रिगर नहीं होता.अगर एक से ज़्यादा स्लॉट वाले पेज पर सिंगल-रिक्वेस्ट आर्किटेक्चर (एसआरए) का इस्तेमाल किया जा रहा है, तो
display()को तब तक कॉल न करें, जब तक स्टैटिक विज्ञापन स्लॉट के डिव बनाए न जाएं. विज्ञापनों के सबसे सही तरीकों में बताए गए तरीके के मुताबिक,display()के पहले कॉल में उस बिंदु से पहले तय किए गए हर विज्ञापन स्लॉट का अनुरोध किया जाता है. गेमिंग इंटरस्टीशियल स्लॉट के लिए, पहले से तय<div>की ज़रूरत नहीं होती. हालांकि, स्टैटिक विज्ञापन स्लॉट के लिए<div>की ज़रूरत होती है. पेज पर इन एलिमेंट के मौजूद होने से पहलेdisplay()को कॉल करने पर, सिग्नल की क्वालिटी खराब हो सकती है. हमारा सुझाव है कि स्टैटिक स्लॉट तय होने तक, शुरुआती कॉल को बाद में करें.