AdMob মেডিয়েশনের সাথে Verve HyBid SDK ইন্টিগ্রেট করা

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

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

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

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

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

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

পূর্বশর্ত

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

• iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।

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

• 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-এর জন্য আপনার আগে থেকেই কোনও ম্যাপিং থাকলে, সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।



এরপরে, আগের বিভাগে পাওয়া জোন আইডি ও অ্যাপটোকেন লিখুন। তারপরে হয়ে গেছে বিকল্পে ক্লিক করুন।

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

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

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

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

মনে রাখবেন: উপযুক্ত Verve HyBid SDK ও Google Mobile Ads SDK ভার্সন ইন্টিগ্রেট করতে না পারলে, বিল্ড সংক্রান্ত সমস্যা হতে পারে।

Swift Package Manager ব্যবহার করা

চালিয়ে যাওয়ার আগে, আপনার কাছে অবশ্যই কাজ করে এমন ন্যূনতম অ্যাডাপ্টার ভার্সন 3.8.0.0 থাকতে হবে।

আপনার প্রোজেক্টে প্যাকেজ নির্ভরতা যোগ করতে এইসব ধাপ অনুসরণ করুন:

1. Xcode-এ, ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন... বিকল্পে নেভিগেট করুন।

2. যে প্রম্পটটি দেখা যাবে, তাতে নিম্নলিখিত প্যাকেজ URL সার্চ করুন:

   https://github.com/googleads/googleads-mobile-ios-mediation-verve.git
   

3. নির্ভরতা সংক্রান্ত নিয়মে, ব্রাঞ্চ বিকল্প বেছে নিন।

4. টেক্সট ফিল্ডে main লিখুন।

CocoaPods ব্যবহার করা

• আপনার প্রোজেক্টের Podfile-এ নিম্নলিখিত লাইনটি যোগ করুন:

  pod 'GoogleMobileAdsMediationVerve'
  

• কমান্ড লাইন থেকে এগুলি রান করুন:

  pod install --repo-update

ম্যানুয়াল ইন্টিগ্রেশন

• Verve iOS SDK-এর লেটেস্ট ভার্সন ডাউনলোড করুন এবং আপনার প্রোজেক্টে VerveSDK.framework লিঙ্ক করুন।

• পরিবর্তনের লগ থেকে ডাউনলোড লিঙ্ক এবং আপনার প্রোজেক্টে লিঙ্ক VerveAdapter.framework থেকে Verve অ্যাডাপ্টরের লেটেস্ট ভার্সন ডাউনলোড করুন।

• আপনার প্রোজেক্টে নিম্নলিখিত ফ্রেমওয়ার্ক যোগ করুন:

  • AdSupport
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreTelephony
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit
  • libz.tbd

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

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

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

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

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

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

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

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

SKAdNetwork প্রয়োগ করা

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, Verve HyBid SDK-এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

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

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob ও Verve HyBid SDK-এর জন্য টেস্ট মোড বন্ধ করুন।

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

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

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

সমস্যার কোড

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

সমস্যার কোড	ডোমেন	কারণ
১০০ থেকে ১০৬	Verve HyBid SDK-তে সমস্যা হয়েছে।
১০১	com.google.mediation.verve	সার্ভার কনফিগারেশনে প্রয়োজনীয় অ্যাপ টোকেন নেই।
102	ব্যবহারকারী অপ্রাপ্তবয়স্ক।
103	com.google.mediation.verve	Verve HyBid SDK চালু করা যায়নি।
104	com.google.mediation.verve	বিজ্ঞাপন লোড করার জন্য ভুল বিজ্ঞাপন কনফিগারেশন।
১০৫	com.google.mediation.verve	ব্যানারের সাইজ কাজ করে না।
106	com.google.mediation.verve	ফুল-স্ক্রিন বিজ্ঞাপনটি দেখানোর জন্য রেডি নয়।
115	com.google.mediation.verve	বিজ্ঞাপন ইউনিট আইডি নেই। বিজ্ঞাপন লোড করা যাচ্ছে না।

Verve iOS মধ্যস্থতা অ্যাডাপ্টরের পরিবর্তনের লগ

ভার্সন ৩.৯.২.০

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

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

• Google Mobile Ads SDK ভার্সন 13.9.0.
• HyBid SDK ভার্সন 3.9.2.

ভার্সন 3.9.1.0

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

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

• Google Mobile Ads SDK ভার্সন 13.8.0.
• HyBid SDK ভার্সন 3.9.1.

ভার্সন 3.9.0.0

• মাইনর ভার্সন শিথিল ও অনুমোদন করতে, ন্যূনতম Google Mobile Ads iOS SDK ভার্সন 13.3-এ আপডেট করা হয়েছে।
• HyBid SDK ভার্সন 3.9.0-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।

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

• Google Mobile Ads SDK ভার্সন 13.6.0.
• HyBid SDK ভার্সন 3.9.0.

ভার্সন 3.8.1.1

• নতুন ageRestrictedTreatment GADAgeRestrictedTreatmentChild হিসেবে সেট করা হলে, Verve SDK-এর জন্য বয়স সংক্রান্ত বিধিনিষেধযুক্ত অনুরোধ ফিল্টার করুন।

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

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

ভার্সন 3.8.1.0

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

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

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

ভার্সন 3.8.0.0

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

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

• Google Mobile Ads SDK ভার্সন 13.2.0.
• HyBid SDK ভার্সন 3.8.0.

ভার্সন 3.7.1.3

• Google Mobile Ads SDK-এর নির্ভরতা ভার্সন 13.0.0-এ আপডেট করা হয়েছে।

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

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

ভার্সন 3.7.1.2

• CocoaPods-এর ন্যূনতম iOS ভার্সন 13.0-এ আপডেট করা হয়েছে।

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

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

ভার্সন 3.7.1.1

• প্রাথমিক রিলিজ!
• বিডিং ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল ও নেটিভ বিজ্ঞাপন ফর্ম্যাট কাজ করে।
• HyBid SDK ভার্সন 3.7.1-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।

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

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