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

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

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

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

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

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

الاختبار

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

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

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

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

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

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

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

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

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

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