এই নির্দেশিকাটিতে অ্যাড ইন্সপেক্টরের বিভিন্ন ফিচার কীভাবে চালু ও ব্যবহার করতে হয়, তা দেখানো হয়েছে।
পূর্বশর্ত
অ্যাড ইন্সপেক্টর ব্যবহার করার জন্য আপনাকে যা করতে হবে:
- শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।
- গুগল মোবাইল অ্যাডস এসডিকে ভার্সন ৯.১.০ বা তার উচ্চতর সংস্করণ ব্যবহার করুন।
- আপনার ডিভাইসটিকে একটি টেস্ট ডিভাইস হিসেবে যুক্ত করুন । অ্যাড ইন্সপেক্টর শুধুমাত্র টেস্ট ডিভাইসগুলিতেই চালু হয়।
লঞ্চ অ্যাড ইন্সপেক্টর
আপনার অ্যাপের যেকোনো জায়গা থেকে নিম্নলিখিত উপায়ে অ্যাড ইন্সপেক্টর চালু করা যেতে পারে:
- টেস্ট ডিভাইস রেজিস্টার করার সময় AdMob UI-তে নির্বাচিত জেসচারটি ব্যবহার করুন।
- প্রদত্ত এপিআই ব্যবহার করে প্রোগ্রামগতভাবে।
- ডিবাগ মেনু থেকে লঞ্চ বাটনটি ব্যবহার করুন।
অঙ্গভঙ্গি ব্যবহার করে চালু করুন
জেসচারের মাধ্যমে অ্যাড ইন্সপেক্টর চালু করতে আপনার অ্যাপে কোনো পরিবর্তনের প্রয়োজন নেই; শুধু সেই জেসচারটি (ডাবল ফ্লিক বা শেক) সম্পাদন করুন যা আপনি সেই টেস্ট ডিভাইসটির জন্য AdMob-এ কনফিগার করেছেন। আরও জানুন
AdMob UI-তে একটি জেসচার সেট করার পর (এবং এটি কার্যকর হওয়ার জন্য ১৫ মিনিট অপেক্ষা করার পর), আপনার জেসচার সেটিং সম্পর্কে জানার জন্য আপনার অ্যাপকে Google Mobile Ads SDK-এর কাছে একটি অ্যাড রিকোয়েস্ট পাঠাতে হবে। যদি আপনার নির্দিষ্ট করা জেসচারটি কাজ না করে, তবে একটি অ্যাড লোড করে, আপনার অ্যাপটি রিস্টার্ট করে, এবং জেসচারটি আবার পরীক্ষা করে দেখুন।
প্রোগ্রাম্যাটিকভাবে চালু করুন
অ্যাড ইন্সপেক্টর প্রোগ্রাম্যাটিকভাবেও চালু করা যেতে পারে:
এই এপিআইটি প্রোগ্রাম্যাটিকভাবে অথবা AdMob UI-তে রেজিস্টার করা টেস্ট ডিভাইসগুলোর জন্য কাজ করে।
বিজ্ঞাপন ইউনিটগুলি দেখুন এবং সমস্যা সমাধান করুন
একবার চালু হলে, মূল বিজ্ঞাপন পরিদর্শক স্ক্রিনটি প্রদর্শিত হয়, যেখানে আপনার AdMob অ্যাপ আইডির সাথে যুক্ত AdMob UI-এর সমস্ত বিজ্ঞাপন ইউনিটের একটি তালিকা থাকে, যেগুলিতে বিডিং বা মিডিয়েশন কনফিগারেশন রয়েছে:
অ্যাড ইন্সপেক্টর ব্যবহার করার আগে গুগল মোবাইল অ্যাডস এসডিকে ইনিশিয়ালাইজ করার পরামর্শ দেওয়া হয়।
একটি বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা প্রক্রিয়ার বিবরণ দেখুন
একটি অ্যাড ইউনিটে ট্যাপ করে তার SDK রিকোয়েস্ট লগ দেখুন, যা সর্বশেষ অ্যাড রিকোয়েস্টগুলোর জন্য অ্যাডটি পূরণ হওয়া পর্যন্ত (অথবা পূরণ ছাড়াই ওয়াটারফলটি শেষ হওয়া পর্যন্ত) মিডিয়েশন ওয়াটারফলের বিস্তারিত তথ্য দেয়।
প্রতিটি অনুরোধকে ডিসক্লোজার ইন্ডিকেটর ব্যবহার করে বিস্তারিত করা যায়, যার মাধ্যমে সেই অনুরোধের জন্য মিডিয়েশন ওয়াটারফলের ফলাফল এবং সেই অনুরোধের জন্য প্রযোজ্য যেকোনো ত্রুটি ও লেটেন্সি দেখা যায়।
তৃতীয় পক্ষের বিজ্ঞাপন উৎসের ক্ষেত্রে, ত্রুটির বার্তাগুলো সরাসরি বিজ্ঞাপন উৎস থেকেই পাঠানো হয়। আপনার যদি আরও তথ্যের প্রয়োজন হয়, তবে আপনার তৃতীয় পক্ষের বিজ্ঞাপন উৎসের সাথে যোগাযোগ করুন।
একটি বিজ্ঞাপন ইউনিটের জন্য নিলামের বিবরণ দেখুন
আপনি যদি নিলামে নতুন হন, তাহলে সংক্ষিপ্ত বিবরণটি পড়ুন।
এসডিকে রিকোয়েস্ট লগে, আপনি সেই বিডিং অ্যাড সোর্সগুলো দেখতে পাবেন যেগুলো অ্যাড রিকোয়েস্টে কল করা হয়েছে। বিডিং অকশনে থাকা প্রতিটি অ্যাড সোর্সের বিস্তারিত দেখতে এসডিকে রিকোয়েস্ট লগে একটি অ্যাড ইউনিটে ট্যাপ করুন।
কার্যকরী বিষয়গুলোকে তালিকার উপরের দিকে নিয়ে আসার জন্য নিলামের ফলাফলগুলো সাজানো হয়েছে:
তালিকার শীর্ষে রয়েছে নিলামে বিজয়ী বিজ্ঞাপন নেটওয়ার্কটি।
এরপরে রয়েছে সমস্যাযুক্ত বিজ্ঞাপন নেটওয়ার্কগুলো। এই সমস্যাগুলো সমাধানের জন্য আপনি ট্রাবলশুটিং ধাপগুলো অনুসরণ করতে পারেন।
এরপর, এমন কিছু অ্যাড নেটওয়ার্ক রয়েছে যেগুলোর কোনো বিজ্ঞাপন দেখানো হয়নি বা যেগুলো বিড করেনি। এটি অ্যাড সোর্সের বিভিন্ন সমস্যার একটি সম্ভাব্য ইঙ্গিত, কারণ এর সেটআপ বা সিদ্ধান্ত গ্রহণের ত্রুটির কারণে এটি হয়তো বিড করেনি। আপনি অ্যাড সোর্সের সেটআপ গাইড দেখতে পারেন অথবা সহায়তার জন্য সরাসরি তাদের সাথে যোগাযোগ করতে পারেন ।
অবশেষে, তালিকার একেবারে নিচে রয়েছে সেইসব বিজ্ঞাপন নেটওয়ার্ক, যারা নিলামে হেরে গেছে।
মিডিয়েশন ওয়াটারফল, বিডিং নিলামে বিজয়ী বিজ্ঞাপন উৎসগুলোকে তাদের eCPM মান অনুযায়ী স্থাপন করতে পারে।
যখন মিডিয়েশন ওয়াটারফলে কোনো অ্যাড সোর্সকে কল করা হয়, তখন সেটি বিজ্ঞাপন পরিবেশন করতে সক্ষম হয়। মিডিয়েশন ওয়াটারফলের সাথে বিডিং কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, একটি মিডিয়েশন গ্রুপে বিডিং এবং ওয়াটারফল অ্যাড সোর্সের উদাহরণ ২ এবং উদাহরণ ৩ দেখুন।
উন্নত অ্যাড ইউনিট ডিবাগিং
অ্যাড ইউনিটগুলির সমস্যা সমাধান করার সময়, কোথায় সমস্যা হচ্ছে তা শনাক্ত করতে অথবা ডিবাগিং-এ সহায়তার জন্য গুগল সাপোর্টের সাথে শেয়ার করতে অ্যাড রিকোয়েস্ট এবং রেসপন্স খতিয়ে দেখা সহায়ক হতে পারে। ওয়াটারফল চেইনের শীর্ষে থাকা মেনু আইকনে ট্যাপ করুন এবং সম্পূর্ণ অ্যাড রিকোয়েস্ট ও রেসপন্স এক্সপোর্ট করতে 'শেয়ার অ্যাড রিকোয়েস্ট অ্যান্ড রেসপন্স' নির্বাচন করুন। এর ফলে আপনাকে নিজের অ্যাপে নেটওয়ার্ক ট্রেস চালানোর ঝামেলা থেকে মুক্তি দেয়।
এছাড়াও, রিকোয়েস্ট স্ট্রিং-এর মেনুতে থাকা ' থার্ড-পার্টি বিডিং প্যারামিটার' অপশনটিতে ট্যাপ করে আপনি ডিকোড করা থার্ড-পার্টি বিডিং প্যারামিটারগুলো দেখতে পারেন। এটি কোন থার্ড-পার্টি বিডিং প্যারামিটারগুলোতে সমস্যা হচ্ছে সে সম্পর্কে বিস্তারিত তথ্য প্রদান করে, যা আপনাকে আপনার অ্যাপ ডিবাগ করতে বা কোনো নেটওয়ার্ক সফলভাবে তার সিগন্যাল সংগ্রহ করছে কিনা তা যাচাই করতে সাহায্য করে।
উপলব্ধ অ্যাডাপ্টারগুলি দেখুন
আপনার অ্যাপের বিডিং বা মিডিয়েশন কনফিগারেশনে থাকা বিজ্ঞাপন উৎসগুলোর সাথে যুক্ত সমস্ত থার্ড-পার্টি অ্যাডাপ্টারের তালিকা দেখতে অ্যাডাপ্টার ট্যাবে ক্লিক করুন। এরপর, তাদের ইনিশিয়ালাইজেশন স্ট্যাটাস এবং SDK ভার্সন দেখতে কার্ডগুলো এক্সপ্যান্ড করুন। সমর্থিত থার্ড-পার্টি অ্যাডাপ্টারগুলোর পাশাপাশি, আপনি কাস্টম ইভেন্ট অ্যাডাপ্টারগুলোও দেখতে পারবেন।
কাস্টম ইভেন্ট পাবলিশারদের এমন অ্যাড নেটওয়ার্ক ব্যবহার করার সুযোগ দেয় যা AdMob সাপোর্ট করে না। অ্যাডাপ্টার লিস্টে কাস্টম ইভেন্টগুলোকে তাদের স্বতন্ত্র ক্লাস নেম দ্বারা স্ট্যান্ডার্ড থার্ড-পার্টি অ্যাডাপ্টার থেকে আলাদা করা যায়। ক্লাস নেম এবং স্ট্যাটাস তথ্য প্রদানের পাশাপাশি, অ্যাড ইন্সপেক্টর AdMob ওয়েব ইন্টারফেসে সেই কাস্টম ইভেন্টগুলোতে নির্ধারিত লেবেলগুলোও প্রদর্শন করে।
যদি অ্যাডাপ্টারটি খুঁজে না পাওয়া যায় বা চালু হতে ব্যর্থ হয়, তাহলে আরও তথ্যের জন্য ‘ad inspector ব্যবহার করে পাওয়া সমস্যাগুলির সমাধান’ দেখুন।
আপনার বিজ্ঞাপন ইউনিটগুলি পরীক্ষা করুন
আপনি যদি আপনার অ্যাপের UI-তে না গিয়েই আপনার অ্যাড ইউনিটটি পরীক্ষা করতে চান, তাহলে অ্যাড ইন্সপেক্টর সরাসরি অ্যাড ইউনিট ডিটেইল স্ক্রিন থেকেই এই সুবিধাটি দেয়। এছাড়াও, আপনি একই সাথে একাধিক অ্যাড ইউনিট পরীক্ষা করতে, অ্যাসিঙ্ক্রোনাসভাবে আপনার টেস্ট অ্যাড রিকোয়েস্টগুলো লোড ও দেখতে এবং এমনকি একক অ্যাড সোর্স পরীক্ষাও করতে পারবেন।
বিজ্ঞাপন পরীক্ষা
এই বিভাগে বর্ণিত অ্যাড ইন্সপেক্টর অ্যাড টেস্টগুলো আপনার বেস অ্যাড এক্সপেরিয়েন্স যাচাই করার জন্য এবং সিঙ্গেল অ্যাড সোর্স টেস্টিং-এর সাথে ব্যবহার করা হলে আপনার মিডিয়েশন কনফিগারেশন ভ্যালিডেট করার জন্য একটি চমৎকার টুল।
যখন আপনি আপনার অ্যাড ইউনিট পরীক্ষা করার জন্য প্রস্তুত হবেন, তখন আপনার অ্যাড ইন্সপেক্টর অ্যাড টেস্টটি চালু করতে আপনার অ্যাড ইন্সপেক্টর স্ক্রিনের উপরের দিকে থাকা ' রিকোয়েস্ট টেস্ট অ্যাড' বোতামটিতে ট্যাপ করুন। এরপর পরীক্ষার ফলাফল SDK রিকোয়েস্ট লগে 'রিকোয়েস্টেড ফ্রম অ্যাড ইন্সপেক্টর' হেডারের নিচে দেখা যাবে।
একক বিজ্ঞাপন উৎস পরীক্ষা
অ্যাড ইন্সপেক্টরে আপনার অ্যাপের অ্যাড রিকোয়েস্টগুলোকে শুধুমাত্র একটি নির্দিষ্ট বিডিং বা ওয়াটারফল মিডিয়েশন অ্যাড সোর্স থেকে বিজ্ঞাপন দেখানোর জন্য সীমাবদ্ধ করার একটি ফিচার রয়েছে। এর মাধ্যমে আপনি যাচাই করতে পারবেন যে, আপনি থার্ড-পার্টি অ্যাডাপ্টারটি সঠিকভাবে ইমপ্লিমেন্ট করেছেন এবং অ্যাড সোর্সটি প্রত্যাশা অনুযায়ী কাজ করছে।
এই ফিচারটি চালু করতে, স্ক্রিনের নিচের দিকে থাকা 'Single ad source test' সুইচটি টগল করুন। এটি নিম্নলিখিত বিজ্ঞাপন উৎস নির্বাচনের ডায়ালগটি প্রদর্শন করবে:
একক বিজ্ঞাপন উৎস পরীক্ষা ব্যবহার করার আগে আপনাকে অবশ্যই গুগল মোবাইল অ্যাডস এসডিকে চালু করতে হবে।
এরপর আপনি পরীক্ষার জন্য একটিমাত্র বিজ্ঞাপন উৎস নির্বাচন করতে পারেন। বিজ্ঞাপন উৎসটি নির্বাচন করা হয়ে গেলে, নিম্নলিখিত স্ক্রিনটি প্রদর্শিত হবে:
একক বিজ্ঞাপন উৎস পরীক্ষার সেটিংটি একই সেশনে আপনার করা ভবিষ্যতের যেকোনো বিজ্ঞাপন অনুরোধের ক্ষেত্রে প্রযোজ্য। তবে, এটি সেই সেশনে থাকা পূর্বে ক্যাশ করা এমন কোনো বিজ্ঞাপনের ক্ষেত্রে প্রযোজ্য নয় যা এখনও দেখানো হয়নি। একক বিজ্ঞাপন উৎস পরীক্ষা প্রয়োগ করার সময় আপনার অ্যাপটি জোরপূর্বক পুনরায় চালু করার পরামর্শ দেওয়া হয়, যাতে আপনার নির্বাচিত বিজ্ঞাপন উৎসের পরিবর্তে প্রদর্শিত হতে পারে এমন যেকোনো ক্যাশ করা বিজ্ঞাপনকে বাতিল করা যায়।
আপনার অ্যাপটি পুনরায় চালু করার পর, সমস্ত অ্যাড ইউনিট প্লেসমেন্ট শুধুমাত্র নির্বাচিত নেটওয়ার্ক থেকে একটি বিজ্ঞাপন দেখানোর চেষ্টা করে। যখন একটি একক অ্যাড সোর্স টেস্ট সক্রিয় থাকে, তখন অ্যাড ইন্সপেক্টর চালু করলে সক্রিয় টেস্ট অ্যাড সোর্সটি দেখা যায়:
একক বিজ্ঞাপন উৎস পরীক্ষা মোডে, সমস্ত বিজ্ঞাপনের অনুরোধ নির্বাচিত বিজ্ঞাপন উৎস দিয়ে পূরণ করার চেষ্টা করা হয়, অনুরোধ করা বিজ্ঞাপন ইউনিটের জন্য সেই বিজ্ঞাপন উৎসটি বিডিং বা মিডিয়েশনের জন্য কনফিগার করা ছিল কি না, তা নির্বিশেষে। আপনি যে বিজ্ঞাপন উৎসটি পরীক্ষা করছেন সেটি যদি কোনো বিজ্ঞাপন ইউনিটের মিডিয়েশন ওয়াটারফলে না থাকে, তাহলে আপনি একটি "নো ফিল" (No fill) ত্রুটির বার্তা পাবেন।
একক বিজ্ঞাপন উৎস পরীক্ষার সময়, আপনি একটি বিজ্ঞাপন ইউনিটে ট্যাপ করে তার SDK অনুরোধ লগ দেখতে পারেন। এর মাধ্যমে আপনি জানতে পারবেন যে, একক বিজ্ঞাপন উৎস পরীক্ষা চালু করার পর করা বিজ্ঞাপনের অনুরোধগুলো বিজ্ঞাপন উৎসটি পূরণ করেছে কি না। যদি বিজ্ঞাপন উৎসটি কোনো বিজ্ঞাপন লোড করতে ব্যর্থ হয়, তাহলে ত্রুটিটি বর্ণনা করে একটি ত্রুটি বার্তা প্রদর্শিত হয়।
যদি আপনি একটি মিডিয়েশন ওয়াটারফলে নির্বাচিত বিজ্ঞাপন উৎসের একাধিক ইনস্ট্যান্স যোগ করে থাকেন, তাহলে বিজ্ঞাপনটি পূরণ না হওয়া পর্যন্ত অথবা কোনো পূরণ ছাড়াই ওয়াটারফলটি শেষ না হওয়া পর্যন্ত আপনি ওয়াটারফলটিতে বিজ্ঞাপন উৎসটির প্রতিটি কল দেখতে পাবেন।
একটি বিজ্ঞাপন উৎস পরীক্ষা বন্ধ করুন
পরীক্ষাটি বন্ধ করতে, সুইচটি বন্ধ করুন:
এরপর পরবর্তী রিস্টার্ট স্ক্রিনে একটি নিশ্চিতকরণ বার্তা প্রদর্শিত হয়:
পরীক্ষা বন্ধ করার পর আপনার অ্যাপটি জোরপূর্বক পুনরায় চালু করার পরামর্শ দেওয়া হচ্ছে, যাতে পরীক্ষাধীন বিজ্ঞাপন উৎসের জন্য ক্যাশ করা বিজ্ঞাপনগুলো বাতিল হয়ে যায়।
গোপনীয়তা সেটিংস ডিবাগ করুন
পূর্বশর্ত: গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ৯.৬.০ বা উচ্চতর
IAB Europe TCF-এর সাথে Publisher ইন্টিগ্রেশনের অংশ হিসেবে, বিজ্ঞাপন অনুরোধে পাঠানো নিম্নলিখিত গোপনীয়তা সংকেতগুলো দেখতে আপনি অ্যাড ইন্সপেক্টর ব্যবহার করতে পারেন:
- GDPR প্রযোজ্য (
IABTCF_gdprApplies) - AC স্ট্রিং (
IABTCF_AddtlConsent) - TC স্ট্রিং (
IABTCF_TCString)
কোনো বিজ্ঞাপন লোড করার পর বা অ্যাড ইন্সপেক্টরে বিজ্ঞাপন পরীক্ষা করার পর, SDK রিকোয়েস্ট লগ-এর অধীনে থাকা রিকোয়েস্টটির মেনু আইকনে ট্যাপ করুন। এরপর, প্রাইভেসি সিগন্যালস অপশনটি নির্বাচন করুন।
প্রাইভেসি সিগন্যাল স্ক্রিনটি বিজ্ঞাপন অনুরোধে পাঠানো প্রাইভেসি সিগন্যালগুলো প্রদর্শন করে।
AC স্ট্রিং সম্পর্কে আরও জানতে, Google-এর অতিরিক্ত সম্মতি প্রযুক্তিগত স্পেসিফিকেশন দেখুন। TC স্ট্রিং-এ থাকা সম্মতির সূক্ষ্ম বিবরণ, যেমন CMP ID এবং IAB-এর সাথে যুক্ত সম্মতিপ্রাপ্ত ভেন্ডর আইডেন্টিফায়ারের তালিকা দেখতে, IAB GPP এনকোডার / ডিকোডার খোলার জন্য ডিকোড-এ ক্লিক করুন।
যদি কোনো ত্রুটি দেখা দেয়, তাহলে সমস্যা সমাধানের জন্য ‘গোপনীয়তার সমস্যা বুঝুন’ অংশের ধাপগুলো অনুসরণ করুন।
সম্পূর্ণ ডিবাগিং আউটপুট কপি করুন
অ্যাড ইন্সপেক্টর টুলটি থেকে প্রাপ্ত সম্পূর্ণ ডিবাগিং আউটপুট সম্বলিত একটি JSON স্ট্রিং কপি করা সমর্থন করে, যার মধ্যে আপনার AdMob অ্যাপের বিবরণ, অ্যাডাপ্টার ইনিশিয়ালাইজেশন স্ট্যাটাস এবং সমস্ত অ্যাড ইউনিটের পরীক্ষার ফলাফল অন্তর্ভুক্ত থাকে।
এটি করতে, অ্যাপ আইকনটিতে সাতবার ট্যাপ করুন যতক্ষণ না আপনি "Copied ad inspector JSON to clipboard" বার্তাটি দেখতে পান।