অ্যাডব্রেক()

ফাংশন স্বাক্ষর:

adBreak(
   type: '<type>',                     // The type of this placement
   name: '<name>',                     // A descriptive name for this placement
   beforeAd: () => {},                 // Prepare for the ad. Mute and pause the game flow
   afterAd: () => {},                  // Resume the game and re-enable sound
   beforeReward: (showAdFn) => {},     // Show reward prompt (call showAdFn() if clicked)
   adDismissed: () => {},              // Player dismissed the ad before completion
   adViewed: () => {},                 // Ad was viewed and closed
   adBreakDone: (placementInfo) => {}, // Always called (if provided) even if an ad didn't show
);

adBreak() প্যারামিটার

নাম টাইপ বর্ণনা
সমস্ত বসানো প্রকার
type স্ট্রিং

বসানোর ধরন। মান:

  • গেম লোড হওয়ার আগে 'preroll' (ইউআই রেন্ডার হওয়ার আগে)
  • গেমপ্লে শুরু হওয়ার আগে 'start' (UI রেন্ডার হওয়ার পরে)
  • 'pause' প্লেয়ার খেলা বিরতি দেয়
  • 'next' প্লেয়ার পরবর্তী স্তরে নেভিগেট করে
  • প্লেয়ার গেমপ্লের বাইরে বিকল্পগুলি অন্বেষণ করে 'browse' করুন'
  • 'reward' একটি পুরস্কৃত বিজ্ঞাপন
name স্ট্রিং (ঐচ্ছিক) আপনার গেমের মধ্যে এই নির্দিষ্ট বিজ্ঞাপন বসানোর জন্য একটি নাম। এটি একটি অভ্যন্তরীণ শনাক্তকারী, এবং প্লেয়ারকে দেখানো হয় না। ভবিষ্যতের রিলিজে এই শনাক্তকারী অতিরিক্ত রিপোর্টিং এবং অপ্টিমাইজেশান বৈশিষ্ট্য সক্রিয় করতে ব্যবহার করা হতে পারে।

আমরা আপনাকে আপনার সমস্ত প্লেসমেন্টের নাম সুপারিশ করি৷
beforeAd ফাংশন (ঐচ্ছিক) বিজ্ঞাপন দেখানোর আগে কল করা হয়। গেমটি থামানো উচিত এবং শব্দটি নিঃশব্দ করা উচিত। এই ক্রিয়াগুলি অবশ্যই সিঙ্ক্রোনাসভাবে করা উচিত। এই কলব্যাক শেষ হওয়ার সাথে সাথে বিজ্ঞাপনটি প্রদর্শিত হবে।
afterAd ফাংশন (ঐচ্ছিক) বিজ্ঞাপন শেষ হওয়ার পরে কল করা হয় (যেকোন কারণে)। পুরস্কৃত বিজ্ঞাপনের জন্য, প্লেয়ারের adViewed উপর নির্ভর করে, এটিকে বিজ্ঞাপন adDismissed বা বিজ্ঞাপন দেখানোর পরে বলা হয়। এই ফাংশনটি গেম প্রবাহ পুনরায় শুরু করতে ব্যবহার করা উচিত। উদাহরণস্বরূপ, শব্দটি আনমিউট করতে এবং পরবর্তী স্তর শুরু করতে ব্যবহার করুন।
adBreakDone ফাংশন (ঐচ্ছিক) সর্বদা একটি adBreak() এর শেষ ধাপ হিসাবে ডাকা হয়, এমনকি কোনো বিজ্ঞাপন দেখানো না হলেও। ফাংশনটি যুক্তি হিসাবে একটি placementInfo ইনফো অবজেক্টকে নিম্নরূপ সংজ্ঞায়িত করে:
{
    breakType: '<type>',
    breakName: '<name>',
    breakFormat: 'interstitial|reward',
    breakStatus:  'error|noAdPreloaded|...|viewed',
}
প্লেসমেন্ট ইনফো অবজেক্টের বিস্তারিত ব্যাখ্যার জন্য adBreakDone এবং placementInfo() দেখুন।
শুধুমাত্র পুরস্কৃত প্লেসমেন্ট...
beforeReward ফাংশন একটি পুরস্কৃত বিজ্ঞাপন উপলব্ধ হলে কল করা হয়. ফাংশনটি একটি একক আর্গুমেন্ট নিতে showAdFn() যা অবশ্যই পুরস্কৃত বিজ্ঞাপন প্রদর্শন করতে কল করতে হবে।
adDismissed ফাংশন প্লেয়ার বিজ্ঞাপনটি খারিজ করলে শুধুমাত্র পুরস্কৃত বিজ্ঞাপনের জন্য কল করা হয়। এটি শুধুমাত্র তখনই বলা হয় যদি প্লেয়ার বিজ্ঞাপনটি সম্পূর্ণ হওয়ার আগে বাতিল করে দেয়। এই ক্ষেত্রে পুরস্কার দেওয়া উচিত নয়।
adViewed ফাংশন শুধুমাত্র পুরস্কৃত বিজ্ঞাপনের জন্য কল করা হয় যখন প্লেয়ার বিজ্ঞাপনটি সম্পূর্ণ করে এবং পুরস্কারটি দেওয়া উচিত।

adBreakDone() and placementInfo ইনফো

যদি বিজ্ঞাপন প্লেসমেন্ট API-এ দেখানোর জন্য একটি বিজ্ঞাপন না থাকে তবে এটি আপনার পাস করা বিভিন্ন কলব্যাকের আগে/পরে কল করবে না। যাইহোক, যদি আপনি একটি adBreakDone() কলব্যাক প্রদান করেন তবে এটি সর্বদা কল করা হবে, এমনকি একটি বিজ্ঞাপন দেখানো না হলেও। এটি আপনাকে প্লেসমেন্টের জন্য যেকোন অতিরিক্ত কাজ করতে দেয়, যেমন প্লেসমেন্ট সম্পর্কে অতিরিক্ত বিশ্লেষণ লগিং করা।

adBreakDone() ফাংশনটি একটি placementInfo ইনফো অবজেক্টকে নিম্নরূপ সংজ্ঞায়িত আর্গুমেন্ট হিসেবে নেয়:

{
  breakType: '<type>',
  breakName: '<name>',
  breakFormat: 'interstitial|reward',
  breakStatus: 'notReady|timeout|error|noAdPreloaded|frequencyCapped|ignored|other|dismissed|viewed',
}

যেখানে এই বস্তুর মধ্যে ক্ষেত্রগুলিতে নিম্নলিখিত শব্দার্থ আছে:

  • breakType হল টাইপ আর্গুমেন্ট যা adBreak() পাস করা হয়েছে
  • breakName হল adBreak() পাস করা নামের আর্গুমেন্ট
  • breakStatus হল এই প্লেসমেন্টের স্থিতি এবং নিম্নলিখিত মানগুলির মধ্যে একটি হতে পারে:
breakStatus কারণ
'notReady' অ্যাড প্লেসমেন্ট এপিআই আরম্ভ করা হয়নি
'timeout' একটি প্লেসমেন্টের সময় শেষ হয়েছে কারণ অ্যাড প্লেসমেন্ট এপিআই প্রতিক্রিয়া জানাতে খুব বেশি সময় নিয়েছে৷
'invalid' প্লেসমেন্টটি অবৈধ ছিল এবং উপেক্ষা করা হয়েছিল-উদাহরণস্বরূপ প্রতি পৃষ্ঠা লোডের জন্য শুধুমাত্র একটি প্রিরোল প্লেসমেন্ট থাকা উচিত, পরবর্তী প্রিরোলগুলি এই স্থিতির সাথে ব্যর্থ হয়েছে
'error' একটি কলব্যাকে একটি জাভাস্ক্রিপ্ট ত্রুটি ছিল৷
'noAdPreloaded' একটি বিজ্ঞাপন এখনও প্রিলোড করা হয়নি তাই এই প্লেসমেন্টটি এড়িয়ে গেছে৷
'frequencyCapped' একটি বিজ্ঞাপন দেখানো হয়নি কারণ এই প্লেসমেন্টে ফ্রিকোয়েন্সি ক্যাপ প্রয়োগ করা হয়েছিল৷
'ignored' ব্যবহারকারী পরবর্তী প্লেসমেন্টে পৌঁছানোর আগে পুরস্কারের প্রম্পটে ক্লিক করেননি, অর্থাৎ showAdFn() কে পরবর্তী adBreak() এর আগে কল করা হয়নি।
'other' বিজ্ঞাপনটি অন্য কারণে দেখানো হয়নি। (উদাহরণস্বরূপ, বিজ্ঞাপনটি এখনও আনা হচ্ছে, বা পূর্বে ক্যাশে করা বিজ্ঞাপনটি নিষ্পত্তি করা হয়েছে কারণ স্ক্রীনটি পুনরায় আকার দেওয়া হয়েছে/ঘোরানো হয়েছে।)
'dismissed' ব্যবহারকারী একটি পুরস্কৃত বিজ্ঞাপন সম্পূর্ণ হওয়ার আগে এটিকে খারিজ করে দিয়েছেন
'viewed' বিজ্ঞাপনটি ব্যবহারকারীরা দেখেছেন

দ্রষ্টব্য : adBreakDone() সর্বদা সর্বশেষ কলব্যাক যা adBreak() কল করে।

আপনি যদি একটি বিজ্ঞাপন দেখানোর পরে আপনার গেমটি আনপজ করতে afterAd() ব্যবহার করেন, তাহলে আপনার গেম পুনরায় চালু হওয়ার পরে adBreakDone() করা হবে। লগিং অ্যানালিটিক্সের মতো জিনিসগুলির জন্য এটি উপযুক্ত হতে পারে, তবে আপনি যদি আপনার গেমটি পুনরায় চালু হওয়ার আগে অতিরিক্ত কাজ করতে চান তবে আপনার afterAd() থেকে adBreakDone() ) তে আপনার গেমটি আনপজ করতে যুক্তিটি সরান।