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

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

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

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

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

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

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

পূর্বশর্ত

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

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

ধাপ ১: 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 ও অ্যাডাপ্টার ইমপোর্ট করা

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

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

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

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

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

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

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

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

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

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

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

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

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

ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা

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

Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা ভালোভাবে দেখে নিন।

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

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

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

সমস্যার কোড

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

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 (কাজ চলছে)

ভার্সন 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.2.

ভার্সন 3.9.1.0

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

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

  • Google Mobile Ads SDK ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন ১.৩.১।
  • 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.8.2.0

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

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

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

ভার্সন 3.8.1.1

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

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

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

ভার্সন 3.8.1.0

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

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

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

ভার্সন 3.7.1.1

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

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

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

ভার্সন 3.7.1.0

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

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

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