پارامترها
توضیحات پارامتر سطح صفحه
این پارامترها فقط باید یک بار در هر صفحه مشخص شوند. آنها همه واحدهای صفحه را تحت تأثیر قرار می دهند.
مورد نیاز
پارامتر | توضیحات و مثالها |
---|---|
adPage | هنگامی که کاربر به صفحه نتایج بعدی یا صفحه نتایج قبلی هدایت می شود، ضروری است. پارامتر |
pubId | مورد نیاز این شناسه مشتری AdSense شما است. pubId شما بخشی از شناسه مشتری شما است که بعد از "partner-" آمده است. به عنوان مثال، اگر شناسه مشتری شما 'partner-test-property' باشد، pubId شما 'test-property' است. این پروتکل استاندارد برای CSA است. مثال: 'pubId' : 'test-property' |
query | الزامی است، به جز در جستجوی مرتبط در صفحات محتوا. این عبارت جستجویی است که کاربر وارد کرده است. مقدار پارامتر پرس و جو باید رمزگذاری نشده باشد. توجه: استفاده از این پارامتر در جستجوی مرتبط در صفحات محتوا باعث نتایج غیرمنتظره می شود. مثال ها: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl | زمانی که واحدهای جستجوی مرتبط در صفحه وجود دارد، الزامی است. نشانی اینترنتی صفحه نتایج جستجو را مشخص می کند که عبارت جستجو عبارت جستجوی مرتبطی است که کاربر روی آن کلیک کرده است. resultsPageBaseUrl ممکن است شامل پارامترهای خود باشد، به جز عبارت جستجو که به طور خودکار اضافه می شود. مثال: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting | زمانی که واحدهای جستجوی مرتبط در صفحه وجود دارد، الزامی است. این پارامتر در صورت درخواست واحدهای جستجوی مرتبط الزامی است. بسته به بافت صفحه، نوع تجربه جستجوی مرتبط را کنترل میکند:
توجه: پارامتر صفحه relatedSearchTargeting به طور خودکار به صورت پيشفرض روي 'query' تنظيم ميشود. با این حال، مهم است که توجه داشته باشید که این مقدار پیش فرض به طور خاص فقط برای صفحات نتایج جستجو طراحی شده است (جستجوی مرتبط در جستجو). اگر از جستجوی مرتبط در هر نوع صفحه دیگری (مثلاً مقالهها، پستهای وبلاگ) استفاده میکنید، باید صراحتاً پارامتر را روی «محتوا» تنظیم کنید. توجه: دستورالعمل های زیر برای استفاده از این پارامتر اعمال می شود:
مثال ها: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId | مورد نیاز شناسه سبک جستجوی سفارشی را برای اعمال به آگهی یا واحدهای جستجوی مرتبط در صفحه مشخص میکند. درباره استفاده از سبک های جستجوی سفارشی بیشتر بیاموزید . توجه داشته باشید که با تنظیم styleId برای یک درخواست، تبلیغات یا جستجوهای مرتبط با سبک ارائه میشوند و پارامترهای سبک قدیمی نادیده گرفته میشوند. اگر styleId در درخواست مشخص نشده باشد، یک سبک پیش فرض سیستم ارائه می شود. مثال: 'styleId': '1234567890' |
اختیاری
پارامتر | توضیحات و مثالها |
---|---|
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' |
ignoredPageParams | اختیاری فهرستی از پارامترهای URL را برای یک صفحه محتوا با واحد جستجوی مرتبط برای محتوا مشخص میکند که میتوان با خیال راحت بدون تأثیر بر محتوای اصلی یا تجربه کاربر، نادیده گرفت. توجه: قبل از اینکه عبارات جستجوی مرتبط در سایت شما ظاهر شوند، گوگل باید صفحات شما را بخزد تا اطمینان حاصل شود که عبارات با زمینه مرتبط هستند. هنگامی که صفحه ای هنوز خزیده نشده است یا خزیدن آن (مثلاً توسط robots.txt) توسط خزنده AdSense مسدود شده است، ما عبارات جستجوی مرتبط پیشنهادی را که به Google ارائه می کنید نشان نمی دهیم. محصول جستجوی مرتبط در محتوا برای فهرستبندی صفحات و تولید عبارتهای جستجوی مرتبط به سیستم خزیدن محتوای Google متکی است. نشانیهای اینترنتی صفحه محتوا حاوی پارامترهای پرس و جو مانند متغیرهای ردیابی، شناسههای کاربر، شناسههای جلسه یا سایر شناسههای پویا میتوانند با توانایی خزنده برای ارزیابی محتوای اصلی صفحه تداخل داشته باشند و ممکن است منجر به عبارات جستجوی مرتبط نادرست یا نامربوط شوند. این پارامتر صفحه به خزنده گوگل دستور می دهد که این پارامترهای غیر ضروری را نادیده بگیرد و از فهرست بندی مناسب محتوا اطمینان حاصل کند و بار خزیدن غیرضروری را کاهش دهد. این به Google امکان میدهد بهتر یک صفحه را که قبلاً خزیده شده است تشخیص دهد و شروع به نمایش شرایط پیشنهادی کند (هم Google و هم شریک، در صورت واجد شرایط بودن). دستورالعمل های زیر برای استفاده از این پارامتر اعمال می شود:
مثال ها: http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' http://example.com/content?page_id=123 |
تنظیمات پیکربندی
پارامتر | توضیحات و مثالها | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe | اختیاری قوانین فیلتری را مشخص می کند که Google باید برای تبلیغات مطابق با عبارت جستجو اعمال کند. در زیر تنظیمات معتبر برای adsafe و تأثیری که هر مقدار بر تبلیغات برگشتی دارد آمده است:
به طور پیش فرض adsafe روی بالا تنظیم شده است. مثال: 'adsafe': 'medium' | |||||||||||||||||||||||||||||||||||||||||||||||||||
adtest | اختیاری پارامتر adtest برای نشان دادن اینکه درخواست تبلیغات آزمایشی است استفاده می شود. زمانی که پارامتر adtest مقدار روی داشته باشد، Google درخواست را به عنوان یک آزمایش تلقی می کند و نمایش تبلیغات را شمارش نمی کند یا نتایج کلیک را دنبال نمی کند. وقتی پارامتر adtest مقدار on داشته باشد، هیچ درآمدی ایجاد نمی کنید. درخواستهای تبلیغاتی با پارامتر adtest تنظیم شده از دامنهای که در برگه سایتها تأیید نشده است، آگهیهایی را برمیگرداند که دارای پوشش «تبلیغ آزمایشی» هستند و غیرقابل کلیک هستند. هنگام تست از این پارامتر استفاده کنید، اما از آن در سیستم های تولید استفاده نکنید وگرنه برای تبلیغاتی که نمایش می دهید پولی دریافت نمی کنید. مقدار adtest پیش فرض خاموش است. مثال: 'adtest' : 'on' | |||||||||||||||||||||||||||||||||||||||||||||||||||
channel | اختیاری می توانید یک کانال AdSense for Search برای ردیابی عملکرد صفحات مختلف قرار دهید. از شناسه کانال منحصر به فرد ایجاد شده در حساب AdSense یا مدیر حساب فنی خود استفاده کنید. در اینجا درباره کانال ها بیشتر بدانید. چندین کانال باید با علامت "+" از هم جدا شوند. مثال ها: 'channel' : 'testA' 'channel' : 'testA+testB' | |||||||||||||||||||||||||||||||||||||||||||||||||||
hl | اختیاری این پارامتر زبانی را که تبلیغات درخواستی یا جستجوهای مرتبط باید هدف قرار دهند، مشخص می کند. مقدار پیش فرض en است. Google از همه کدهای زبان AdWords API پشتیبانی می کند. توجه: تبلیغکنندگان زبانهایی را که تبلیغاتشان هدف قرار میدهد را مشخص میکنند. اگر این پارامتر را در درخواست خود لحاظ کنید، Google فقط تبلیغاتی را برمیگرداند که برای آن زبان یا برای همه زبانها هدفگذاری شدهاند، اما تضمین نمیکند که متن آگهی به زبان مشخصشده باشد. به طور معمول، شما باید پارامتر hl را به زبان اصلی صفحه ای که این پارامتر از آن ارسال می شود، تنظیم کنید. مثال ها: 'hl' : 'es' | |||||||||||||||||||||||||||||||||||||||||||||||||||
ie | اختیاری پارامتر مقدار پیش فرض
| |||||||||||||||||||||||||||||||||||||||||||||||||||
oe | اختیاری پارامتر مقدار پیش فرض
| |||||||||||||||||||||||||||||||||||||||||||||||||||
ivt | اختیاری این پارامتر به شما امکان میدهد یک بولی ارائه دهید که به Google اطلاع میدهد که میخواهید به تبلیغاتی که از کوکی فقط ترافیک نامعتبر و فضای ذخیرهسازی محلی استفاده میکنند، هم در ترافیک مورد رضایت و هم بدون رضایت اجازه دهید.
به طور پیش فرض IVT روی true تنظیم شده است. مثال: 'ivt': false |
توضیحات پارامتر سطح واحد
این پارامترها بر نحوه ارائه واحدهای تبلیغاتی منفرد در یک صفحه به کاربر تأثیر میگذارند. هر پارامتر میتواند بهصورت جداگانه برای هر واحد آگهی تنظیم شود.
مورد نیاز
پارامتر | توضیحات و مثال ها |
---|---|
container | مورد نیاز شناسه محفظه خالی آگهی <div> جایی که آگهی باید نمایش داده شود.مثال: 'container' : 'afscontainer1' |
maxTop | زمانی که واحد تبلیغات بالاتر از نتایج جستجو باشد، الزامی است. از این پارامتر برای تعیین تعداد تبلیغاتی که باید در واحد تبلیغات بالا نمایش داده شوند استفاده کنید. توجه: این پارامتر به جای پارامتر "تعداد" استفاده می شود. این واحد تبلیغاتی باید به اندازه کافی گسترده باشد تا خط اول تبلیغات بسته نشود. استفاده از پارامتر maxTop در هر مکان دیگری در صفحه یک نقض خط مشی است. مثال: 'maxTop' : 4 |
width | مورد نیاز عرض آگهی یا واحد جستجوی مرتبط را بر حسب پیکسل مشخص می کند. مثال: 'width' : '700px' 'width' : 700 |
تنظیمات پیکربندی
پارامتر | توضیحات و مثالها | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback | اختیاری یک تابع جاوا اسکریپت را مشخص می کند تا زمانی که تبلیغات یا جستجوهای مرتبط بارگیری می شوند یا زمانی که هیچ آگهی یا جستجوی مرتبطی ارائه نمی شود، فراخوانی شود. این پارامتر باید روی یک تابع فراخوانی جاوا اسکریپت تنظیم شود که پیادهسازی میکنید و اجازه میدهد تا زمانی که فراخوانی آگهی کامل شد، یک عمل انجام شود. تابع callback پارامترهای زیر را می گیرد:
توجه: لطفاً عملکرد پاسخ به تماس خود را آزمایش کنید تا مطمئن شوید که هیچ خطایی ایجاد نمی کند، به خصوص خطاهایی که ممکن است در بارگذاری صفحه شما اختلال ایجاد کنند. نمونه ای از پاسخ به تماس جاوا اسکریپت: var adblock1 = { 'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; | ||||||||
number | اختیاری تعداد تبلیغاتی که باید در این واحد نمایش داده شود. مقدار پیش فرض 2 است. مثال: 'number' : 4 | ||||||||
relatedSearches | اختیاری تعداد جستجوهای مرتبطی که باید در این واحد ظاهر شود. اگر مشخص نشده باشد به صورت پیش فرض 0 می شود. مثال: 'relatedSearches' : 4 |