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

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

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

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

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

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

• إذا تمّ عرض إعلاناتك من خلال "مدير إعلانات Google"، عليك ضبط مقدّم خدمات إمكانية العرض لشبكة "مدير إعلانات Google" وتخصيص مقدّم خدمات إمكانية العرض هذا لعنصرك.

الاختبار

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

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

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

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

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

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

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

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

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

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

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

نقطة رئيسية: يجب أن تتّبع سلسلة detailedReason المستخدَمة عند إنشاء ملف IMAFriendlyObstruction معيار IAB من خلال:

• أن يتألّف من 50 حرفًا أو أقل
• أن يحتوي على الأحرف A-z أو 0-9 أو المسافات فقط
• يمكن أن تكون السلسلة فارغة.

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];

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