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

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

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

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

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

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

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

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

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

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

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

নতুন নিবন্ধন

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

নতুন নিবন্ধন ফর্ম

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

নিবন্ধনের বিবরণ

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

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

স্লট যোগ করুন

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

স্লট ফর্ম যোগ করুন

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

স্লটের বিবরণ

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

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

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

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

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

কোম্পানিগুলিতে LINE Ads Network যোগ করুন

নিলাম

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

জলপ্রপাত

অ্যাডমিন > কোম্পানিজ- এ যান, তারপর অল কোম্পানিজ ট্যাবে থাকা নিউ কোম্পানি বাটনে ক্লিক করুন। অ্যাড নেটওয়ার্ক নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে LINE Ads Network নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন চালু করুন। স্বয়ংক্রিয় ডেটা সংগ্রহ চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত লগইন নামপাসওয়ার্ড লিখুন।

আপনাকে কোনো ইউজারনেম বা পাসওয়ার্ড দিতে হবে না। কাজ শেষ হলে সেভ-এ ক্লিক করুন।

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

নিলাম

অ্যাডমিন > গ্লোবাল সেটিংস- এ যান। অ্যাড এক্সচেঞ্জ অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং ‘সিকিওর সিগন্যাল শেয়ারিং’ পর্যালোচনা করে সেটি চালু করুন। ‘সেভ’- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

নিলাম

Inventory > Secure Signals- এ যান। Secure signals-এর অধীনে, LINE অনুসন্ধান করুন এবং Enable app integration টগলটি অন করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

SDK বিডিং-এর জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন

নিলাম

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস- এ যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিং-এর জন্য ‘Allow secure signal sharing’ অপশনটি চালু করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

লাইন অ্যাডস নেটওয়ার্কের বিডিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

নতুন দরদাতা-তে ক্লিক করুন।

বিডার হিসেবে LINE Ads Network-কে নির্বাচন করুন।

এই বিডারের জন্য SDK বিডিং সক্রিয় করতে ' চালিয়ে যান'-এ ক্লিক করুন।

সম্পন্ন ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

লাইন অ্যাডস নেটওয়ার্কের জন্য কোম্পানি নির্বাচন করুন।

অ্যাড ইউনিট ম্যাপিং ট্যাবে যান এবং নতুন অ্যাড ইউনিট ম্যাপিং-এ ক্লিক করুন।

নির্দিষ্ট বিজ্ঞাপন ইউনিট বেছে নিন। একটি বিজ্ঞাপন ইউনিট ও ফরম্যাট, ইনভেন্টরি টাইপ হিসেবে মোবাইল অ্যাপ এবং আপনার মোবাইল অ্যাপ্লিকেশন নির্বাচন করুন। তারপর, পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ্লিকেশন আইডি এবং স্লট আইডি প্রবেশ করান। সবশেষে, সেভ-এ ক্লিক করুন।

জলপ্রপাত

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

নিচে স্ক্রোল করুন এবং ‘Add yield partner’-এ ক্লিক করুন।

পূর্ববর্তী বিভাগে LINE Ads Network-এর জন্য আপনার তৈরি করা কোম্পানিটি নির্বাচন করুন। ইন্টিগ্রেশন টাইপ হিসেবে মোবাইল এসডিকে মিডিয়েশন , প্ল্যাটফর্ম হিসেবে অ্যান্ড্রয়েড এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বেছে নিন।

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

দ্রষ্টব্য: একটি মিডিয়েশন নেটওয়ার্কের জন্য ডাইনামিক সিপিএম (Dynamic CPM) মান সঠিকভাবে গণনা করার আগে, স্বয়ংক্রিয় ডেটা সংগ্রহ প্রক্রিয়ায় কয়েক দিন সময় লাগে। একবার ইসিপিএম (eCPM) গণনা করা হয়ে গেলে, এটি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে আপডেট হয়ে যায়।

ধাপ ৩: LINE Ads Network 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 ফাইলটি ডাউনলোড করুন এবং আপনার প্রজেক্টে যোগ করুন।

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

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

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

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

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।

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

জাভা

LineMediationAdapter.Companion.setTestMode(true);

কোটলিন

LineMediationAdapter.setTestMode(true)

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

আপনি 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();

কোটলিন

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

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

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

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

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

মাঠ 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 প্রয়োজনীয় উপাদান অনুপস্থিত থাকায় একটি নেটিভ বিজ্ঞাপন লোড করা সম্ভব হয়নি।