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

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

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

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

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

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

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

الاختبار

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

من المفترض أن يظهر <AdVerifications> في ردّ VAST.

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

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

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

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

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

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

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

بدعم من IAB وMRC، تقدّم حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية واجهة برمجة تطبيقات لتسجيل هذه الإعلانات المتراكبة باستخدام حزمة SDK للقياس المفتوح. يجب أن تكون عناصر التحكّم هذه عبارة عن تراكبات شفافة بالكامل أو أزرار صغيرة. يجب عدم تسجيل أي مشاهدات أخرى غير مرتبطة بعناصر التحكّم في الفيديو.

DO register عدم التسجيل
  • تراكب شفاف لتسجيل نقرات المستخدم
  • أزرار مؤقتة
    • إيقاف مؤقت
    • تشغيل
    • ملء الشاشة
    • البث/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();
}