মধ্যস্থতার সাথে ভার্ভ হাইবিড এসডিকে একীভূত করুন

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে বিডিং ইন্টিগ্রেশন সহ AdMob মিডিয়েশন ব্যবহার করে Google Mobile Ads SDK (Legacy) এর মাধ্যমে Verve HyBid SDK থেকে বিজ্ঞাপন লোড ও প্রদর্শন করতে হয়। এতে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে কীভাবে Verve HyBid SDK যোগ করতে হয় এবং একটি অ্যান্ড্রয়েড অ্যাপে Verve HyBid SDK ও অ্যাডাপ্টারকে কীভাবে ইন্টিগ্রেট করতে হয়, তা আলোচনা করা হয়েছে।

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

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

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

১. বিডিং ইন্টিগ্রেশন বর্তমানে আলফা পর্যায়ে রয়েছে। অ্যাক্সেসের অনুরোধ জানাতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলো যাচাই করে নিন:

  • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার পরবর্তী সংস্করণ।

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

কনফিগারেশন সেটআপের জন্য ভার্ভ-এর সাথে যোগাযোগ করুন

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

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

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

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

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

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

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

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

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

বিজ্ঞাপনের উৎস হিসেবে Verve HyBid SDK যোগ করুন


বিডিং কার্ডের অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স নির্বাচন করুন। তারপর ভার্ভ হাইব্রিড এসডিকে (Verve HyBid SDK ) নির্বাচন করুন।

Verve HyBid SDK ব্যবহার করে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন, তা জানতে ক্লিক করুন।



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



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



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

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

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

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

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

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

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

Verve HyBid SDK, UMP SDK সহ বিভিন্ন কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা নির্ধারিত GDPR সম্মতি স্বয়ংক্রিয়ভাবে পড়ে নেয়। আরও তথ্যের জন্য, GDPR TCF Compliance দেখুন।

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

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

Verve HyBid SDK একটি পদ্ধতির মাধ্যমে গোপনীয়তা সেটিংস সমর্থন করে। নিম্নলিখিত নমুনা কোডটি এই সম্মতির তথ্য Verve HyBid SDK-তে প্রেরণ করে। আপনি যদি ম্যানুয়ালি Verve HyBid SDK-তে সম্মতির তথ্য প্রেরণ করেন, তাহলে আমরা সুপারিশ করি যে আপনি Google Mobile Ads SDK (Legacy) এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে উদাহরণটি কল করুন।

জাভা

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

কোটলিন

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

US_PRIVACY_STRING জায়গায় আপনার মার্কিন গোপনীয়তা স্ট্রিংটি বসান।

বিস্তারিত জানতে, CCPA কমপ্লায়েন্স বিষয়ে Verve HyBid SDK-এর প্রাইভেসি ডকুমেন্টেশন দেখুন।

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

Verve HyBid SDK ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

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

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

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

অতিরিক্ত কনফিগারেশনের জন্য Verve HyBid SDK-এর ডকুমেন্টেশন অনুসরণ করুন।

ত্রুটি কোড

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

net.pubnative.lite.sdk
com.google.ads.mediation.verve

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

ত্রুটি কোড কারণ
১০০ থেকে ১০৩ Verve HyBid SDK একটি ত্রুটি দেখিয়েছে।
১০১ অনুরোধ করা বিজ্ঞাপনের আকারটি Verve HyBid SDK সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০২ অ্যাপ টোকেন অনুপস্থিত বা খালি।
১০৩ প্রসঙ্গটি শূন্য।

ভার্ভ অ্যান্ড্রয়েড মিডিয়েশন অ্যাডাপ্টার পরিবর্তন তালিকা

সংস্করণ ৩.৯.১.০

  • Verve HyBid SDK সংস্করণ 3.9.1-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.৪.০।
  • গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.৩.১।
  • Verve HyBid SDK সংস্করণ 3.9.1।

সংস্করণ ৩.৯.০.০

  • যখন নতুন AgeRestrictedTreatment CHILD এ সেট করা থাকে, তখন Verve SDK-এর জন্য বয়স-সীমাবদ্ধ অনুরোধগুলি ফিল্টার করুন।
  • Verve HyBid SDK সংস্করণ 3.9.0-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.৪.০।
  • গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.২.১।
  • ভার্ভ হাইব্রিড এসডিকে সংস্করণ ৩.৯.০।

সংস্করণ ৩.৮.২.০

  • Verve HyBid SDK সংস্করণ 3.8.2-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.৩.০।
  • গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.২.১।
  • Verve HyBid SDK সংস্করণ 3.8.2।

সংস্করণ ৩.৮.১.১

  • VerveNativeAd-এর জন্য কন্টেন্ট তথ্যে ক্লিক এবং সাধারণ বিজ্ঞাপনে ক্লিকের মধ্যে পার্থক্য করতে ক্লিকযোগ্য ভিউগুলো ফিল্টার করুন।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.২.০।
  • গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.০.১।
  • ভার্ভ হাইব্রিড এসডিকে সংস্করণ ৩.৮.১।

সংস্করণ ৩.৮.১.০

  • GMA নেক্সট-জেন SDK নির্ভরতার মাধ্যমে অ্যাডাপ্টারটি বিল্ড করার জন্য একটি প্রপার্টি যোগ করা হয়েছে।
  • Verve HyBid SDK সংস্করণ 3.8.1-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.১.০।
  • ভার্ভ হাইব্রিড এসডিকে সংস্করণ ৩.৮.১।

সংস্করণ ৩.৭.১.১

  • সিগন্যাল সংগ্রহের ব্যর্থতা নিরসনে ভার্ভ অ্যাডাপ্টার থেকে ব্যানার সাইজ চেকের বিকল্পটি সরিয়ে দেওয়া হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.০.০।
  • Verve HyBid SDK সংস্করণ 3.7.1।

সংস্করণ ৩.৭.১.০

  • প্রাথমিক প্রকাশ।
  • Verve HyBid SDK সংস্করণ 3.7.1-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৪.৮.০।
  • Verve HyBid SDK সংস্করণ 3.7.1।