المراجع

المَعلمات

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

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

مطلوبة

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

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

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

مثال: 

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

مثال: 

'styleId': '1234567890'

اختياري

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

مثال: 

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

مثال: 

'maxTermLength' : 50
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 أيضًا مطلوبة.

أمثلة: 

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

ملاحظة: يعتمد استخدام ميزة "البحث ذو الصلة في المحتوى" على نظام الزحف إلى المحتوى في 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 مع الطلب على أنّه اختبار ولا تحتسب مرات ظهور الإعلان أو تتتبّع نتائج النقر.

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

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

القيمة الافتراضية للمعلمة "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 البلغارية والروسية
arabic ISO-8859-6  
اليونانية ISO-8859-7 اليونانية
hebrew 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 البلغارية والروسية
arabic ISO-8859-6  
اليونانية ISO-8859-7 اليونانية
hebrew 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 في حال عدم توفّر هذه المَعلمة أو ضبطها على "صحيح"، سنضبط ملف تعريف ارتباط مخصّص للزيارات غير الصالحة فقط وسنستخدم ميزة التخزين المحلي مع الزيارات التي تتم الموافقة عليها فقط.
  • false عند ضبط هذه المَعلمة على "خطأ"، سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط وسنستخدم مساحة التخزين المحلية على كلٍّ من الزيارات التي تمت الموافقة عليها وتلك التي لم يوافق عليها.

يتم ضبط الزيارات غير الصالحة تلقائيًا على "صحيح".

مثال: 

'ivt': false

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

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

مطلوبة

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

مثال: 

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

استخدِم هذه المَعلمة لتحديد عدد الإعلانات التي سيتمّ عرضها في الوحدة الإعلانية العلوية.

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

مثال:

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

مثال: 

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

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

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

تستخدم دالة رد الاتصال المعلمات التالية:

containerName اسم حاوية الإعلان أو وحدة البحث ذي الصلة.
adsLoaded يتم ضبطها على "صحيح" عند عرض إعلان واحد أو عبارة بحث ذي صلة واحدة على الأقل، ويتم ضبطها على "خطأ" عند عدم عرض إعلانات أو عمليات بحث ذات صلة.
isExperimentVariant يتم ضبطها على "صحيح" إذا كانت تجربة تصميم مخصّص قيد التنفيذ وتم اختيار صيغة التجربة لعرض الإعلانات.
callbackOptions عنصر JSON يحتوي على الحقول التالية:
termPositions: بالنسبة إلى مجموعة بحث ذات صلة، يتضمّن الردّ خريطة<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