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

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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে বিডিং ইন্টিগ্রেশন কভার করে মধ্যস্থতা ব্যবহার করে 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-এর সাথে যোগাযোগ করুন।

ধাপ ২: 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-তে গোপনীয়তা সেটিংস প্রয়োগ করা

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

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)

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

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];

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

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

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

SKAdNetwork প্রয়োগ করা

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

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

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

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

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

আপনি 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 মধ্যস্থতা অ্যাডাপ্টরের পরিবর্তনের লগ

ভার্সন 3.9.3.0

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

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

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

ভার্সন 3.9.2.0

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

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

  • 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 ভার্সন 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.0.0

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

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

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

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

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

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

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

ভার্সন 3.7.1.2

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

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

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

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

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

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

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