মধ্যস্থতার সাথে আয়রনসোর্সকে একীভূত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) নতুন-নির্বাচিত অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে মিডিয়েশন ব্যবহার করে GMA Next-Gen SDK সাহায্যে ironSource Ads থেকে বিজ্ঞাপন লোড ও প্রদর্শন করতে হয়, যেখানে ওয়াটারফল ইন্টিগ্রেশনও অন্তর্ভুক্ত রয়েছে। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে ironSource Ads যোগ করতে হয়, কিভাবে অ্যাড সোর্স অপটিমাইজেশন সেট আপ করতে হয়, এবং কিভাবে ironSource Ads SDK ও অ্যাডাপ্টারকে আপনার অ্যান্ড্রয়েড অ্যাপে ইন্টিগ্রেট করতে হয়।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

ironSource Ads-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল ১
স্থানীয়

এই ফরম্যাটটি শুধুমাত্র ওয়াটারফল ইন্টিগ্রেশনে সমর্থিত।

প্রয়োজনীয়তা

  • অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

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

আপনার ironSource Ads অ্যাকাউন্টে সাইন আপ করুন এবং সাইন ইন করুন ।

একটি নতুন অ্যাপ যোগ করুন

নতুন অ্যাপ যোগ করতে, Ads > Apps- এ যান এবং Add app-এ ক্লিক করুন।

ফর্মটি পূরণ করুন এবং 'অ্যাপ যোগ করুন'-এ ক্লিক করুন।

অ্যাপ কী-টি লিখে নিন, তারপর আপনার অ্যাপ যে বিজ্ঞাপন ফরম্যাটগুলো সমর্থন করে তা নির্বাচন করুন এবং 'চালিয়ে যান'-এ ক্লিক করুন।

একটি ইনস্ট্যান্স তৈরি করুন

এরপরে, আপনার যোগ করা অ্যাপটির জন্য একটি ইনস্ট্যান্স কনফিগার করুন।

Ads > Setup > Instances- এ যান। অ্যাপটি নির্বাচন করুন এবং Create instance-এ ক্লিক করুন।

নিলাম

ফর্মটি পূরণ করুন এবং মূল্য নির্ধারণের জন্য বিডিং নির্বাচন করুন। সেভ এবং ক্লোজ-এ ক্লিক করুন।

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

জলপ্রপাত

ফর্মটি পূরণ করুন এবং 'সংরক্ষণ করুন ও বন্ধ করুন'- এ ক্লিক করুন।

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

আপনার রিপোর্টিং এপিআই কী খুঁজুন

নিলাম

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

জলপ্রপাত

আমার অ্যাকাউন্ট পেজে থাকা API ট্যাবে ক্লিক করুন এবং আপনার সিক্রেট কী ও রিফ্রেশ টোকেন লিখে নিন।

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

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

ironSource-এর জন্য app-ads.txt প্রয়োগ করতে, ironSource অনুমোদিত রিসেলারদের দেখুন।

টেস্ট মোড চালু করুন

ironSource Ads টেস্ট অ্যাড চালু করার জন্য, ironSource Ads-এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে ironSource বিজ্ঞাপনের চাহিদা সেট আপ করুন।

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

ডেলিভারি > ইল্ড গ্রুপস- এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন।

আপনার ইয়েল্ড গ্রুপের জন্য একটি অনন্য নাম লিখুন, স্ট্যাটাস ‘অ্যাক্টিভ’ -এ সেট করুন, আপনার অ্যাড ফরম্যাট নির্বাচন করুন এবং ইনভেন্টরি টাইপ ‘মোবাইল অ্যাপ’- এ সেট করুন। টার্গেটিং > ইনভেন্টরি বিভাগের অধীনে, ইনভেন্টরি এবং মোবাইল অ্যাপ্লিকেশনের মধ্য থেকে সেই অ্যাড ইউনিটটি নির্বাচন করুন যেটিতে আপনি মিডিয়েশন যোগ করতে চান।

এরপর, 'Add yield partner' বাটনটিতে ক্লিক করুন।

ironSource Ads-এর জন্য আপনার যদি আগে থেকেই কোনো Yield পার্টনার থাকে, তাহলে আপনি তাকে নির্বাচন করতে পারেন। অন্যথায়, ‘Create a new yield partner’ নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে ironSource Ads নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন সক্রিয় করুন।

স্বয়ংক্রিয় ডেটা সংগ্রহ চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত সিক্রেট কী ও রিফ্রেশ টোকেন প্রবেশ করান।

Yield পার্টনার নির্বাচন করা হয়ে গেলে, ইন্টিগ্রেশন টাইপ হিসেবে Mobile SDK Mediation , প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ কী এবং ইনস্ট্যান্স আইডি প্রবেশ করান। তারপর, একটি ডিফল্ট CPM মান প্রবেশ করান।

কাজ শেষ হলে পৃষ্ঠার নীচে থাকা সেভ বাটনে ক্লিক করুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় ironSource Mobile-কে যুক্ত করুন

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা বিজ্ঞাপন অংশীদারদের তালিকায় ironSource Mobile যোগ করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস- এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: ironSource Ads SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

আপনার প্রোজেক্ট-স্তরের settings.gradle.kts ফাইলে নিম্নলিখিত রিপোজিটরিগুলো যোগ করুন:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

আপনার অ্যাপ-লেভেলের গ্রেডল ফাইলে নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন:

কোটলিন 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

গ্রুভি 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ম্যানুয়াল ইন্টিগ্রেশন

  1. ironSource Ads Android SDK- এর সর্বশেষ সংস্করণটি ডাউনলোড করে আপনার প্রজেক্টে যুক্ত করুন।

  2. Google-এর Maven Repository-তে ironSource Ads অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, IronSource অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।

ধাপ ৪: ironSource Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করুন

Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে থাকা আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ প্রেরণ করতে অক্ষম।

ironSource SDK সংস্করণ 7.7.0 থেকে শুরু করে, ironSource স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা নির্ধারিত GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, “Support for Google UMP and CMPs that support Google's Additional Consent ” দেখুন।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন

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

SDK সংস্করণ 6.14.0-এ, ironSource Ads CCPA বিধিমালা সমর্থন করার জন্য একটি API যুক্ত করেছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে এই সম্মতির তথ্য ironSource Ads SDK-তে পাঠাতে হয়। এই অপশনগুলো ironSource Ads SDK-তে সঠিকভাবে পাঠানো নিশ্চিত করতে, GMA Next-Gen SDK চালু করার আগেই এগুলো সেট করতে হবে।

জাভা 

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

কোটলিন 

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

আরও বিস্তারিত তথ্যের জন্য এবং মেথডটিতে যে মানগুলো প্রদান করা যেতে পারে, সে সম্পর্কে জানতে ironSource Ads-এর Regulation Advanced Settings সংক্রান্ত ডকুমেন্টেশন দেখুন।

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

অ্যাক্টিভিটি কনটেক্সট সহ বিজ্ঞাপন লোড করুন

ব্যানার, ইন্টারস্টিশিয়াল এবং রিওয়ার্ডেড বিজ্ঞাপন ফর্ম্যাট লোড করার সময় Activity কনটেক্সট পাস করুন। অ্যাক্টিভিটি কনটেক্সট ছাড়া বিজ্ঞাপন লোড হবে না।

প্রোগার্ড নিয়ম

আপনি যদি আপনার অ্যাপকে সংকুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন , তাহলে ironSource Ads আপনার প্রোজেক্টে অতিরিক্ত ProGuard নিয়ম যোগ করার প্রয়োজন হবে। আরও তথ্যের জন্য ironSource Ads-এর Android SDK ইন্টিগ্রেশন গাইড দেখুন।

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করুন এবং ironSource Ads UI-তে টেস্ট মোড চালু করুন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি ironSource Ads থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে ironSource Ads (Bidding) এবং ironSource Ads (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি ironSource Ads থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন ironSource Ads অ্যাডাপ্টার দ্বারা প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:

ত্রুটি কোড কারণ
১০১ অ্যাড ম্যানেজার UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০২ ironSource Ads তাদের SDK চালু করার জন্য একটি Activity context-এর প্রয়োজন হয়।
১০৩ ironSource Ads প্রতিটি ironSource Ads ইনস্ট্যান্স আইডির জন্য শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে।
১০৫ অনুরোধ করা ব্যানার বিজ্ঞাপনের আকারটি ironSource Ads দ্বারা সমর্থিত নয়।
১০৬ ironSource Ads SDK চালু করা হয়নি।
৫০১-১০৫৬ ironSource Ads SDK-তে ত্রুটি। আরও বিস্তারিত জানতে ডকুমেন্টেশন দেখুন।