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

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

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

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

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

পূর্বশর্ত

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

• Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।

• Google Mobile Ads SDK (Legacy)-এর লেটেস্ট ভার্সন।

• মধ্যস্থতা সেট-আপ করুন।

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

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

ধাপ ২: Ad Manager UI-তে Verve HyBid SDK চাহিদা সেট-আপ করুন

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

সুরক্ষিত সিগন্যাল শেয়ারিং চালু করা

অ্যাডমিন > গ্লোবাল সেটিংস বিকল্পে যান। Ad Exchange অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং নিরাপদ সিগন্যাল শেয়ারিং পর্যালোচনা করে টগল অন করুন। সেভ করুন বিকল্পে ক্লিক করুন।

বিড করার অনুরোধে নিরাপদ সিগন্যাল শেয়ার করা

ইনভেনটরি > সুরক্ষিত সিগন্যাল বিকল্পে নেভিগেট করুন। নিরাপদ সিগন্যাল বিকল্পের মধ্যে, Verve HyBid SDK সার্চ করুন এবং অ্যাপ ইন্টিগ্রেশন চালু করুন বিকল্পে টগল করুন।

সেভ করুন বিকল্পে ক্লিক করুন।

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

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস বিকল্পে যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ারিংয়ের অনুমতি দিন বিকল্প টগল করে চালু করুন।

সেভ করুন বিকল্পে ক্লিক করুন।

Verve HyBid SDK বিডিং কনফিগার করা

ডেলিভারি > বিডার বিকল্পে গিয়ে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

নতুন বিডার বিকল্পে ক্লিক করুন।

বিডার হিসেবে Verve Group বেছে নিন।

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

হয়ে গেছে বিকল্পে ক্লিক করুন।

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

ডেলিভারি > বিডার বিকল্পে নেভিগেট করে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

Verve HyBid SDK-এর জন্য কোম্পানি বেছে নিন।

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

নির্দিষ্ট বিজ্ঞাপন ইউনিট বেছে নিন। বিজ্ঞাপন ইউনিট ও ফর্ম্যাট, ইনভেনটরির ধরন হিসেবে মোবাইল অ্যাপ এবং আপনার মোবাইল অ্যাপ্লিকেশন বেছে নিন। তারপর, আগের বিভাগে পাওয়া Zone ID এবং AppToken লিখুন।

আপনি যদি Ad Manager UI-এর মধ্যে পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করেন, তাহলে পুরস্কার প্রদানকারী ফর্ম্যাট বেছে নিন এবং পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল প্লেসমেন্ট আইডি ব্যবহার করুন।

শেষে, সেভ করুন বিকল্পে ক্লিক করুন।

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

Ad Manager 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-এর বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রসেসিং চালু করার সুবিধা দেয়, কিন্তু Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মধ্যস্থতা চেনে এমন প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে আপনাকে শনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রি করার কাজে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের নির্দেশিকা মেনে চলতে হবে।

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

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

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

US_PRIVACY_STRING-এর জায়গায় আপনার মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা স্ট্রিং লিখুন।

বিস্তারিত জানতে, Verve HyBid SDK-এর গোপনীয়তা সংক্রান্ত ডকুমেন্টেশনের CCPA মেনে চলা অংশটি দেখুন।

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

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

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করুন

Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

টেস্ট বিজ্ঞাপন যাচাই করা

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

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

সমস্যার কোড

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

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

কোনও বিজ্ঞাপন লোড করা না গেলে, Verve HyBid SDK অ্যাডাপ্টার এই কোড ও মেসেজ দেখায়:

Verve Android মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

ভার্সন 3.9.3.0

• Verve HyBid SDK ভার্সন 3.9.3-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 25.5.0.
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৫.০।
• Verve HyBid SDK ভার্সন ৩.৯.৩।

ভার্সন 3.9.2.0

• অ্যাডাপ্টারের Kotlin ডিপেন্ডেন্সি ১.৯.০-এ পিন করুন (GMA NextGen SDK-এর মাধ্যমে সমর্থিত Kotlin-এর ন্যূনতম ভার্সন)।
• Verve HyBid SDK ভার্সন ৩.৯.২-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 25.4.0.
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Verve HyBid SDK ভার্সন ৩.৯.২।

ভার্সন 3.9.1.0

• Verve HyBid SDK ভার্সন ৩.৯.১-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 25.4.0.
• Google Mobile Ads Next-Gen SDK ভার্সন 1.3.1.
• Verve HyBid SDK ভার্সন 3.9.1.

ভার্সন 3.9.0.0

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

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Verve HyBid SDK ভার্সন 3.9.0.

ভার্সন 3.8.2.0

• Verve HyBid SDK ভার্সন 3.8.2-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।

এগুলির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৩.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Verve HyBid SDK ভার্সন ৩.৮.২।

ভার্সন ৩.৮.১.১

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

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.0.1।
• Verve HyBid SDK ভার্সন ৩.৮.১।

ভার্সন 3.8.1.0

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

এগুলির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 25.1.0.
• Verve HyBid SDK ভার্সন 3.8.1.

ভার্সন 3.7.1.1

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

এগুলির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 25.0.0.
• Verve HyBid SDK ভার্সন 3.7.1.

ভার্সন 3.7.1.0

• প্রাথমিক রিলিজ।
• Verve HyBid SDK ভার্সন 3.7.1-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এগুলির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.8.0.
• Verve HyBid SDK ভার্সন 3.7.1.