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