বিজ্ঞাপন পরিদর্শক (বিটা)

বিজ্ঞাপন পরিদর্শক হল একটি ইন-অ্যাপ ওভারলে যা অনুমোদিত ডিভাইসগুলিকে সরাসরি মোবাইল অ্যাপের মধ্যে পরীক্ষার বিজ্ঞাপনের অনুরোধের রিয়েল-টাইম বিশ্লেষণ করতে সক্ষম করে। এটি Google Mobile Ads SDK সংস্করণ 20.2.0 এবং উচ্চতরের সাথে অন্তর্ভুক্ত করা হয়েছে এবং কোন কোডিং প্রয়োজন ছাড়াই সক্ষম করা যেতে পারে।

বিজ্ঞাপন পরিদর্শক ব্যবহার করে, আপনি করতে পারেন:

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

বিজ্ঞাপন পরিদর্শকের বিভিন্ন বৈশিষ্ট্য কীভাবে লঞ্চ করতে হয় এবং ব্যবহার করতে হয় তা এই নির্দেশিকা প্রদর্শন করে।

পূর্বশর্ত

বিজ্ঞাপন পরিদর্শক ব্যবহার করার জন্য, আপনাকে এটি করতে হবে:

  • Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 20.2.0 বা উচ্চতর ব্যবহার করুন৷

বিজ্ঞাপন পরিদর্শক চালু করুন

নিম্নলিখিত উপায়ে আপনার অ্যাপের যেকোনো জায়গা থেকে অ্যাড ইন্সপেক্টর চালু করা যেতে পারে:

  1. ডিবাগ মেনু থেকে লঞ্চ বোতামটি ব্যবহার করুন।
  2. বিজ্ঞাপন পরিদর্শক সেটিংসে আপনি যে অঙ্গভঙ্গি বেছে নিয়েছেন সেটি ব্যবহার করুন।
  3. প্রোগ্রাম্যাটিকভাবে প্রদত্ত API ব্যবহার করে।

ডিবাগ মেনু ব্যবহার করে লঞ্চ করুন

ডিবাগ মেনুর মাধ্যমে বিজ্ঞাপন পরিদর্শক চালু করতে আপনার অ্যাপে কোনো পরিবর্তনের প্রয়োজন নেই; শুধু আপনার অ্যাড ম্যানেজার নেটওয়ার্ক দ্বারা পরিবেশিত একটি বিজ্ঞাপন খুঁজুন, এবং ডিবাগ মেনু খুলতে দুটি আঙুল দিয়ে বিজ্ঞাপনটিকে স্পর্শ করুন এবং ধরে রাখুন ৷ তারপরে, ওপেন অ্যাড ইন্সপেক্টর নির্বাচন করুন।

আপনি আপনার ডিভাইস লিঙ্ক না করলে, আপনাকে আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করতে বলা হতে পারে৷

এছাড়াও আপনি ডিবাগ সেটিংস থেকে বিজ্ঞাপন পরিদর্শক সেটিংস নির্বাচন করতে পারেন এবং ডিবাগ মেনুতে না গিয়ে ভবিষ্যতে বিজ্ঞাপন পরিদর্শক খুলতে পারে এমন একটি অঙ্গভঙ্গি চয়ন করতে পারেন৷

প্রোগ্রামিকভাবে চালু করুন

বিজ্ঞাপন পরিদর্শকও প্রোগ্রামগতভাবে চালু করা যেতে পারে:

জাভা

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

কোটলিন

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

এই API প্রোগ্রামে নিবন্ধিত পরীক্ষা ডিভাইসের জন্য কাজ করে।

বিজ্ঞাপন ইউনিট দেখুন এবং সমস্যা সমাধান করুন

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

বিজ্ঞাপন পরিদর্শক ব্যবহার করার আগে আমরা Google মোবাইল বিজ্ঞাপন SDK শুরু করার পরামর্শ দিই।

একটি বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা জলপ্রপাতের বিবরণ দেখুন

একটি বিজ্ঞাপন ইউনিটের SDK অনুরোধের লগ দেখতে ট্যাপ করুন, যা সাম্প্রতিক বিজ্ঞাপনের অনুরোধের জন্য বিজ্ঞাপনটি পূরণ হওয়ার সময় পর্যন্ত মধ্যস্থতা জলপ্রপাত সম্পর্কে বিশদ বিবরণ দেয় (বা জলপ্রপাতটি পূরণ না করে শেষ হয়েছে)।

প্রতিটি অনুরোধ ডিসক্লোজার ইন্ডিকেটর ব্যবহার করে প্রসারিত করা যেতে পারে সেই অনুরোধের জন্য মধ্যস্থতা জলপ্রপাতের ফলাফল দেখানোর জন্য, সেই অনুরোধের জন্য প্রযোজ্য যেকোন ত্রুটি এবং বিলম্বতা সহ।

তৃতীয় পক্ষের বিজ্ঞাপন উত্সগুলির জন্য, ত্রুটির বার্তাগুলি সরাসরি বিজ্ঞাপন উত্স থেকে পাঠানো হয়৷ আপনার যদি আরও তথ্যের প্রয়োজন হয়, আপনার তৃতীয় পক্ষের বিজ্ঞাপন উত্সের সাথে পরামর্শ করুন৷

একটি বিজ্ঞাপন ইউনিটের জন্য বিডিংয়ের বিবরণ দেখুন

আপনি যদি বিডিংয়ে নতুন হন, তাহলে ওপেন বিডিংয়ের ভূমিকা পড়ুন।

SDK অনুরোধ লগে, আপনি বিজ্ঞাপনের অনুরোধে কল করা বিডিং বিজ্ঞাপনের উৎস দেখতে পাবেন। বিডিং নিলামে প্রতিটি বিজ্ঞাপনের উৎসের বিশদ বিবরণ দেখতে SDK অনুরোধ লগে একটি বিজ্ঞাপন ইউনিটে ট্যাপ করুন।

দরপত্রের ফলাফলগুলিকে তালিকার শীর্ষের কাছাকাছি আনার জন্য অ্যাকশনেবল আইটেমগুলিকে সাজানো হয়েছে:

  • শীর্ষে রয়েছে বিজ্ঞাপন নেটওয়ার্ক যা নিলাম জিতেছে।

  • পরবর্তী সমস্যা সহ বিজ্ঞাপন নেটওয়ার্ক আছে. আপনি বিডিং প্রায়শই জিজ্ঞাসিত প্রশ্নগুলির শেষে সমস্যাগুলির জন্য সমস্যা সমাধানের পদক্ষেপগুলি অনুসরণ করতে পারেন৷

  • তারপরে, এমন বিজ্ঞাপন নেটওয়ার্ক রয়েছে যেখানে কোনও বিজ্ঞাপন ফেরত আসেনি বা বিড করেনি। এটি বিজ্ঞাপন উত্সের বিভিন্ন সমস্যার সম্ভাব্য সূচক কারণ এটির সেটআপ বা সিদ্ধান্ত নেওয়ার কারণে এটি বিড নাও হতে পারে। আরও সমর্থনের জন্য আপনি বিজ্ঞাপন উত্সের সেটআপ গাইড বা ওপেন বিডিং FAQs দেখতে পারেন।

  • সবশেষে, তালিকার নিচের দিকে রয়েছে বিজ্ঞাপন নেটওয়ার্ক যারা বিডিং নিলামে হারিয়েছে।

মধ্যস্থতা জলপ্রপাত তাদের eCPM মান অনুসারে বিডিং নিলামে জিতেছে এমন বিজ্ঞাপন উত্স রাখতে পারে।

একটি মধ্যস্থতা জলপ্রপাত হল একই ইনভেন্টরির জন্য একাধিক ফলন গোষ্ঠী প্রতিযোগিতার ফলাফল। আপনি একটি একক ফলন গোষ্ঠীতে দশটি পর্যন্ত তৃতীয়-পক্ষের ফলন অংশীদার যোগ করতে পারেন, যার মধ্যে উভয় বিডিং ইল্ড পার্টনার এবং মোবাইল অ্যাপস ইল্ড পার্টনারদের জন্য মধ্যস্থতা।

অ্যাডভান্সড অ্যাড ইউনিট ডিবাগিং

বিজ্ঞাপন ইউনিটের সমস্যা সমাধানের সময়, কোন কিছু কোথায় ব্যর্থ হচ্ছে তা শনাক্ত করতে বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া অনুসন্ধান করা বা ডিবাগিংয়ে সহায়তা করার জন্য Google সহায়তার সাথে শেয়ার করা সহায়ক হতে পারে। জলপ্রপাত চেইনের উপরে মেনু আইকনে আলতো চাপুন এবং সম্পূর্ণ বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া রপ্তানি করতে বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া শেয়ার করুন নির্বাচন করুন। এটি আপনাকে আপনার নিজের অ্যাপে নেটওয়ার্ক ট্রেস চালানোর ঝামেলা বাঁচায়।

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

উপলব্ধ অ্যাডাপ্টার দেখুন

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

ইভেন্টে অ্যাডাপ্টার পাওয়া যায় না বা আরম্ভ করতে ব্যর্থ হয়, আরও তথ্যের জন্য মোবাইল অ্যাপ বিজ্ঞাপন বিতরণ পরিদর্শন দেখুন।

আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করুন

আপনি যদি আপনার অ্যাপের UI-তে নেভিগেট না করে আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করতে চান, তাহলে বিজ্ঞাপন পরিদর্শক সরাসরি বিজ্ঞাপন ইউনিটের বিস্তারিত স্ক্রীন থেকে এটি সমর্থন করে। উপরন্তু, আপনি একবারে একাধিক বিজ্ঞাপন ইউনিট পরীক্ষা করতে, অ্যাসিঙ্ক্রোনাসভাবে লোড করতে এবং আপনার পরীক্ষার বিজ্ঞাপনের অনুরোধগুলি দেখতে এবং এমনকি একক বিজ্ঞাপন উত্স পরীক্ষা করতে সক্ষম।

বিজ্ঞাপন পরীক্ষা

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

আপনি যখন আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করার জন্য প্রস্তুত হন, তখন আপনার বিজ্ঞাপন পরিদর্শক বিজ্ঞাপন পরীক্ষা ট্রিগার করতে আপনার বিজ্ঞাপন পরিদর্শক স্ক্রিনের উপরে পরীক্ষার বিজ্ঞাপনের অনুরোধ বোতামে ট্যাপ করুন। পরীক্ষার ফলাফল তারপর বিজ্ঞাপন পরিদর্শক থেকে অনুরোধ করা শিরোনামের নীচে SDK অনুরোধ লগে প্রদর্শিত হবে।

আপনার অ্যাপে বিজ্ঞাপন পরিদর্শক কীভাবে ব্যবহার করবেন তা জানুন

একক বিজ্ঞাপন উৎস পরীক্ষা

বিজ্ঞাপন পরিদর্শক আপনার অ্যাপে শুধুমাত্র একটি বিডিং বা জলপ্রপাত মধ্যস্থতা বিজ্ঞাপন উত্স থেকে বিজ্ঞাপন পরিবেশন করার জন্য বিজ্ঞাপনের অনুরোধগুলিকে সীমাবদ্ধ করার একটি বৈশিষ্ট্য রয়েছে। এটি আপনাকে যাচাই করতে দেয় যে আপনি থার্ড-পার্টি অ্যাডাপ্টার সঠিকভাবে প্রয়োগ করেছেন এবং বিজ্ঞাপনের উত্সটি প্রত্যাশা অনুযায়ী পরিবেশন করছে।

এই বৈশিষ্ট্যটি সক্ষম করতে, স্ক্রিনের নীচে একক বিজ্ঞাপন উত্স পরীক্ষার সুইচটি টগল করুন। এটি নিম্নলিখিত বিজ্ঞাপন উত্স নির্বাচন ডায়ালগ প্রদর্শন করে:

একক বিজ্ঞাপন উৎস পরীক্ষা ব্যবহার করার আগে আপনাকে অবশ্যই Google মোবাইল বিজ্ঞাপন SDK শুরু করতে হবে।

তারপরে আপনি পরীক্ষা করার জন্য একটি একক বিজ্ঞাপন উত্স নির্বাচন করতে পারেন৷ একবার বিজ্ঞাপনের উৎস নির্বাচন করা হলে, নিম্নলিখিত স্ক্রিনটি প্রদর্শিত হবে:

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

আপনার অ্যাপ পুনরায় চালু করার পরে, সমস্ত বিজ্ঞাপন ইউনিট প্লেসমেন্ট শুধুমাত্র নির্বাচিত নেটওয়ার্ক থেকে একটি বিজ্ঞাপন দেখানোর চেষ্টা করে। একটি একক বিজ্ঞাপন উত্স পরীক্ষা সক্রিয় থাকলে বিজ্ঞাপন পরিদর্শক চালু করা সক্রিয় পরীক্ষার বিজ্ঞাপন উত্স দেখায়:

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

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

আপনি যদি একটি মধ্যস্থতা জলপ্রপাতে নির্বাচিত বিজ্ঞাপন উত্সের একাধিক দৃষ্টান্ত যোগ করে থাকেন, তাহলে বিজ্ঞাপনটি পূরণ না হওয়া পর্যন্ত বা জলপ্রপাতটি পূরণ না হওয়া পর্যন্ত আপনি জলপ্রপাতের বিজ্ঞাপন উত্সে কলের প্রতিটি ঘটনা দেখতে পাবেন।

একটি একক বিজ্ঞাপন উৎস পরীক্ষা বন্ধ করুন

পরীক্ষা বন্ধ করতে, সুইচটি টগল বন্ধ করুন:

একটি নিশ্চিতকরণ বার্তা তারপর নিম্নলিখিত পুনঃসূচনা পর্দায় প্রদর্শিত হবে:

পরীক্ষা করা বিজ্ঞাপন উত্সের জন্য ক্যাশে করা বিজ্ঞাপনগুলিকে বাতিল করার জন্য আমরা পরীক্ষা বন্ধ করার পরে আপনার অ্যাপটিকে জোর করে পুনরায় চালু করার পরামর্শ দিই।

সম্পূর্ণ ডিবাগিং আউটপুট কপি করুন

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

এটি করতে, অ্যাপ আইকনে সাতবার আলতো চাপুন যতক্ষণ না আপনি ক্লিপবোর্ডে বিজ্ঞাপন পরিদর্শক JSON অনুলিপি করেছেন বার্তাটি দেখতে পান।

,বিজ্ঞাপন পরিদর্শক হল একটি ইন-অ্যাপ ওভারলে যা অনুমোদিত ডিভাইসগুলিকে সরাসরি মোবাইল অ্যাপের মধ্যে পরীক্ষার বিজ্ঞাপনের অনুরোধের রিয়েল-টাইম বিশ্লেষণ করতে সক্ষম করে। এটি Google Mobile Ads SDK সংস্করণ 20.2.0 এবং উচ্চতরের সাথে অন্তর্ভুক্ত করা হয়েছে এবং কোন কোডিং প্রয়োজন ছাড়াই সক্ষম করা যেতে পারে।

বিজ্ঞাপন পরিদর্শক ব্যবহার করে, আপনি করতে পারেন:

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

বিজ্ঞাপন পরিদর্শকের বিভিন্ন বৈশিষ্ট্য কীভাবে লঞ্চ করতে হয় এবং ব্যবহার করতে হয় তা এই নির্দেশিকা প্রদর্শন করে।

পূর্বশর্ত

বিজ্ঞাপন পরিদর্শক ব্যবহার করার জন্য, আপনাকে এটি করতে হবে:

  • Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 20.2.0 বা উচ্চতর ব্যবহার করুন৷

বিজ্ঞাপন পরিদর্শক চালু করুন

নিম্নলিখিত উপায়ে আপনার অ্যাপের যেকোনো জায়গা থেকে অ্যাড ইন্সপেক্টর চালু করা যেতে পারে:

  1. ডিবাগ মেনু থেকে লঞ্চ বোতামটি ব্যবহার করুন।
  2. বিজ্ঞাপন পরিদর্শক সেটিংসে আপনি যে অঙ্গভঙ্গি বেছে নিয়েছেন সেটি ব্যবহার করুন।
  3. প্রোগ্রাম্যাটিকভাবে প্রদত্ত API ব্যবহার করে।

ডিবাগ মেনু ব্যবহার করে লঞ্চ করুন

ডিবাগ মেনুর মাধ্যমে বিজ্ঞাপন পরিদর্শক চালু করতে আপনার অ্যাপে কোনো পরিবর্তনের প্রয়োজন নেই; শুধু আপনার অ্যাড ম্যানেজার নেটওয়ার্ক দ্বারা পরিবেশিত একটি বিজ্ঞাপন খুঁজুন, এবং ডিবাগ মেনু খুলতে দুটি আঙুল দিয়ে বিজ্ঞাপনটিকে স্পর্শ করুন এবং ধরে রাখুন ৷ তারপরে, ওপেন অ্যাড ইন্সপেক্টর নির্বাচন করুন।

আপনি আপনার ডিভাইস লিঙ্ক না করলে, আপনাকে আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করতে বলা হতে পারে৷

এছাড়াও আপনি ডিবাগ সেটিংস থেকে বিজ্ঞাপন পরিদর্শক সেটিংস নির্বাচন করতে পারেন এবং ডিবাগ মেনুতে না গিয়ে ভবিষ্যতে বিজ্ঞাপন পরিদর্শক খুলতে পারে এমন একটি অঙ্গভঙ্গি চয়ন করতে পারেন৷

প্রোগ্রামিকভাবে চালু করুন

বিজ্ঞাপন পরিদর্শকও প্রোগ্রামগতভাবে চালু করা যেতে পারে:

জাভা

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

কোটলিন

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

এই API প্রোগ্রামে নিবন্ধিত পরীক্ষা ডিভাইসের জন্য কাজ করে।

বিজ্ঞাপন ইউনিট দেখুন এবং সমস্যা সমাধান করুন

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

বিজ্ঞাপন পরিদর্শক ব্যবহার করার আগে আমরা Google মোবাইল বিজ্ঞাপন SDK শুরু করার পরামর্শ দিই।

একটি বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা জলপ্রপাতের বিবরণ দেখুন

একটি বিজ্ঞাপন ইউনিটের SDK অনুরোধের লগ দেখতে ট্যাপ করুন, যা সাম্প্রতিক বিজ্ঞাপনের অনুরোধের জন্য বিজ্ঞাপনটি পূরণ হওয়ার সময় পর্যন্ত মধ্যস্থতা জলপ্রপাত সম্পর্কে বিশদ বিবরণ দেয় (বা জলপ্রপাতটি পূরণ না করে শেষ হয়েছে)।

প্রতিটি অনুরোধ ডিসক্লোজার ইন্ডিকেটর ব্যবহার করে প্রসারিত করা যেতে পারে সেই অনুরোধের জন্য মধ্যস্থতা জলপ্রপাতের ফলাফল দেখানোর জন্য, সেই অনুরোধের জন্য প্রযোজ্য যেকোন ত্রুটি এবং বিলম্বতা সহ।

তৃতীয় পক্ষের বিজ্ঞাপন উত্সগুলির জন্য, ত্রুটির বার্তাগুলি সরাসরি বিজ্ঞাপন উত্স থেকে পাঠানো হয়৷ আপনার যদি আরও তথ্যের প্রয়োজন হয়, আপনার তৃতীয় পক্ষের বিজ্ঞাপন উত্সের সাথে পরামর্শ করুন৷

একটি বিজ্ঞাপন ইউনিটের জন্য বিডিংয়ের বিবরণ দেখুন

আপনি যদি বিডিংয়ে নতুন হন, তাহলে ওপেন বিডিংয়ের ভূমিকা পড়ুন।

SDK অনুরোধ লগে, আপনি বিজ্ঞাপনের অনুরোধে কল করা বিডিং বিজ্ঞাপনের উৎস দেখতে পাবেন। বিডিং নিলামে প্রতিটি বিজ্ঞাপনের উৎসের বিশদ বিবরণ দেখতে SDK অনুরোধ লগে একটি বিজ্ঞাপন ইউনিটে ট্যাপ করুন।

দরপত্রের ফলাফলগুলিকে তালিকার শীর্ষের কাছাকাছি আনার জন্য অ্যাকশনেবল আইটেমগুলিকে সাজানো হয়েছে:

  • শীর্ষে রয়েছে বিজ্ঞাপন নেটওয়ার্ক যা নিলাম জিতেছে।

  • পরবর্তী সমস্যা সহ বিজ্ঞাপন নেটওয়ার্ক আছে. আপনি বিডিং প্রায়শই জিজ্ঞাসিত প্রশ্নগুলির শেষে সমস্যাগুলির জন্য সমস্যা সমাধানের পদক্ষেপগুলি অনুসরণ করতে পারেন৷

  • তারপরে, এমন বিজ্ঞাপন নেটওয়ার্ক রয়েছে যেখানে কোনও বিজ্ঞাপন ফেরত আসেনি বা বিড করেনি। এটি বিজ্ঞাপন উত্সের বিভিন্ন সমস্যার সম্ভাব্য সূচক কারণ এটির সেটআপ বা সিদ্ধান্ত নেওয়ার কারণে এটি বিড নাও হতে পারে। আরও সমর্থনের জন্য আপনি বিজ্ঞাপন উত্সের সেটআপ গাইড বা ওপেন বিডিং FAQs দেখতে পারেন।

  • সবশেষে, তালিকার নিচের দিকে রয়েছে বিজ্ঞাপন নেটওয়ার্ক যারা বিডিং নিলামে হারিয়েছে।

মধ্যস্থতা জলপ্রপাত তাদের eCPM মান অনুসারে বিডিং নিলামে জিতেছে এমন বিজ্ঞাপন উত্স রাখতে পারে।

একটি মধ্যস্থতা জলপ্রপাত হল একই ইনভেন্টরির জন্য একাধিক ফলন গোষ্ঠী প্রতিযোগিতার ফলাফল। আপনি একটি একক ফলন গোষ্ঠীতে দশটি পর্যন্ত তৃতীয়-পক্ষের ফলন অংশীদার যোগ করতে পারেন, যার মধ্যে উভয় বিডিং ইল্ড পার্টনার এবং মোবাইল অ্যাপস ইল্ড পার্টনারদের জন্য মধ্যস্থতা।

অ্যাডভান্সড অ্যাড ইউনিট ডিবাগিং

বিজ্ঞাপন ইউনিটের সমস্যা সমাধানের সময়, কোন কিছু কোথায় ব্যর্থ হচ্ছে তা শনাক্ত করতে বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া অনুসন্ধান করা বা ডিবাগিংয়ে সহায়তা করার জন্য Google সহায়তার সাথে শেয়ার করা সহায়ক হতে পারে। জলপ্রপাত চেইনের উপরে মেনু আইকনে আলতো চাপুন এবং সম্পূর্ণ বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া রপ্তানি করতে বিজ্ঞাপনের অনুরোধ এবং প্রতিক্রিয়া শেয়ার করুন নির্বাচন করুন। এটি আপনাকে আপনার নিজের অ্যাপে নেটওয়ার্ক ট্রেস চালানোর ঝামেলা বাঁচায়।

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

উপলব্ধ অ্যাডাপ্টার দেখুন

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

ইভেন্টে অ্যাডাপ্টার পাওয়া যায় না বা আরম্ভ করতে ব্যর্থ হয়, আরও তথ্যের জন্য মোবাইল অ্যাপ বিজ্ঞাপন বিতরণ পরিদর্শন দেখুন।

আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করুন

আপনি যদি আপনার অ্যাপের UI-তে নেভিগেট না করে আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করতে চান, তাহলে বিজ্ঞাপন পরিদর্শক সরাসরি বিজ্ঞাপন ইউনিটের বিস্তারিত স্ক্রীন থেকে এটি সমর্থন করে। উপরন্তু, আপনি একবারে একাধিক বিজ্ঞাপন ইউনিট পরীক্ষা করতে, অ্যাসিঙ্ক্রোনাসভাবে লোড করতে এবং আপনার পরীক্ষার বিজ্ঞাপনের অনুরোধগুলি দেখতে এবং এমনকি একক বিজ্ঞাপন উত্স পরীক্ষা করতে সক্ষম।

বিজ্ঞাপন পরীক্ষা

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

আপনি যখন আপনার বিজ্ঞাপন ইউনিট পরীক্ষা করার জন্য প্রস্তুত হন, তখন আপনার বিজ্ঞাপন পরিদর্শক বিজ্ঞাপন পরীক্ষা ট্রিগার করতে আপনার বিজ্ঞাপন পরিদর্শক স্ক্রিনের উপরে পরীক্ষার বিজ্ঞাপনের অনুরোধ বোতামে ট্যাপ করুন। পরীক্ষার ফলাফল তারপর বিজ্ঞাপন পরিদর্শক থেকে অনুরোধ করা শিরোনামের নীচে SDK অনুরোধ লগে প্রদর্শিত হবে।

আপনার অ্যাপে বিজ্ঞাপন পরিদর্শক কীভাবে ব্যবহার করবেন তা জানুন

একক বিজ্ঞাপন উৎস পরীক্ষা

বিজ্ঞাপন পরিদর্শক আপনার অ্যাপে শুধুমাত্র একটি বিডিং বা জলপ্রপাত মধ্যস্থতা বিজ্ঞাপন উত্স থেকে বিজ্ঞাপন পরিবেশন করার জন্য বিজ্ঞাপনের অনুরোধগুলিকে সীমাবদ্ধ করার একটি বৈশিষ্ট্য রয়েছে। এটি আপনাকে যাচাই করতে দেয় যে আপনি থার্ড-পার্টি অ্যাডাপ্টার সঠিকভাবে প্রয়োগ করেছেন এবং বিজ্ঞাপনের উত্সটি প্রত্যাশা অনুযায়ী পরিবেশন করছে।

এই বৈশিষ্ট্যটি সক্ষম করতে, স্ক্রিনের নীচে একক বিজ্ঞাপন উত্স পরীক্ষার সুইচটি টগল করুন। এটি নিম্নলিখিত বিজ্ঞাপন উত্স নির্বাচন ডায়ালগ প্রদর্শন করে:

একক বিজ্ঞাপন উৎস পরীক্ষা ব্যবহার করার আগে আপনাকে অবশ্যই Google মোবাইল বিজ্ঞাপন SDK শুরু করতে হবে।

তারপরে আপনি পরীক্ষা করার জন্য একটি একক বিজ্ঞাপন উত্স নির্বাচন করতে পারেন৷ একবার বিজ্ঞাপনের উৎস নির্বাচন করা হলে, নিম্নলিখিত স্ক্রিনটি প্রদর্শিত হবে:

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

আপনার অ্যাপ পুনরায় চালু করার পরে, সমস্ত বিজ্ঞাপন ইউনিট প্লেসমেন্ট শুধুমাত্র নির্বাচিত নেটওয়ার্ক থেকে একটি বিজ্ঞাপন দেখানোর চেষ্টা করে। একটি একক বিজ্ঞাপন উত্স পরীক্ষা সক্রিয় থাকলে বিজ্ঞাপন পরিদর্শক চালু করা সক্রিয় পরীক্ষার বিজ্ঞাপন উত্স দেখায়:

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

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

আপনি যদি একটি মধ্যস্থতা জলপ্রপাতে নির্বাচিত বিজ্ঞাপন উত্সের একাধিক দৃষ্টান্ত যোগ করে থাকেন, তাহলে বিজ্ঞাপনটি পূরণ না হওয়া পর্যন্ত বা জলপ্রপাতটি পূরণ না হওয়া পর্যন্ত আপনি জলপ্রপাতের বিজ্ঞাপন উত্সে কলের প্রতিটি ঘটনা দেখতে পাবেন।

একটি একক বিজ্ঞাপন উৎস পরীক্ষা বন্ধ করুন

পরীক্ষা বন্ধ করতে, সুইচটি টগল বন্ধ করুন:

একটি নিশ্চিতকরণ বার্তা তারপর নিম্নলিখিত পুনঃসূচনা পর্দায় প্রদর্শিত হবে:

পরীক্ষা করা বিজ্ঞাপন উত্সের জন্য ক্যাশে করা বিজ্ঞাপনগুলিকে বাতিল করার জন্য আমরা পরীক্ষা বন্ধ করার পরে আপনার অ্যাপটিকে জোর করে পুনরায় চালু করার পরামর্শ দিই।

সম্পূর্ণ ডিবাগিং আউটপুট কপি করুন

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

এটি করতে, অ্যাপ আইকনে সাতবার আলতো চাপুন যতক্ষণ না আপনি ক্লিপবোর্ডে বিজ্ঞাপন পরিদর্শক JSON অনুলিপি করেছেন বার্তাটি দেখতে পান।