المرجع

المعلمات

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

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

مطلوب

المَعلمة الوصف والأمثلة
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"). إذا كنت تستخدِم ميزة "البحث ذو الصلة" في أي نوع آخر من الصفحات (مثل المقالات ومشاركات المدونات)، يجب ضبط المَعلمة على "المحتوى" صراحةً.

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

  • قد يتم تفعيل بعض ميزات البحث ذو الصلة أو إيقافها استنادًا إلى قيمة مَعلمة الصفحة هذه.
  • يُعدّ تقديم وصف مضلِّل لنوع الصفحة أو الاعتماد على الإعداد التلقائي "طلب البحث" لمَعلمة 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 مطلوبة ويجب ضبطها على "المحتوى".

أمثلة: 

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

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

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

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

  • يجب تقديم المَعلمة فقط في طلب البحث ذي الصلة بالمحتوى، وسيتم تجاهلها في جميع الطلبات الأخرى.
  • يجب أن تكون قيمة هذه المَعلمة قائمة مفصولة بفواصل لمَعلمات عناوين 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 تلقائيًا على true.

مثال: 

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

مثال: 

'relatedSearches' : 4