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

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

20.2.0এর চেয়ে কম মোবাইল বিজ্ঞাপন SDK সংস্করণে বিজ্ঞাপন পরিদর্শক ব্যবহার করে, আপনি করতে পারেন:

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

মোবাইল বিজ্ঞাপন SDK সংস্করণ 20.2.0 এবং উচ্চতরের জন্য, আপনি এটিও করতে পারেন:

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

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

পূর্বশর্ত

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

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

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

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

  1. একটি পরীক্ষা ডিভাইস নিবন্ধন করার সময় AdMob UI এ নির্বাচিত অঙ্গভঙ্গি ব্যবহার করুন৷
  2. প্রোগ্রাম্যাটিকভাবে প্রদত্ত API ব্যবহার করে।
  3. ডিবাগ মেনু থেকে লঞ্চ বোতামটি ব্যবহার করুন।

অঙ্গভঙ্গি ব্যবহার করে লঞ্চ করুন

একটি অঙ্গভঙ্গি সহ বিজ্ঞাপন পরিদর্শক চালু করতে আপনার অ্যাপে কোনো পরিবর্তনের প্রয়োজন নেই; শুধুমাত্র সেই পরীক্ষা ডিভাইসের জন্য AdMob-এ কনফিগার করা অঙ্গভঙ্গি (ডাবল ফ্লিক বা শেক) করুন। আরও জানুন

AdMob UI-তে একটি অঙ্গভঙ্গি সেট করার পরে (এবং এটি প্রচারের জন্য 15 মিনিট অপেক্ষা করা), আপনার অঙ্গভঙ্গি সেটিং সম্পর্কে জানতে আপনার অ্যাপটিকে Google মোবাইল বিজ্ঞাপন SDK-এর জন্য একটি বিজ্ঞাপন অনুরোধ করতে হবে। যদি আপনার নির্দিষ্ট অঙ্গভঙ্গি কাজ না করে, তাহলে একটি বিজ্ঞাপন লোড করার চেষ্টা করুন, আপনার অ্যাপ পুনরায় চালু করুন এবং আবার অঙ্গভঙ্গি পরীক্ষা করুন।

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

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

জাভা

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টিপ্রোগ্রামে বা AdMob UI-তে নিবন্ধিত পরীক্ষার ডিভাইসগুলির জন্য কাজ করে।

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

একবার চালু হলে, প্রধান বিজ্ঞাপন পরিদর্শক স্ক্রীন প্রদর্শিত হবে, যেখানে আপনার AdMob অ্যাপ আইডির সাথে যুক্ত AdMob UI-তে সমস্ত বিজ্ঞাপন ইউনিটএর একটি তালিকা রয়েছে যার মধ্যে বিডিং বা মধ্যস্থতা কনফিগারেশন রয়েছে:

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

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

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

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

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

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

পূর্বশর্ত: Google মোবাইল বিজ্ঞাপন SDK 20.2.0 বা উচ্চতর

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

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

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

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

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

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

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

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

মধ্যস্থতা জলপ্রপাতে একটি বিজ্ঞাপন উত্সকে কল করা হলে, এটি বিজ্ঞাপন পরিবেশন করতে সক্ষম হয়। মধ্যস্থতা জলপ্রপাতের সাথে বিডিং কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, মধ্যস্থতা গোষ্ঠীতে বিডিং এবং জলপ্রপাত বিজ্ঞাপন উত্সগুলির উদাহরণ 2 এবং উদাহরণ 3 দেখুন৷

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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