المراجع

تُحدِّد المَعلمة adPage صفحة النتائج التي يتمّ عرض الإعلانات عليها. يتم استخدام هذه المعلمة عند انتقال المستخدمين إلى ما بعد الصفحة الأولى من نتائج البحث. على سبيل المثال، إذا تمّ طلب خمسة إعلانات، وتم ضبط مَعلمة adPage على 2، ستظهر الإعلانات المعروضة في الصفحة الثانية من خمسة إعلانات.

مثال:

'pubId' : 'test-property'

ملاحظة: سيؤدي استخدام هذه المعلمة في "البحث ذو الصلة" في صفحات المحتوى إلى نتائج غير متوقعة.

أمثلة:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

مثال:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' استخدِم هذا الخيار لميزة "البحث ذو الصلة" في صفحات المحتوى (مثل المقالات مشاركات المدونة).
• 'query' استخدِم هذا الخيار حصريًا لميزة "البحث ذو الصلة" على صفحات نتائج البحث.

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

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

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

أمثلة:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

مثال:

'styleId': '1234567890'

• '_top' يفتح في النافذة نفسها.
• "'_blank'" يفتح في نافذة جديدة.

مثال:

'linkTarget' : '_blank'

مثال:

'maxTermLength' : 50

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

• يجب تقديم المعلمة فقط في طلب بحث ذي صلة للمحتوى، وسيتم سيتم تجاهلها في جميع الطلبات الأخرى.
• ولا يمكن استخدامها إلا على الزيارات التي تستمدها عن قصد من مصادر أخرى مواقع إلكترونية، ويجب عدم استخدامها في الزيارات الواردة من نتائج البحث المجانية.
• ويجب أن يتضمّن سطر العنوان و/أو الوصف و/أو أي صياغة أخرى في الإعلان أو تصميم رابط الإعلان.
• يُعد حذف قيم من تصميم الإعلان أو الرابط (أو تضمين قيم إضافية) تُعد انتهاكًا لهذه التعليمات المكتوبة.
• إنها غير حساسة لحالة الأحرف.
• تقبل ترميز UTF-8 الصالح. يُسمح باستخدام أحرف يونيكود / علامات التشكيل.
• قد تستخدم Google أو تتجاهل المَعلمة التي تُرسلها. قد يؤثّر استخدام هذا الخيار في الاختيار. وترتيب البنود.

ملاحظة: هذه المَعلمة مطلوبة عند استخدام سمة مَعلمة terms.

أمثلة:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

مثال:

'resultsPageQueryParam' : 'query'

ملاحظة: عند استخدام هذه المعلمة، يكون referrerAdCreative أيضًا مطلوبة وrelatedSearchTargeting مطلوبة ويجب ضبطها إلى "المحتوى".

أمثلة:

'terms' : 'cars rental, flight ticket'

ملاحظة: قبل أن تظهر عبارات البحث ذات الصلة على موقعك الإلكتروني، يحتاج محرّك بحث 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

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• 'high' تعرض إعلانات مناسبة لجميع أفراد العائلة. لا يتم عرض إعلانات المحتوى الجنسي للبالغين أو غير المناسبة للأطفال.
• 'medium' تعرض إعلانات مناسبة لجميع أفراد العائلة وأخرى غير مناسبة للأطفال. لا يتم عرض إعلانات المحتوى الجنسي للبالغين.
• تعرض 'low' جميع أنواع الإعلانات.

يتم ضبط adsafe تلقائيًا على "عالية".

مثال:

'adsafe': 'medium'

عندما تكون قيمة المَعلمة adtest هي on، لن تتمكّن من تحقيق أيّ أرباح.

أما طلبات الإعلان التي تم ضبط المعلمة adtest فيها على on، والتي تأتي من نطاق لم تتم الموافقة عليه في علامة التبويب "المواقع الإلكترونية"، فستعرض الإعلانات التي تحتوي على "إعلان تجريبي" متراكبة ولا يمكن النقر عليها.

استخدِم هذه المَعلمة عند إجراء اختبار، ولكن لا يُنصح باستخدامها في أنظمة الإنتاج، وإلا لن يتم الدفع لك مقابل الإعلانات التي تعرضها.

القيمة الافتراضية للمعلمة "adtest" هي "off".

مثال:

'adtest' : 'on'

أمثلة:

'channel' :  'testA'  

'channel' :  'testA+testB'  

تتيح Google كل رموز لغات AdWords API.

ملاحظة: يحدد المعلنون اللغات التي تستهدفها إعلاناتهم. إذا كنت تضمّن هذه المعلمة في طلبك، فإن Google تعرض فقط الإعلانات التي تستهدف هذه اللغة أو التي تستهدف جميع اللغات ولكنها لا تضمن أن نص الإعلان سيكون باللغة المحددة.

تحديدًا، يجب تعيين المعلمة "hl" لتكون اللغة الأساسية للصفحة التي تم إرسال هذه المعلمة منها.

أمثلة:

'hl' : 'es'

تحدّد المَعلمة ie نظام ترميز الأحرف الذي يجب استخدامه لتفسير سلسلة طلب البحث.

قيمة ie التلقائية هي utf-8.

تحدّد المَعلمة oe نظام ترميز الأحرف الذي يجب أن تستخدمه Google لترميز نصوص الإعلانات. وعلى الرغم من أنّها اختيارية من الناحية الفنية، يفضَّل تمرير قيمة لهذه المَعلمة.

قيمة oe التلقائية هي utf-8.

• true في حال عدم توفّر هذه المَعلمة أو عند ضبطها على "true"، سنضبط ملف تعريف ارتباط زيارات غير صالحة فقط ونستخدم مساحة التخزين المحلية على الزيارات التي تتم الموافقة على استخدامها فقط.
• false عند ضبط هذه المَعلمة على "false" سنضبط ملف تعريف ارتباط مخصّص لرصد الزيارات غير الصالحة فقط، وسنستخدم مساحة التخزين على الجهاز لكل من الزيارات التي تمت الموافقة على استخدامها وتلك التي لم تتم الموافقة على استخدامها.

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

مثال:

'ivt': false

مثال:

'container' : 'afscontainer1'

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

ملاحظة: تُستخدم هذه المعلمة بدلاً من "الرقم" . هذه الوحدة الإعلانية يجب أن يكون واسعًا بما يكفي بحيث لا يلتف السطر الأول من الإعلانات. استخدام maxTop على أي موضع آخر على الصفحة يُعد انتهاكًا للسياسة.

مثال:

'maxTop' : 4

مثال:

'width' : '700px'

'width' : 700

تستخدم دالة رد الاتصال المَعلمات التالية:

ملاحظة: يُرجى اختبار دالة معاودة الاتصال للتأكد من أنها لا تؤدي إلى حدوث أي أخطاء، وخاصةً تلك التي قد تؤثر في تحميل صفحتك.

مثال على استدعاء 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' : 4

مثال:

'relatedSearches' : 4