فتح أداة القياس في حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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

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

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