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

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

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

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

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

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

পূর্বশর্ত

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

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

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



এরপর, আগের বিভাগ থেকে পাওয়া Zone ID এবং AppToken লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

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

AdMob 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 লিখুন।

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

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

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

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

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

CocoaPods ব্যবহার করা

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

    pod 'GoogleMobileAdsMediationVerve'
    
  • কমান্ড লাইন থেকে রান করুন:

    pod install --repo-update

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

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

Verve HyBid SDK iOS অ্যাডাপ্টার ভার্সন 3.7.1.1 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে Verve HyBid SDK SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, জিডিপিআর (GDPR) টিসিএফ (TCF) সম্মতি দেখুন।

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

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

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

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

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

Objective-C

[[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-তে সমস্যা হয়েছে।
১০১ com.google.mediation.verve সার্ভার কনফিগারেশনে প্রয়োজনীয় অ্যাপ টোকেন নেই।
102 com.google.mediation.verve ব্যবহারকারী একজন বাচ্চা।
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 মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

ভার্সন 3.9.3.0

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

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

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

ভার্সন 3.9.2.0

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

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

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

ভার্সন 3.9.1.0

  • HyBid SDK ভার্সন ৩.৯.১-এর সাথে কাজ করার উপযুক্ততা যাচাই করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 13.8.0.
  • 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 ভার্সন ১৩.৪.০।
  • HyBid SDK ভার্সন ৩.৮.১।

ভার্সন 3.8.1.0

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

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

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

ভার্সন 3.8.0.0

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

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

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

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

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

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

  • 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.

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

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

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

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