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

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

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

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

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

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

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

পূর্বশর্ত

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

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

ধাপ ১: 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 যোগ করুন

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.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.0")
}

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

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);

Kotlin

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-এর সাথে কাজ করে এমন ব্যানার সাইজের সাথে মেলে না।
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 বাদ দেওয়া হবে।

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

ভার্সন 3.9.3.0

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

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

  • Google Mobile Ads SDK ভার্সন ২৫.৫.০।
  • 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 ভার্সন ২৫.৪.০।
  • Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
  • Verve HyBid SDK ভার্সন ৩.৯.২।

ভার্সন 3.9.1.0

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

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

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

ভার্সন 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.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 ভার্সন ৩.৮.১-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

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

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

ভার্সন 3.7.1.1

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

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

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

ভার্সন 3.7.1.0

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

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

  • Google Mobile Ads SDK ভার্সন ২৪.৮.০।
  • Verve HyBid SDK ভার্সন ৩.৭.১।