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

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

মধ্যস্থতার সাথে Verve HyBid SDK ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Android (Legacy)

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

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

Verve HyBid SDK-এর জন্য মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং	^১
জলপ্রপাত
ফর্ম্যাট
ব্যানার
স্থান
পুরস্কৃত ইন্টারস্টিশিয়াল
পুরস্কার জিতেছেন
নেটিভ

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

পূর্বশর্ত

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

Android API লেভেল ২৪ বা তার পরের ভার্সন।

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন-ইন করুন। এরপর, মধ্যস্থতা ট্যাবে নেভিগেট করুন। আপনার আগে থেকে থাকা কোনও মধ্যস্থতাকারী গ্রুপ আপনি পরিবর্তন করতে চাইলে, সেটি এডিট করার জন্য সেই মধ্যস্থতাকারী গ্রুপের নামে ক্লিক করুন এবং বিজ্ঞাপনের সোর্স হিসেবে Verve HyBid SDK যোগ করুন বিকল্পে যান।

নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপনের ফর্ম্যাট ও প্ল্যাটফর্ম লিখে চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপর, মধ্যস্থতা গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপর বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার আগে থেকে থাকা এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপ যুক্ত করুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনি এখন বিজ্ঞাপন ইউনিটের কার্ডে আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দেখতে পাবেন:

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

বিজ্ঞাপনের সোর্স বিভাগে, বিডিং কার্ড খুঁজে নিন এবং বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন। তারপর Verve HyBid SDK বেছে নিন ।

পার্টনারশিপ চুক্তিতে কীভাবে স্বাক্ষর করবেন এবং Verve HyBid SDK-এর সাথে বিডিং পার্টনারশিপ সেট-আপ করবেন তাতে ক্লিক করুন।

স্বীকার করে সম্মতি দিন বিকল্পে ক্লিক করুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

Verve HyBid SDK-এর জন্য আপনার কাছে আগে থেকেই ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

এরপর, আগের বিভাগে পাওয়া জোন আইডি এবং AppToken লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় Verve Group যোগ করুন

গুরুত্বপূর্ণ: ইউরোপীয় ইউনিয়নের সম্মতি ও জিডিপিআর (GDPR), মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন এবং ব্যবহারকারীর মেসেজিং প্ল্যাটফর্মের জন্য কনফিগারেশন সম্পূর্ণ করতে আপনার কাছে অ্যাকাউন্ট ম্যানেজমেন্ট সংক্রান্ত অনুমতি আছে কিনা তা যাচাই করুন। বিস্তারিত জানতে আপনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস ম্যানেজ করুন দেখুন।

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

ধাপ ৩: Verve HyBid SDK ও অ্যাডাপ্টার ইম্পোর্ট করা

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা হয়েছে)

আপনার প্রোজেক্ট-লেভেল 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.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.0")
}

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

EU কনসেন্ট ও জিডিপিআর (GDPR)

Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।

Verve HyBid SDK অটোমেটিক UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা জিডিপিআর (GDPR) সম্মতি পড়ে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) টিসিএফ (TCF) সম্মতি দেখুন।

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

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

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

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);VerveMediationSnippets.java

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)VerveMediationSnippets.kt

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-এর সাথে কাজ করে এমন ব্যানার সাইজের সাথে মেলে না।
102	net.pubnative.lite.sdk	Verve HyBid Error - Couldn't load ad.
103	com.google.ads.mediation.verve	একটি নাল ফুলস্ক্রিন বিজ্ঞাপন দেখানোর চেষ্টা করা হয়েছে।
104	com.google.ads.mediation.verve	MobileAds.getRequestConfiguration() ইঙ্গিত করে যে ব্যবহারকারী একজন বাচ্চা। Verve বাদ দেওয়া হবে।