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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস অ্যান্ড্রয়েড (লেগ্যাসি)

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

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

একীকরণ
নিলাম ১
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত ইন্টারস্টিশিয়াল
পুরস্কৃত
স্থানীয়

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

পূর্বশর্ত

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

  • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার পরবর্তী সংস্করণ।

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

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

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

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

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

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি 'অ্যাড ভার্ভ হাইব্রিড এসডিকে অ্যাজ অ্যান অ্যাড সোর্স' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

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


বিডিং কার্ডের অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স নির্বাচন করুন। তারপর ভার্ভ হাইব্রিড এসডিকে (Verve HyBid SDK ) নির্বাচন করুন।

Verve HyBid SDK ব্যবহার করে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন, তা জানতে ক্লিক করুন।



স্বীকৃতি ও সম্মতিতে ক্লিক করুন, তারপর চালিয়ে যান-এ ক্লিক করুন।



আপনার যদি আগে থেকেই Verve HyBid SDK-এর জন্য কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘Add mapping’-এ ক্লিক করুন।



এরপর, পূর্ববর্তী অংশে প্রাপ্ত জোন আইডি এবং অ্যাপটোকেন প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় ভার্ভ গ্রুপকে যুক্ত করুন

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

ধাপ ৩: Verve HyBid SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন

চালিয়ে যাওয়ার আগে, আপনার কাছে সর্বনিম্ন সমর্থিত অ্যাডাপ্টার সংস্করণ ৩.৮.০.০ থাকতে হবে।

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

  1. Xcode-এ, File > Add Package Dependencies... -এ যান।

  2. প্রদর্শিত প্রম্পটে, নিম্নলিখিত প্যাকেজ URL-টি অনুসন্ধান করুন:

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

  3. ডিপেন্ডেন্সি রুল- এ, ব্রাঞ্চ নির্বাচন করুন।

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

কোকোপড ব্যবহার করুন

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

    pod 'GoogleMobileAdsMediationVerve'

  • কমান্ড লাইন থেকে চালান:

    pod install --repo-update

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

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

  • চেঞ্জলগে দেওয়া ডাউনলোড লিঙ্ক থেকে ভার্ভ অ্যাডাপ্টারের সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে VerveAdapter.framework ফাইলটি লিঙ্ক করুন।

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

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

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

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

Verve HyBid SDK, UMP SDK সহ বিভিন্ন কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা নির্ধারিত GDPR সম্মতি স্বয়ংক্রিয়ভাবে পড়ে নেয়। আরও তথ্যের জন্য, GDPR TCF Compliance দেখুন।

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

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

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

সুইফট 

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

usPrivacyString পরিবর্তে আপনার মার্কিন গোপনীয়তা স্ট্রিংটি ব্যবহার করুন।

উদ্দেশ্য-সি 

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

kUSPrivacyString পরিবর্তে আপনার মার্কিন গোপনীয়তা স্ট্রিংটি বসান।

বিস্তারিত জানতে, CCPA কমপ্লায়েন্স বিষয়ে Verve HyBid SDK-এর প্রাইভেসি ডকুমেন্টেশন দেখুন।

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

SKAdNetwork বাস্তবায়ন করুন

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য রেজিস্টার করে নিন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

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

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

ত্রুটি কোড

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

ত্রুটি কোড কারণ
১০০ থেকে ১০৬ Verve HyBid SDK একটি ত্রুটি দেখিয়েছে।
১০১ অ্যাপ টোকেন অনুপস্থিত।
১০২ ব্যবহারকারী একজন শিশু।
১০৩ Verve HyBid SDK চালু হতে ব্যর্থ হয়।
১০৪ অবৈধ বিজ্ঞাপন কনফিগারেশন।
১০৫ অসমর্থিত ব্যানার আকার।
১০৬ পূর্ণ পর্দার বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়।
১১৫ বিজ্ঞাপন ইউনিট আইডি অনুপস্থিত। বিজ্ঞাপনটি লোড করা যাচ্ছে না।
১১৬ বিজ্ঞাপনটি প্রস্তুত নয়। বিজ্ঞাপনটি প্রদর্শন করা যাচ্ছে না।

Verve iOS Mediation Adapter পরিবর্তন তালিকা

সংস্করণ ৩.৯.০.০

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.৬.০।
  • HyBid SDK সংস্করণ 3.9.0।

সংস্করণ ৩.৮.১.১

  • যখন নতুন ageRestrictedTreatment GADAgeRestrictedTreatmentChild এ সেট করা থাকে, তখন Verve SDK-এর জন্য বয়স-সীমাবদ্ধ অনুরোধগুলি ফিল্টার করুন।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.৪.০।
  • HyBid SDK সংস্করণ 3.8.1।

সংস্করণ ৩.৮.১.০

  • HyBid SDK সংস্করণ 3.8.1-এর সাথে সামঞ্জস্য যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.৪.০।
  • HyBid SDK সংস্করণ 3.8.1।

সংস্করণ ৩.৮.০.০

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.২.০।
  • HyBid SDK সংস্করণ 3.8.0।

সংস্করণ ৩.৭.১.৩

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.০.০।
  • HyBid SDK সংস্করণ 3.7.1।

সংস্করণ ৩.৭.১.২

  • CocoaPods-এর সর্বনিম্ন iOS সংস্করণ 13.0 -এ আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৩.০.০।
  • HyBid SDK সংস্করণ 3.7.1।

সংস্করণ ৩.৭.১.১

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১২.১৩.০।
  • HyBid SDK সংস্করণ 3.7.1।