المرجع

تُحدِّد المَعلمة adPage صفحة النتائج التي يتمّ عرض الإعلانات عليها. يتم استخدام هذه المعلمة عند انتقال المستخدمين إلى ما بعد الصفحة الأولى من نتائج البحث. على سبيل المثال، إذا تم طلب عرض خمسة إعلانات، وتم ضبط المَعلمة adPage على 2، ستُعرَض الإعلانات في الصفحة الثانية وستُضم خمسة إعلانات.

مثال:

'pubId' : 'test-property'

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

أمثلة:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

مثال:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' استخدِم هذا الخيار لعبارات "البحث ذو الصلة" في صفحات المحتوى (مثل المقالات ومنشورات المدونة).
• 'query' استخدِم هذا الخيار حصريًا لميزة "البحث ذو الصلة" على صفحات نتائج البحث.

ملاحظة:يتم تلقائيًا ضبط مَعلمة الصفحة relatedSearchTargeting على القيمة "query" بشكلٍ تلقائي. ومع ذلك، من المهم ملاحظة أنّ هذه القيمة التلقائية مصمّمة فقط لصفحات نتائج البحث (عبارات البحث ذو الصلة على "بحث Google"). إذا كنت تستخدم ميزة "البحث ذو الصلة" على أي نوع آخر من الصفحات (مثل المقالات أو مشاركات المدونات)، عليك ضبط المَعلمة على القيمة "content" بشكل صريح.

ملاحظة: تنطبق الإرشادات التالية على استخدام هذه المعلّمة:

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

أمثلة:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

مثال:

'styleId': '1234567890'

• '_top' يتم فتحه في النافذة نفسها.
• '_blank' يتم فتحها في نافذة جديدة.

مثال:

'linkTarget' : '_blank'

تنطبق الإرشادات التالية على استخدام هذه المَعلمة:

• يجب تقديم المَعلمة فقط في طلب البحث ذي الصلة للمحتوى، وسيتمّ تجاهلها في جميع الطلبات الأخرى.
• يجب عدم استخدامها إلا على الزيارات التي تحصل عليها عن قصد من مواقع إلكترونية أخرى، ولا يجوز استخدامها مطلقًا في الزيارات الواردة من نتائج البحث المجانية.
• يجب أن تتضمّن سطر العنوان والوصف و/أو أي عبارات أخرى في الإعلان أو تصميم الرابط.
• يُعدّ حذف قيم من تصميم الإعلان أو الرابط (أو تضمين قيم إضافية) مخالفة لهذه التعليمات المكتوبة.
• تكون حساسة لحالة الأحرف.
• تقبل ترميز UTF-8 الصالح، ويُسمَح باستخدام أحرف يونيكود / رموز التشكيل.
• قد تستخدِم Google أو تتجاهل المعلّمة التي تُرسِلها أنت. وعند استخدامها، قد تؤثر في اختيار العبارات وترتيبها.

ملاحظة: هذه المَعلمة مطلوبة عند استخدام المَعلمة terms.

أمثلة:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

مثال:

'resultsPageQueryParam' : 'query'

ملاحظة: عند استخدام هذه المَعلمة، يجب أيضًا توفير قيمة referrerAdCreative إلزاميًا، كما يجب توفير قيمة relatedSearchTargeting إلزاميًا وضبطها على "content".

أمثلة:

'terms' : 'cars rental, flight ticket'

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

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

تنطبق الإرشادات التالية على استخدام هذه المَعلمة:

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

أمثلة:
يزور مستخدم صفحة محتوى حيث يكون عنوان URL كما يلي:

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

• 'high' تعرِض إعلانات مناسبة لجميع أفراد العائلة. ولا تعرِض إعلانات غير مناسبة للأطفال أو إعلانات تضمّ محتوى جنسي موجّه للبالغين.
• 'medium' تعرِض إعلانات مناسبة لجميع أفراد العائلة بالإضافة إلى إعلانات غير مناسبة للأطفال. ولا تعرِض إعلانات تضمّ محتوى جنسيًا موجّهًا للبالغين.
• 'low' تعرِض جميع أنواع الإعلانات.

يتم ضبط adsafe تلقائيًا على "مرتفع".

مثال:

'adsafe': 'medium'

عندما تكون قيمة المَعلمة adtest هي on، لن تتمكّن من تحقيق أيّ إيرادات.

ستعرِض طلبات الإعلانات، التي تكون فيها قيمة المَعلمة adtest هي on ويكون مصدرها نطاقًا لم تتمّ الموافقة عليه في علامة التبويب "المواقع الإلكترونية"، إعلانات تحتوي على تراكب "إعلان اختباري"، وتكون هذه الإعلانات غير قابلة للنقر.

يُمكنك استخدام هذه المَعلمة عند إجراء اختبار، لكن لا يُنصح باستخدامها في أنظمة الإنتاج، وإلّا فلن يتمّ الدفع لك مقابل الإعلانات التي تعرضها.

القيمة الافتراضية للمعلمة "adtest" هي "off".

مثال:

'adtest' : 'on'

أمثلة:

'channel' :  'testA'  

'channel' :  'testA+testB'  

تتيح Google كل رموز لغات AdWords API.

ملاحظة: يحدد المعلنون اللغات التي تستهدفها إعلاناتهم. إذا كنت تضمّن هذه المعلمة في طلبك، فإن Google تعرض فقط الإعلانات التي تستهدف هذه اللغة أو التي تستهدف جميع اللغات ولكنها لا تضمن أن نص الإعلان سيكون باللغة المحددة.

تحديدًا، يجب تعيين المعلمة "hl" لتكون اللغة الأساسية للصفحة التي تم إرسال هذه المعلمة منها.

أمثلة:

'hl' : 'es'

تحدّد المَعلمة ie مخطّط ترميز الأحرف الذي يجب استخدامه لتفسير سلسلة طلب البحث.

القيمة التلقائية ie هي utf-8.

تُحدِّد المَعلمة oe مخطّط ترميز الأحرف الذي يجب أن تستخدمه Google لترميز نصوص الإعلانات. يُفضَّل نقل قيمة لهذه المَعلمة، على الرغم من أنّ ذلك أمر اختياري من الناحية الفنية.

القيمة التلقائية oe هي utf-8.

• true عندما لا تكون هذه المَعلمة متوفّرة أو عندما تضبطها على "true"، سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط ونستخدم مساحة التخزين المحلية في الزيارات التي تمّت الموافقة عليها فقط.
• false عند ضبط هذه المَعلمة على "false"، سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط، وسنستخدم مساحة التخزين المحلية في كل الزيارات سواء مُنحت الموافقة أو لم تُمنح.

يتم ضبط IVT تلقائيًا على "صحيح".

مثال:

'ivt': false

مثال:

'container' : 'afscontainer1'

تُستخدَم هذه المَعلمة لتحديد عدد الإعلانات المُراد عرضها في الوحدة الإعلانية أعلى الصفحة.

ملاحظة: تُستخدَم هذه المَعلمة بدلاً من المَعلمة "number". ويجب أن تكون هذه الوحدة الإعلانية عريضة بما يكفي بحيث لا يمتد السطر الأول من الإعلانات إلى سطر جديد. لاحظ أنّ استخدام المعلّمة maxTop في أي موضع آخر على الصفحة يُعدّ انتهاكًا للسياسة.

مثال:

'maxTop' : 4

مثال:

'width' : '700px'

'width' : 700

تتطلّب دالة ردّ الاتصال المعلّمات التالية:

ملاحظة: يُرجى اختبار دالّة ردّ الاتّصال للتأكُّد من أنّها لا تؤدّي إلى حدوث أيّ أخطاء، خاصةً تلك التي قد تؤثر في تحميل صفحتك.

مثال على رد اتصال JavaScript:

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' : 4

مثال:

'relatedSearches' : 4