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

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

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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

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

من خلال دعم IAB وMRC، تقدّم حزمة IMA SDK واجهة برمجة تطبيقات لتسجيل هذه الإعلانات المركّبة باستخدام حزمة 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()
}