বিডিংয়ের সাথে Verve HyBid SDK ইন্টিগ্রেট করা

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

Swift প্যাকেজ ম্যানেজার ব্যবহার করা

চালিয়ে যাওয়ার আগে, আপনার কাছে ন্যূনতম সমর্থিত অ্যাডাপ্টার ভার্সন 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 লিঙ্ক করুন।

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

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

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

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

EU কনসেন্ট ও জিডিপিআর (GDPR)

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

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

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

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

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

SKAdNetwork প্রয়োগ করা

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

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

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

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

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

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

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

ত্রুটি কোড

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

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

ভার্সন 3.9.3.0

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

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

• Google Mobile Ads SDK ভার্সন ১৩.১১.০।
• HyBid SDK ভার্সন ৩.৯.৩।

ভার্সন 3.9.2.0

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

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

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

ভার্সন 3.9.1.0

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

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

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

ভার্সন 3.9.0.0

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

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

• Google Mobile Ads SDK ভার্সন ১৩.৬.০।
• HyBid SDK ভার্সন ৩.৯.০।

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

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

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

• Google Mobile Ads SDK ভার্সন 13.4.0.
• HyBid SDK ভার্সন ৩.৮.১।

ভার্সন 3.8.1.0

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

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

• Google Mobile Ads SDK ভার্সন 13.4.0.
• HyBid SDK ভার্সন ৩.৮.১।

ভার্সন 3.8.0.0

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

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

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

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

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

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

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

ভার্সন ৩.৭.১.২

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

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

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

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

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

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

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