গুগল ima ImaSdk সেটিংস
এই ক্লাসে SDK-ব্যাপী সেটিংস রয়েছে।
গণনা
CompanionBackfillMode
স্ট্রিং
সহচর ব্যাকফিল সেটিং এর জন্য ধ্রুবকের একটি সেট সংজ্ঞায়িত করে। এই সেটিং নির্দেশ করে যে বিভিন্ন পরিস্থিতিতে সঙ্গীদের ব্যাকফিল করা উচিত কিনা।
যদি মানটি ALWAYS
হয় , সঙ্গী ব্যাকফিল সব পরিস্থিতিতে চেষ্টা করা হবে, এমনকি যখন কোনো প্রধান বিজ্ঞাপন ফেরত না থাকে।
যদি মানটি ON_MASTER_AD
হয়, সঙ্গী ব্যাকফিল করার চেষ্টা করা হবে যদি সহচর স্লটের তুলনায় কম সঙ্গী সহ একটি প্রধান বিজ্ঞাপন থাকে। নিখোঁজ সঙ্গীরা ফিরে আসবে।
ডিফল্ট মান হল ALWAYS
।
... 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
।
... 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