تفعيل ميزة "القياس المفتوح"

اختيار النظام الأساسي: HTML5 Android iOS

تتضمّن حزمة IMA SDK لنظام Android حزمة Open Measurement (OM) SDK، وهو معيار متّبع في المجال طوّره مكتب الإعلانات التفاعلية (IAB) لتفعيل قياس إمكانية العرض والتحقّق من صحة البيانات من جهة خارجية. عند استخدام حزمة IMA SDK لنظام Android، تحلّل حزمة Open Measurement SDK المضمّنة تلقائيًا علامة <AdVerifications> ضمن علامات VAST الإعلانية وترسل بيانات إمكانية العرض إلى مورّدي القياس المحدّدين باستخدام واجهة برمجة التطبيقات OMID. تتوافق حزمة IMA SDK مع حزمة Open Measurement SDK الإصدار 1.6، وإضافات GAM AdVerifications على VAST 2 والإصدارات الأحدث، وعقدة AdVerifications على VAST 4 والإصدارات الأحدث.للاستفادة من ميزة Open Measurement، يُرجى مراعاة النقاط التالية:

  • لاستخدام ميزة Open Measurement، يجب أن يكون لديك الإصدار 3.11.0 أو إصدار أحدث من حزمة IMA SDK لنظام Android. ومع ذلك، تم تصميم المثال الوارد في هذا الدليل لأحدث إصدار من حزمة SDK ويتضمّن واجهات برمجة التطبيقات التي تم طرحها في الإصدار 3.16.5.

  • يجب ضبط الإعلانات لعرض <AdVerifications> في علامات VAST وفقًا لـ مواصفات VAST 4.1 إذا كنت تستخدم VAST 4.1 والإصدارات الأحدث، وإلا يجب استخدام <Extension type="AdVerifications">.

  • يُرجى عدم تغطية AdDisplayContainer بأي عناصر مركّبة (شفافة أو غير شفافة)، لأنّ حزمة Open Measurement SDK ستضع علامة على هذه العناصر باعتبارها عوائق وستقلّل من إمكانية العرض.

المتطلبات الأساسية

الاختبار

لاختبار ميزة Open Measurement باستخدام حزمة IMA SDK، استخدِم إصدارًا من حزمة IMA SDK يتوافق مع حزمة Open Measurement SDK، بالإضافة إلى علامة إعلانية اختبارية.

من المفترض أن تظهر لك علامة <AdVerifications> التي تم عرضها في استجابة VAST.

تسجيل العوائق التي تحجب عناصر التحكّم في الفيديو

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

للاطّلاع على مثال على عناصر التحكّم في الفيديو المركّبة، يُرجى الاطّلاع على الصورة التالية في تطبيق YouTube التي تعرض عناصر التحكّم:

فتح صورة مثال على تراكب القياس

عند استخدام حزمة IMA SDK، ينفّذ معظم الناشرين عناصر التحكّم هذه من خلال إضافة طريقة عرض فوق حاوية عرض الإعلان تكون شفافة في الغالب. عادةً ما تكون عناصر التحكّم عناصر فرعية من طريقة العرض هذه التي تحجب مشغّل الفيديو الأساسي بالكامل. يتم استخدام هذا العنصر المركّب الشفاف لتسجيل أحداث النقر ثم عرض عناصر التحكّم للمستخدمين عند النقر عليها.

عند احتساب إمكانية عرض الإعلان باستخدام حزمة Open Measurement SDK، تُعتبر جميع طرق العرض التي تحجب عنصر الوسائط عوائق وتقلّل من معدّل إمكانية العرض. في حال وضع عنصر مركّب شفاف للنقر فوق حاوية عرض الإعلان بأكملها، من الممكن أن يتم الإعلان عن أنّ المساحة الإعلانية غير قابلة للعرض تمامًا.

تتضمّن حزمة SDK للقياس المفتوح أحكامًا تسمح باعتبار عناصر التحكّم في الفيديو عوائق "سهلة الاستخدام" ضرورية لتجربة المستخدم. بعد تسجيل عناصر التحكّم هذه على أنّها سهلة الاستخدام، يتم استبعادها من قياس إمكانية عرض الإعلان.

مع دعم IAB وMRC، تقدّم حزمة IMA SDK واجهة برمجة تطبيقات لتسجيل هذه العناصر المركّبة في حزمة Open Measurement SDK. يجب أن تكون عناصر التحكّم هذه عناصر مركّبة شفافة بالكامل أو أزرارًا صغيرة. يجب عدم تسجيل أي طرق عرض أخرى غير مرتبطة بعناصر التحكّم في الفيديو.

ما يجب تسجيله ما لا يجب تسجيله
  • عنصر مركّب شفاف لتسجيل نقرات المستخدم
  • أزرار مؤقتة
    • إيقاف مؤقت
    • تشغيل
    • ملء الشاشة
    • البث/AirPlay
    • تصغير
    • التقدّم/البحث
    • إجراءات أخرى ذات صلة بالتشغيل
  • العلامات المائية
  • النوافذ المنبثقة
  • مربّعات حوار
  • أزرار غير مؤقتة
  • طرق عرض أخرى تحجب المحتوى

يوضّح الرمز النموذجي التالي كيفية تسجيل العناصر المركّبة لعناصر التحكّم في الفيديو على حاوية عرض الإعلان: 

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}

عند الانتهاء من استخدام هذه العوائق، يمكن إزالتها من خلال استدعاء الطريقة التالية: 

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}