المرجع

المعلمات

أوصاف معلمات مستوى الصفحة

تتطلّب هذه المَعلمات التحديد مرّة واحدة فقط لكل صفحة. وتوثّر على جميع الوحدات في الصفحة.

مطلوب

المَعلمة الوصف والأمثلة
adPage مطلوبة عند انتقال المستخدم إلى صفحة النتائج التالية أو صفحة النتائج السابقة.

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

pubId مطلوبة
تمثّل هذه المعلّمة معرِّف العميل المتعلق بك في AdSense. وpubId هي جزء من معرِّف العميل الذي يأتي بعد "-partner". على سبيل المثال، إذا كان معرِّف العميل المتعلق بك هو "partner-test-property"، يعني ذلك أنّ قيمة pubId هي "test-property". هذا هو البروتوكول العادي المُتّبَع في "إعلانات البحث المخصّص".

مثال: 

'pubId' : 'test-property'
query مطلوب، باستثناء "عبارات البحث ذو الصلة" في صفحات المحتوى
تمثّل هذه المعلّمة طلب البحث الذي أدخله المستخدم. ويجب أن تكون قيمة مَعلمة طلب البحث غير مرمّزة.

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

أمثلة: 

'query' : 'flowers'
 
'query' : 'black & decker'
 
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl مطلوبة عند توفُّر وحدات "بحث ذو صلة" في الصفحة.
تحدِّد هذه المعلّمة عنوان URL لصفحة نتائج البحث التي كان فيها طلب البحث في شكل عبارة البحث ذي الصلة التي نقر المستخدم عليها. وقد تتضمّن resultsPageBaseUrl معلّماتها الخاصة، باستثناء طلب البحث الذي سيتم إلحاقه تلقائيًا.

مثال: 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting مطلوبة عند توفُّر وحدات "بحث ذو صلة" في الصفحة.
هذه المَعلمة إلزامية عند طلب وحدات "بحث ذو صلة". تتحكّم هذه السمة في نوع تجربة "البحث ذو الصلة" التي يتم عرضها، وذلك استنادًا إلى سياق الصفحة:
  • 'content' استخدِم هذا الخيار لعبارات "البحث ذو الصلة" في صفحات المحتوى (مثل المقالات ومنشورات المدونة).
  • 'query' استخدِم هذا الخيار حصريًا لميزة "البحث ذو الصلة" على صفحات نتائج البحث.

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

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

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

أمثلة:

'relatedSearchTargeting' : 'content'
 
'relatedSearchTargeting' : 'query'
styleId مطلوبة
تحدِّد هذه المَعلمة رقم تعريف نمط البحث المخصّص الذي سيتم تطبيقه على الإعلان أو وحدات الإعلانات لعبارات البحث ذي الصلة على الصفحة. مزيد من المعلومات عن استخدام أنماط البحث المخصّص تجدر الإشارة إلى أنّه عند إعداد styleId لطلب ما، سيتم عرض الإعلانات أو عمليات البحث ذات الصلة باستخدام النمط، وسيتم تجاهل معلّمات النمط القديمة. وإذا لم يتم تحديد styleId في الطلب، سيتم عرض نمط الإعداد التلقائي للنظام.

مثال: 

'styleId': '1234567890'

اختياري

المَعلمة الوصف والأمثلة
linkTarget اختيارية
تحدِّد هذه المعلّمة ما إذا كان النقر على إعلان سيؤدي إلى فتحه في النافذة نفسها أو نافذة جديدة. القيمة التلقائية هي "top_". ويمكن أيضًا استخدام هذه المعلّمة على مستوى الوحدة.
  • '_top' يتم فتحه في النافذة نفسها.
  • '_blank' يتم فتحها في نافذة جديدة.

مثال: 

'linkTarget' : '_blank'
referrerAdCreative اختيارية
إذا وصل مستخدم إلى صفحة المحتوى التي تتضمّن وحدة "بحث ذو صلة" للمحتوى من خلال النقر على إعلان أو رابط على موقع إلكتروني آخر، وكنت متحكّمًا في هذا الإعلان أو الرابط، يجب ضبط هذه المَعلمة لتطابق تمامًا نصّ تصميم ذلك الإعلان أو الرابط.

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

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

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

أمثلة: 

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

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam اختيارية
تحدِّد هذه المعلّمة اسم معلّمة عنوان URL لطلب البحث في صفحة نتائج البحث. ويتم إعداد القيمة على "q" تلقائيًا في حال عدم تحديدها.

مثال: 

'resultsPageQueryParam' : 'query'
terms اختيارية
تسمح لك هذه المَعلمة بتقديم قائمة بعبارات البحث ذات الصلة مفصولة بفواصل والتي يتم عرضها مع طلب بحث ذي صلة، على الرغم من أنّ Google قد تستخدِم أو لا تستخدِم العبارات المقدّمة هنا.

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

أمثلة: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams اختيارية
تحدّد هذه السمة قائمة بمَعلمات عناوين URL لصفحة محتوى تتضمّن وحدة "بحث ذو صلة" للمحتوى، ويمكن تجاهلها بأمان بدون التأثير في المحتوى الأساسي أو تجربة المستخدم.

ملاحظة: قبل أن تظهر عبارات البحث ذي الصلة على موقعك الإلكتروني، يجب أن يزحف محرّك بحث 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
 توفير مَعلمات عناوين URL التالية التي يمكن تجاهلها: 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
 سيتم التعامل مع عنوان URL لصفحة المحتوى على النحو التالي: 
http://example.com/content?page_id=123

إعدادات الضبط

المَعلمة الوصف والأمثلة
adsafe اختيارية
تحدِّد هذه المَعلمة قواعد الفلترة التي ستطبّقها Google على الإعلانات التي تتطابق مع طلب البحث. في ما يلي الإعدادات الصالحة للمعلّمة adsafe وتأثير كل قيمة على الإعلانات المعروضة:
  • 'high' تعرِض إعلانات مناسبة لجميع أفراد العائلة. ولا تعرِض إعلانات غير مناسبة للأطفال أو إعلانات تضمّ محتوى جنسي موجّه للبالغين.
  • 'medium' تعرِض إعلانات مناسبة لجميع أفراد العائلة بالإضافة إلى إعلانات غير مناسبة للأطفال. ولا تعرِض إعلانات تضمّ محتوى جنسيًا موجّهًا للبالغين.
  • 'low' تعرِض جميع أنواع الإعلانات.

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

مثال: 

'adsafe': 'medium'
adtest اختيارية
تُستخدَم المَعلمة adtest للإشارة إلى أنّ طلب الإعلانات هو مجرّد اختبار. عندما تكون قيمة المَعلمة adtest هي on، تتعامل Google مع الطلب على أنّه اختبار ولا يتمّ احتساب عدد مرّات ظهور الإعلان أو تتبُّع نتائج النقر.

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

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

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

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

مثال: 

'adtest' : 'on'
channel اختيارية
يمكنك تضمين قناة "AdSense للبحث" لتتبُّع أداء الصفحات المختلفة. استخدِم معرّف القناة الفريد الذي أنشأته في حسابك على AdSense أو الذي أنشأه مدير الحساب الفني. يمكنك الاطّلاع على مزيد من المعلومات حول القنوات هنا.

يجب الفصل بين القنوات المتعدّدة باستخدام الرمز '+'.

أمثلة: 

'channel' :  'testA'  
'channel' :  'testA+testB'
hl اختيارية
تحدِّد هذه المَعلمة اللغة التي يجب أن تستهدِفها الإعلانات أو عمليات البحث ذات الصلة المطلوبة. القيمة التلقائية هي en.

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

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

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

أمثلة: 

'hl' : 'es'
ie اختياري

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

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

القيمة الاسم القياسي اللغات المعتمدة المقترنة
latin1 ISO-8859-1 لغات غرب أوروبا (الكتالانية و‏‫الدانمركية و‏‫الهولندية والإنجليزية و‏‫الفنلندية، والفرنسية والألمانية والإندونيسية والإيطالية والنرويجية والبرتغالية والإسبانية والسويدية)
latin2 ISO-8859-2 لغات شرق أوروبا (الكرواتية والتشيكية والمجرية والبولندية والرومانية والصربية والسلوفاكية والسلوفينية)
latin3 ISO-8859-3  
latin4 ISO-8859-4 البلطيقية (الإستونية واللاتفية والليتوانية)
السيريلية ISO-8859-5 البلغارية والروسية
العربية ISO-8859-6  
اليونانية ISO-8859-7 اليونانية
العبرية ISO-8859-8 العبرية
latin5 ISO-8859-9  
latin6 ISO-8859-10 الأيسلندية
euc-jp EUC-JP اليابانية
euc-kr EUC-KR الكورية
sjis Shift_JIS اليابانية
big5 Big5 الصينية التقليدية
gb GB2312 الصينية المبسطة
utf-8 UTF-8 الكل
oe اختياري

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

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

القيمة الاسم القياسي اللغات المعتمدة المقترنة
latin1 ISO-8859-1 لغات غرب أوروبا (الكتالانية و‏‫الدانمركية و‏‫الهولندية والإنجليزية و‏‫الفنلندية، والفرنسية والألمانية والإندونيسية والإيطالية والنرويجية والبرتغالية والإسبانية والسويدية)
latin2 ISO-8859-2 لغات شرق أوروبا (الكرواتية والتشيكية والمجرية والبولندية والرومانية والصربية والسلوفاكية والسلوفينية)
latin3 ISO-8859-3  
latin4 ISO-8859-4 البلطيقية (الإستونية واللاتفية والليتوانية)
السيريلية ISO-8859-5 البلغارية والروسية
العربية ISO-8859-6  
اليونانية ISO-8859-7 اليونانية
العبرية ISO-8859-8 العبرية
latin5 ISO-8859-9  
latin6 ISO-8859-10 الأيسلندية
euc-jp EUC-JP اليابانية
euc-kr EUC-KR الكورية
sjis Shift_JIS اليابانية
gb GB2312 الصينية المبسطة
utf-8 UTF-8 الكل
ivt اختيارية
تتيح لك هذه المَعلمة تقديم قيمة منطقية تُعلم Google بأنّك تريد السماح بالإعلانات التي تستخدم ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط ومساحة التخزين المحلية، وذلك في كل الزيارات سواء مُنحَت الموافقة أو لم تُمنَح.
  • true عندما لا تكون هذه المَعلمة متوفّرة أو عندما تضبطها على "true"، سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط ونستخدم مساحة التخزين المحلية في الزيارات التي تمّت الموافقة عليها فقط.
  • false عند ضبط هذه المَعلمة على "false"، سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط، وسنستخدم مساحة التخزين المحلية في كل الزيارات سواء مُنحت الموافقة أو لم تُمنح.

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

مثال: 

'ivt': false

أوصاف معلمات مستوى الوحدة

تؤثر هذه المعلمات على طريقة عرض وحدات إعلانات فردية في إحدى الصفحات للمستخدم، ويمكن تعيين كل معلمة على حدة لكل وحدة إعلان.

مطلوب

المَعلمة الوصف والأمثلة
container مطلوبة
رقم تعريف حاوية الإعلان الفارغة <div> التي يجب أن يظهر فيها الإعلان.

مثال: 

'container' : 'afscontainer1'
maxTop مطلوبة عندما تكون الوحدة الإعلانية أعلى نتائج البحث.

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

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

مثال:

'maxTop' : 4
width مطلوبة
تحدِّد هذه المَعلمة عرض الإعلان أو وحدة الإعلانات لعبارات البحث ذي الصلة بالبكسل.

مثال: 

'width' : '700px'
 
'width' : 700

إعدادات الضبط

المَعلمة الوصف والأمثلة
adLoadedCallback اختيارية
تحدِّد هذه المعلّمة دالة JavaScript التي سيتم طلبها عند تحميل الإعلانات أو عمليات البحث ذات الصلة، أو في حال عدم عرض إعلانات أو عمليات بحث ذات صلة. ويجب إعداد المَعلمة على دالة رد اتصال JavaScript التي تنفّذها والتي تسمح بتنفيذ الإجراء عند اكتمال طلب عرض الإعلان.

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

containerName اسم حاوية الإعلان أو وحدة الإعلانات لعبارات بحث ذي صلة.
adsLoaded يتمّ إعداد هذه المَعلمة على "true" عندما يكون هناك إعلان واحد أو عبارة بحث ذات صلة واحدة على الأقلّ مطلوب عرضها وعلى "false" عندما لا يتمّ عرض إعلانات أو عمليات بحث ذات صلة.
isExperimentVariant يتمّ إعداد هذه المَعلمة على "true" إذا كانت هناك تجربة نمط مخصّص قيد التنفيذ ويتمّ اختيار صيغة التجربة لعرض الإعلانات.
callbackOptions عنصر JSON يحتوي على الحقول التالية:
termPositions: لقالب بحث ذي صلة، يحتوي على map<string,int> للعبارات التي قدّمها الناشر إلى الموضع المفهرس بصفر لهذه العبارات في الرد. وإذا تم تقديم عبارة معيّنة ولكن لم يتم عرضها، لن تظهر في الدالة.

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

مثال على رد اتصال 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 اختيارية
عدد الإعلانات التي يجب ظهورها في هذه الوحدة. والقيمة الافتراضية هي 2.

مثال: 

'number' : 4
relatedSearches اختيارية
عدد عمليات البحث ذات الصلة التي يجب أن تظهر في هذه الوحدة. إذا كانت هذه القيمة أقل من 3، لن يتم عرض أي عمليات بحث ذات صلة.

مثال: 

'relatedSearches' : 4