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

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

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

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

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

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

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

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

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

মোলোকো পাবলিশার পোর্টালে লগ ইন করুন ।

ওভারভিউ > অ্যাপস ট্যাবে যান, তারপর একটি নতুন অ্যাপ তৈরি করতে অ্যাড অ্যাপ বোতামে ক্লিক করুন।

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

আপনার অ্যাপটি তৈরি হয়ে গেলে, এর বিবরণ দেখতে অ্যাপস ট্যাব থেকে সেটি নির্বাচন করুন এবং অ্যাপ কী-টি লিখে রাখুন।

Overview > Ad Units ট্যাবে যান, ড্রপ-ডাউন মেনু থেকে অ্যাপটি নির্বাচন করুন এবং তারপরে New Ad Unit-এ ক্লিক করুন।

নিলাম পদ্ধতি হিসেবে ইন-অ্যাপ বিডিং নির্বাচন করুন এবং ফর্মের বাকি অংশ পূরণ করুন। তারপর, ক্রিয়েট (Create ) বাটনে ক্লিক করুন।

এর বিবরণ দেখতে, 'অ্যাড ইউনিটস' ট্যাবের অধীনে আপনার নতুন তৈরি করা অ্যাড ইউনিটে যান। অ্যাড ইউনিট আইডি-টি লিখে রাখুন।

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

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

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

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

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

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

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

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

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

বিজ্ঞাপনের উৎস হিসেবে মোলোকো অ্যাডস এসডিকে যোগ করুন

ইউরোপীয় এবং মার্কিন রাষ্ট্রীয় প্রবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় মোলোকো অ্যাডস যোগ করুন

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

ধাপ ৩: মোলোকো এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

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

আপনার অ্যাপ-স্তরের build.gradle.kts ফাইলে, নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন। Moloco SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ ব্যবহার করুন:

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

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

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

ইইউ সম্মতি এবং জিডিপিআর

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

Moloco SDK-তে সম্মতির তথ্য প্রেরণের জন্য isUserConsent ফ্ল্যাগটি অন্তর্ভুক্ত রয়েছে।

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে মোলোকো এসডিকে-তে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই ফ্ল্যাগগুলি সেট করতে চান, GMA Next-Gen 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-তে সম্মতির তথ্য প্রেরণের জন্য isDoNotSell ফ্ল্যাগটি অন্তর্ভুক্ত রয়েছে।

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে মোলোকো এসডিকে-তে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই ফ্ল্যাগগুলি সেট করতে চান, GMA Next-Gen 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);

আরও তথ্যের জন্য মোলোকো এসডিকে অ্যান্ড্রয়েড ডকুমেন্টেশন দেখুন।

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

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

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

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

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

ত্রুটি কোড

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

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

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

সার্ভার-সাইড যাচাইকরণ পুরস্কৃত

আপনি যদি সার্ভার-সাইড ভেরিফিকেশন (SSV) কলব্যাকগুলি যাচাই করেন , তাহলে Moloco-এর জন্য বিজ্ঞাপন উৎস শনাক্তকারীটি হলো 8267622065755668722 ।