تتيح لك واجهة برمجة التطبيقات "أداة مراقبة نشاط البث" (SAM) لميزة "إدراج إعلان ديناميكي" (DAI) فحص جلسات مشاهدة البث المباشر والفيديو عند الطلب (VOD) الفردية وتحديد المشاكل وحلّها.
لفحص جلسة مشاهدة فردية لبث مباشر أو فيديو عند الطلب وتحديد المشاكل وحلّها، استخدِم أداة مراقبة نشاط البث في واجهة مستخدم "مدير إعلانات Google".
لاسترداد بيانات التشخيص لجلسة معيّنة آليًا، استخدِم المرجع
networks.daiSessions
في Ad Manager API.
فهم حالات الاستخدام
باستخدام واجهة برمجة التطبيقات SAM API، يمكنك إجراء تشخيصات تلقائية للبث وحلّ مشاكل عرض الإعلانات في جميع عمليات دمج ميزة "إدراج الإعلان ديناميكيًا"، مثل ما يلي:
- التحقّق من إنشاء جلسة بث: تأكَّد من المَعلمات ووضع الدمج
STITCHEDأوPOD_SERVINGووضع إعداد التقارير والبيانات الوصفية للمحتوى التي تتلقّاها ميزة "إدراج الإعلان الديناميكي" في Google عند إنشاء بث مباشر أو جلسة فيديو عند الطلب. - تدقيق طلبات عرض الإعلانات واستجاباتها: يمكنك فحص علامات إعلانات "نموذج عرض إعلانات الفيديو" (VAST) و"قائمة تشغيل إعلانات الفيديو المتعددة" (VMAP) الصادرة، ورموز حالة HTTP، وأوقات استجابة الخادم، ونصوص استجابة XML الأولية، وسلاسل إعادة التوجيه المجمّعة.
- تحديد المشاكل وحلّها في ما يتعلّق باتخاذ القرارات بشأن مجموعات الإعلانات المتسلسلة ومواد الإعلان الإبداعية: يمكنك التحقّق من الإعلانات التي تختارها أو تسقطها ميزة "إدراج الإعلان الديناميكي" من Google لكل مجموعة إعلانات متسلسلة، ومدة كل إعلان في المجموعة، ونظام الإعلانات المصدر لمواد الإعلان الإبداعية.
- تتبُّع تنفيذ الجلب المُسبق للإعلانات: يمكنك تحديد ما إذا كانت ميزة "إدراج الإعلان الديناميكي" من Google تجلب مسبقًا مجموعة إعلانات متسلسلة، والاطّلاع على مرحلة الجلب المُسبق لكل مجموعة إعلانات متسلسلة.
- التحقّق من صحة طلبات البيانات من واجهة برمجة التطبيقات الخاصة بفواصل الإعلانات في ميزة "إدراج إعلان ديناميكي" وطلبات البيانات من واجهة برمجة التطبيقات الخاصة بعرض مجموعات الإعلانات في ميزة "إدراج إعلان ديناميكي": يمكنك التحقّق من التنفيذ الفعلي للفواصل الإعلانية ومُدد الإعلانات المعروضة ومُدد اللوحات المُدرَجة مقارنةً بطلبات البيانات من واجهة برمجة التطبيقات، مثل واجهة برمجة التطبيقات الخاصة بفواصل الإعلانات في ميزة "إدراج إعلان ديناميكي" وواجهة برمجة التطبيقات الخاصة بعرض مجموعات الإعلانات في ميزة "إدراج إعلان ديناميكي".
- التحقّق من تتبُّع أحداث الإعلانات: تأكَّد من نجاح إشعارات التتبُّع من جهة العميل أو من جهة الخادم وافحص استجابات HTTP من خوادم الإعلانات.
- أتمِتة مراقبة الجلسات والتنبيهات: يمكنك تحليل إدخالات النتائج المنظَّمة التي تتضمّن مستوى الخطورة
INFOأوWARNINGأوERRORلرصد مشاكل التشغيل أو تحقيق الربح في اختبارات الدمج الآلية ومسارات مراقبة الإنتاج.
التعرّف على المرجع ذي المستوى الأعلى
تُعدّ واجهة SAM API جزءًا من واجهة REST API في "مدير إعلانات Google" (إصدار تجريبي) على نقطة النهاية admanager.googleapis.com، وتكشف عن طريقة القراءة فقط networks.daiSessions.get. يمكنك الاستعلام عن مورد DaiSession
باستخدام معرّف جلسة إدراج الإعلانات الديناميكية أو مفتاح تصحيح أخطاء مخصّص. تحتفظ ميزة "إدراج الإعلان الديناميكي" بسجلّات الجلسات لمدة تصل إلى ثلاثة أيام بعد التشغيل.
لا تتيح واجهة برمجة التطبيقات SAM API إدراج جميع موارد "DaiSession" في شبكة "إدارة إعلانات Google".
فحص استجابات بث "إدراج الإعلان الديناميكي" باستخدام SAM
للتحقّق من كيفية معالجة ميزة "إدراج الإعلان الديناميكي" من Google لطلبات البث، يمكنك فحص استجابة DaiSession:
- واجهة برمجة تطبيقات DAI للخدمة الكاملة: افحص الحقل
creationContext.streamCreateRequestللتحقّق من طلب تسجيل البث، وتحقّق من خريطتَيadSelectionsوadPodsلمراجعة عملية اتخاذ القرار بشأن الإعلانات، وافحص الخريطةadBreaksللتأكّد من مُدد الإعلانات المدمجة وتصاميم الإعلانات الثابتة والمحتوى الأساسي. - واجهة برمجة التطبيقات لعرض الإعلانات في مجموعات متتالية (DAI): تأكَّد من ضبط الحقل
creationContext.stitchingTypeعلى القيمةPOD_SERVING، وتحقَّق من الحقلadBreakIdفي الخريطتَينadPodsوadBreaksباستخدام طلبات بيان المجموعة المتتالية أو طلبات شرائح المجموعة المتتالية، وافحص إشارات التحقّق من الوسائط أو من جهة الخادم في الخريطةtrackingPings. - واجهة برمجة التطبيقات DAI Ad Break API: يمكنك مطابقة قيمة
breakSequenceلعنصرAdBreakمع السمةAdBreak.breakSequence.
تقديم طلبك الأول
لإعداد المصادقة واسترداد موارد جلسات إدراج الإعلان الديناميكي، يُرجى الاطّلاع على استخدام واجهة أداة مراقبة نشاط البث API.