پیاده سازی وب

توجه: صرف نظر از تعداد بلوک‌ها، فقط یک درخواست تبلیغ در هر صفحه ایجاد کنید.

مهم: قبل از استفاده از این کد، شرایط و ضوابط را مطالعه کنید.

برای استفاده از این کد، باید یک حساب AdSense با مجوز فعال برای استفاده از AdSense Custom Search Adsense داشته باشید.

نمای کلی

پیاده‌سازی تبلیغات جستجوی سفارشی ادسنس در سایت شما یک فرآیند ۳ مرحله‌ای است:

مرحله ۱: سبک جستجوی سفارشی خود را در AdSense ایجاد کنید

پس از ورود به سیستم، «تبلیغات برای جستجو» را باز کنید و سپس روی «سبک‌های جستجو» کلیک کنید. از اینجا می‌توانید یک سبک جدید ایجاد کنید یا یک سبک موجود را به‌روزرسانی کنید.

مرحله ۲: کد را پیکربندی کنید

دریافت کد کلیک کنید Embed محفظه‌های تبلیغاتی خود را طوری پیکربندی کنید که با محفظه‌های تبلیغاتی صفحه جستجوی شما مطابقت داشته باشند.

مرحله ۳: پیاده‌سازی کد

کد را از مولد کد کپی کرده و در صفحه خود قرار دهید، به یاد داشته باشید که پارامتر query را به‌روزرسانی کنید. کد تولید شده در تگ head باید در تگ head سایت شما قرار گیرد تا تبلیغات به درستی بارگذاری شوند. کد مربوط به واحد تبلیغاتی ۱ شامل تنظیمات مربوط به همه واحدهای تبلیغاتی در صفحه خواهد بود. واحدهای تبلیغاتی اضافی فقط نیاز به قرار دادن واحد تبلیغاتی مربوطه <div> در صفحه‌ای که تبلیغات باید در آن ظاهر شوند، دارند.

رایج‌ترین ویژگی‌ها در مولد کد ارائه شده‌اند، اما برخی پارامترهای اضافی در بخش مرجع موجود هستند. بخش مرجع شامل تمام گزینه‌های سطح صفحه است که برای همه واحدهای تبلیغاتی در صفحه اعمال می‌شود، و همچنین تمام گزینه‌های سطح واحد که برای واحدهای تبلیغاتی جداگانه اعمال می‌شود.

کد نمونه

بارگذاری ناهمزمان تبلیغات

کد تولید شده ناهمزمان است. یک مثال کامل از بارگذاری ناهمزمان تبلیغات در زیر نشان داده شده است. می‌توانید این مثال را در برگه جدید باز کنید . فراموش نکنید که شناسه کلاینت خود را وارد کنید.

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<div id="afscontainer1"></div>
<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId' : 'test client ID', // Enter your own client-ID here
  'query' : 'flowers', // User query for this page
  'styleId': '7824176615' // Enter your own style ID here
};

var adblock1 = {
  'container' : 'afscontainer1',
  'width' : 700
};

var adblock2 = {
  'container' : 'afscontainer2',
  'width' : 700
};

_googCsa('ads', pageOptions, adblock1, adblock2);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

جستجوی مرتبط در جستجو، یک واحد ارگانیک با عبارات جستجوی مرتبط با عبارت جستجوی فعلی است. لینک‌های این واحد به صفحه نتایج جستجوی جدید می‌روند. 

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<div id="afscontainer1"></div>
<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'relatedSearchTargeting': 'query', // Must use 'query' for Related Search on Search pages
  'query': 'flowers', // User query for this page
  'styleId': '1234567890', // Enter your own style ID here
  'resultsPageBaseUrl': '//www.example.com/search', // Enter your own base URL here
  'resultsPageQueryParam': 'query' // Enter your own query parameter here
};

var adblock = {
  'container': 'afscontainer1',
  'number': 3,
  'width': 700
};

var rsblock = {
  'container': 'afscontainer2',
  'relatedSearches': 6,
  'width': 500
};

_googCsa('ads', pageOptions, adblock, rsblock);
</script>

<p>Search result 1</p>
<p>Search result 2</p>
<p>Search result 3</p>

<div id="afscontainer2"></div>
</body>
</html>

جستجوی مرتبط در صفحات محتوا

جستجوی مرتبط در محتوا، عبارات جستجوی مرتبط با محتوای صفحه را برای کاربر فراهم می‌کند. این امر کاربران را قادر می‌سازد تا موضوعات مرتبط را بررسی کنند، با تبلیغات جستجو یا پیمایش سایت درگیر شوند. از پارامتر «پرس‌وجو» برای جستجوی مرتبط در صفحات محتوا استفاده نکنید زیرا باعث نتایج غیرمنتظره‌ای خواهد شد.

توجه: قبل از اینکه عبارات جستجوی مرتبط بتوانند در سایت شما ظاهر شوند، گوگل باید صفحات شما را بررسی کند تا از مرتبط بودن عبارات با متن اطمینان حاصل کند. وقتی صفحه‌ای هنوز بررسی نشده یا توسط خزنده Mediapartners-Google از بررسی آن جلوگیری شده است (مثلاً توسط robots.txt)، عبارات جستجوی مرتبط پیشنهادی که شما به گوگل ارائه می‌دهید را نشان نخواهیم داد.

محصول «جستجوی مرتبط در محتوا» برای فهرست‌بندی صفحات و تولید عبارات جستجوی مرتبط، به سیستم خزش محتوای گوگل متکی است. آدرس‌های اینترنتی صفحات محتوا که حاوی پارامترهای جستجو مانند متغیرهای ردیابی، شناسه‌های کاربر، شناسه‌های جلسه یا سایر شناسه‌های پویا هستند، می‌توانند در توانایی خزنده در ارزیابی محتوای اصلی صفحه اختلال ایجاد کنند و ممکن است منجر به عبارات جستجوی مرتبط نادرست یا نامربوط شوند. لطفاً از پارامتر «ignoredPageParams» برای شناسایی این پارامترهای غیرضروری استفاده کنید، از فهرست‌بندی صحیح محتوا اطمینان حاصل کنید و بار خزش غیرضروری را کاهش دهید. این به گوگل اجازه می‌دهد تا صفحه‌ای را که قبلاً خزش شده است، بهتر تشخیص دهد و عبارات پیشنهادی (هم گوگل و هم شرکای آن، در صورت واجد شرایط بودن) را نشان دهد.

<html>
<head>

<script async="async" src="https://www.google.com/adsense/search/ads.js"></script>

<script type="text/javascript" charset="utf-8">
  (function(g,o){g[o]=g[o]||function(){(g[o]['q']=g[o]['q']||[]).push(
  arguments)},g[o]['t']=1*new Date})(window,'_googCsa');
</script>

</head>

<body>

<p>Page content</p>

<div id="afscontainer1"></div>

<script type="text/javascript" charset="utf-8">

var pageOptions = {
  'pubId': 'test client ID', // Enter your own client-ID here
  'relatedSearchTargeting': 'content', // Must use 'content' for Related Search on Content pages
  'hl': 'en', // The preferred language for related terms (default to 'en' if not specified)
  'styleId': '1234567890', // Enter your style ID
  'resultsPageBaseUrl': '//www.example.com/search', // Enter the base URL of your results page
  'resultsPageQueryParam': 'query', // Specify the query parameter on your results page
  'terms': 'term a,term b', // Optionally provide your own related terms in a comma-delimited list
  'referrerAdCreative': 'example ad title' // Only used when a user comes from a source you control;
                                           // required when 'terms' is present.
};

var rsblock1 = {
  'container': 'afscontainer1',
  'relatedSearches': 6
};

_googCsa('relatedsearch', pageOptions, rsblock1);
</script>

<p>More page content</p>

</body>
</html>

چیزهایی که باید از آنها اجتناب کنید

ما به همه ناشران توصیه می‌کنیم که به دستورالعمل‌های ما برای پیاده‌سازی تبلیغات جستجوی سفارشی AdSense پایبند باشند و از روش‌های پیاده‌سازی خاصی که ممکن است در رندر تبلیغات اختلال ایجاد کنند و باعث نتایج غیرمنتظره یا عملکرد نامطلوب شوند، اجتناب کنند.

  • چندین فراخوانی تبلیغ از یک صفحه انجام ندهید، مگر اینکه بخواهید اسکرول بی‌نهایت را پیاده‌سازی کنید.
  • بلوک‌های تبلیغاتی را قبل یا بعد از نمایش تبلیغات پنهان نکنید
  • بلوک‌های تبلیغاتی را در صفحه جابجا نکنید
  • درخواست بلوک‌های تبلیغاتی بیشتر از آنچه می‌خواهید در صفحه نمایش داده شود، نکنید
  • DOM بلوک‌های تبلیغاتی را دستکاری نکنید
  • بارگذاری تنبل (lazy-loading) خودتان را پیاده‌سازی نکنید (به جای آن به بارگذاری تنبل گوگل تکیه کنید)
  • منابع JS گوگل را در سایت خود ذخیره نکنید
  • از پارامتر «query» برای جستجوی مرتبط در صفحات محتوا استفاده نکنید زیرا باعث نتایج غیرمنتظره‌ای خواهد شد.