المراجع

المعلمات

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

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

مطلوبة

المَعلمة الوصف والأمثلة
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' استخدِم هذا الخيار حصريًا لميزة "البحث ذو الصلة" في صفحات نتائج البحث.

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

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

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

أمثلة:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
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 مطلوبة أيضًا وrelatedSearchTargeting مطلوبة ويجب ضبطها على "content".

أمثلة: 

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

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

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

عندما تكون قيمة المَعلمة 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 البلغارية والروسية
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 عند ضبط هذه المَعلمة على "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