এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মিডিয়েশন-এর মাধ্যমে ironSource Ads থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এটি কীভাবে ironSource Ads-কে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে যোগ করতে হয় এবং কীভাবে ironSource Ads SDK ও অ্যাডাপ্টারকে React Native অ্যাপে ইন্টিগ্রেট করতে হয় তা কভার করে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
ironSource Ads-এর জন্য 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 মেডিয়েশন সেট-আপ করুন।
ধাপ ১: ironSource Ads UI-তে কনফিগারেশন সেট-আপ করা
আপনার ironSource Ads অ্যাকাউন্টে সাইন-আপ এবং সাইন-ইন করুন।
নতুন অ্যাপ যোগ করুন
নতুন অ্যাপ যোগ করতে, বিজ্ঞাপন > অ্যাপ বিকল্পে গিয়ে অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।
ফর্ম পূরণ করে অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।
অ্যাপ কী নোট করে নিন, তারপর আপনার অ্যাপে কাজ করে এমন বিজ্ঞাপনের ফর্ম্যাট বেছে নিন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।
Android
iOS
ইনস্ট্যান্স তৈরি করুন
এরপর, আপনার যোগ করা অ্যাপের জন্য একটি ইনস্ট্যান্স কনফিগার করুন।
বিজ্ঞাপন > সেট-আপ > ইনস্ট্যান্স বিকল্পে যান। অ্যাপ বেছে নিয়ে ইনস্ট্যান্স তৈরি করুন বিকল্পে ক্লিক করুন।
বিডিং
ফর্ম পূরণ করুন এবং মূল্য নির্ধারণ-এর জন্য বিডিং বিকল্প বেছে নিন। সেভ করে বন্ধ করুন বিকল্পে ক্লিক করুন।
Android
iOS
ইনস্ট্যান্স আইডি নোট করুন।
Android
iOS
জলপ্রপাত
ফর্ম পূরণ করে সেভ করে বন্ধ করুন বিকল্পে ক্লিক করুন।
ইনস্ট্যান্স আইডি নোট করুন।
আপনার রিপোর্টিং API Key খুঁজে নিন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজনীয় নয়।
জলপ্রপাত
আমার অ্যাকাউন্ট পৃষ্ঠা-এ API ট্যাবে ক্লিক করুন এবং আপনার সিক্রেট কী ও রিফ্রেশ টোকেন নোট করে নিন।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।
ironSource-এর জন্য app-ads.txt প্রয়োগ করতে,
ironSource অনুমোদিত রিসেলার দেখুন।
টেস্ট মোড চালু করুন
ironSource Ads-এর টেস্ট বিজ্ঞাপন কীভাবে চালু করবেন তা জানতে ironSource Ads-এর ইন্টিগ্রেশন টেস্টিং গাইডে দেওয়া নির্দেশাবলী অনুসরণ করুন।
ধাপ ২: AdMob UI-তে ironSource Ads-এর চাহিদা সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় ironSource Mobile যোগ করুন
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় ironSource Mobile যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: ironSource Ads SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, ironSource Ads-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/ironsource/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/ironsource/gma-mediation-ironsource-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-ironsource-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-ironsource-0.1.0.tgzআপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের
androidডিরেক্টরিতেbuild.gradleফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:repositories { google() mavenCentral() maven { url = uri("https://android-sdk.is.com/") } }
ধাপ ৪: ironSource Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
ironSource Ads React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন UMP SDK এবং সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে জিডিপিআর (GDPR) সম্মতি সিগন্যাল পাস করার সুবিধা প্রদান করে যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন থেকে ironSource Ads SDK-তে ইন্টিগ্রেট করে। আরও তথ্যের জন্য, ironSource জিডিপিআর (GDPR) সম্মতি দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
ironSource Ads-এর
জন্য Google মোবাইল বিজ্ঞাপন মিডিয়েশন প্লাগ-ইনে
GmaMediationIronsource().setDoNotSell
পদ্ধতি অন্তর্ভুক্ত আছে। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় যে কীভাবে
সম্মতি সংক্রান্ত তথ্য
ironSource Ads SDK-তে পাস করতে হয়। এইসব বিকল্প অবশ্যই
শুরু করার Google Mobile Ads SDK for React Native আগে সেট করতে হবে
যাতে সেগুলি সঠিকভাবে ironSource Ads SDK-তে
ফরওয়ার্ড করা যায়।
import { IronSourceMediation } from '@google/gma-mediation-ironsource';
// ...
IronSourceMediation.setDoNotSell(true);
আরও বিবরণ এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালুর জন্য Android এবং iOS উভয়ের জন্য রেগুলেশন উন্নত সেটিংসের উপর ironSource Ads-এর ডকুমেন্টেশন দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
Proguard নিয়ম
আপনি যদি আপনার অ্যাপ সঙ্কুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন, তাহলে ironSource Ads-এর জন্য আপনার প্রোজেক্টে অতিরিক্ত ProGuard নিয়ম প্রয়োজন।
আপনার প্রোজেক্টের জন্য কোন ProGuard নিয়ম প্রয়োজন সেই সম্পর্কে আরও তথ্যের জন্য
ironSource Ads-এর Android SDK
ইন্টিগ্রেশন
গাইড
পরামর্শ করুন এবং আপনার proguard-user.txt ফাইলে সেই নিয়মগুলি যোগ করুন।
iOS
SKAdNetwork ইন্টিগ্রেশন
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন এবং ironSource Ads UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি ironSource Ads থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, ironSource Ads (বিডিং) এবং ironSource Ads (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার ironSource Ads থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশক নিম্নলিখিত ক্লাস থেকে
ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে
অন্তর্নিহিত সমস্যা চেক করতে পারবেন:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
কোনও বিজ্ঞাপন লোড হতে না পারলে ironSource Ads অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং সংশ্লিষ্ট মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | কারণ |
|---|---|
| ১০১ | AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | ironSource Ads-এর SDK শুরু করার জন্য অ্যাক্টিভিটি কনটেক্সট প্রয়োজন। |
| 103 | ironSource বিজ্ঞাপন, প্রতিটি ironSource ইনস্ট্যান্স আইডিতে শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে। |
| ১০৫ | অনুরোধ করা ব্যানার বিজ্ঞাপনের সাইজ ironSource Ads-এ কাজ করে না। |
| 106 | ironSource Ads SDK চালু করা হয়নি। |
| 107 | বিজ্ঞাপন ঠিকমতো লোড হওয়ার আগেই বিজ্ঞাপন দেখানোর অনুরোধ করা হয়েছে। |
| 108 | ironSource Ads SDK ফাঁকা বা খালি বিডিং সিগন্যাল রিটার্ন করেছে। |
| 501-1056 | ironSource Ads SDK সংক্রান্ত সমস্যা। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন। |
iOS
| সমস্যার কোড | কারণ |
|---|---|
| ১০১ | AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট ironSource Ads অ্যাডাপ্টারে কাজ করে না। |
| 103 | এই নেটওয়ার্ক কনফিগারেশনের জন্য ironSource বিজ্ঞাপন আগে থেকেই লোড করা আছে। |
| 104 | অনুরোধ করা ব্যানার বিজ্ঞাপনের সাইজ ironSource Ads-এ কাজ করে না। |
| ১০৫ | ironSource Ads বিজ্ঞাপন দেখাতে পারেনি। |
| 508-1037 | ironSource Ads SDK সংক্রান্ত সমস্যা। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- ironSource Android অ্যাডাপ্টার ভার্সন 9.6.0.1 কাজ করে।
- ironSource iOS অ্যাডাপ্টার ভার্সন 9.5.0.0.0 কাজ করে।