ক্লাস: ImaSdkসেটিংস

গণনা

CompanionBackfillMode

ধ্রুবক স্থির

স্ট্রিং

সহচর ব্যাকফিল সেটিং এর জন্য ধ্রুবকের একটি সেট সংজ্ঞায়িত করে। এই সেটিং নির্দেশ করে যে বিভিন্ন পরিস্থিতিতে সঙ্গীদের ব্যাকফিল করা উচিত কিনা।

যদি মানটি ALWAYS হয় , সঙ্গী ব্যাকফিল সব পরিস্থিতিতে চেষ্টা করা হবে, এমনকি যখন কোনো প্রধান বিজ্ঞাপন ফেরত না থাকে।

যদি মানটি ON_MASTER_AD হয়, সঙ্গী ব্যাকফিল করার চেষ্টা করা হবে যদি সহচর স্লটের তুলনায় কম সঙ্গী সহ একটি প্রধান বিজ্ঞাপন থাকে। নিখোঁজ সঙ্গীরা ফিরে আসবে।

ডিফল্ট মান হল ALWAYS

মনে রাখবেন যে ক্লায়েন্ট-সাইড কম্প্যানিয়ন ব্যাকফিলের জন্য আপনার সঙ্গীদের সঠিকভাবে একটি Google প্রকাশক ট্যাগ (GPT) দিয়ে ট্যাগ করা প্রয়োজন। ব্যাকফিল সক্ষম করতে, স্ট্যান্ডার্ড GPT সেটআপে নিম্নলিখিত পরিবর্তনগুলি প্রয়োজনীয়:
...
let slot1 = googletag.defineSlot('/1234/adunit', [300, 250], 'slot-div');
slot1.addService(googletag.companionAds()).addService(googletag.pubads());
...
googletag.companionAds().setRefreshUnfilledSlots(true);
...
googletag.enableServices();
অটোপ্লে ভিডিওগুলির জন্য, সহচর স্লটগুলিকে প্রিলোড হওয়া থেকে রোধ করার জন্য নিম্নলিখিত অতিরিক্ত পরিবর্তনের সুপারিশ করা হয় এবং তারপরে অবিলম্বে সঙ্গীদের সাথে প্রতিস্থাপন করা হয়৷
googletag.pubads().disableInitialLoad();
...
googletag.enableServices();

মান

সর্বদা

ON_MASTER_AD

VpaidMode

ধ্রুবক স্থির

সংখ্যা

VPAID কার্যকারিতা সক্ষম করার জন্য ধ্রুবকের একটি সেট।

মান

অক্ষম

VPAID বিজ্ঞাপনগুলি চলবে না এবং একটি ত্রুটি ফেরত দেওয়া হবে৷

সক্ষম

একটি ক্রস ডোমেইন iframe ব্যবহার করে VPAID বিজ্ঞাপন সক্ষম করা হয়৷ VPAID বিজ্ঞাপনটি সাইটে প্রবেশ করতে পারে না। বন্ধুত্বপূর্ণ iframe অ্যাক্সেসের উপর নির্ভরশীল VPAID বিজ্ঞাপনে ত্রুটি হতে পারে। এটি ডিফল্ট।

নিরাপত্তাহীন

VPAID বিজ্ঞাপন একটি বন্ধুত্বপূর্ণ iframe ব্যবহার করে সক্রিয় করা হয়। এটি জাভাস্ক্রিপ্টের মাধ্যমে সাইটে বিজ্ঞাপন অ্যাক্সেসের অনুমতি দেয়।

বৈশিষ্ট্য

CompanionBackfillMode

ধ্রুবক স্থির

স্ট্রিং

সহচর ব্যাকফিল সেটিং এর জন্য ধ্রুবকের একটি সেট সংজ্ঞায়িত করে। এই সেটিং নির্দেশ করে যে বিভিন্ন পরিস্থিতিতে সঙ্গীদের ব্যাকফিল করা উচিত কিনা।

যদি মানটি ALWAYS হয় , সঙ্গী ব্যাকফিল সব পরিস্থিতিতে চেষ্টা করা হবে, এমনকি যখন কোনো প্রধান বিজ্ঞাপন ফেরত না থাকে।

যদি মানটি ON_MASTER_AD হয়, সঙ্গী ব্যাকফিল করার চেষ্টা করা হবে যদি সহচর স্লটের তুলনায় কম সঙ্গী সহ একটি প্রধান বিজ্ঞাপন থাকে। নিখোঁজ সঙ্গীরা ফিরে আসবে।

ডিফল্ট মান হল ALWAYS

মনে রাখবেন যে ক্লায়েন্ট-সাইড কম্প্যানিয়ন ব্যাকফিলের জন্য আপনার সঙ্গীদের সঠিকভাবে একটি Google প্রকাশক ট্যাগ (GPT) দিয়ে ট্যাগ করা প্রয়োজন। ব্যাকফিল সক্ষম করতে, স্ট্যান্ডার্ড GPT সেটআপে নিম্নলিখিত পরিবর্তনগুলি প্রয়োজনীয়:
...
let slot1 = googletag.defineSlot('/1234/adunit', [300, 250], 'slot-div');
slot1.addService(googletag.companionAds()).addService(googletag.pubads());
...
googletag.companionAds().setRefreshUnfilledSlots(true);
...
googletag.enableServices();
অটোপ্লে ভিডিওগুলির জন্য, সহচর স্লটগুলিকে প্রিলোড হওয়া থেকে আটকাতে নিম্নলিখিত অতিরিক্ত পরিবর্তনের সুপারিশ করা হয় এবং তারপরে অবিলম্বে সঙ্গীদের সাথে প্রতিস্থাপন করা হয়৷
googletag.pubads().disableInitialLoad();
...
googletag.enableServices();

মান

সর্বদা

ON_MASTER_AD

VpaidMode

ধ্রুবক স্থির

সংখ্যা

VPAID কার্যকারিতা সক্ষম করার জন্য ধ্রুবকের একটি সেট।

মান

অক্ষম

VPAID বিজ্ঞাপনগুলি চলবে না এবং একটি ত্রুটি ফেরত দেওয়া হবে৷

সক্ষম

একটি ক্রস ডোমেইন iframe ব্যবহার করে VPAID বিজ্ঞাপন সক্ষম করা হয়৷ VPAID বিজ্ঞাপনটি সাইটে প্রবেশ করতে পারে না। বন্ধুত্বপূর্ণ iframe অ্যাক্সেসের উপর নির্ভরশীল VPAID বিজ্ঞাপনে ত্রুটি হতে পারে। এটি ডিফল্ট।

নিরাপত্তাহীন

VPAID বিজ্ঞাপন একটি বন্ধুত্বপূর্ণ iframe ব্যবহার করে সক্রিয় করা হয়। এটি জাভাস্ক্রিপ্টের মাধ্যমে সাইটে বিজ্ঞাপন অ্যাক্সেসের অনুমতি দেয়।

পদ্ধতি

কম্প্যানিয়ন ব্যাকফিল পান

getCompanionBackfill() CompanionBackfillMode প্রদান করে

বর্তমান সহচর ব্যাকফিল মোড প্রদান করে।

রিটার্নস

non-null CompanionBackfillMode বর্তমান মান।

GetDisableCustomPlaybackForIOS10Plus

getDisableCustomPlaybackForIOS10Plus() বুলিয়ান রিটার্ন করে

iOS 10+ ব্রাউজারে কাস্টম প্লেব্যাক অক্ষম করতে হবে কিনা তা পায়। ডিফল্ট মান মিথ্যা।

রিটার্নস

boolean

ফিচার পতাকা পান

getFeatureFlags() যেকোন ধরনের বৈশিষ্ট্য সহ অবজেক্ট রিটার্ন করে

বৈশিষ্ট্য ফ্ল্যাগ হিসাবে কী সহ একটি বস্তু এবং বর্তমান অবস্থা হিসাবে মান প্রদান করে।

রিটার্নস

non-null Object with any type properties

getLocale

getLocale() স্ট্রিং প্রদান করে

প্রকাশক প্রদত্ত লোকেল ফেরত দেয়।

রিটার্নস

string প্রকাশক লোকেল প্রদান করেছে।

getNumRedirects

getNumRedirects() নম্বর প্রদান করে

পরবর্তী পুনঃনির্দেশের জন্য সর্বাধিক সংখ্যক পুনঃনির্দেশ প্রদান করে অস্বীকার করা হবে।

রিটার্নস

রিডাইরেক্টের সর্বোচ্চ number

গেট প্লেয়ার টাইপ

getPlayerType() স্ট্রিং প্রদান করে

অংশীদার প্রদত্ত প্লেয়ারের ধরন প্রদান করে।

রিটার্নস

string পার্টনার প্লেয়ারের ধরন।

গেট প্লেয়ার সংস্করণ

getPlayerVersion() স্ট্রিং প্রদান করে

অংশীদার প্রদত্ত প্লেয়ার সংস্করণ প্রদান করে।

রিটার্নস

string পার্টনার প্লেয়ার সংস্করণ।

getPpid

getPpid() রিটার্ন করে (নাল বা স্ট্রিং)

প্রকাশকের প্রদত্ত আইডি ফেরত দেয়।

রিটার্নস

(null or string) প্রকাশক প্রদত্ত আইডি।

isCookiesEnabled

isCookiesEnabled() বুলিয়ান রিটার্ন করে

রিটার্নস

boolean প্রকাশক কুকি ব্যবহার করার অনুমতি দেয় কিনা।

setAutoPlayAdBreaks

setAutoPlayAdBreaks(autoPlayAdBreaks) অকার্যকর প্রদান করে

VMAP এবং বিজ্ঞাপনের নিয়ম বিজ্ঞাপন বিরতিগুলি স্বয়ংক্রিয়ভাবে চালানো হয় কিনা তা সেট করে

প্যারামিটার

autoPlayAdBreaks

বুলিয়ান

বিজ্ঞাপন বিরতি স্বয়ংক্রিয়ভাবে প্লে করতে হবে কিনা।

রিটার্নস

void

সেট কম্পানিয়ন ব্যাকফিল

setCompanionBackfill(মোড) অকার্যকর প্রদান করে

সঙ্গী ব্যাকফিল মোড সেট করে। ImaSdkSettings.CompanionBackfillMode-এ উপলব্ধ বিভিন্ন মোড দেখুন।

ডিফল্ট মোড হল ImaSdkSettings.CompanionBackfillMode.ALWAYS৷

প্যারামিটার

মোড

CompanionBackfillMode

নির্বাচিত সহচর ব্যাকফিল মোড।

মান শূন্য হতে হবে না.

রিটার্নস

void

setCookiesEnabled

setCookiesEnabled(cookiesEnabled) অকার্যকর প্রদান করে

প্রথম পক্ষের কুকি হিসাবে SDK প্রকাশকের ডোমেনে Google বিজ্ঞাপন ম্যানেজার কুকি (GFP কুকি) সংরক্ষণ করবে কিনা। এটি তৃতীয় পক্ষের কুকিজ ব্যবহার না করে একই ডোমেনে একাধিক ভিজিট জুড়ে স্থিরতা সক্ষম করে। ডিফল্ট থেকে সত্য।

এই সেটিং অন্যান্য কুকিগুলিকে প্রভাবিত করবে না যা অন্য পক্ষের দ্বারা বা অন্যান্য উদ্দেশ্যে সেট করা হতে পারে৷ ব্যবহারকারীর সম্মতি এবং অপ্ট-আউটগুলিও প্রথম পক্ষের কুকির ব্যবহার অক্ষম করতে পারে৷ একই ফ্রেমে থাকলে, IAB অনুগত সম্মতি ম্যানেজমেন্ট প্রদানকারীর মাধ্যমে প্রকাশকের ব্যবহার করে এগুলি সংগ্রহ করা হবে।

প্যারামিটার

কুকিজ সক্ষম

বুলিয়ান

রিটার্নস

void

সেটDisableCustomPlaybackForIOS10Plus

setDisableCustomPlaybackForIOS10Plus(অক্ষম) অকার্যকর প্রদান করে

iOS 10+ ব্রাউজারে কাস্টম প্লেব্যাক অক্ষম করতে হবে কিনা তা সেট করে। সত্য হলে, বিষয়বস্তু ভিডিও ইনলাইন হলে বিজ্ঞাপনগুলি ইনলাইনে চলবে৷ এটি TrueView এড়িয়ে যাওয়া বিজ্ঞাপনগুলিকে সক্ষম করে৷ যাইহোক, বিজ্ঞাপনটি ইনলাইনে থাকবে এবং iOS এর নেটিভ পূর্ণস্ক্রীন সমর্থন করবে না। মিথ্যা হলে, বিজ্ঞাপনগুলি আপনার সামগ্রীর মতো একই প্লেয়ারে চলবে৷ যখন একটি AdDisplayContainer তৈরি করা হয় তখন এখানে সেট করা মানটি কন্টেইনারের আজীবনের জন্য ব্যবহার করা হয়। ডিফল্ট মান মিথ্যা।

প্যারামিটার

নিষ্ক্রিয়

বুলিয়ান

কাস্টম প্লেব্যাক অক্ষম করতে হবে কি না।

রিটার্নস

void

সেট ফিচার পতাকা

setFeatureFlags(featureFlags) অকার্যকর প্রদান করে

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

প্যারামিটার

বৈশিষ্ট্য পতাকা

যে কোনো ধরনের বৈশিষ্ট্য সহ অবজেক্ট

মান শূন্য হতে হবে না.

রিটার্নস

void

setLocale

setLocale(locale) void প্রদান করে

প্রকাশক প্রদত্ত লোকেল সেট করে। AdsLoader বা AdDisplayContainer তৈরি করার আগে অবশ্যই কল করতে হবে। লোকেল যে ভাষাতে UI উপাদানগুলি প্রদর্শন করবে তা নির্দিষ্ট করে৷ সমর্থিত কোডগুলি ভাষা এবং লোকেলের জন্য স্থানীয়করণে পাওয়া যাবে।

প্যারামিটার

লোকেল

স্ট্রিং

প্রকাশক-প্রদত্ত লোকেল।

রিটার্নস

void

setNumRedirects

setNumRedirects(numRedirects) অকার্যকর প্রদান করে

পরবর্তী পুনঃনির্দেশগুলি অস্বীকার করার আগে সর্বাধিক সংখ্যক পুনঃনির্দেশ উল্লেখ করে এবং বিজ্ঞাপন লোড বাতিল করা হয়। পুনঃনির্দেশের সংখ্যা সরাসরি লেটেন্সি এবং এইভাবে ব্যবহারকারীর অভিজ্ঞতাকে প্রভাবিত করে। এটি সমস্ত VAST র‍্যাপার বিজ্ঞাপনের ক্ষেত্রে প্রযোজ্য৷

প্যারামিটার

numRedirects

সংখ্যা

রিডাইরেক্টের সর্বোচ্চ সংখ্যা।

রিটার্নস

void

সেট প্লেয়ার টাইপ

setPlayerType(playerType) অকার্যকর প্রদান করে

পার্টনার প্রদত্ত প্লেয়ারের ধরন সেট করে। এই সেটিংটি SDK-এর সাথে একত্রিত হওয়া প্লেয়ারের নাম নির্দিষ্ট করতে ব্যবহার করা উচিত। 20 অক্ষরের বেশি প্লেয়ারের ধরন কাটা হবে। নির্দিষ্ট প্লেয়ারের ধরন সংক্ষিপ্ত এবং অনন্য হওয়া উচিত। এটি একটি ঐচ্ছিক সেটিং যা প্লেয়ারের ধরন ট্র্যাক করে SDK ব্যবহারযোগ্যতা উন্নত করতে ব্যবহৃত হয়।

উদাহরণ:


settings.setPlayerType('google/gmf-player');

প্যারামিটার

প্লেয়ার টাইপ

স্ট্রিং

পার্টনার প্লেয়ারের ধরন।

রিটার্নস

void

সেট প্লেয়ার সংস্করণ

setPlayerVersion(playerVersion) অকার্যকর প্রদান করে

অংশীদার প্রদত্ত প্লেয়ার সংস্করণ সেট করে। এই সেটিংটি SDK-এর সাথে একত্রিত হওয়া অংশীদার প্লেয়ারের সংস্করণ নির্দিষ্ট করতে ব্যবহার করা উচিত৷ 20টি অক্ষরের বেশি প্লেয়ার সংস্করণগুলি কাটা হবে৷ এটি একটি ঐচ্ছিক সেটিংস যা প্লেয়ার সংস্করণ ট্র্যাক করে SDK ব্যবহারযোগ্যতা উন্নত করতে ব্যবহৃত হয়।

উদাহরণ:


settings.setPlayerVersion('1.0.0');

প্যারামিটার

প্লেয়ার সংস্করণ

স্ট্রিং

অংশীদার প্লেয়ারের সংস্করণ।

রিটার্নস

void

সেটপিপিড

setPpid(ppid) void প্রদান করে

প্রকাশকের প্রদত্ত আইডি সেট করে।

প্যারামিটার

ppid

স্ট্রিং

প্রকাশক আইডি প্রদান করেছে।

রিটার্নস

void

setSessionId

setSessionId(sessionId) void প্রদান করে

সেশন আইডি একটি অস্থায়ী র্যান্ডম আইডি। এটি ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য একচেটিয়াভাবে ব্যবহৃত হয়। একটি সেশন আইডি একটি UUID হতে হবে।

প্যারামিটার

সেশন আইডি

স্ট্রিং

ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য ব্যবহৃত একটি অস্থায়ী UUID।

রিটার্নস

void

setVpaidAllowed

setVpaidAllowed(allowVpaid) অকার্যকর প্রদান করে

অবচয়। setVpaidMode ব্যবহার করুন। VPAID ক্রিয়েটিভ অনুমোদিত কিনা তা সেট করে।

প্যারামিটার

allowVpaid

বুলিয়ান

VPAID ক্রিয়েটিভের অনুমতি দেওয়া হবে কিনা।

রিটার্নস

void

setVpaidMode

setVpaidMode(vpaidMode) অকার্যকর প্রদান করে

VPAID প্লেব্যাক মোড সেট করে।

প্যারামিটার

vpaidMode

VpaidMode

VPAID বিজ্ঞাপনগুলি কীভাবে চালানো হবে তা সেট করে। ডিফল্ট নিরাপদ মোড।

মান শূন্য হতে হবে না.

রিটার্নস

void