অ্যাড প্লেসমেন্ট API ব্যবহার করুন

Ad Placement API-এ দুটি ফাংশন রয়েছে: adBreak() এবং adConfig() , নিম্নলিখিত গ্লোবাল নেমস্পেসে সংজ্ঞায়িত করা হয়েছে। বেশিরভাগ আর্গুমেন্ট হল আপনার প্রদান করা ফাংশন যা আপনাকে একটি বিজ্ঞাপনের জন্য প্রস্তুতি এবং প্রদর্শনের মূল ধাপগুলি পরিচালনা করতে দেয়:

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 un-mute the 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
});

adConfig({
   preloadAdBreaks: 'on|auto',      // Should ads always be preloaded
   sound: 'on|off',                 // Is sound currently enabled within the game
});

এই ফাংশনগুলি আপনার গেমের মধ্যে বিজ্ঞাপন স্থাপন এবং কনফিগার করতে ব্যবহৃত হয়। উপরে দেখানো আর্গুমেন্ট হল একমাত্র বৈধ আর্গুমেন্ট যা এই ফাংশনে পাস করা যেতে পারে। বিভিন্ন ধরনের বিজ্ঞাপনের জন্য এই আর্গুমেন্টের বিভিন্ন উপসেট প্রয়োজন যা নীচে বিশদভাবে দেওয়া হয়েছে।

adBreak() হল আপনার গেমের মধ্যে বিজ্ঞাপন স্থাপনের মূল ফাংশন। এটি একটি বিজ্ঞাপনের স্থান নির্ধারণ করে এবং একটি প্লেসমেন্ট কনফিগার নামে একটি বস্তু নেয় যা একটি বিজ্ঞাপন দেখানোর জন্য প্রয়োজনীয় সবকিছু নির্দিষ্ট করে।

adBreak() ফাংশন এমন একটি স্থান নির্ধারণ করে যেখানে একটি বিজ্ঞাপন দেখানো যেতে পারে। একটি বিজ্ঞাপন আসলে দেখাবে কিনা তা নিম্নলিখিত বিষয়গুলির উপর নির্ভর করে:

• আপনি যে ধরনের বিজ্ঞাপন প্লেসমেন্ট ঘোষণা করেছেন
  • এই বিজ্ঞাপনটি কি খেলার শুরুতে? স্তরের মধ্যে? কোন মুহুর্তে খেলোয়াড় খেলা বন্ধ করে দিয়েছেন?
• বর্তমান প্লেয়ারের জন্য উপযুক্ত বিজ্ঞাপন আছে কিনা
  • এই বিজ্ঞাপনটি কি তাদের জন্য প্রাসঙ্গিক?
  • এটি কি তাদের ডেটা গোপনীয়তা এবং সম্মতি সেটিংসের সাথে সামঞ্জস্যপূর্ণ?
• প্লেয়ার সম্প্রতি দেখা বিজ্ঞাপনের সংখ্যা
• নিয়ন্ত্রণ সেটিংস—উদাহরণস্বরূপ, বিজ্ঞাপনের ফ্রিকোয়েন্সি, আপনি এই গেমটির জন্য কনফিগার করেছেন৷
  • হয় ট্যাগে ইঙ্গিত হিসাবে, অথবা,
  • AdSense-এর মধ্যে—মনে রাখবেন যে AdSense-এ উপলব্ধ নিয়ন্ত্রণগুলি সময়ের সাথে বিকশিত হবে।

যে ধরনের বিজ্ঞাপন দেখায় তাও একই কারণের উপর নির্ভর করে।

মনে রাখবেন যে adBreak() এ কল করা হয়ত কোনো বিজ্ঞাপন দেখাবে না। এটি কেবল একটি জায়গা ঘোষণা করে যেখানে একটি বিজ্ঞাপন দেখানো যেতে পারে।

এটি গতানুগতিক API-এর বিপরীত যেখানে আপনার কোড সর্বদা জানে যে একটি বিজ্ঞাপন উপলব্ধ কিনা এবং আপনি এটি প্রদর্শন করবেন কিনা তা গেমের মধ্যেই সিদ্ধান্ত নেন। বিজ্ঞাপন প্লেসমেন্ট এপিআই সিদ্ধান্ত নেওয়ার এই পদ্ধতিটি একটি নির্দিষ্ট প্লেসমেন্টে বিজ্ঞাপন দেখানো হয় কিনা তা একটি প্যাটার্ন যা কখনও কখনও "নিয়ন্ত্রণের বিপরীত" হিসাবে উল্লেখ করা হয়।

আমরা আমাদের গেমস এপিআইকে এই মডেলে রূপান্তর করার কারণ হল প্রথমত, এটি আপনার গেমের মধ্যে যে কোডটি লিখতে হবে তা ছোট করে। দ্বিতীয়ত, এটি একটি দুর্দান্ত ব্যবহারকারীর অভিজ্ঞতার সাথে নীতি সম্মত প্লেসমেন্টগুলি সরবরাহ করা সহজ করে তোলে, যার ফলে আমরা গেম প্রকাশকদের কাছে আমাদের সর্বোচ্চ পারফরম্যান্সের কিছু ফর্ম্যাট সরবরাহ করতে পারি৷ সবশেষে, এটি দেখানোর জন্য বিজ্ঞাপনের ধরন এবং সংখ্যা সম্পর্কে নগদীকরণ সিদ্ধান্ত থেকে আপনার গেমে বিজ্ঞাপন রাখার প্রক্রিয়াটিকে আরও পরিষ্কারভাবে আলাদা করে।

আমরা চাই আপনি আপনার নগদীকরণ সেটিংস পরিবর্তন করতে এবং আপনার গেমের একটি নতুন সংস্করণ সম্পাদনা এবং প্রকাশ না করেই ব্যবহারকারীর অভিজ্ঞতা নিয়ন্ত্রণ করতে সক্ষম হন, প্রাথমিকভাবে ট্যাগে ইঙ্গিতগুলি নির্দিষ্ট করে৷ কিন্তু ভবিষ্যতের রিলিজে আমরা সরাসরি AdSense এবং AdMob ফ্রন্টএন্ডে নিয়ন্ত্রণ প্রদান করতে পারব।

ইন্টারস্টিশিয়াল

একটি ইন্টারস্টিশিয়াল বিজ্ঞাপন হল একটি পূর্ণ স্ক্রীন বিজ্ঞাপন যা আপনার গেমের বিভিন্ন মুহুর্তে দেখাতে পারে, যেমন প্লেয়ার যখন গেমটি শুরু করে বা প্লেয়ার একটি লেভেল সম্পূর্ণ করার পরে। এটি গেমটিকে বিরতি দেয়, পুরো ডকুমেন্ট কভার করে এবং প্লেয়ার বিজ্ঞাপনটি ক্লিক করতে পারে (যে ক্ষেত্রে বিজ্ঞাপনটি তাদের ব্রাউজারের একটি ভিন্ন ট্যাবে দেখায়) বা বাতিল করতে পারে যা তাদের গেমের সাথে এগিয়ে যেতে দেয়।

দ্রষ্টব্য: আপনার গেম এমনকি তার ব্যবহারকারী ইন্টারফেস লোড করার আগে একটি ইন্টারস্টিশিয়াল দেখানো যেতে পারে। এই ধরনের বিজ্ঞাপনকে প্রিরোল বলা হয় এবং নিয়মিত ইন্টারস্টিশিয়াল থেকে একটু ভিন্নভাবে আচরণ করা প্রয়োজন। প্রিরোল সম্পর্কে আরও জানুন

একটি ইন্টারস্টিশিয়াল বিজ্ঞাপন স্থাপন করতে, প্লেসমেন্ট কনফিগারেশনের মধ্যে নিম্নলিখিত ক্ষেত্রগুলি পূরণ করুন:

adBreak({
   type: 'start',           // The type of this placement
   name: 'game_started',    // A descriptive name for this placement
   beforeAd: beforeAd,      // Prepare for the ad. Mute and pause the game flow
   afterAd: afterAd,        // Resume the game and un-mute the sound
   adBreakDone: breakDone,  // Always called (if provided) even if an ad didn't show
});

type আর্গুমেন্ট প্রয়োজন, এবং আমরা সুপারিশ করি যে আপনি সর্বদা আপনার প্লেসমেন্টের নাম দিন । অন্যান্য কলব্যাক ঐচ্ছিক।

কল ক্রম

একটি ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য কল ক্রম পর্যালোচনা করুন।

বর্ণনা

ইন্টারস্টিশিয়াল - বিস্তারিত কল ক্রম
আপনার H5 গেম	বিজ্ঞাপন বসানো API
	বিজ্ঞাপনের সূচনা এবং প্রিলোডিং
খেলা চলছে
একটি বিজ্ঞাপন দেখানোর একটি ভাল সুযোগ... adBreak() →
	একটি বিজ্ঞাপন উপলব্ধ আছে এবং এখন এটি দেখানোর জন্য একটি ভাল সময়... ← beforeAd()
গেমটি বিরতি দেয়, শব্দটি নিঃশব্দ করে এবং বিজ্ঞাপনটি দেখানোর জন্য প্রস্তুত হয়। API এ return যান →
	অ্যাড প্লেসমেন্ট API ইন্টারস্টিশিয়াল বিজ্ঞাপন রেন্ডার করে। প্লেয়ার বিজ্ঞাপনে ক্লিক করতে পারে (যা একটি নতুন ট্যাবে প্রদর্শিত হয়)। গেম খেলা চালিয়ে যাওয়ার জন্য তাদের অবশ্যই বিজ্ঞাপনটি খারিজ করতে হবে।
	← afterAd() বলা হয় যদি কোন বিজ্ঞাপন দেখানো হয়
গেমটি আনপজ করে এবং শব্দটি আনমিউট করে।
	← adBreakDone() adBreakDone() সবসময় কল করা হয় (যদিও বিজ্ঞাপন দেখানো না হয়)
গেমটি এই প্লেসমেন্ট সম্পর্কে বিশ্লেষণগুলি লগ করে৷

মন্তব্য

• adBreak() একটি অ্যাসিঙ্ক্রোনাস ফাংশন যা অবিলম্বে ফিরে আসে।
• যদি একটি প্লেসমেন্টের জন্য প্রদর্শনের জন্য কোনো বিজ্ঞাপন না থাকে তাহলে কলব্যাকগুলির কোনোটিই বলা হয় না—অর্থাৎ, কোনোটি beforeAd() , afterAd() , বলা হয় না৷
• বিজ্ঞাপনটি দেখানোর সময় আপনার গেমটি কার্যকর না হয় তা নিশ্চিত করার জন্য, সাউন্ড মিউট করতে এবং গেমটি পজ করতে beforeAd() কলব্যাক ব্যবহার করুন।
• beforeAd() সিঙ্ক্রোনাস, অ্যাড প্লেসমেন্ট API একটি বিজ্ঞাপন দেখাবে না যতক্ষণ না এটি ফিরে আসে।
• আপনার গেম রিস্টার্ট করুন এবং afterAd() কল পেলে সাউন্ড আন-মিউট করুন।
• যদি প্রদান করা হয়, তাহলে সর্বদা adBreakDone() বলা হয় এমনকি যদি এই প্লেসমেন্টে কোনো বিজ্ঞাপন দেখানো না হয়।
• অন্য বিজ্ঞাপন দেখানোর সময় adBreak() কল করা ব্যর্থ হবে এবং JavaScript কনসোলে একটি সতর্কতা প্রদর্শিত হবে।

প্রিরোল

একটি প্রিরোল হল একটি ইন্টারস্টিশিয়াল যা আপনার গেমের UI লোড হওয়ার আগে প্রদর্শিত হয়। একজন খেলোয়াড় যখন আপনার গেমে নেভিগেট করে তখন এটি প্রথম জিনিসটি দেখে। কারণ একটি প্রিরোল পৃষ্ঠা লোডের খুব তাড়াতাড়ি ঘটে, এবং আপনার গেমটি এখনও প্রদর্শিত হয়নি—আপনার গেমকে বিরতি এবং নিঃশব্দ করার জন্য সাধারণ কলগুলির প্রয়োজন নেই৷ পরিবর্তে আপনি বিজ্ঞাপনের সাথে আপনার গেমের শুরুর ক্রমানুসারে adBreakDone() কলব্যাক ব্যবহার করুন—অর্থাৎ, UI রেন্ডার করুন এবং শব্দ বাজানো শুরু করুন। প্রতিটি পৃষ্ঠা লোডের জন্য শুধুমাত্র একটি প্রিরোল ট্রিগার করা যেতে পারে।

কল ক্রম

একটি প্রিরোলের জন্য কল পৃষ্ঠা লোডের খুব তাড়াতাড়ি করা হয়৷ যেহেতু আপনার গেমটি এই মুহুর্তে তার UI রেন্ডার করেনি, তাই আপনার beforeAd() এবং afterAd() কলব্যাকগুলি পাস করা উচিত নয়৷ পরিবর্তে, প্লেসমেন্টের পরে আপনার গেম শুরু করতে adBreakDone() ব্যবহার করুন, কারণ কোনও বিজ্ঞাপন না থাকলেও এটি কল করা নিশ্চিত।

নিচের কোডে কল করলে, আপনার গেমের লজিকের প্রথম দিকে একটি প্রিরোল বিজ্ঞাপন থাকবে। এই কোডটি কল করার আগে আপনার UI রেন্ডার করা উচিত নয়।

// Game must not be running.
// Nothing in the game area should be clickable
adBreak({
   type: ‘preroll',
   adBreakDone: startGame,
})

প্রিরোল - বিস্তারিত কল ক্রম
আপনার H5 গেম	বিজ্ঞাপন বসানো API
	এপিআই আরম্ভ করা এবং বিজ্ঞাপনের প্রাক-ক্যাশিং শুরু হয়
চলছে কিন্তু শুরু হয়নি এবং একটি UI প্রদর্শন করেনি
adBreak(type:'preroll',…) →
	অ্যাড প্লেসমেন্ট এপিআই বিজ্ঞাপনগুলি শুরু এবং লোড করা শেষ করে৷ কোনো বিজ্ঞাপন থাকলে তা দেখানো হয়। প্লেয়ার বিজ্ঞাপনে ক্লিক করতে পারে (যা একটি নতুন ট্যাবে প্রদর্শিত হয়)। খেলা শুরু করার জন্য তাদের অবশ্যই এটি বাতিল করতে হবে।
	← adBreakDone() সর্বদা কল করা হয় (এমনকি যদি একটি বিজ্ঞাপন দেখানো না হয়)
গেম UI স্ক্রিনে রেন্ডার করা হয়েছে এবং প্লেয়ার এখন এটির সাথে ইন্টারঅ্যাক্ট করতে পারে। গেমটি প্রয়োজন অনুযায়ী placementInfo adBreakDone() পাস করা PlacementInfo অবজেক্ট ব্যবহার করতে পারে (উদাহরণস্বরূপ, অতিরিক্ত বিশ্লেষণ লগ করতে)।

মন্তব্য

• একটি প্রিরোল সর্বদা বিজ্ঞাপনগুলি প্রিলোড করার চেষ্টা করবে:
  • adConfig(preloadAds: 'on') কল করার প্রয়োজন নেই।
• অন্যান্য বিজ্ঞাপন প্লেসমেন্টের মত, একটি প্রিরোল একটি বিজ্ঞাপন প্রদর্শন করতে পারে বা নাও করতে পারে।
• beforeAd() এবং afterAd() একটি প্রিরোলে পাস করা উচিত নয়।
  • যেহেতু আপনার গেম শুরু হওয়ার আগে প্রি-রোল বিজ্ঞাপনগুলি চলে, তাই গেমের শব্দকে বিরতি বা নিঃশব্দ করার দরকার নেই৷
  • যদি আপনি একটি প্রিরোলের সাথে beforeAd() বা afterAd() ) পাস করেন, তাহলে কলটি ব্যর্থ হবে এবং একটি ত্রুটি জাভাস্ক্রিপ্ট কনসোলে লগ করা হবে।
• একটি প্রিরোল স্বয়ংক্রিয়ভাবে বিজ্ঞাপন প্লেসমেন্ট API এর আরম্ভ এবং প্রিলোড বিজ্ঞাপনের জন্য অপেক্ষা করে:
  • যাইহোক, একটি টাইমআউট (2s) আছে যা কলটিকে অনির্দিষ্টকালের জন্য বিলম্বিত হতে বাধা দেয়। এটি নিশ্চিত করে যে adBreakDone() একটি সময়মত কল করা হবে এবং আপনার গেম শুরু হবে।
  • কোনো বিজ্ঞাপন না থাকলেও adBreakDone() কে সবসময় ডাকা হয়।
• আপনার গেম শুরু হওয়ার আগে আমরা আপনাকে বিজ্ঞাপন দেওয়ার জন্য একটি প্রিরোল ব্যবহার করার পরামর্শ দিই।
  • বিকল্পভাবে, আপনি onReady() to adConfig() onReady() কলব্যাক ব্যবহার করতে পারেন আপনার গেম লজিককে API এর আরম্ভ এবং প্রিলোডিং বিজ্ঞাপনের সাথে সিকোয়েন্স করার জন্য।

পুরস্কৃত বিজ্ঞাপন

একটি পুরস্কৃত বিজ্ঞাপন আপনাকে আপনার খেলোয়াড়দের অ্যাপ-মধ্যস্থ আইটেম দিয়ে পুরস্কৃত করতে দেয় যদি তারা একটি বিজ্ঞাপন দেখতে পছন্দ করে। যেখানে ইন্টারস্টিশিয়ালগুলি অপ্ট-আউট করা হয় , একজন খেলোয়াড়কে বিজ্ঞাপন দেখানো হয় এবং এটি খারিজ করতে বেছে নিতে পারে৷ পুরস্কৃত বিজ্ঞাপন অপ্ট-ইন হয় . পুরষ্কার পাওয়ার জন্য একজন খেলোয়াড় বেছে নেয় যে তারা কখন বিজ্ঞাপন দেখতে চায়।

ইন্টারস্টিশিয়ালের বিপরীতে, যেখানে প্লেয়ার যেকোন সময় বিজ্ঞাপনটি খারিজ করতে পারে, পুরস্কার পাওয়ার জন্য তাদের অবশ্যই ন্যূনতম সময়ের জন্য বিজ্ঞাপনটি দেখতে হবে (যা বিজ্ঞাপন ক্রিয়েটিভ দেখানোর উপর নির্ভর করে পরিবর্তিত হতে পারে)।

যেহেতু পুরস্কৃত বিজ্ঞাপনগুলি খেলোয়াড়ের জন্য ঐচ্ছিক, সেগুলিকে আপনার গেম ফ্লোতে গভীর একীকরণের প্রয়োজন৷ আপনার গেমের মধ্যে একটি পুরষ্কার প্রম্পট রেন্ডার করার জন্য আপনাকে অবশ্যই ফাংশন প্রদান করতে হবে এবং প্লেয়ার যদি বিজ্ঞাপনটি দেখেন তবে তাকে পুরস্কার বরাদ্দ করতে হবে।

পুরস্কারের আপনার অ্যাপের বাইরে মূল্য থাকতে হবে না, তাদের অবশ্যই আর্থিক মূল্য থাকতে হবে না (বা সহজে বিনিময় করা যাবে) এবং পণ্য ও পরিষেবার জন্য বিক্রয়যোগ্য বা বিনিময়যোগ্য হতে হবে না এবং আপনার খেলোয়াড়দের বিজ্ঞাপনে ক্লিক করতে উৎসাহিত করা উচিত নয়। অনুগ্রহ করে ইন্টারস্টিশিয়ালের জন্য খসড়া নীতি দেখুন এবং আরও বিশদ বিবরণের জন্য পুরস্কৃত করুন।

যেহেতু পুরষ্কারগুলি খেলোয়াড়ের জন্য ঐচ্ছিক, তাই আপনি সেগুলিকে আপনার গেমের মধ্যে উপলব্ধি করে এমন যেকোনো জায়গায় যোগ করতে পারেন এবং ইন্টারস্টিশিয়াল ছাড়াও সেগুলি ব্যবহার করতে পারেন৷ ইন্টারস্টিশিয়ালের মতো, এই প্লেসমেন্ট হল পুরস্কৃত বিজ্ঞাপন দেখানোর সুযোগ । অ্যাড প্লেসমেন্ট API শুধুমাত্র আপনার কোড কল করবে যদি একটি পুরস্কৃত বিজ্ঞাপন আসলে আপনার গেমের একটি নির্দিষ্ট পয়েন্টে অফার করা হয়।

এখানে আবার লক্ষ্য হল আপনাকে বিজ্ঞাপন প্লেসমেন্ট API-এর সাথে আপনার গেমকে একবার এবং তারপরে একীভূত করার অনুমতি দেওয়া, সময়ের সাথে সাথে ট্যাগ বা AdSense-এ কন্ট্রোল ব্যবহার করে, আপনি সক্রিয় করা বিজ্ঞাপনগুলির সুনির্দিষ্ট মিশ্রণ পরিবর্তন করতে পারেন-তা ছাড়াই আপনার গেমটি পুনরায় কোড করুন এবং পুনরায় প্রকাশ করুন।

পুরস্কৃত প্লেসমেন্টের ধরন সর্বদা 'reward' এবং প্লেসমেন্ট কনফিগারেশনের সমস্ত ক্ষেত্র ব্যবহার করা যেতে পারে।

adBreak({
   type: 'reward',                      // 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 it finished.
   adViewed: () => {},                  // Player watched the ad–give them the reward.
   adBreakDone: (placementInfo) => {},  // Always called (if provided) even if an ad didn't show
});

মূল নতুন ফাংশন হল beforeReward() যা ট্রিগার যা আপনাকে পুরষ্কার প্রম্পট রেন্ডার করার সংকেত দেয় এবং adViewed() যাকে বলা হয় যখন প্লেয়ার সফলভাবে বিজ্ঞাপনটি দেখেছে, যাতে আপনি তাদের পুরস্কার বরাদ্দ করতে পারেন।

আপনি নিম্নরূপ একটি পুরস্কৃত স্থান নির্ধারণ করতে পারেন:

adBreak({
   type: 'reward',
   name: 'new_life_reward_1',
   beforeAd: pauseGame,
   afterAd: restartGame,
   beforeReward: showRewardPrompt,
   adDismissed: adDismissed,
   adViewed: adViewed,
   adBreakDone: breakDone,
});

পুরস্কৃত বিজ্ঞাপনগুলি আপনার গেমে একটি প্রম্পট দিয়ে শুরু হয় যাতে খেলোয়াড় একটি বিজ্ঞাপন দেখেন তাহলে তাকে একটি পুরস্কার প্রদান করা হয়।

একটি পুরস্কৃত বিজ্ঞাপনের জন্য কল ক্রম

বর্ণনা

পুরস্কৃত বিজ্ঞাপন - বিস্তারিত কল ক্রম
আপনার H5 গেম	বিজ্ঞাপন বসানো API
	বিজ্ঞাপনের সূচনা এবং প্রাক-ক্যাশিং
খেলা চলছে
adBreak(type:'reward', ... ) →
	একটি বিজ্ঞাপন উপলব্ধ আছে তাই একটি পুরস্কৃত বিজ্ঞাপন বসানো শুরু করুন. beforeReward() কে সিঙ্ক্রোনাসলি বলা হয়-অ্যাডব্রেককে কল করার adBreak() ← beforeReward(showAdFn)
গেমটি রিওয়ার্ড প্রম্পট রেন্ডার করে। এটি খেলোয়াড়কে একটি বিজ্ঞাপন দেখে পুরস্কার পাওয়ার সুযোগ দেয়। একাধিক ধরণের পুরস্কার দেওয়া যেতে পারে (উদাহরণস্বরূপ, একটি নতুন জীবন বা একটি সোনার মুদ্রা)। প্লেয়ার একটি পুরষ্কার প্রম্পটে ক্লিক করতে পারে, তাদের বরখাস্ত করতে পারে, বা কেবল তাদের উপেক্ষা করতে পারে। যদি তারা একটি প্রম্পটে ক্লিক করে, তাহলে গেমটি তাদের অনুরোধ করা পুরস্কার সঞ্চয় করে এবং showAdFn()... অন্যথায় যদি পুরষ্কার প্রম্পটটি খারিজ করা হয় বা উপেক্ষা করা হয় তবে আপনি পুরস্কার প্লেসমেন্ট টাইপ সহ adBreak() এ আরেকটি কল না করা পর্যন্ত কিছুই ঘটবে না যেখানে Ad Placement API রিসেট করবে এবং এই কল থেকে স্টেট পরিষ্কার করবে। অ্যাপটি যদি পূর্ববর্তী বিজ্ঞাপন বিরতি থেকে showAdFn কল করে তবে এর কোন প্রভাব নেই।
showAdFn() →
	← beforeAd()
গেমটি বিরতি দেয়, শব্দটি নিঃশব্দ করে এবং বিজ্ঞাপনটি দেখানোর জন্য প্রস্তুত হয় API এ return যান →
	API বিজ্ঞাপনটি দেখায়। এটিতে একটি খারিজ বোতাম রয়েছে এবং বিজ্ঞাপনে কতটা সময় থাকবে তার একটি গণনা রয়েছে৷
যদি খেলোয়াড় বিজ্ঞাপনটি খারিজ করে দেয়...
	← adDismissed()
প্লেয়ার বিজ্ঞাপনটি খারিজ করেছে এবং গেমটি পুরষ্কার জারি করে না।
অন্যথায় প্লেয়ার বিজ্ঞাপনটি সম্পূর্ণ করতে দেখেন...
	← adViewed()
খেলোয়াড় সমাপ্তির বিজ্ঞাপনটি দেখেছে এবং গেমটি পুরষ্কার জারি করেছে। (এটি সাধারণত কিছু গেম স্টেট সেট করার মাধ্যমে হবে যা তারপরে নিচের afterAd() এ কল দিয়ে গেমটি পুনরায় আরম্ভ করার সময় তোলা হয়)।
বিজ্ঞাপনটি দেখা বা খারিজ করার পরে...
	← afterAd() বলা হয় যদি কোন বিজ্ঞাপন দেখানো হয়
গেমটি আনপজ করে এবং শব্দটি আনমিউট করে।
	← adBreakDone() adBreakDone() সবসময় কল করা হয় (যদিও বিজ্ঞাপন দেখানো না হয়)
গেমটি এই প্লেসমেন্ট সম্পর্কে বিশ্লেষণগুলি লগ করে৷

মন্তব্য

• adBreak() একটি অ্যাসিঙ্ক্রোনাস ফাংশন যা অবিলম্বে ফিরে আসে।
• যদি একটি প্লেসমেন্টের জন্য প্রদর্শনের জন্য কোনো বিজ্ঞাপন না থাকে তাহলে কোনোটি কলব্যাককে বলা হয় না—অর্থাৎ, কোনোটি beforeAd() , beforeReward() বলা হয় না।
• বিজ্ঞাপনটি দেখানোর সময় আপনার গেমটি কার্যকর না হয় তা নিশ্চিত করার জন্য, সাউন্ড মিউট করতে এবং গেমটি পজ করতে beforeAd() কলব্যাক ব্যবহার করুন।
• beforeAd() সিঙ্ক্রোনাস, অ্যাড প্লেসমেন্ট API একটি বিজ্ঞাপন দেখাবে না যতক্ষণ না এটি ফিরে আসে।
• আপনার গেম রিস্টার্ট করুন এবং afterAd() কল পেলে সাউন্ড আন-মিউট করুন।
• যদি প্রদান করা হয়, তাহলে সর্বদা adBreakDone() বলা হয় এমনকি যদি এই প্লেসমেন্টে কোনো বিজ্ঞাপন দেখানো না হয়।
• অন্য বিজ্ঞাপন দেখানোর সময় adBreak() কল করা ব্যর্থ হবে এবং JavaScript কনসোলে একটি সতর্কতা প্রদর্শিত হবে।