تنفيذ الويب

ملاحظة: لا تقدّم سوى طلب عرض إعلان واحد لكل صفحة بغض النظر عن عدد الوحدات الإعلانية التي قد تكون معروضة.

ملاحظة مهمة: يُرجى قراءة الأحكام والشروط قبل استخدام هذا الرمز.

لاستخدام هذا الرمز، يجب أن يتوفر لديك حساب AdSense مع إذن نشط لاستخدام "إعلانات البحث المخصّصة من AdSense".

نظرة عامة

يتضمّن تنفيذ "إعلانات البحث المخصّص من AdSense" على موقعك الإلكتروني 3 خطوات:

الخطوة 1: إنشاء نمط بحث مخصّص في AdSense

بعد تسجيل الدخول، وسِّع الإعلانات على شبكة البحث، ثمّ انقر على أنماط الإعلانات على شبكة البحث. من هنا، يمكنك إنشاء نمط جديد أو تعديل نمط حالي.

الخطوة 2: ضبط الرمز

انقر على الحصول على الرمز تضمين. اضبط حاويات الإعلانات لتتطابق مع حاويات الإعلانات في صفحة البحث.

الخطوة 3: تنفيذ الرمز

انسخ الرمز من نظام إنشاء الرموز والصقه في صفحتك، مع الحرص على تعديل المَعلمة query. يجب وضع الرمز الذي تم إنشاؤه في علامة الرأس في علامة الرأس على موقعك الإلكتروني ليتم تحميل الإعلانات بشكلٍ صحيح. ستحتوي شفرة الوحدة الإعلانية الأولى على إعدادات جميع الوحدات الإعلانية في الصفحة. لن تتطلّب الوحدات الإعلانية الإضافية سوى وضع <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>

"البحث ذو الصلة" على "بحث Google" هو وحدة مجانية تتضمّن عبارات بحث ذات صلة بعبارة البحث الحالية. تؤدي الروابط في هذه الوحدة إلى صفحة جديدة لنتائج البحث. 

<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>

"البحث ذو الصلة" في صفحات المحتوى

توفّر ميزة "البحث ذو الصلة" عن المحتوى عبارات بحث للمستخدم ذات صلة بمحتوى الصفحة. يتيح ذلك للمستخدمين استكشاف المواضيع ذات الصلة والتفاعل مع الإعلانات على شبكة البحث أو التنقّل في الموقع الإلكتروني. لا تستخدِم المَعلمة "query" في "عبارات البحث ذو الصلة على صفحات المحتوى" لأنّ ذلك سيؤدي إلى ظهور نتائج غير متوقّعة.

ملاحظة: قبل أن تظهر عبارات البحث ذو الصلة على موقعك الإلكتروني، يجب أن يزحف محرّك بحث Google إلى صفحاتك لضمان أن تكون العبارات ذات صلة بالسياق. عندما لا يكون قد تم الزحف إلى صفحة أو عندما يتم حظر الزحف إليها (مثلاً، باستخدام ملف robots.txt) من خلال زاحف Mediapartners-Google، لن نعرض عبارات &quot;البحث ذو الصلة&quot; المقترَحة التي تقدّمها إلى Google.

يعتمد منتج "البحث ذو الصلة" على نظام الزحف إلى المحتوى من Google لفهرسة الصفحات وإنشاء عبارات بحث ذات صلة. يمكن أن تؤثر عناوين URL لصفحات المحتوى التي تحتوي على مَعلمات طلب بحث، مثل متغيّرات التتبّع أو أرقام تعريف المستخدمين أو أرقام تعريف الجلسات أو غيرها من المعرّفات الديناميكية، في قدرة الزاحف على تقييم المحتوى الأساسي للصفحة، وقد تؤدي إلى ظهور عبارات بحث ذات صلة غير دقيقة أو غير ملائمة. يُرجى استخدام المَعلمة "ignoredPageParams" لتحديد هذه المَعلمات غير الأساسية، ما يضمن فهرسة المحتوى بشكل سليم ويقلّل من عبء الزحف غير الضروري. يتيح ذلك لمحرك بحث Google التعرّف بشكل أفضل على الصفحات التي سبق أن تم الزحف إليها والبدء في عرض عبارات مقترَحة (من Google ومن الشريك، إذا كان مؤهلاً). 

<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>

إجراءات يجب تجنبها

ننصح جميع الناشرين بالالتزام بإرشاداتنا المتعلّقة بتنفيذ &quot;إعلانات البحث المخصّص&quot; من AdSense، وتجنُّب طرق تنفيذ معيّنة قد تتداخل مع عرض الإعلانات وتتسبّب في نتائج غير متوقّعة أو أداء دون المستوى المطلوب.

  • لا تُجرِ طلبات إعلانات متعدّدة من صفحة ما إلا عند تنفيذ التمرير اللانهائي.
  • لا تخفِ وحدات الإعلانات قبل عرض الإعلانات أو بعده
  • عدم نقل مربّعات الإعلانات في الصفحة
  • عدم طلب عدد من حظر الإعلانات أكبر من العدد المطلوب عرضه على الصفحة
  • عدم التلاعب بنظام DOM الخاص بكتل الإعلانات
  • عدم تنفيذ ميزة "التحميل الكسول" الخاصة بك (الاعتماد على ميزة "التحميل الكسول" من Google بدلاً من ذلك)
  • عدم تخزين موارد JavaScript من Google مؤقتًا على موقعك الإلكتروني
  • لا تستخدِم المَعلمة "query" لـ "عبارات البحث ذو الصلة على صفحات المحتوى" لأنّ ذلك سيؤدي إلى نتائج غير متوقّعة.