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

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

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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

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

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

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}
OpenMeasurementSnippets.java

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

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java