المعلمات
أوصاف معلمات مستوى الصفحة
يجب تحديد هذه المعلمات مرة واحدة فقط لكل صفحة. وهي تؤثر على جميع الوحدات في الصفحة.
مطلوبة
المَعلمة | الوصف والأمثلة |
---|---|
adPage
|
مطلوبة عند انتقال المستخدم إلى صفحة النتائج التالية أو صفحة النتائج السابقة. تُحدِّد المَعلمة |
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
|
مطلوبة عند تضمين وحدات بحث ذي صلة على الصفحة. تكون هذه المَعلمة إلزامية عند طلب وحدات البحث ذي الصلة. وتحدّد هذه الصفحة نوع تجربة "بحث ذو صلة" التي يتم عرضها، وذلك استنادًا إلى سياق الصفحة:
ملاحظة: يتم ضبط مَعلمة صفحة relatedSearchTarget تلقائيًا على "طلب البحث" تلقائيًا. في المقابل، من المهم معرفة أنّ هذه القيمة التلقائية مصمّمة خصيصًا لصفحات نتائج البحث فقط ("البحث ذو الصلة على "بحث Google"). إذا كنت تستخدم ميزة "البحث ذو الصلة" في أي نوع آخر من الصفحات (مثل المقالات ومشاركات المدوّنات)، عليك ضبط المَعلمة بشكل صريح على "المحتوى". ملاحظة: تنطبق الإرشادات التالية على استخدام هذه المَعلمة:
أمثلة: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
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 إلى صفحاتك لضمان ملاءمة العبارات للسياق. إذا لم يتم بعد الزحف إلى صفحة أو تم حظر الزحف إليها (مثلاً باستخدام ملف robots.txt) من قِبل زاحف AdSense، لن نعرض عبارات "البحث ذي الصلة" المقترَحة التي تقدّمها إلى Google. يعتمد منتج "البحث ذو الصلة ضمن المحتوى" على نظام الزحف إلى المحتوى من 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 مع الطلب على أنه اختبار ولا تحتسب مرات ظهور الإعلان ولا تتتبّع نتائج النقر. عندما تكون قيمة المَعلمة 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
|
اختيارية تحدّد المَعلمة قيمة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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 |