AdMob মেডিয়েশনের সাথে LY Ads Network ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter React Native Android (Legacy)

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মিডিয়েশন-এর মাধ্যমে LY Ads Network থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, এতে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়েছে। এতে LY Ads Network-কে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে কীভাবে যোগ করতে হয় এবং LY Ads Network SDK ও অ্যাডাপ্টারকে React Native অ্যাপে কীভাবে ইন্টিগ্রেট করতে হয় তা কভার করা হয়েছে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

LY Ads Network-এর জন্য AdMob মিডিয়েশন অ্যাডাপ্টারে নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলা
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কৃত ইন্টারস্টিশিয়াল
নেটিভ

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

• লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
• React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
• Android-এ ডিপ্লয় করতে
  • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
• iOS-এ ডিপ্লয় করতে
  • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
• Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
  • gma-sdk-react-native ফোল্ডার থেকে adapters ফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
• AdMob মেডিয়েশন সেট-আপ করুন।

ধাপ ১: LY Ads Network UI-তে কনফিগারেশন সেট-আপ করা

আপনার LY Ads Network অ্যাকাউন্টে সাইন-আপ ও লগ-ইন করুন।

নতুন অ্যাপ্লিকেশন যোগ করুন

অ্যাপ ট্যাবে গিয়ে নতুন রেজিস্ট্রেশন বোতামে ক্লিক করুন।

ফর্ম পূরণ করে রেজিস্ট্রেশন বিকল্পে ক্লিক করুন।

মনে রাখবেন: আপনি যে প্ল্যাটফর্মকে সাপোর্ট করতে চান, তার জন্য আপনাকে আলাদা অ্যাপ তৈরি করতে হবে।

অ্যাপ আইডি নোট করে রাখুন।

Android

iOS

বিজ্ঞাপন স্লট তৈরি করা

অ্যাপ ট্যাবে, আপনার অ্যাপের বিবরণ দেখতে আপনার অ্যাপ বেছে নিন। স্লট বিভাগের মধ্যে, যোগ করুন বিকল্পে ক্লিক করুন।

স্লট সম্পর্কে বিস্তারিত জানতে ফর্মটি পূরণ করুন। বিডিংয়ের ধরন-এর জন্য, ওয়াটারফল মধ্যস্থতার জন্য এই স্লট কনফিগার করতে স্ট্যান্ডার্ড বেছে নিন অথবা বিডিংয়ের জন্য এই স্লট কনফিগার করতে Google SDK বিডিং বেছে নিন। ফর্ম পূরণ করা হয়ে গেলে তৈরি করুন বিকল্পে ক্লিক করুন।

মনে রাখবেন: স্লট রেজিস্টার করার পরে বিজ্ঞাপনের ফর্ম্যাট এবং বিডিংয়ের ধরন পরিবর্তন করা যাবে না। LY Ads Network UI-তে নেটিভ বিজ্ঞাপন প্লেসমেন্ট তৈরি করার অ্যাক্সেস পেতে আপনার LY Ads Network অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

স্লট আইডি নোট করে রাখুন।

আপনার প্রথম স্লট তৈরি করার পরে, LY Ads Network থেকে অনুমোদন পেতে আপনার অ্যাপের বিবরণ পৃষ্ঠায় পর্যালোচনা করুন বিকল্পে ক্লিক করুন। এতে কিছুটা সময় লাগতে পারে। আপনার কোনও প্রশ্ন থাকলে, LY Ads Network প্রতিনিধির সাথে যোগাযোগ করুন।

রিপোর্টিং API Key তৈরি করুন

রিপোর্টিং API key ম্যানেজ করা ট্যাবে গিয়ে API key তৈরি করুন বোতামে ক্লিক করুন।

ফর্ম পূরণ করে সেভ করুন বিকল্পে ক্লিক করুন।

আপনার API Key ID এবং API Key Secret নোট করে রাখুন।

আপনার app-ads.txt আপডেট করুন

অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।

LY বিজ্ঞাপন নেটওয়ার্কের জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt সম্পর্কে দেখুন।

ধাপ ২: AdMob UI-তে LY Ads Network ডিমান্ড সেট-আপ করুন

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

ধাপ ৩: LY Ads Network SDK ও অ্যাডাপ্টার ইম্পোর্ট করা

মনে রাখবেন: মানানসই LY বিজ্ঞাপন নেটওয়ার্ক ও Google Mobile Ads SDK ভার্সন ইন্টিগ্রেট করতে না পারলে, বিল্ড সংক্রান্ত সমস্যা হতে পারে।

আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, LY Ads Network-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি gma-sdk-react-native/adapters/line/ ডিরেক্টরি থেকে আপনার প্রোজেক্টের local_packages/ ডিরেক্টরিতে কপি করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/
   

   EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।

2. আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:

   npm

   npm install ./local_packages/gma-mediation-line-0.1.0.tgz
   

   তন্তু

   yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
   

ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন

Android

LY Ads Network ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।

iOS

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে LY Ads Network-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৫: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করুন

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob এবং LY Ads Network-এর জন্য টেস্ট মোড বন্ধ করুন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি LY Ads Network থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, LY Ads Network বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ঐচ্ছিক ধাপ

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার

LY Ads Network React Native মধ্যস্থতা প্লাগ-ইন নিম্নলিখিত অতিরিক্ত অনুরোধ প্যারামিটারকে সাপোর্ট করে যা LineMediationExtras ক্লাসের মাধ্যমে অ্যাডাপ্টারে পাস করা যেতে পারে:

• enableAdSound : ব্যানার, ইন্টারস্টিশিয়াল ও পুরস্কার প্রদানকারী বিজ্ঞাপনের ডিফল্ট সাউন্ড স্টার্ট স্টেট নির্দিষ্ট করে।

এইসব প্যারামিটার সেট করে এমন বিজ্ঞাপনের অনুরোধ কীভাবে তৈরি করতে হয় তার কোডের উদাহরণ এখানে দেওয়া হল:

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

ত্রুটি কোড

LY Ads Network থেকে অ্যাডাপ্টার বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি চেক করতে পারবেন:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

কোনও বিজ্ঞাপন লোড হতে না পারলে LY Ads Network অ্যাডাপ্টার যে কোড ও মেসেজ পাঠায় তা এখানে দেওয়া হল:

Android

সমস্যার কোড	ডোমেন	কারণ
1-10	com.five_corp.ad	LY Ads Network SDK থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও বিবরণের জন্য LY Ads Network-এর ডকুমেন্টেশন দেখুন।
১০১	com.google.ads.mediation.line	অ্যাপ্লিকেশন আইডি নেই বা ভুল আছে।
102	com.google.ads.mediation.line	স্লট আইডি নেই বা ভুল আছে।
103	com.google.ads.mediation.line	অনুরোধ করা বিজ্ঞাপনের সাইজ LY Ads Network-এ কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না।
104	com.google.ads.mediation.line	অ্যাক্টিভিটি প্রসঙ্গ না থাকার কারণে ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন লোড করা যায়নি।
১০৫	com.google.ads.mediation.line	LY Ads Network SDK ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি।
106	com.google.ads.mediation.line	অ্যাসেট না থাকার কারণে নেটিভ বিজ্ঞাপন লোড করা যায়নি।
107	com.google.ads.mediation.line	FiveAd SDK একটি নাল বিজ্ঞাপন লোডার রিটার্ন করেছে।

iOS

সমস্যার কোড	ডোমেন	কারণ
1-10	LY Ads Network SDK-এর মাধ্যমে পাঠানো হয়েছে	LY Ads Network SDK থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও বিবরণের জন্য LY Ads Network-এর ডকুমেন্টেশন দেখুন।
১০১	com.google.ads.mediation.line	সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ্লিকেশন আইডি বা স্লট আইডি নেই)।
102	com.google.ads.mediation.line	অনুরোধ করা বিজ্ঞাপনের সাইজ LY Ads Network-এ কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না।
103	com.google.ads.mediation.line	নেটিভ বিজ্ঞাপনে তথ্যের আইকন ইমেজ অ্যাসেট লোড করা যায়নি।
104	com.google.ads.mediation.line	বিডিংয়ের জন্য সিগন্যাল সংগ্রহ করা যায়নি।
১০৫	com.google.ads.mediation.line	LINE Ads SDK বিজ্ঞাপন লোডার শুরু করা যায়নি।

ভার্সন 0.1.0

• প্রাথমিক রিলিজ।

• LINE Android অ্যাডাপ্টার ভার্সন 3.1.1.2-এ কাজ করে।
• LINE iOS অ্যাডাপ্টার ভার্সন 3.1.1.0-এ কাজ করে।
• Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।