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

لماذا لا يتم عرض الإعلانات لجميع أشكال الإعلانات؟
تم إعداد علامات الإعلانات الاختبارية لعرض إعلانات للطلبات الصالحة دائمًا. هذا هو ويهدف إلى تسهيل عملية الدمج وتسهيل اختبار طريقة عمل المشغّل تطلب الإعلانات وتعرضها. ومع ذلك، لا تتوفر الإعلانات دائمًا في كل شكل موقعك الإلكتروني أو حسابك أو وحدتك الإعلانية في حال نجاح عملية الدمج بشكلٍ مناسب لعلامة الاختبار ولكن ليس لعلامتك الخاصة، فقد يكون السبب أحد ما يلي:
  • أنت تعرض فيديوهات بتنسيق غير متوافق في بيئتك. على سبيل المثال: كنت تعرض إعلانات HTML5 فقط على نظام التشغيل iOS أو Android.
  • إذا كنت تستخدم "مدير الإعلانات"، قد لا يتضمن الرقم التعريفي للناشر أي إعلانات في هذا الوقت. أيضًا، تأكد من الموافقة على الإعلانات و والتصاميم في "مدير إعلانات Google"
  • في حال استخدام 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 في علامة إعلانات "مدير إعلانات Google" هو مَعلمة استهداف ولا تؤثّر بالضرورة في تصميم الإعلان الذي يتمّ عرضه (اطّلِع على مزيد من المعلومات أدناه).
تبدو علامة الإعلان التجريبي رائعة، ولكن عندما أقوم بتبديلها باستخدام علامة إعلاني، لا يظهر أي إعلان.
تأكّد من أنّه يتم نقل شيء ما إلى علامة الإعلان التي تستخدمها يطلبها. وتتمثل أسهل طريقة لمعرفة ذلك في مراقبة حركة الزيارات على HTTP. إذا يتم عرض صورة 1x1 بكسل grey.gif ضمن كتلة ارتساء HTML، عليك بعد ذلك التحقّق من استهدافك في "مدير إعلانات Google"
أريد طلب إعلانات باستخدام العلامة نفسها أكثر من مرة، لكنني لا أتلقّى إعلانات إلا لأول مرة طلبك. كيف أحل هذه المشكلة؟
عند طلب الإعلانات أكثر من مرة، عليك إبلاغ خادم الإعلانات بذلك. من أنّ هذه الطلبات مشروعة وليست تكرارًا غير مقصود. حزمة SDK تفعل ذلك نيابةً عنك من خلال طلبَين سريعَين لواجهة برمجة التطبيقات:
  1. يمكنك الاتصال بـ destroy() على الجهاز الافتراضي AdsManager. يمنع هذا الإجراء تشغيل أي إعلانات ما بعد التشغيل عند إجراء الاتصال أدناه contentComplete() تحصل على AdsManager جديد عند تقديم طلبك التالي.
  2. الاتصال بـ "contentComplete()" على جهاز AdsLoader مثال. ويؤدي هذا إلى إعادة تعيين حزمة SDK بحيث لا يبدو طلب الإعلان الجديد نسخة مكررة من السابق.
بعد إجراء المكالمتَين أعلاه، يمكنك الاتصال بـ "requestAds()" على مثيل AdsLoader لعرض مجموعة أخرى من الإعلانات لعرضها فيديو جديد.
كيف أطلب إعلانات AdSense التي تظهر على سطح الفيديو وفي مواضع كاملة باستخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية؟

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

الإعلانات التي تظهر على سطح الفيديو
  1. في AdsRequest، اضبط أوضاع العرض على NORMAL
  2. في علامة إعلانك، أضِف المَعلمة overlay=1.
الإعلانات الكاملة للخانات
  1. في AdsRequest، اضبط أوضاع العرض على FULLSCREEN
  2. في علامة إعلانك، أضِف المَعلمة overlay=0.
تظهر لي "عنوان URL غير صالح للنقرة" خطأ عندما أنقر على إعلاني. فما السبب المحتمل؟
يُعد السبب الأكثر شيوعًا لهذا الخطأ إلى حدوث خطأ في النقر إلى الظهور عنوان URL. إذا ظهر لك هذا الخطأ، تحقّق للتأكد من أنّ نسبة النقر إلى الظهور تم تخطي عنوان URL بشكل صحيح في استجابة VAST.
لماذا يظهر لي "مستند VAST فارغ"؟ الخطأ؟
يحدث هذا الخطأ عندما تعرض علامة الإعلان مستند VAST فارغًا، مما يشير إلى عدم عرض الإعلان بشكل صحيح التحدث إلى مدير حسابك أو ممثل خادم الإعلانات لمعرفة سبب عدم عمل علامة إعلانك.
هل يمكنني تغيير حجم/نص مربّع تخطّي الإعلان أو عناصر أخرى في واجهة المستخدم؟
لا تتيح "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية" إمكانية تغيير تنسيق عناصر واجهة المستخدم أو حجمها أو محتواها. لمزيد من التفاصيل حول عناصر واجهة المستخدم، انتقِل إلى AdsManager.uiElements.
هل عناصر التحكّم الأصلية في الفيديو متوافقة مع حزمة تطوير برامج HTML5؟
لا، لا تدعم حزمة 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.
      });