نوفّر للمستخدمين المتقدّمين في ما يلي قائمة بمَعلمات أنماط "الإعلانات على شبكة البحث" المتاحة حاليًا. ويحتوي الرمز الذي تُنشئه في AdSense على جميع إعدادات المَعلمات شائعة الاستخدام. وهناك معلّمتَان مطلوبتَان: pubId وquery. ويوفّر AdSense المعلّمة pubId ولكن عليك تعديل الرمز وتمرير قيمة للمعلّمة query. جميع المَعلمات الأخرى اختيارية وموضّحة في ما يلي.
أنواع المعلّمات
هناك نوعَان من المَعلمات:
- مَعلمات على مستوى الصفحة، وتنطبق على جميع الوحدات الإعلانية في الصفحة.
- معلّمات على مستوى الوحدة، وتنطبق على وحدات إعلانات فردية.
إليك مثال على الرمز من مُنشئ الرمز يضمّ قالبَي إعلانات. ولضبط هذا الرمز، عليك إعداد معلّمة query المطلوبة في الدالة pageOptions (مثل “query”: myQuery). وهذه هي جميع الإجراءات اللازمة لبدء عرض الإعلانات. ويمكنك أيضًا إعداد معلّمات اختيارية في القالب على مستوى الصفحة ومعلّمات على مستوى وحدة فردية في الدالتَين adblock1 وadblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
أوصاف المَعلمات على مستوى الصفحة
تتطلّب هذه المعلمات التحديد مرّة واحدة فقط لكل صفحة. وتوثّر على جميع الوحدات في الصفحة.
مطلوبة
| المَعلمة | الوصف والأمثلة |
|---|---|
adPage |
مطلوبة عند انتقال المستخدم إلى صفحة النتائج التالية أو صفحة النتائج السابقة
تُحدِّد المَعلمة |
pubId |
مطلوبة تمثّل هذه المعلّمة معرِّف العميل المتعلق بك في AdSense. وpubId هي جزء من معرِّف العميل الذي يأتي بعد "-partner". على سبيل المثال، إذا كان معرِّف العميل المتعلق بك هو "partner-test-property"، يعني ذلك أنّ قيمة pubId هي "test-property". هذا هو البروتوكول العادي المُتّبَع في "إعلانات البحث المخصّص". مثال: 'pubId' : 'test-property' |
query |
مطلوبة تمثّل هذه المعلّمة طلب البحث الذي أدخله المستخدم. ويجب أن تكون قيمة مَعلمة طلب البحث غير مرمّزة. أمثلة:
|
referrerAdCreative |
مطلوبة (في حال اكتساب الزيارات) إذا وصل المستخدِم إلى صفحة تتضمّن وحدات بحث ذي صلة بالمحتوى من مصدر خاضع لسيطرتك (يشمل ذلك أي شريك تابع أو خدمة أو شبكة خارجية تتعاون معها)، يجب ضبط هذه المَعلمة لتطابق تمامًا نص تصميم ذلك المصدر. تنطبق الإرشادات التالية على استخدام هذه المعلّمة:
ملاحظة: هذه المَعلمة مطلوبة عند استخدام المَعلمة
terms.أمثلة: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageBaseUrl |
مطلوبة عند توفُّر وحدات "بحث ذو صلة" في الصفحة تحدِّد هذه المعلّمة عنوان URL لصفحة نتائج البحث التي كان فيها طلب البحث في شكل عبارة البحث ذي الصلة التي نقر المستخدم عليها. وقد تتضمّن resultsPageBaseUr معلّماتها الخاصة، باستثناء طلب البحث الذي سيتم إلحاقه تلقائيًا.
مثال:
|
styleId |
مطلوبة تحدِّد هذه المَعلمة رقم تعريف نمط "الإعلان على شبكة البحث" الذي سيتمّ تطبيقه على الإعلان أو وحدات الإعلانات لعبارات البحث ذي الصلة على الصفحة. اطّلِع على مزيد من المعلومات عن استخدام أنماط الإعلانات على شبكة البحث. تجدر الإشارة إلى أنّه عند إعداد styleId لطلب ما، سيتمّ عرض الإعلانات أو عمليات البحث ذات الصلة باستخدام النمط، وسيتمّ تجاهل مَعلمات النمط القديمة. وإذا لم يتم تحديد styleId في الطلب، سيتم عرض نمط الإعداد التلقائي للنظام. مثال
|
اختياري
| المَعلمة | الوصف والأمثلة |
|---|---|
linkTarget |
اختيارية تحدِّد هذه المعلّمة ما إذا كان النقر على إعلان سيؤدي إلى فتحه في النافذة نفسها أو نافذة جديدة. والقيمة التلقائية هي "top_". ويمكن أيضًا استخدام هذه المعلّمة على مستوى الوحدة.
مثال: 'linkTarget' : '_blank' |
maxTermLength |
اختيارية تحدِّد هذه المعلّمة الحد الأقصى لعدد أحرف عبارة البحث ذات الصلة بما في ذلك المسافات. وما مِن حد أقصى إذا لم يتم إعداد هذه المعلّمة. مثال: 'maxTermLength' : 50 |
resultsPageQueryParam |
اختيارية تحدِّد هذه المعلّمة اسم معلّمة عنوان URL لطلب البحث في صفحة نتائج البحث. ويتم إعداد القيمة على "q" تلقائيًا في حال عدم تحديدها. مثال: 'resultsPageQueryParam' : 'query' |
terms |
اختيارية تسمح لك هذه المعلّمة بتقديم قائمة بعبارات البحث ذات الصلة مفصولة بفواصل التي يتم عرضها مع طلب بحث ذي صلة، على الرغم من أن Google قد تستخدِم أو لا تستخدِم العبارات المقدّمة هنا. مثال: 'terms' : 'cars rental, flight ticket' |
إعدادات الضبط
| المَعلمة | الوصف والأمثلة | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
اختيارية تحدِّد هذه المعلّمة قواعد الفلترة التي ستطبّقها Google على الإعلانات التي تتطابق مع طلب البحث. وفي ما يلي الإعدادات الصالحة للمعلّمة adsafe وتأثير كل قيمة على الإعلانات المعروضة:
ملاحظة: يتم إعداد المعلّمة
adsafe تلقائيًا على 'high'.مثال: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
اختيارية تُستخدَم المَعلمة adtest للإشارة إلى أنّ طلب الإعلانات هو مجرّد اختبار. وعندما تكون قيمة المَعلمة adtest هي "on"، تتعامل Google مع الطلب على أنّه اختبار ولا يتمّ احتساب عدد مرّات ظهور الإعلان أو تتبُّع نتائج النقر.
عندما تكون قيمة المَعلمة ملاحظات:
القيمة التلقائية للمعلمة adtest هي "off". مثال: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
اختيارية يمكنك تضمين قناة AdSense للبحث لتتبُّع أداء الصفحات المختلفة. استخدِم معرّف القناة الفريد الذي أنشأته في حسابك على AdSense. اطّلِع على مزيد من المعلومات عن تتبُّع أداء الإعلان باستخدام القنوات المخصّصة. يجب فصل القنوات المتعدّدة باستخدام الرمز '+'. أمثلة: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
اختيارية تحدِّد هذه المعلّمة اللغة التي يجب أن تستهدِفها الإعلانات المطلوبة. والقيمة التلقائية لهذه المعلمة هي "en". تتيح Google كلّ رموز لغات Google Ads API. ملاحظة: يحدِّد المعلِنون اللغات التي تستهدِفها إعلاناتهم. وفي حال أدرجتَ هذه المعلمة في طلبك، لن تعرِض Google سوى الإعلانات التي تستهدِف هذه اللغة أو تلك التي تستهدِف جميع اللغات، ولكنّها لن تضمن ظهور نصّ الإعلان باللغة المحدَّدة.
بشكل عام، عليك تحديد المعلمة أمثلة: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
اختياري
تحدّد المعلمة القيمة التلقائية لمعلمة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
اختياري
تُحدِّد المعلمة القيمة التلقائية للمعلّمة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
متوقّفة نهائيًا
ملاحظة: تم إيقاف ميزة "تخصيص الإعلانات" نهائيًا في "AdSense للبحث". لمزيد من المعلومات، راجِع المقالة خدمة "AdSense للبحث" ومنتجات الإعلانات الأخرى على شبكة البحث تستخدم نطاقات عرض جديدة وتوقِف إعدادات تخصيص الإعلانات نهائيًا.
|
أوصاف المَعلمات على مستوى الوحدة
تؤثّر تلك المعلّمات في طريقة عرض الوحدات الإعلانية الفردية على الصفحة للمستخدِم. ويمكن إعداد كل معلّمة بشكلٍ فردي لكل وحدة إعلانية.
مطلوبة
| المَعلمة | الوصف والأمثلة |
|---|---|
container |
مطلوبة رقم تعريف حاوية الإعلان الفارغة <div id='afscontainer1'></div> التي يجب أن يظهر فيها الإعلان.
مثال: |
إعدادات الضبط
| المَعلمة | الوصف والأمثلة | ||||||||
|---|---|---|---|---|---|---|---|---|---|
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 } } }; |
||||||||
maxTop |
اختياري
تُستخدَم هذه المَعلمة لتحديد عدد الإعلانات المُراد عرضها في الوحدة الإعلانية أعلى الصفحة. ملاحظة: تُستخدَم هذه المعلّمة بدلاً من المعلّمة
number. ويجب أن تكون هذه الوحدة الإعلانية عريضة بما يكفي بحيث لا يمتد السطر الأول من الإعلانات إلى سطر جديد. لاحظ أنّ استخدام المعلّمة maxTop في أي موضع آخر على الصفحة يُعدّ انتهاكًا للسياسة.مثال: |
||||||||
number |
اختيارية عدد الإعلانات التي يجب ظهورها في هذه الوحدة. القيمة التلقائية لهذه المَعلمة هي '2'. مثال: |
||||||||
relatedSearches |
اختيارية عدد عمليات البحث ذات الصلة التي يجب أن تظهر في هذه الوحدة. وتعرِض هذه المَعلمة ما لا يقلّ عن ثلاث عمليات بحث ذات صلة، ما لم يتمّ ضبطها على صفر. ويتمّ ضبط القيمة على 0 تلقائيًا في حال عدم تحديدها. مثال: 'relatedSearches' : 4 |
||||||||
width |
اختيارية تحدِّد هذه المَعلمة عرض الوحدة الإعلانية أو وحدة عبارات البحث ذي الصلة بالبكسل. أمثلة: 'width' : '700px''width' : 700 |