المَعلمات
أوصاف معلمات مستوى الصفحة
يجب تحديد هذه المعلمات مرة واحدة فقط لكل صفحة. وهي تؤثر في جميع الوحدات في الصفحة.
مطلوبة
المَعلمة | الوصف والأمثلة |
---|---|
adPage
|
مطلوبة عندما ينتقل المستخدم إلى صفحة النتائج التالية أو صفحة النتائج السابقة. تُحدِّد المعلمة |
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". ويمكن استخدام هذه المَعلمة على مستوى الوحدة أيضًا.
مثال: 'linkTarget' : '_blank' |
maxTermLength
|
اختيارية تحدِّد هذه السمة الحد الأقصى لعدد أحرف عبارة البحث ذات الصلة، بما في ذلك المسافات. ولن يتم تحديد حدّ أقصى إذا لم يتم ضبط السياسة. مثال: 'maxTermLength' : 50 |
referrerAdCreative
|
اختياري إذا وصل مستخدم إلى صفحة المحتوى الخاصة بك التي تحتوي على وحدة "البحث ذو الصلة للمحتوى" عن طريق النقر على إعلان أو رابط على موقع إلكتروني آخر، وكان هذا الإعلان أو الرابط تحت سيطرتك، يجب ضبط هذه المَعلمة على نص تصميم الإعلان أو الرابط حرفيًا. تسري الإرشادات التالية على استخدام هذه المَعلمة:
ملاحظة: هذه المَعلمة مطلوبة عند استخدام
المعلَمة أمثلة: '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' |
ignoredPageParams
|
اختيارية تحدِّد هذه السياسة قائمة معلَمات عناوين URL لصفحة محتوى تتضمن وحدة "البحث ذو الصلة للمحتوى" والتي يمكن تجاهلها بأمان بدون التأثير على المحتوى الأساسي أو تجربة المستخدم. ملاحظة: يعتمد استخدام ميزة "البحث ذو الصلة في المحتوى" على نظام الزحف إلى المحتوى في Google لفهرسة الصفحات وإنشاء عبارات بحث ذات صلة بها. إنّ عناوين URL لصفحات المحتوى التي تحتوي على معلَمات طلبات بحث مثل متغيّرات التتبّع أو أرقام تعريف المستخدمين أو أرقام تعريف الجلسات أو غيرها من المعرّفات الديناميكية يمكن أن تتداخل مع قدرة الزاحف على تقييم المحتوى الأساسي للصفحة، وقد تؤدي إلى ظهور عبارات بحث غير دقيقة أو غير ملائمة. تطلب مَعلمة الصفحة هذه من زاحف Google تجاهل هذه المعلَمات غير الضرورية، ما يضمن فهرسة المحتوى بشكل صحيح والحدّ من حِمل الزحف غير الضروري. ويساعد ذلك محرّك بحث Google في التعرّف بشكل أفضل على الصفحة للإشارة إلى أنّه قد سبق أن تم الزحف إليها، وبدء عرض العبارات المقترَحة (العبارات المقترَحة على كلٍّ من Google والشريك، في حال استيفاء شروط الأهلية). تسري الإرشادات التالية على استخدام هذه المَعلمة:
أمثلة:
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 وتأثير كل قيمة على الإعلانات المعروضة:
يتم ضبط 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
|
اختيارية تحدّد المعلَمة قيمة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
اختيارية تحدّد المعلمة قيمة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
اختيارية تسمح لك هذه المَعلمة بتوفير قيمة منطقية تُعلم Google بأنّك تريد السماح بالإعلانات التي تستخدم ملفات تعريف الارتباط المخصّصة لرصد الزيارات غير الصالحة فقط ومساحة التخزين المحلية على كلٍّ من الزيارات التي وافق عليها المستخدمون وتلك التي لم يوافقوا على استخدامها.
يتم ضبط الزيارات غير الصالحة تلقائيًا على "صحيح". مثال: 'ivt': false |
أوصاف معلمات مستوى الوحدة
تؤثر هذه المعلمات على طريقة عرض وحدات إعلانات فردية في إحدى الصفحات للمستخدم، ويمكن تعيين كل معلمة على حدة لكل وحدة إعلان.
مطلوبة
المَعلمة | الوصف والأمثلة |
---|---|
container
|
مطلوبة رقم تعريف حاوية الإعلان الفارغة <div> التي يجب أن يظهر فيها الإعلان.
مثال: 'container' : 'afscontainer1' |
maxTop
|
مطلوبة عندما تكون الوحدة الإعلانية أعلى نتائج البحث. استخدِم هذه المَعلمة لتحديد عدد الإعلانات التي سيتمّ عرضها في الوحدة الإعلانية العلوية. ملاحظة: تُستخدَم هذه المَعلمة بدلاً من المَعلمة 'number'. ويجب أن تكون هذه الوحدة الإعلانية عريضة بما يكفي بحيث لا يمتد السطر الأول من الإعلانات إلى نهايتها. ويُعدّ استخدام المَعلمة maxTop في أي موضع إعلان آخر على الصفحة انتهاكًا للسياسة. مثال: 'maxTop' : 4 |
width
|
مطلوب تحدِّد هذه السمة عرض الإعلان أو وحدة البحث ذي الصلة بالبكسل. مثال: 'width' : '700px' 'width' : 700 |
إعدادات الضبط
المَعلمة | الوصف والأمثلة | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
اختيارية تحدّد دالة JavaScript ليتم طلبها عند تحميل الإعلانات أو عمليات البحث ذات الصلة أو في حال عدم عرض أي إعلانات أو عمليات بحث ذات صلة. يجب ضبط المَعلمة على وظيفة استدعاء في JavaScript تنفّذها وتسمح بتنفيذ إجراء عند اكتمال طلب عرض الإعلان. تستخدم دالة رد الاتصال المعلمات التالية:
ملاحظة: يُرجى اختبار دالة معاودة الاتصال للتأكّد من أنّها لا تؤدي إلى حدوث أي أخطاء، لا سيّما تلك التي قد تتداخل مع تحميل صفحتك. مثال على معاودة الاتصال باستخدام 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 |