تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تنفيذ الويب

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

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

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

نظرة عامة

تتألف عملية تنفيذ إعلانات البحث المخصص من AdSense على موقعك من 3 خطوات:

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

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

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

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

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

انسخ الرمز من أداة إنشاء الرموز والصقه في صفحتك، مع تذكُّر تحديث المعلمة 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>

"البحث ذو الصلة" على "بحث 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) من قِبل زاحف AdSense، لن نعرض عبارات "البحث ذي الصلة" المقترَحة التي تقدّمها إلى 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 clicked an ad to arrive here;
                                           // 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) لمجموعات الإعلانات
لا تنفِّذ التحميل الكسول بنفسك (بل تعتمد على التحميل الكسول من Google بدلاً من ذلك)
عدم تخزين موارد JavaScript من Google مؤقتًا على موقعك الإلكتروني
لا تستخدم المعلمة "query" للبحث ذي الصلة في صفحات المحتوى لأنها ستؤدي إلى نتائج غير متوقعة.

تنفيذ الويب

نظرة عامة

نموذج التعليمات البرمجية

تحميل غير متزامن للإعلان

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

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

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