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

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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

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

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

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

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

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

displayContainer.unregisterAllFriendlyObstructions();