বিডিংয়ের সাথে Verve HyBid SDK একীভূত করুন

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

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

অ্যাডমিন > গ্লোবাল সেটিংস- এ যান। অ্যাড এক্সচেঞ্জ অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং ‘সিকিওর সিগন্যাল শেয়ারিং’ পর্যালোচনা করে সেটি চালু করুন। ‘সেভ’- এ ক্লিক করুন।

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

Inventory > Secure Signals- এ যান। Secure signals- এর অধীনে, Verve HyBid SDK অনুসন্ধান করুন এবং Enable app integration টগলটি অন করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

SDK বিডিং-এর জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস- এ যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিং-এর জন্য ‘Allow secure signal sharing’ অপশনটি চালু করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

Verve HyBid SDK বিডিং কনফিগার করুন

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

নতুন দরদাতা-তে ক্লিক করুন।

ভার্ভ গ্রুপকে দরদাতা হিসেবে নির্বাচন করুন।

এই বিডারের জন্য SDK বিডিং সক্রিয় করতে ' চালিয়ে যান'-এ ক্লিক করুন।

সম্পন্ন ক্লিক করুন।

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

Verve HyBid SDK-এর জন্য কোম্পানি নির্বাচন করুন।

অ্যাড ইউনিট ম্যাপিং ট্যাবে যান এবং নতুন অ্যাড ইউনিট ম্যাপিং-এ ক্লিক করুন।

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

আপনি যদি অ্যাড ম্যানেজার UI-এর মধ্যে কোনো রিওয়ার্ডেড ইন্টারস্টিশিয়াল অ্যাডের জন্য অ্যাড ইউনিট ম্যাপিং কনফিগার করেন, তাহলে রিওয়ার্ডেড ফরম্যাটটি বেছে নিন এবং রিওয়ার্ডেড ইন্টারস্টিশিয়াল প্লেসমেন্ট আইডিটি ব্যবহার করুন।

অবশেষে, সেভ-এ ক্লিক করুন।

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

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

ধাপ ৩: 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-এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।

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

আপনি 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।