الأسئلة الشائعة حول حزمة تطوير البرامج لإعلانات الوسائط التفاعلية من Google

لماذا لا أحصل على إعلانات لجميع الأشكال؟
تم إعداد علامات الإعلانات الاختبارية بحيث يتم دائمًا عرض إعلانات عند تقديم طلبات صالحة. والهدف من ذلك هو تيسير التكامل وتسهيل اختبار الطريقة التي يطلب من خلالها اللاعب عرض الإعلانات ويعرضها. ومع ذلك، لا تتوفّر الإعلانات دائمًا بكل شكل لموقعك الإلكتروني أو حسابك أو وحدتك الإعلانية. إذا كانت عملية الدمج تعمل بشكل صحيح مع العلامة الاختبارية ولكنها لا تتوافق مع علامتك، قد يكون السبب واحدًا مما يلي:
  • أنت تعرض مقاطع فيديو بتنسيق غير متوافق مع بيئتك. على سبيل المثال، إذا كنت تعرض إعلانات HTML5 فقط على الأجهزة التي تعمل بنظام التشغيل iOS أو Android.
  • إذا كنت تستخدم "مدير الإعلانات"، قد لا يتضمن الرقم التعريفي للناشر أي إعلانات تستهدفه في الوقت الحالي. تأكد أيضًا من أنك وافقت على الإعلانات وتصميمات الإعلانات ذات الصلة في "مدير الإعلانات".
  • إذا كنت تستخدم AdSense، قد لا تتضمن معايير الاستهداف لموقعك الإلكتروني أو الصفحة الاختبارية أي إعلانات نشطة. والسبب الأكثر شيوعًا هو استخدام المواقع الإلكترونية الخاصة التي لم يتم الزحف إليها.
  • إذا كنت تستخدم "إدارة شركاء شبكة Ad Exchange" ولم يتم ضبط descriptionURL أو إذا لم تكن مدرَجة في قائمة إدارة النطاقات المملوكة أو المُدارة، لن يتم عرض الإعلانات على هذا النحو.
  • تحقق من حدود minCPM المحددة في فيديو Ad Exchange. وقد تؤدي التكلفة لكل ألف ظهور المرتفعة نسبيًا إلى انخفاض معدّلات التعبئة بشكل كبير. ولتصحيح ذلك، جرِّب إما إزالة التكلفة الدنيا لكل ألف ظهور أو إزالة معلمة الوحدة الإعلانية من طلب الإعلان (أي اسم الشريحة الإعلانية) للتحقق مما إذا كان هذا يؤثر في معدل التعبئة أم لا.
كيف تبدو descriptionUrl الجيّدة؟
لتحقيق أكبر قدر من الفاعلية، يجب ألا يكون محتوى الصفحة الذي يشير إليه descriptionUrl عبارة عن مجموعة من الكلمات أو العبارات، بل من 1 إلى 3 فقرات تصف المحتوى ودورك في تقديمه. كانت إحدى الطرق الناجحة في الماضي هي تجميع محتوى صفحة descriptionUrl ديناميكيًا من كتل محددة مسبقًا. على سبيل المثال، بعض الجُمل حول المحتوى، وبعض الجُمل حول عرض موقعك الإلكتروني، ثم بعض المقتطفات المحدّدة مسبقًا المرتبطة بكل قناة في AdSense (مثل "الترفيه" أو "الرياضة"). نتيجةً لذلك، يكون لكل جزء من المحتوى علامة descriptionUrl مميزة بشكل معقول مرتبطة به، ويقدّم معلومات عامة (مثل كلمات وصفية للنوع) ومعلومات معيّنة (محتوى حول المحتوى مباشرةً).

يجب أن يكون HTML للبيانات الوصفية بسيطًا، على سبيل المثال:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
لماذا أتلقى الخطأ "لا تحتوي استجابة الإعلان على نوع إعلان صالح"؟
يظهر هذا الخطأ بشكل عام لأنه لم يتم استهداف أي إعلانات لنطاق publisherId المحدّد (في الفترة الزمنية المحدّدة). وقد يختلف هذا الشرط على مدار اليوم، أو على مدار عدة أيام عند بدء الحملات وانتهائها. يجب التحقق من عدم انتهاء صلاحية الإعلان الذي ترغب في استهدافه ومن صحة معايير استهداف الإعلان. طالما أنّه يتمّ طلب الإعلانات واستلامها وعرضها بشكل صحيح باستخدام الاختبار publisherId، يمكنك التأكّد من معالجة هذه الإعلانات بشكل صحيح باستخدام publisherId المباشرة عندما تكون الإعلانات متاحة.
هل لديك علامة إعلان فيديو في "مدير الإعلانات" يمكنني استخدامها للاختبار؟
تتوفّر نماذج العلامات على صفحة نماذج العلامات.
هل يجب أن أضبط adSlotWidth وadSlotHeight على القيم نفسها مثل sz في علامة إعلان "مدير الإعلانات"؟
ليس بالضرورة. يجب ضبط adSlotWidth وadSlotHeight على عرض/ارتفاع المشغّل أو المنطقة التي تريد أن تملؤها إعلاناتك. ويستخدم AdSense هذه الإعلانات لتحديد الإعلانات المتاحة لتناسب تلك المساحة. زوج المفتاح/القيمة sz في علامة إعلان "مدير الإعلانات" هو معلمة استهداف ولا يؤثر بالضرورة في تصميم الإعلان المعروض (يمكنك الاطّلاع على مزيد من المعلومات أدناه).
تبدو علامة الإعلان التجريبي رائعة، لكن عند تبديلها مع علامة الإعلان، لا يظهر أي إعلان.
تأكّد من أنّه يتم توجيه الزيارات إلى علامة الإعلان التي تطلبها. أسهل طريقة لمعرفة ذلك هي مراقبة حركة بيانات HTTP. في حال عرض صورة باللون الرمادي gif.1x1 بكسل ضمن كتلة ارتساء HTML، ستحتاج عندئذٍ إلى التحقق من استهدافك في "مدير الإعلانات".
أريد طلب الإعلانات باستخدام العلامة نفسها أكثر من مرة، ولكني أحصل على إعلانات لطلبي الأول فقط. كيف أحل هذه المشكلة؟
عند طلب الإعلانات أكثر من مرة، عليك إبلاغ خادم الإعلانات بأنّ هذه الطلبات مشروعة وليست مكرّرة عن طريق الخطأ. وتُنفِّذ حزمة تطوير البرامج (SDK) هذا الإجراء نيابةً عنك من خلال طلبَي بيانات سريعَين من واجهة برمجة التطبيقات:
  1. اتصل بـ destroy() على النسخة الافتراضية من AdsManager. يؤدي ذلك إلى منع تشغيل أي إعلانات ما بعد التشغيل عند إجراء الاستدعاء التالي إلى contentComplete(). ستحصل على بطاقة AdsManager جديدة عند تقديم طلبك التالي.
  2. اتّصِل بالرقم contentComplete() على الرقم AdsLoader. يؤدي هذا إلى إعادة ضبط حزمة تطوير البرامج (SDK) بحيث لا يبدو طلب الإعلان الجديد نسخة مكررة من الطلب السابق.
بعد إجراء المكالمتين المذكورتَين أعلاه، يمكنك استدعاء requestAds() على مثيل AdsLoader للحصول على مجموعة أخرى من الإعلانات التي يمكن تشغيلها للفيديو الجديد.
كيف أطلب إعلانات AdSense التي تظهر على سطح الفيديو وبالشرائح الكاملة باستخدام أداة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA)؟

لطلب إعلانات AdSense باستخدام حزمة تطوير البرامج (SDK)، عليك أولاً الحصول على علامة إعلان AdSense. ويمكنك معرفة المزيد من المعلومات حول ذلك في صفحة AdSense للفيديو. بعد الحصول على علامتك، يجب اتخاذ الخطوات التالية لإنشاء إعلان مركّب أو طلب إعلان على شكل شريحة كاملة:

الإعلانات التي تظهر على سطح الفيديو
  1. في AdsRequest، اضبط "أوضاع العرض" على NORMAL.
  2. في علامة الإعلان، أضف المعلمة overlay=1.
إعلانات الشرائح الكاملة
  1. في AdsRequest، اضبط "أوضاع العرض" على FULLSCREEN.
  2. في علامة الإعلان، أضف المعلمة overlay=0.
يظهر لي خطأ "عنوان URL لنسبة النقر إلى الظهور غير صالح" عند النقر على إعلاني. ما سبب ذلك؟
السبب الأكثر شيوعًا لحدوث هذا الخطأ هو عنوان URL لنسبة النقر إلى الظهور التي تم تخطيها بشكل غير صحيح. إذا ظهر لك هذا الخطأ، تأكّد من عدم تضمين عنوان URL لنسبة النقر إلى الظهور بشكل صحيح في استجابة VAST.
لماذا يظهر لي الخطأ "VAST Document Empty"؟
يحدث هذا الخطأ عندما تعرض علامة الإعلان مستند VAST فارغًا، مما يشير إلى عدم عرض الإعلان بشكلٍ صحيح. تحدّث إلى مدير حسابك أو ممثل خادم الإعلانات لمعرفة سبب عدم عمل علامة الإعلان.
هل يمكنني تغيير حجم/نص المربع تخطي الإعلان أو عناصر واجهة المستخدم الأخرى؟
لا تتيح أدوات تطوير البرامج لإعلانات الوسائط التفاعلية تغيير تنسيق عناصر واجهة المستخدم أو حجمها أو محتواها. لمزيد من التفاصيل عن عناصر واجهة المستخدم، يُرجى الاطّلاع على AdsManager.uiElements.
هل عناصر التحكم في الفيديو المدمجة مع المحتوى متوافقة مع HTML5 SDK؟
لا، فحزمة HTML5 SDK لا تتيح استخدام عناصر التحكّم الأصلية.
تظهر لي الرسالة "أخفق تنفيذ الأمر "تشغيل" على العنصر "HTMLMediaElement": لا يمكن بدء واجهة برمجة التطبيقات إلا بإيماءة مستخدم" في عملية تنفيذ HTML5. كيف أحل هذه المشكلة؟
على الأجهزة الجوّالة، عليك الاتصال بـ adDisplayContainer.initialize() كنتيجة لإجراء نفّذه المستخدم (كنقرة). إذا كنت تشاهد هذا الخطأ، فمن المرجح أنك تستدعيه في سياق لا يبدأه المستخدم. تجدر الإشارة إلى أنها يجب أن تكون النتيجة المباشرة لإجراء المستخدم. على سبيل المثال، إذا استجبت لحدث "النقر" من خلال تشغيل فيديو، ثم استخدمت حدث "تشغيل" مشغّل الفيديو لاستدعاء initialize()، تعرض حزمة تطوير البرامج (SDK) هذا الخطأ. يجب استدعاء initialize() كنتيجة لحدث النقر نفسه.
كيف أتعامل مع تركيز لوحة المفاتيح على النقرات على الإعلانات؟
إذا استخدمت عناصر التحكّم في لوحة المفاتيح للمشغل، قد تلاحظ أنها لن تعمل بعد ذلك بعد النقر على adDisplayContainer. ويرجع ذلك إلى أنه بعد النقر على أحد الإعلانات، يتم تحويل تركيز لوحة المفاتيح إلى إطار iframe لإعلانات الوسائط التفاعلية. للحفاظ على تركيز لوحة المفاتيح على مشغّل المحتوى، يُرجى استخدام حدث CLICK لنقل تركيز لوحة المفاتيح مرة أخرى إلى الحاوية المطلوبة. يمكنك الاطّلاع على مقتطف الرمز التالي للحصول على مزيد من التفاصيل: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });