এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে মধ্যস্থতা ব্যবহার করে Moloco থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, বিডিং ইন্টিগ্রেশন কভার করে৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Moloco যোগ করতে হয় এবং কীভাবে Moloco SDK এবং অ্যাডাপ্টারকে একটি Android অ্যাপে সংহত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
মোলোকোর মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| অ্যাপ খুলুন | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
প্রয়োজনীয়তা
Android API স্তর 23 বা উচ্চতর
মোলোকো অ্যাডাপ্টার 3.8.0.0 বা উচ্চতর
সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড ।
ধাপ 1: Moloco UI এ কনফিগারেশন সেট আপ করুন
মোলোকো প্রকাশক পোর্টালে লগ ইন করুন ।
ওভারভিউ > অ্যাপস ট্যাবে নেভিগেট করুন, তারপর একটি নতুন অ্যাপ তৈরি করতে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।
আপনার অ্যাপের জন্য ওএস এবং গোপনীয়তা সেটিংস নির্বাচন করুন, বাকি ফর্মটি পূরণ করুন এবং তারপর তৈরি করুন ক্লিক করুন।
একবার আপনার অ্যাপ তৈরি হয়ে গেলে, বিস্তারিত দেখতে এবং অ্যাপ কী নোট করতে অ্যাপস ট্যাব থেকে এটি নির্বাচন করুন।
ওভারভিউ > বিজ্ঞাপন ইউনিট ট্যাবে নেভিগেট করুন, ড্রপ-ডাউন মেনু থেকে অ্যাপটি নির্বাচন করুন এবং তারপরে নতুন বিজ্ঞাপন ইউনিটে ক্লিক করুন।
নিলাম পদ্ধতি হিসাবে অ্যাপ-মধ্যস্থ বিডিং নির্বাচন করুন এবং বাকি ফর্মটি পূরণ করুন। তারপর, তৈরি করুন ক্লিক করুন।
বিশদ বিবরণ দেখতে বিজ্ঞাপন ইউনিট ট্যাবের অধীনে আপনার নতুন তৈরি বিজ্ঞাপন ইউনিটে নেভিগেট করুন। বিজ্ঞাপন ইউনিট আইডি নোট নিন।
ধাপ 2: Ad Manager UI-তে Moloco চাহিদা সেট আপ করুন
আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।
নিরাপদ সংকেত শেয়ারিং সক্ষম করুন
অ্যাডমিন > গ্লোবাল সেটিংসে নেভিগেট করুন। অ্যাড এক্সচেঞ্জ অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং সুরক্ষিত সংকেত ভাগ করে নেওয়ার উপর পর্যালোচনা করুন এবং টগল করুন৷ সংরক্ষণ করুন ক্লিক করুন.
বিড অনুরোধে নিরাপদ সংকেত শেয়ার করুন
ইনভেন্টরি > সিকিউর সিগন্যালে নেভিগেট করুন। সিকিউর সিগন্যালের অধীনে, Moloco বিজ্ঞাপন SDK অনুসন্ধান করুন এবং অ্যাপ ইন্টিগ্রেশন সক্ষম করুন এ টগল করুন।
সংরক্ষণ করুন ক্লিক করুন.
SDK বিডিংয়ের জন্য নিরাপদ সংকেত ভাগ করার অনুমতি দিন
ডেলিভারি > চাহিদা চ্যানেল সেটিংসে নেভিগেট করুন। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিংয়ের জন্য নিরাপদ সংকেত ভাগ করে নেওয়ার অনুমতি দিন -এ টগল করুন।
সংরক্ষণ করুন ক্লিক করুন.
মোলোকো বিডিং কনফিগার করুন
ডেলিভারি > বিডার- এ নেভিগেট করুন এবং SDK বিডিং-এ যান-এ ক্লিক করুন।
নতুন দরদাতা ক্লিক করুন.
দরদাতা হিসাবে Moloco বিজ্ঞাপন নির্বাচন করুন.
এই দরদাতার জন্য SDK বিডিং সক্ষম করতে অবিরত ক্লিক করুন৷
সম্পন্ন ক্লিক করুন.
বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন
ডেলিভারি > বিডার- এ নেভিগেট করুন এবং SDK বিডিং-এ যান-এ ক্লিক করুন।
Moloco Ads SDK-এর জন্য কোম্পানি নির্বাচন করুন।
বিজ্ঞাপন ইউনিট ম্যাপিং ট্যাবে যান এবং নতুন বিজ্ঞাপন ইউনিট ম্যাপিং এ ক্লিক করুন।
নির্দিষ্ট বিজ্ঞাপন ইউনিট বেছে নিন। একটি বিজ্ঞাপন ইউনিট এবং বিন্যাস নির্বাচন করুন, ইনভেন্টরি প্রকার হিসাবে মোবাইল অ্যাপ এবং আপনার মোবাইল অ্যাপ্লিকেশন । তারপরে, পূর্ববর্তী বিভাগে প্রাপ্ত অ্যাপ কী এবং বিজ্ঞাপন ইউনিট আইডি লিখুন।
অবশেষে, সংরক্ষণ করুন ক্লিক করুন।
ইউরোপীয় এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় Moloco বিজ্ঞাপন যোগ করুন
অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্যের বিধিবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় Moloco বিজ্ঞাপন যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: Moloco SDK এবং অ্যাডাপ্টার আমদানি করুন
অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)
আপনার অ্যাপ-লেভেল build.gradle.kts ফাইলে, নিম্নলিখিত বাস্তবায়ন নির্ভরতা এবং কনফিগারেশন যোগ করুন। Moloco SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ ব্যবহার করুন:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:moloco:3.12.1.0")
}
ধাপ 4: Moloco SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে অবশ্যই ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে আপনার ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু প্রকাশ করতে হবে এবং কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ যেখানে আইনত প্রয়োজন সেখানে এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করা এবং ব্যবহারের জন্য তাদের সম্মতি পেতে হবে৷ এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন উত্সে প্রচারিত সম্মতি যাচাই করার জন্য আপনি দায়ী। Google স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
Moloco SDK-এ Moloco SDK-কে সম্মতির তথ্য পাঠানোর জন্য isUserConsent পতাকা রয়েছে।
নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Moloco SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই ফ্ল্যাগগুলি সেট করতে চান তবে Google মোবাইল বিজ্ঞাপন SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়৷
কোটলিন
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)
জাভা
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ true,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ false);
MolocoPrivacy.setPrivacy(privacySettings);
আরও তথ্যের জন্য Moloco SDK Android ডকুমেন্টেশন দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইনে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দিতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" পক্ষের হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে৷ মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
Moloco SDK-এ Moloco SDK-কে সম্মতির তথ্য পাঠানোর জন্য isDoNotSell পতাকা অন্তর্ভুক্ত রয়েছে।
নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Moloco SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই ফ্ল্যাগগুলি সেট করতে চান তবে Google মোবাইল বিজ্ঞাপন SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়৷
কোটলিন
import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...
val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
জাভা
import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...
// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
/* isUserConsent */ false,
/* isAgeRestrictedUser */ false,
/* isDoNotSell */ true);
MolocoPrivacy.setPrivacy(privacySettings);
আরও তথ্যের জন্য Moloco SDK Android ডকুমেন্টেশন দেখুন।
ধাপ 5: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
অ্যাড ম্যানেজারের জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করা নিশ্চিত করুন।
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি Moloco বিজ্ঞাপন SDK থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, Moloco (বিডিং) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার Moloco থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, আপনি নিম্নলিখিত ক্লাসের অধীনে ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
যখন একটি বিজ্ঞাপন লোড হতে ব্যর্থ হয় তখন মোলোকো অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
| ত্রুটি কোড | ডোমেইন | কারণ |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | অনুপস্থিত বা অবৈধ Moloco অ্যাপ কী। |
| 102 | com.google.ads.mediation.moloco | অনুপস্থিত বা অবৈধ Moloco বিজ্ঞাপন ইউনিট আইডি. |
| 103 | com.google.ads.mediation.moloco | মোলোকো বিজ্ঞাপন বস্তুটি শূন্য ছিল। |
| -1 থেকে 5000 | com.moloco.sdk | Moloco SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য Moloco এর ডকুমেন্টেশন দেখুন। |
পুরস্কৃত সার্ভার-সাইড যাচাইকরণ
আপনি সার্ভার-সাইড ভেরিফিকেশন (SSV) কলব্যাক যাচাই করলে , Moloco-এর বিজ্ঞাপন উৎস শনাক্তকারী হল 8267622065755668722 ।
মোলোকো অ্যান্ড্রয়েড মধ্যস্থতা অ্যাডাপ্টার চেঞ্জলগ
সংস্করণ 4.0.0.0 (প্রগতিতে)
সংস্করণ 3.12.1.0
- Moloco SDK 3.12.1 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.5.0।
- Moloco SDK সংস্করণ 3.12.1।
সংস্করণ 3.12.0.0
- Moloco SDK 3.12.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
- Moloco SDK সংস্করণ 3.12.0।
সংস্করণ 3.11.0.0
- Moloco SDK 3.11.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.4.0।
- Moloco SDK সংস্করণ 3.11.0।
সংস্করণ 3.10.0.0
- Moloco SDK 3.10.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.3.0।
- মোলোকো SDK সংস্করণ 3.10.0।
সংস্করণ 3.9.0.0
- Moloco SDK 3.9.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.2.0।
- Moloco SDK সংস্করণ 3.9.0।
সংস্করণ 3.8.0.1
- মাঝারি আয়তক্ষেত্র ব্যানার বিজ্ঞাপন আকারের জন্য সমর্থন যোগ করা হয়েছে.
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.1.0।
- Moloco SDK সংস্করণ 3.8.0।
সংস্করণ 3.8.0.0
- নেটিভ বিজ্ঞাপন বিন্যাসের জন্য বিডিং সমর্থন যোগ করা হয়েছে।
- Moloco SDK 3.8.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.1.0।
- Moloco SDK সংস্করণ 3.8.0।
সংস্করণ 3.7.2.0
- Moloco SDK 3.7.2 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.0.0।
- Moloco SDK সংস্করণ 3.7.2।
সংস্করণ 3.7.1.0
- ন্যূনতম প্রয়োজনীয় Android API লেভেল 23-এ আপডেট করা হয়েছে।
- 24.0.0-এ ন্যূনতম প্রয়োজনীয় Google মোবাইল বিজ্ঞাপন SDK সংস্করণ আপডেট করা হয়েছে৷
- Moloco SDK 3.7.1 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 24.0.0।
- Moloco SDK সংস্করণ 3.7.1।
সংস্করণ 3.7.0.0
- Moloco SDK 3.7.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 23.6.0।
- Moloco SDK সংস্করণ 3.7.0।
সংস্করণ 3.6.1.0
- Moloco SDK 3.6.1 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 23.6.0।
- Moloco SDK সংস্করণ 3.6.1।
সংস্করণ 3.6.0.0
- Moloco SDK 3.6.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 23.6.0।
- Moloco SDK সংস্করণ 3.6.0।
সংস্করণ 3.5.0.0
- প্রাথমিক মুক্তি।
- ব্যানার, ইন্টারস্টিশিয়াল এবং পুরস্কৃত বিজ্ঞাপন ফর্ম্যাটের জন্য বিডিং সমর্থন যোগ করা হয়েছে।
- Moloco SDK 3.5.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
এর সাথে নির্মিত এবং পরীক্ষিত:
- Google মোবাইল বিজ্ঞাপন SDK সংস্করণ 23.6.0।
- Moloco SDK সংস্করণ 3.5.0।