উন্নত ব্যবহারকারীদের জন্য আমরা সার্চ স্টাইল প্যারামিটারের এই তালিকা প্রদান করেছি যা বর্তমানে কাজ করে। আপনি AdSense-এ যে কোড তৈরি করেন তাতে সাধারণভাবে সবথেকে বেশি ব্যবহৃত প্যারামিটারের সেটিংস থাকে। দুটি প্রয়োজনীয় প্যারামিটার আছে: pubId
এবং query
। AdSense pubId প্রদান করে কিন্তু আপনাকে কোডটি এডিট করতে হবে এবং query
প্যারামিটারের জন্য একটি ভ্যালু পাস করতে হবে। অন্যান্য প্যারামিটারগুলি ঐচ্ছিক এবং নিচে বর্ণনা করা হয়েছে।
প্যারামিটারের ধরন
দুই ধরনের প্যারামিটার হয়:
- পৃষ্ঠা লেভেল প্যারামিটার যা পৃষ্ঠার সকল বিজ্ঞাপন ইউনিটগুলির ক্ষেত্রে প্রযোজ্য
- ইউনিট লেভেল প্যারামিটার যা আলাদা আলাদা বিজ্ঞাপন ইউনিটের ক্ষেত্রে প্রযোজ্য।
এখানে দুটি বিজ্ঞাপন ব্লকের কোড জেনারেটর থেকে পাওয়া কিছু আউটপুট উদাহরণ হিসেবে দেওয়া হল। এই কোড কনফিগার করতে, আপনাকে pageOptions
ম্যাপে থাকা প্রয়োজনীয় query
প্যারামিটার (যেমন, “query”: myQuery
) সেট করতে হবে। বিজ্ঞাপন দেখানো শুরু করতে শুধু এগুলিই প্রয়োজন। আপনি পৃষ্ঠা লেভেল ব্লকে ঐচ্ছিক পৃষ্ঠা লেভেল প্যারামিটার এবং adblock1
ও adblock2
ম্যাপে আলাদা আলাদা ইউনিট লেভেল প্যারামিটার সেট করতে পারবেন।
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// পৃষ্ঠা লেভেল প্যারামিটার
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// ইউনিট লেভেল প্যারামিটার
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
পৃষ্ঠা লেভেল প্যারামিটারের বিবরণ
এই প্যারামিটারগুলি প্রতিটি পৃষ্ঠায় একবার উল্লেখ করতে হবে। এগুলি পৃষ্ঠার সমস্ত ইউনিটকে প্রভাবিত করে।
প্রয়োজনীয়
প্যারামিটার | বিবরণ ও উদাহরণ |
---|---|
adPage |
ব্যবহারকারী আগের বা পরের ফলাফল পৃষ্ঠায় যাওয়ার সময় এটি প্রয়োজন
|
pubId |
প্রয়োজনীয় এটি আপনার AdSense ক্লায়েন্ট-আইডি। pubId হল আপনার ক্লায়েন্ট-আইডির অংশ যা 'পার্টনার-'-এর পরে থাকে। যেমন, আপনার ক্লায়েন্ট-আইডি যদি 'partner-test-property' হয়, তাহলে আপনার pubId হল 'test-property'। এটি হল CSA-এর স্ট্যান্ডার্ড প্রোটোকল। যেমন: 'pubId' : 'test-property' |
query |
প্রয়োজন এটি হল ব্যবহারকারীর লেখা সার্চ কোয়েরি। কোয়েরি প্যারামিটারের ভ্যালু এনকোড না করা অবস্থায় রাখতে হবে। যেমন:
|
resultsPageBaseUrl |
পৃষ্ঠায় এই ধরনের সার্চ ইউনিট থাকলে প্রয়োজন এমন সার্চ ফলাফল পৃষ্ঠার URL উল্লেখ করে, যেখানে সার্চ কোয়েরি হল এই ধরনের সার্চ টার্ম যাতে ব্যবহারকারী ক্লিক করেছেন। আমি resultsPageBaseUr -এর মধ্যে, এটির নিজস্ব প্যারামিটার অন্তর্ভুক্ত করতে পারি, তবে এমন সার্চ কোয়েরি অন্তর্ভুক্ত করা যাবে না যা অটোমেটিক যুক্ত হয়।
যেমন:
|
styleId |
প্রয়োজন পৃষ্ঠার বিজ্ঞাপন বা এই ধরনের সার্চ ইউনিটে প্রয়োগ করা হবে এমন সার্চ স্টাইলের আইডি উল্লেখ করে। সার্চ স্টাইল ব্যবহার করা সম্পর্কে আরও জানুন। মনে রাখবেন যে অনুরোধ, বিজ্ঞাপন বা এই ধরনের সার্চের জন্য সেট করা স্টাইল আইডি, স্টাইলের সাথে রেন্ডার করা হবে এবং লিগ্যাসি স্টাইলিং প্যারামিটার উপেক্ষা করা হবে। অনুরোধে স্টাইল আইডি উল্লেখ না করা থাকলে, সিস্টেম ডিফল্ট স্টাইল রেন্ডার করা হবে। যেমন
|
ঐচ্ছিক
প্যারামিটার | বিবরণ ও উদাহরণ |
---|---|
linkTarget |
ঐচ্ছিক কোনও বিজ্ঞাপনে ক্লিক করলে তা একই উইন্ডোতে নাকি নতুন উইন্ডোতে খুলবে তা উল্লেখ করে। '_top' হল ডিফল্ট। এছাড়াও, এই প্যারামিটার ইউনিট লেভেলেও ব্যবহার করা যেতে পারে।
যেমন: 'linkTarget' : '_blank' |
maxTermLength |
ঐচ্ছিক স্পেস সহ এই ধরনের সার্চ করা শব্দের সর্বাধিক সংখ্যক অক্ষর উল্লেখ করে। সেট না করা থাকলে সর্বাধিক কোনও কিছুই হবে না। যেমন: 'maxTermLength' : 50 |
referrerAdCreative |
ঐচ্ছিক কোনও ব্যবহারকারী যদি অন্য কোনও ওয়েবসাইটে থাকা বিজ্ঞাপনে বা লিঙ্কে ক্লিক করে আপনার এমন কন্টেন্ট পৃষ্ঠায় আসেন, যেখানে কন্টেন্ট ইউনিটের জন্য এই ধরনের সার্চ আছে এবং সেই বিজ্ঞাপন বা লিঙ্ক যদি আপনার নিয়ন্ত্রণে থাকে, তাহলে এই প্যারামিটার একদম একইরকম বিজ্ঞাপনের ক্রিয়েটিভ টেক্সটে বা লিঙ্কে সেট করতে হবে। এই প্যারামিটার ব্যবহার করার ক্ষেত্রে এই নির্দেশিকা প্রযোজ্য:
যেমন: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
ঐচ্ছিক সার্চ ফলাফল পৃষ্ঠার সার্চ কোয়েরির URL প্যারামিটারের নাম উল্লেখ করে। উল্লেখ করা না থাকলে ‘q’ হল ডিফল্ট প্যারামিটার। যেমন: 'resultsPageQueryParam' : 'query' |
terms |
ঐচ্ছিক এই প্যারামিটার আপনাকে কমা দ্বারা আলাদা করা আপনার নিজস্ব এই ধরনের সার্চ করা শব্দের একটি তালিকা প্রদান করতে দেয়। এই ধরনের সার্চ অনুরোধ করলে সেগুলি দেখা যায়। তবে Google এখানে প্রদান করা শব্দ ব্যবহার করতে বা নাও করতে পারে। যেমন: 'terms' : 'cars rental, flight ticket' |
কনফিগারেশন সেটিংস
প্যারামিটার | বিবরণ ও উদাহরণ | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
ঐচ্ছিক সার্চ কোয়েরির সাথে ম্যাচ করে এমন বিজ্ঞাপনে যেসব ফিল্টার করা সংক্রান্ত নিয়ম Google-এর প্রয়োগ করা উচিত সেগুলিকে উল্লেখ করে। নিম্নলিখিতগুলি হল adsafe -এর জন্য সঠিক সেটিংস এবং দেখানো বিজ্ঞাপনের উপর থাকা প্রতিটি ভ্যালুর প্রভাব:
মনে রাখবেন: সাধারণত
adsafe 'high'-তে সেট করা থাকে।যেমন: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
ঐচ্ছিক বিজ্ঞাপনের জন্য অনুরোধ করা হল একটি পরীক্ষা এটি ইঙ্গিত করার জন্য adtest প্যারামিটার ব্যবহার করা হয়। adtest প্যারামিটারে 'on'-এর ভ্যালু থাকলে, Google অনুরোধটি পরীক্ষা হিসেবে বিবেচনা করে এবং বিজ্ঞাপনের ইম্প্রেশন গণনা করে না বা ক্লিক-থ্রু ফলাফল ট্র্যাক করে না।
মনে রাখবেন:
'off' হল adtest-এর ডিফল্ট ভ্যালু। যেমন: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
ঐচ্ছিক বিভিন্ন পৃষ্ঠার পারফর্ম্যান্স ট্র্যাক করার জন্য আপনি AdSense for search চ্যানেল যোগ করতে পারেন। আপনার AdSense অ্যাকাউন্টে যে অনন্য চ্যানেল আইডি তৈরি করেছেন সেটি ব্যবহার করুন। কাস্টম চ্যানেলের মাধ্যমে বিজ্ঞাপনের পারফর্ম্যান্স ট্র্যাক করা সম্বন্ধে আরও জানুন। '+' চিহ্নের মাধ্যমে একাধিক চ্যানেলগুলি আলাদা করা উচিত। যেমন: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
ঐচ্ছিক অনুরোধ করা বিজ্ঞাপনের যে ভাষাটি টার্গেট করা উচিত, এই প্যারামিটার সেই ভাষাটি শনাক্ত করে। 'en' হল ডিফল্ট ভ্যালু। সমস্ত Google Ads API ভাষা কোড Google-এ কাজ করে। মনে রাখবেন: তাদের বিজ্ঞাপন যেগুলি টার্গেট করে, বিজ্ঞাপনদাতারা সেইসব ভাষা উল্লেখ করে। আপনি যদি অনুরোধের মধ্যে এই প্যারামিটার অন্তর্ভুক্ত করেন তাহলে Google শুধুমাত্র সেই ভাষা বা সমস্ত ভাষার জন্য টার্গেট করা বিজ্ঞাপন দেখায়, কিন্তু বিজ্ঞাপনের টেক্সট উল্লেখ করা ভাষাতেই হবে এমন কোনও গ্যারেন্টি থাকে না।
সাধারণত, যে পৃষ্ঠা থেকে এই প্যারামিটার পাঠানো হয় সেই পৃষ্ঠার প্রাথমিক ভাষাতে আপনার যেমন: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
ঐচ্ছিক
ডিফল্ট
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
ঐচ্ছিক
'utf-8' হল ডিফল্ট
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
ঐচ্ছিক পছন্দমতো বিজ্ঞাপনের জন্য, Google-এর সাথে ব্যক্তিগত তথ্য শেয়ার করার ক্ষেত্রে ব্যবহারকারী প্রকাশককে সম্মতি দিয়েছেন কিনা তা উল্লেখ করে।
মনে রাখবেন:
personalizedAds সাধারণত 'true'-এ সেট করা থাকে।যেমন: 'personalizedAds': false |
ইউনিট লেভেল প্যারামিটারের বিবরণ
কোনও পৃষ্ঠায় ব্যবহারকারীর জন্য আলাদা আলাদা বিজ্ঞাপন ইউনিট দেখানোর পদ্ধতিকে এই প্যারামিটার প্রভাবিত করে। প্রতিটি বিজ্ঞাপন ইউনিটের জন্য, প্রতিটি প্যারামিটার আলাদাভাবে সেট করা যেতে পারে।
প্রয়োজনীয়
প্যারামিটার | বিবরণ ও উদাহরণ |
---|---|
container |
প্রয়োজনীয় খালি বিজ্ঞাপন কন্টেনারের আইডি <div id='afscontainer1'></div> যেখানে বিজ্ঞাপন দেখা যাবে।
যেমন:
|
maxTop |
প্রয়োজনীয়
উপরের বিজ্ঞাপন ইউনিটে যতগুলি বিজ্ঞাপন দেখানো হবে তার সংখ্যা উল্লেখ করার জন্য এই প্যারামিটার ব্যবহার করুন। মনে রাখবেন: এই প্যারামিটার
number প্যারামিটারের পরিবর্তে ব্যবহার করা হয়। এই বিজ্ঞাপন ইউনিট যথেষ্ট চওড়া হওয়া উচিত যাতে বিজ্ঞাপনের প্রথম লাইনটি র্যাপ না হয়ে যায়। পৃষ্ঠার অন্য কোনও প্লেসমেন্টে maxTop প্যারামিটার ব্যবহার করা হলে সেটি নীতি লঙ্ঘন হিসেবে বিবেচনা করা হবে।যেমন:
|
width |
প্রয়োজন বিজ্ঞাপন ইউনিট বা এই ধরনের সার্চ ইউনিটের প্রস্থ পিক্সেলে উল্লেখ করে। যেমন: 'width' : '700px' 'width' : 700 |
কনফিগারেশন সেটিংস
প্যারামিটার | বিবরণ ও উদাহরণ | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
ঐচ্ছিক বিজ্ঞাপন বা এই ধরনের সার্চ, লোড হওয়ার সময় বা কোনও বিজ্ঞাপন বা এই ধরনের সার্চ দেখানো না হলে একটি জাভাস্ক্রিপ্ট ফাংশন কল করার কথা উল্লেখ করে। প্যারামিটারটি এমন একটি জাভাস্ক্রিপ্ট কলব্যাক ফাংশনে সেট করতে হবে যেটি আপনি প্রয়োগ করেন, যা বিজ্ঞাপন সংক্রান্ত কল সম্পূর্ণ হলে অ্যাকশন পারফর্ম করতে দেয়। কলব্যাক ফাংশন নিম্নলিখিত প্যারামিটার অনুসরণ করে:
মনে রাখবেন: আপনার কলব্যাক ফাংশন যাতে কোনও সমস্যা তৈরি না করে তা নিশ্চিত করতে এটি পরীক্ষা করুন, বিশেষ করে সেইসব কলব্যাক যেগুলি আপনার পৃষ্ঠা লোড হওয়ার ক্ষেত্রে সমস্যা তৈরি করতে পারে।
জাভাস্ক্রিপ্ট কলব্যাকের উদাহরণ: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // খুব সম্ভবত কিছু করতে হবে না } catch (e) { alert ("Error in callback function"); // সমস্যা ভালভাবে সামলানোর জন্য কিছু করুন } } else { // Google থেকে কোনও বিজ্ঞাপন কভারেজ না থাকলে আপনি সবসময় যা করে থাকেন } } }; |
||||||||
number |
ঐচ্ছিক এই বিজ্ঞাপন ইউনিটে যতগুলি বিজ্ঞাপন দেখা যাওয়া উচিত তার সংখ্যা। '২' হল ডিফল্ট ভ্যালু। যেমন:
|
||||||||
relatedSearches |
ঐচ্ছিক এই ইউনিটে যতগুলি এই ধরনের সার্চ দেখা যাওয়া উচিত তার সংখ্যা। এই প্যারামিটার শূন্যতে সেট করা না থাকলে এতে সর্বনিম্ন তিনটি এই ধরনের সার্চ দেখানো হয়। নির্দিষ্ট করা না থাকলে ০ হল ডিফল্ট। যেমন: 'relatedSearches' : 4 |