آشنایی با Stream Activity Monitor API

بااستفاده از میانای برنامه‌سازی کاربردی (API) «پایشگر فعالیت جاری‌سازی» (SAM) «درج آگهی پویا» (DAI) می‌توانید جلسه‌های مشاهده ویدیو به‌درخواست (VOD) و جاری‌سازی زنده را به‌صورت جداگانه بازرسی و عیب‌یابی کنید.

برای بازرسی بصری و عیب‌یابی یک جلسه مشاهده جاری‌سازی زنده یا ویدیو به‌درخواست، از پایشگر فعالیت جاری‌سازی در میانای کاربر Google Ad Manager استفاده کنید. برای بازیابی برنامه‌ریزی‌شده داده‌های عیب‌یابی برای یک جلسه، از منبع Ad Manager API networks.daiSessions استفاده کنید.

درک موارد استفاده

با SAM API، می‌توانید عیب‌یابی جاری‌سازی را خودکار کنید و مشکلات ارائه آگهی را در ادغام‌های DAI خود حل کنید، مانند موارد زیر:

  • تأیید ایجاد جلسه جاری‌سازی: پارامترها، حالت اتصال STITCHED یا POD_SERVING، حالت گزارش‌دهی، و فراداده محتوا را که Google DAI هنگام ایجاد جلسه جاری‌سازی زنده یا ویدیو به‌درخواست دریافت می‌کند تأیید کنید.
  • بازرسی درخواست‌ها و پاسخ‌های آگهی: برچسب‌های آگهی خروجی «الگوی سرویس‌دهی آگهی ویدیویی» (VAST) و «فهرست پخش چندآگهی ویدیویی» (VMAP)، کدهای وضعیت HTTP، تأخیرهای پاسخ، بدنه پاسخ XML خام، و زنجیره‌های تغییرمسیر پوشاننده را بازرسی کنید.
  • عیب‌یابی تصمیم‌گیری و طرح‌آگهی‌های دسته آگهی: بررسی کنید که Google DAI کدام آگهی‌ها را برای هر دسته انتخاب یا حذف می‌کند، مدت‌زمان هر آگهی در دسته، و سیستم آگهی منبع طرح‌آگهی.
  • ردگیری اجرای پیش‌واکشی آگهی: تعیین کنید که آیا Google DAI یک دسته آگهی را پیش‌واکشی می‌کند یا نه و مرحله پیش‌واکشی هر دسته آگهی را بررسی کنید.
  • اعتبارسنجی فراخوانی‌های میانای برنامه‌سازی کاربردی وقفه آگهی DAI و میانای برنامه‌سازی کاربردی DAI ارائه‌دهنده Pod: اجرای وقفه واقعی، مدت آگهی‌های ارائه‌شده، و مدت لوح‌های درج‌شده را درمقابل فراخوانی‌های میانای برنامه‌سازی کاربردی، مانند میانای برنامه‌سازی کاربردی وقفه آگهی DAI و میانای برنامه‌سازی کاربردی DAI ارائه‌دهنده Pod، بررسی کنید.
  • درستی‌سنجی کردن ردگیری رویداد آگهی: تأیید کنید که پینگ‌های ردگیری سمت کارخواه یا سمت سرور موفقیت‌آمیز بوده‌اند و پاسخ‌های HTTP را از سرورهای آگهی بررسی کنید.
  • خودکارسازی پایش جلسه و هشدار: ورودی‌های یافته‌های ساختاریافته را با شدت INFO، WARNING، یا ERROR تجزیه کنید تا مشکلات بازپخش یا درآمدزایی را در آزمایش‌های ادغام خودکار و خطوط پایش تولید شناسایی کنید.

آشنایی با منبع سطح بالا

SAM API بخشی از Google Ad Manager REST API (نسخه بتا) در نقطه پایانی admanager.googleapis.com است و روش فقط‌خواندنی networks.daiSessions.get را نشان می‌دهد. می‌توانید منبع DaiSession را با شناسه جلسه درج آگهی پویا یا کلید اشکال‌زدایی سفارشی پُرسمان کنید. DAI سوابق جلسه را تا سه روز پس‌از بازپخش نگه می‌دارد.

‫SAM API از فهرست کردن همه منابع DaiSession در شبکه Google Ad Manager پشتیبانی نمی‌کند.

بازرسی پاسخ‌های جاری‌سازی DAI با SAM

برای درستی‌سنجی نحوه پردازش درخواست‌های جاری‌سازی شما توسط Google DAI، پاسخ DaiSession را بررسی کنید:

  • میانای برنامه‌سازی کاربردی DAI با خدمات کامل: فیلد creationContext.streamCreateRequest را بررسی کنید تا تماس ثبت جاری‌سازی را تأیید کنید، نقشه‌های adSelections و adPods را بررسی کنید تا تصمیم‌گیری آگهی را بازبینی کنید، و نقشه adBreaks را بررسی کنید تا آگهی ادغام‌شده، طرح آگهی لوح، و مدت زمان محتوای زیرین را تأیید کنید.
  • Pod serving DAI API: Confirm that the creationContext.stitchingType field is set to the POD_SERVING value, cross-check the adBreakId field in the adPods and adBreaks maps with your pod manifest or pod segment request calls, and inspect server-side or media-verification beacons in the trackingPings map.
  • DAI Ad Break API: مقدار breakSequence شیء AdBreak را با ویژگی AdBreak.breakSequence مطابقت دهید.

اولین درخواستتان را ارسال کنید

برای راه‌اندازی اصالت‌سنجی و بازیابی منابع جلسه DAI، استفاده از Stream Activity Monitor API را ببینید.