أوصاف معلّمات إعلانات البحث المخصّص

نوفّر للمستخدمين المتقدّمين في ما يلي قائمة بمعلّمات نمط الإعلانات على شبكة البحث المتاحة حاليًا. ويحتوي الرمز الذي تُنشئه في AdSense على جميع إعدادات المعلمات الأكثر استخدامًا. وهناك معلّمتَان مطلوبتَان: pubId وquery. ويوفّر AdSense المعلّمة pubId ولكن عليك تعديل الرمز وتمرير قيمة للمعلّمة query. وجميع المعلّمات الأخرى اختيارية وموضّحة في ما يلي.

أنواع المعلّمات

هناك نوعَان من المعلّمات:

• معلّمات على مستوى الصفحة، وتنطبق على جميع الوحدات الإعلانية في الصفحة
• معلّمات على مستوى الوحدة، وتنطبق على وحدات إعلانية فردية.

إليك مثال على الرمز من مُنشئ الرمز يضمّ قالبَي إعلانات. ولضبط هذا الرمز، عليك إعداد معلّمة query المطلوبة في الدالة pageOptions (مثل “query”: myQuery). وهذه هي جميع الإجراءات اللازمة لبدء عرض الإعلانات. ويمكنك أيضًا إعداد معلّمات اختيارية في القالب على مستوى الصفحة ومعلّمات على مستوى وحدة فردية في الدالتَين adblock1 وadblock2.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Page level parameters
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Unit level parameters
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

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

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

مطلوبة

المعلّمة	الوصف والأمثلة
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 // where myQuery is a JavaScript 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 أو تتجاهل المعلّمة التي تُرسِلها أنت. وعند استخدامها، قد تؤثر في اختيار العبارات وترتيبها. أمثلة: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam	اختيارية تحدِّد هذه المعلّمة اسم معلّمة عنوان URL لطلب البحث في صفحة نتائج البحث. ويتم إعداد القيمة على "q" تلقائيًا في حال عدم تحديدها. مثال: 'resultsPageQueryParam' : 'query'
terms	اختيارية تسمح لك هذه المعلّمة بتقديم قائمة بعبارات البحث ذات الصلة مفصولة بفواصل التي يتم عرضها مع طلب بحث ذي صلة، على الرغم من أن Google قد تستخدِم أو لا تستخدِم العبارات المقدّمة هنا. مثال: 'terms' : 'cars rental, flight ticket'

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

المعلّمة	الوصف والأمثلة
adsafe	اختيارية تحدِّد هذه المعلّمة قواعد الفلترة التي ستطبّقها Google على الإعلانات التي تتطابق مع طلب البحث. وفي ما يلي الإعدادات الصالحة للمعلّمة adsafe وتأثير كل قيمة على الإعلانات المعروضة: 'high' تعرِض إعلانات مناسبة لجميع أفراد العائلة. ولا تعرِض إعلانات غير مناسبة للأطفال أو إعلانات تضمّ محتوى جنسي موجّه للبالغين. 'medium' تعرِض إعلانات مناسبة لجميع أفراد العائلة بالإضافة إلى إعلانات غير مناسبة للأطفال. ولا تعرِض إعلانات تضمّ محتوى جنسي موجّه للبالغين. 'low' تعرِض جميع أنواع الإعلانات. ملاحظة: يتم إعداد المعلّمة adsafe تلقائيًا على 'high'. مثال: 'adsafe': 'medium'
adtest	اختيارية تُستخدَم المعلّمة adtest للإشارة إلى أن طلب الإعلانات هو مجرد اختبار. وعندما تكون قيمة المعلّمة adtest هي 'on'، تتعامل Google مع الطلب كاختبار ولا يتم احتساب عدد مرات ظهور الإعلان أو تتبُّع نتائج النقر. عندما تكون قيمة المعلّمة adtest هي 'on'، لن تتمكّن من تحقيق أي أرباح. ملاحظة: يمكنك استخدام هذه المعلّمة عند إجراء اختبار، ولكن لا يُنصح باستخدامها في أنظمة الإنتاج، وإلا لن يتم الدفع لك مقابل الإعلانات التي تعرضها. القيمة التلقائية للمعلّمة adtest هي 'off'. مثال: 'adtest' : 'on'
channel	اختيارية يمكنك تضمين قناة AdSense للبحث لتتبُّع أداء الصفحات المختلفة. استخدِم معرّف القناة الفريد الذي أنشأته في حسابك على AdSense. اطّلِع على مزيد من المعلومات عن تتبُّع أداء الإعلان باستخدام القنوات المخصّصة. يجب فصل القنوات المتعدّدة باستخدام الرمز '+'.   أمثلة: 'channel' : 'testA' 'channel' : 'testA+testB'
hl	اختيارية تحدِّد هذه المعلّمة اللغة التي يجب أن تستهدِفها الإعلانات المطلوبة. والقيمة التلقائية لهذه المعلّمة هي 'en'. تتيح Google كل رموز لغات Google Ads 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 الكل
personalizedAds	اختيارية تحدِّد ما إذا كان المستخدمون قد وافقوا على السماح للناشر بمشاركة معلوماتهم الشخصية مع Google بغرض الإعلانات المخصّصة أم لا. true تعرِض الإعلانات المستهدِفة لطلب البحث وبعض الإعلانات التي قد تستهدِف ملفات تعريف ارتباط Google للمستخدِم. وإذا كان المستخدِم موجودًا داخل منطقة الاتحاد الأوروبي، يجب أن يوافق أولاً على السماح للموقع بمشاركة المعلومات الشخصية مع Google بغرض الإعلانات المخصّصة. false تعرِض الإعلانات المستهدِفة لطلب البحث فقط. ولا تعرِض أي إعلانات تستهدف ملفات تعريف ارتباط Google للمستخدِم. وفي حال عدم موافقة المستخدِم على السماح للموقع الإلكتروني بمشاركة المعلومات الشخصية مع Google بغرض عرض الإعلانات المخصّصة، يجب إعداد هذه القيمة على 'false'. ملاحظة: يتم إعداد المعلّمة personalizedAds تلقائيًا على 'true'. مثال: 'personalizedAds': false

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

تؤثّر تلك المعلّمات في طريقة عرض الوحدات الإعلانية الفردية على الصفحة للمستخدِم. ويمكن إعداد كل معلّمة بشكلٍ فردي لكل وحدة إعلانية.

مطلوبة

المعلّمة	الوصف والأمثلة
container	مطلوبة رقم تعريف حاوية الإعلان الفارغة <div id='afscontainer1'></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