المراجع

المعلمات

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

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

مطلوب

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

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

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

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

أمثلة:

'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 البلغارية والروسية
العربية 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 الكل
ivt اختيارية
تسمح لك هذه المعلمة بتقديم قيمة منطقية لإعلام Google برغبتك في السماح بالإعلانات التي تستخدم ملفات تعريف الارتباط المخصّصة لرصد الزيارات غير الصالحة فقط. التخزين على الجهاز في كل من حركة البيانات التي تمت الموافقة على استخدامها وتلك التي لم تتم الموافقة على استخدامها.
  • true في حال عدم توفّر هذه المَعلمة أو عند ضبطها على "true"، سنضبط ملف تعريف ارتباط زيارات غير صالحة فقط ونستخدم مساحة التخزين المحلية على الزيارات التي تتم الموافقة على استخدامها فقط.
  • false عند ضبط هذه المَعلمة على "false" سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط، وسنستخدم مساحة التخزين على الجهاز لكل من الزيارات التي تمت الموافقة على استخدامها وتلك التي لم تتم الموافقة على استخدامها.

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

مثال:

'ivt': false

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

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

مطلوب

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

مثال:

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

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

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