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

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

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

  • لاستخدام ميزة Open Measurement، يجب أن يكون لديك الإصدار 3.9.0 أو أي إصدار أحدث من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) لنظام التشغيل iOS.

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

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

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

الاختبار

لاختبار ميزة Open Measurement باستخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA)، استخدِم إصدارًا من حزمة IMA يتيح حزمة تطوير البرامج (SDK) الخاصة بـ Open Measurement‏ (OM)، بالإضافة إلى علامة إعلانية اختبارية.

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

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

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

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

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

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

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

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

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

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

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

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Replace myTransparentTapOverlay and myPauseButton with your own elements
// that function as video control overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
   [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                          purpose:IMAFriendlyObstructionPurposeNotVisible
                                 detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
   [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                          purpose:IMAFriendlyObstructionPurposeMediaControls
                                 detailedReason:@"This is the video player pause button"];

[displayContainer registerFriendlyObstruction:overlayObstruction];
[displayContainer registerFriendlyObstruction:pauseButtonObstruction];

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

Objective-C 

- (void)unregisterObstructionsForContainer:(IMAAdDisplayContainer *)displayContainer {
    // This removes all previously registered friendly obstructions from the container.
    [displayContainer unregisterAllFriendlyObstructions];
}

Swift 

func unregisterObstructions(displayContainer: IMAAdDisplayContainer) {
  // This removes all previously registered friendly obstructions from the container.
  displayContainer.unregisterAllFriendlyObstructions()
}