মধ্যস্থতার সাথে লাইন সংহত করুন

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

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

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

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

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

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

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

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

• [বিডিং-এর জন্য]: বিডিং-এ সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, LINE Ads Network অ্যাডাপ্টার 2.9.20241129.0 বা তার উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।

• সর্বশেষ GMA Next-Gen SDK

• মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

アプリ (App) ট্যাবে নেভিগেট করুন এবং新規登録 (নতুন নিবন্ধন) বোতামে ক্লিক করুন৷

ফর্মটি পূরণ করুন এবং ক্লিক করুন登録 (নিবন্ধন করুন) ।

アプリID (App ID) নোট করুন।

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

アプリ (App) ট্যাবে, আপনার অ্যাপের বিবরণ দেখতে আপনার অ্যাপটি নির্বাচন করুন।スロット (স্লট) বিভাগের অধীনে,追加 (যোগ করুন) ক্লিক করুন।

স্লট সম্পর্কে বিস্তারিত জানতে ফর্মটি পূরণ করুন। বিডিং টাইপের জন্য, এই স্লটটিকে ওয়াটারফল মিডিয়েশনের জন্য কনফিগার করতে স্ট্যান্ডার্ড নির্বাচন করুন, অথবা বিডিংয়ের জন্য কনফিগার করতে গুগল এসডিকে বিডিং নির্বাচন করুন। ফর্মটি পূরণ হয়ে গেলে তৈরি করুন (Create) বোতামে ক্লিক করুন।

দ্রষ্টব্য: স্লট নিবন্ধন করার পর বিজ্ঞাপনের ফরম্যাট (Ad Format) এবং বিডিং টাইপ পরিবর্তন করা যাবে না। LINE Ads Network UI-তে নেটিভ বিজ্ঞাপন প্লেসমেন্ট তৈরি করার অ্যাক্সেস পেতে আপনার LINE Ads Network অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

スロットID (স্লট আইডি) নোট করুন।

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

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

LINE Ads Network-এর জন্য app-ads.txt প্রয়োগ করতে, App-ads.txt সম্পর্কে দেখুন।

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

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে LINE Ads Network যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি 'বিজ্ঞাপনের উৎস হিসেবে LINE Ads Network যোগ করুন' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

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

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে LINE Ads Network যোগ করুন

নিলাম

Ad Sources সেকশনের Bidding কার্ডের অধীনে, Add ad source নির্বাচন করুন। তারপর LINE Ads Network নির্বাচন করুন।

লাইন অ্যাডস নেটওয়ার্কের সাথে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন তা জানতে ক্লিক করুন।



স্বীকৃতি ও সম্মতিতে ক্লিক করুন, তারপর চালিয়ে যান-এ ক্লিক করুন।



আপনার যদি LINE Ads Network-এর জন্য আগে থেকেই কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।



এরপর, পূর্ববর্তী অংশে প্রাপ্ত অ্যাপ্লিকেশন আইডি এবং স্লট আইডি প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

গুরুত্বপূর্ণ : অ্যাপ্লিকেশন আইডিটি অবশ্যই টার্গেট করা অ্যাপের সাথে যুক্ত থাকতে হবে, যেমনটি LINE Ads Network UI-তে দেখানো আছে।

জলপ্রপাত

Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।

লাইন অ্যাডস নেটওয়ার্ক নির্বাচন করুন এবং অপটিমাইজ সুইচটি চালু করুন। লাইন অ্যাডস নেটওয়ার্কের জন্য অ্যাড সোর্স অপটিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত লগইন নাম এবং পাসওয়ার্ড লিখুন। তারপর লাইন অ্যাডস নেটওয়ার্কের জন্য একটি eCPM মান লিখুন এবং কন্টিনিউ-তে ক্লিক করুন।

দ্রষ্টব্য : আপনাকে প্রতিটি নেটওয়ার্কের জন্য শুধুমাত্র একবার বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে হবে।

আপনার যদি LINE Ads Network-এর জন্য আগে থেকেই কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।

এরপর, পূর্ববর্তী অংশে প্রাপ্ত অ্যাপ্লিকেশন আইডি এবং স্লট আইডি প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

গুরুত্বপূর্ণ : অ্যাপ্লিকেশন আইডিটি অবশ্যই টার্গেট করা অ্যাপের সাথে যুক্ত থাকতে হবে, যেমনটি LINE Ads Network UI-তে দেখানো আছে।

দ্রষ্টব্য : একটি মিডিয়েশন নেটওয়ার্কের জন্য eCPM সঠিকভাবে গণনা করার মতো পর্যাপ্ত ডেটা সংগ্রহ করতে অ্যাড সোর্স অপটিমাইজেশনের কয়েক দিন সময় লাগে। এই সময়ের মধ্যে, অ্যাড সোর্স অপটিমাইজেশনের স্ট্যাটাস PENDING থাকে, তাই আপনাকে নেটওয়ার্কটির জন্য ম্যানুয়ালি একটি eCPM ভ্যালু সেট করতে হবে। একবার eCPM গণনা করা সম্ভব হলে, অ্যাড সোর্সটি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে eCPM আপডেট করা শুরু করে।

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

দ্রষ্টব্য: সামঞ্জস্যপূর্ণ LINE Ads Network এবং GMA Next-Gen SDK সংস্করণগুলি সংহত করতে ব্যর্থ হলে বিল্ডে সমস্যা দেখা দিতে পারে।

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

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

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    implementation("com.google.ads.mediation:line:3.0.1.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.24.0-beta03'
    implementation 'com.google.ads.mediation:line:3.0.1.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. LINE Ads Network SDK- এর .aar ফাইলের সর্বশেষ সংস্করণটি ডাউনলোড করে আপনার প্রজেক্টে যুক্ত করুন।

2. গুগলের মেভেন রিপোজিটরিতে থাকা লাইন অ্যাডস নেটওয়ার্ক অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, লাইন অ্যাডস নেটওয়ার্ক অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রজেক্টে যোগ করুন।

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

লাইন অ্যাডস নেটওয়ার্ক ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

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

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

জাভা

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

কোটলিন

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

গুরুত্বপূর্ণ: আপনার অ্যাপটি প্রকাশ করার আগে AdMob এবং LINE Ads Network-এর টেস্ট মোড নিষ্ক্রিয় করুন।

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

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

ঐচ্ছিক পদক্ষেপ

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

লাইন অ্যাডস নেটওয়ার্ক অ্যাডাপ্টার একটি অতিরিক্ত রিকোয়েস্ট প্যারামিটার সমর্থন করে, যা LineExtras ক্লাস ব্যবহার করে অ্যাডাপ্টারে পাঠানো যায়। এই ক্লাস কনস্ট্রাক্টরে নিম্নলিখিত প্যারামিটারগুলো অন্তর্ভুক্ত থাকে:

enableAdSound

ব্যানার, ইন্টারস্টিশিয়াল এবং রিওয়ার্ডেড বিজ্ঞাপনের ডিফল্ট সাউন্ড শুরুর অবস্থা নির্দিষ্ট করার জন্য একটি boolean ।

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

জাভা

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

কোটলিন

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

নেটিভ বিজ্ঞাপন ব্যবহার করে

বিজ্ঞাপন রেন্ডারিং

LINE Ads Network অ্যাডাপ্টার একটি NativeAd এর জন্য নিম্নলিখিত Native ads অ্যাডভান্সড ফিল্ডের বিবরণগুলি পূরণ করে।

মাঠ	LINE Ads Network অ্যাডাপ্টারের মাধ্যমে অ্যাসেটগুলো সর্বদা অন্তর্ভুক্ত থাকে।
শিরোনাম
ছবি
শরীর
অ্যাপ আইকন	^১
পদক্ষেপ গ্রহণের আহ্বান
তারকা রেটিং
দোকান
মূল্য

^{নেটিভ} বিজ্ঞাপনের জন্য, LINE Ads Network SDK কোনো অ্যাপ আইকন অ্যাসেট প্রদান করে না। এর পরিবর্তে, LINE Ads Network অ্যাডাপ্টার একটি স্বচ্ছ ছবি দিয়ে অ্যাপ আইকনটি পূরণ করে দেয়।

ত্রুটি কোড

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

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

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

ত্রুটি কোড	ডোমেইন	কারণ
১-১০	com.five_corp.ad	লাইন অ্যাডস নেটওয়ার্ক এসডিকে একটি এসডিকে-নির্দিষ্ট ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে লাইন অ্যাডস নেটওয়ার্কের ডকুমেন্টেশন দেখুন।
১০১	com.google.ads.mediation.line	আবেদন আইডি অনুপস্থিত বা অবৈধ।
১০২	com.google.ads.mediation.line	স্লট আইডি অনুপস্থিত বা অবৈধ।
১০৩	com.google.ads.mediation.line	অনুরোধ করা বিজ্ঞাপনের আকারটি LINE Ads Network সমর্থিত ব্যানার বিজ্ঞাপনের আকারের সাথে মেলে না।
১০৪	com.google.ads.mediation.line	অ্যাক্টিভিটি কনটেক্সট অনুপস্থিত থাকায় একটি ইন্টারস্টিশিয়াল বা রিওয়ার্ডেড বিজ্ঞাপন লোড করা সম্ভব হয়নি।
১০৫	com.google.ads.mediation.line	LINE Ads Network SDK একটি ইন্টারস্টিশিয়াল বা রিওয়ার্ডেড বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে।
১০৬	com.google.ads.mediation.line	প্রয়োজনীয় উপাদান অনুপস্থিত থাকায় একটি নেটিভ বিজ্ঞাপন লোড করা সম্ভব হয়নি।