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

حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية (IMA) على نظام التشغيل iOS

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

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

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

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

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

الاختبار

لاختبار Open Measurement باستخدام "حزمة تطوير البرامج لإعلانات الوسائط التفاعلية"، استخدِم أحد الإصدارات المطلوبة من حزمة تطوير البرامج المذكورة أعلاه، بالإضافة إلى علامة إعلان اختبارية.

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

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

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

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

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

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

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

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

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

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

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls 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];

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

[displayContainer unregisterAllFriendlyObstructions];