پرسش‌های متداول را درگیر SDK کنید

سوالات متداول را منتشر کنید

چه کسی کار انتشار محتوا را مدیریت می‌کند؟

توسعه‌دهنده‌ی برنامه، کار انتشار محتوا را مدیریت کرده و درخواست‌ها را به سرویس Engage ارسال می‌کند. به این ترتیب، شرکای توسعه‌دهنده کنترل بیشتری بر زمان و نحوه‌ی انتشار محتوا برای کاربران دارند. این امر از بیدار شدن مکرر برنامه‌ی همکار برای انتشار محتوا جلوگیری می‌کند.

آیا یک توسعه‌دهنده نیاز دارد که همه انواع خوشه‌ها را منتشر کند؟

اگرچه از نظر فنی، توسعه‌دهندگان می‌توانند فقط یک خوشه منتشر کنند، اما اکیداً توصیه می‌کنیم تعداد بیشتری را در نظر بگیرید. در غیر این صورت، توسعه‌دهندگان فرصت ایجاد تعامل بهتر با محتوای خود را از دست می‌دهند. ما اکیداً توصیه می‌کنیم که برای هر بخش، همه انواع خوشه‌ها را منتشر کنید.

شریک توسعه‌دهنده در حین اجرای برنامه، چند وقت یکبار باید داده‌ها را با استفاده از مدیر کار منتشر کند؟

این موضوع باید توسط شریک توسعه‌دهنده تعیین شود. گوگل توصیه می‌کند که برای محتوای توصیه‌های عمومی، یک یا دو بار در روز منتشر شود و از یک روش مبتنی بر رویداد برای سبد خرید، سفارش مجدد و سایر محتوای ادامه‌دار استفاده شود (برای مثال، worker را به عنوان فراخوانی برای اضافه کردن اقلام به سبد خرید توسط کاربر یا متوقف کردن فیلم توسط کاربر در نیمه راه شروع کنید). برای برنامه‌های اجتماعی ، انتشار خوشه‌های توصیه به‌روز شده پس از هر بار استفاده از برنامه بسیار مهم است. کاربران برنامه‌های اجتماعی بیشتر به جدیدترین توصیه‌ها علاقه‌مند هستند و در حالت ایده‌آل دوست دارند حداکثر یک بار یک پست را ببینند.

چه زمانی توسعه‌دهنده باید APIهای حذف را فراخوانی کند؟

APIهای Delete فقط باید زمانی فراخوانی شوند که محتوایی برای انتشار وجود ندارد. APIهای delete و publish را متعاقباً برای جایگزینی محتوا فراخوانی نکنید ؛ APIهای publish محتوای قبلی را به طور خودکار حذف می‌کنند.

سوالات متداول در مورد قصد پخش

چرا توسعه‌دهندگان برنامه‌های اندروید باید برای broadcast intents ثبت‌نام کنند؟

برای ارائه محتوای تازه به کاربر، باید از اهداف پخش (broadcast intents) برای راه‌اندازی همگام‌سازی داده‌ها در مواردی که کاربران ممکن است مرتباً از برنامه استفاده نکنند، استفاده کنید.

آزمایش قصد پخش امکان‌پذیر نیست

برنامه‌ی تأیید از آزمایش قصد پخش با مجوز پشتیبانی نمی‌کند. شما باید هنگام آزمایش، مجوزها را حذف کنید و قبل از تغییر نسخه SDK به نسخه prod در مرحله‌ی 6 ، دوباره آنها را اضافه کنید.

اجرای پس‌زمینه مجاز نیست

هنگام ثبت قصد پخش، ممکن است با خطای زیر مواجه شوید:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

شما باید گیرنده‌های پخش را به صورت پویا ثبت کنید.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

سوالات متداول گردش کار

هنگام ادغام با SDK، ممکن است با خطاهای زیر مواجه شوید:

خطاهای اعتبارسنجی در سطح برنامه، خوشه، موجودیت

خلاصه‌ها در سطوح برنامه، خوشه و موجودیت، تعداد خطاهای اعتبارسنجی را نشان می‌دهند. این خطاها مربوط به فیلدهای الزامی از دست رفته یا مقادیر نامعتبر ارائه شده هستند. پیام‌های خطا با رنگ قرمز در زیر هر فیلد مربوطه نشان داده می‌شوند. قبل از به اشتراک گذاشتن APK، تمام خطاهای اعتبارسنجی را برطرف کرده و صحت آنها را بررسی کنید.

لینک‌های عمیق با نام بسته مرتبط هستند. یک راه خوب برای آزمایش لینک‌های عمیق، استفاده از ابزار adb است.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

لینک‌های عمیق راهی عالی برای ردیابی انتساب هستند. URLهای لینک‌های عمیق که کاربران را به برنامه شما هدایت می‌کنند، می‌توانند با پارامترهای ردیابی اضافی گنجانده شوند. به عنوان مثال - "http://xx/deeplink?source_tag=engage".

توسعه‌دهندگان می‌توانند پارامترهای ردیابی خود را اضافه کنند و برای محاسبه تأثیر، نسبت‌دهی ارائه دهند.

سوالات متداول در مورد تعامل با تلویزیون ۲.۰

سوالات عمومی

تعامل چیست؟

Engage تجربه «ادامه از جایی که رها کرده‌اید» را به سطح بالاتری می‌برد! این یک ارتقاء قابل توجه است که به بینندگان اجازه می‌دهد محتوای خود را به طور یکپارچه در طیف وسیع‌تری از دستگاه‌ها از سر بگیرند. تصور کنید که یک فیلم را در Google TV خود شروع می‌کنید و سپس به راحتی آن را در تلفن خود در طول رفت و آمد خود ادامه می‌دهید - این قدرت Engage است.

این سیستم جدید به گونه‌ای طراحی شده است که با ارائه یک تجربه روان و بدون مشکل در کل اکوسیستم گوگل، تعامل و حفظ بیننده را افزایش دهد.

آیا API مربوط به Video Discovery همان Engage است؟

بله، آنها یکسان هستند. Engage SDK کتابخانه‌ای است که از ردیف «ادامه تماشا» پشتیبانی می‌کند. Engage از انواع موجودیت‌های محتوایی بیشتری نسبت به ویدیو پشتیبانی می‌کند، به همین دلیل است که این ادغام دیگر «کشف ویدیو» نامگذاری نشده است.

مزایای استفاده از Engage چیست؟

پاسخ: قابلیت Engage باعث می‌شود بینندگان راحت‌تر از همیشه بتوانند محتوای شما را از جایی که متوقف شده‌اند، ادامه دهند، صرف نظر از اینکه از چه دستگاهی استفاده می‌کنند. نحوه‌ی کار آن به این صورت است:

  • تجربه‌ای یکپارچه در سراسر گوگل: شروع به تماشا در گوگل تی‌وی خود کنید و به طور یکپارچه در تلفن اندروید، آیفون یا تبلت اندروید خود ادامه دهید. این برنامه حتی روی دستگاه‌هایی که هنوز برنامه را روی آنها نصب نکرده‌اید نیز کار می‌کند!
  • افزایش تعامل و ماندگاری: تعامل به بازگرداندن کاربران به برنامه شما، حتی در دستگاه‌های جدید، کمک می‌کند. با اجازه دادن به کاربران برای از سرگیری برنامه‌های مورد علاقه‌شان، شانس آنها را برای تماشای مداوم برنامه افزایش می‌دهید.
  • دسترسی گسترده‌تر: فراتر از گوگل تی‌وی، Engage در سایر تجربیات رسانه‌ای اندروید، مانند Play Collections و سایر برنامه‌های رسانه‌ای گوگل، نیز کار می‌کند.
  • سازگار با نسخه‌های قبلی: اگر از قبل از ویژگی قدیمی‌تر « مشاهده بعدی » استفاده می‌کنید، مشکلی نیست! Engage با نسخه‌های قبلی سازگار است، بنابراین ادغام فعلی شما همچنان کار خواهد کرد.

نکته مهم: همه ادغام‌های جدید Continue Watching باید از Engage استفاده کنند. سیستم قدیمی‌تر «Cross Device Play Next» در حال حذف شدن است.

چه سطوحی از Engage پشتیبانی می‌کنند؟

  1. گوگل تی‌وی
  2. اندروید تی‌وی (فقط روی دستگاه اما از Engage SDK پشتیبانی می‌کند)
  3. اپلیکیشن موبایل گوگل تی‌وی اندروید
  4. اپلیکیشن موبایل گوگل تی‌وی برای iOS
  5. مجموعه‌های بازی
  6. فضای سرگرمی گوگل
  7. دستگاه‌های iOS (با ادغام REST API).

آیا Engage SDK برای ادامه تماشا وجود دارد؟

بله، Engage SDK از محتوای ردیف «ادامه تماشا» پشتیبانی می‌کند. این مورد برای ادغام با Engage لازم است.

آیا Engage برای همه در دسترس است؟

Engage به صورت مرحله‌ای در حال اجرا است.

  • دسترسی زودهنگام: ما در ابتدا از طریق یک برنامه دسترسی زودهنگام (EAP) به گروه منتخبی از شرکا دسترسی می‌دهیم.
  • گسترش دسترسی: ما سخت تلاش می‌کنیم تا به‌زودی Engage را در دسترس همه توسعه‌دهندگان قرار دهیم.

برای یک راه‌اندازی روان و موفق، ما تمهیدات امنیتی لازم را برای مدیریت انتشار در نظر گرفته‌ایم. این شامل یک لیست مجوز در سمت Engage و یک بررسی جداگانه در Engage SDK می‌شود. چه شریک EAP باشید و چه بخواهید به زودی به این مجموعه بپیوندید، لطفاً با ما تماس بگیرید تا بتوانیم مجوزهای دسترسی را قبل از شروع ادغام Engage SDK تنظیم کنیم.

الزامات تصویر در بخش ایجاد موجودیت‌ها به‌روزرسانی شده است.

با این مستندات API جدید، آیا داده‌های Continue Watching توسط سرور گوگل از کلاینت گرفته می‌شود و در تمام دستگاه‌ها منعکس خواهد شد؟

API جدید بهبودهای قابل توجهی را برای محتوای ردیف «ادامه تماشا» ارائه می‌دهد، از جمله:

  • تجربه یکپارچه در تلویزیون‌های گوگل: کاربران می‌توانند شروع به تماشا در یک تلویزیون گوگل کنند و در هر تلویزیون گوگل دیگری که با همان حساب کاربری وارد سیستم شده است، ادامه دهند. این ویژگی با نسخه‌های قدیمی‌تر تلویزیون اندروید نیز کار می‌کند.

  • ادغام با اپلیکیشن موبایل: محتوای Engage در اپلیکیشن موبایل گوگل تی‌وی برای اندروید و iOS نمایش داده می‌شود و به کاربران امکان می‌دهد به راحتی بین تلویزیون و دستگاه‌های موبایل خود جابجا شوند.

  • افزایش ماندگاری کاربر: حتی در دستگاه‌هایی که برنامه نصب نشده یا کاربر وارد سیستم نشده است، محتوای موجود در ردیف «ادامه تماشا» کاربران را به تعامل مجدد با برنامه شما تشویق می‌کند و باعث افزایش ماندگاری می‌شود.

  • گسترش به پلتفرم‌های دیگر: Engage به سایر پلتفرم‌های رسانه‌ای گوگل مانند اندروید، Play Collections، تبلت‌ها و سایر برنامه‌ها و سطوح رسانه‌ای گوگل در اندروید گسترش می‌یابد و تعامل کاربر را در بین دستگاه‌ها به حداکثر می‌رساند.

محدودیت تعداد موجودیت‌هایی که می‌توانم در خوشه Continuation منتشر کنم، چقدر است؟

هر شریک توسعه‌دهنده به حداکثر ۵ نهاد در خوشه Continuation محدود شده است. این محدودیت برای توزیع منصفانه محتوا در ردیف "ادامه تماشا" در Google TV است که یک فضای مشترک برای چندین ارائه‌دهنده رسانه است.

اگر سعی کنم بیش از ۵ موجودیت منتشر کنم چه اتفاقی می‌افتد؟

اگر تعداد موجودیت‌ها از حد مجاز ۵ فراتر رود، Engage SDK درخواست انتشار شما را رد می‌کند. برای انتشار موفقیت‌آمیز، باید تعداد موجودیت‌ها را در درخواست خود کاهش دهید. شما فقط باید موجودیت‌هایی را که کاربران از تماشای آنها صرف نظر کرده‌اند، لحاظ کنید، بنابراین در بیشتر موارد، فقط تعداد کمی از این موجودیت‌ها وجود خواهد داشت. وقتی بیش از ۵ موجودیت از این نوع وجود دارد، می‌توانید جدیدترین‌ها را برای انتشار انتخاب کنید.

چرا محدودیت تعداد نهادها وجود دارد؟

ردیف «ادامه تماشا» در گوگل تی‌وی، محتوا را از ارائه‌دهندگان مختلف رسانه نمایش می‌دهد. محدود کردن تعداد نهادها در هر ارائه‌دهنده به گونه‌ای که کاربران بتوانند مجموعه متنوعی از محتوا را از همه منابع مورد علاقه خود مشاهده کنند و یک تجربه کاربری منصفانه و متعادل را ارتقا دهند.

سوالات مربوط به برنامه تأیید

آیا آزمایش برنامه‌ام با برنامه تأیید صحت قبل از ارسال اجباری است؟

بله، آزمایش برنامه شما با برنامه تأیید صحت قبل از ارسال APK ضروری است.

اگرچه درک می‌کنیم که ممکن است به پیاده‌سازی خود اطمینان داشته باشید، اما یکپارچه‌سازی Engage اجزای پیچیده‌ی زیادی دارد. برنامه‌ی تأیید هویت به عنوان یک شبکه‌ی ایمنی عمل می‌کند، مشکلات احتمالی را در مراحل اولیه شناسایی می‌کند و در درازمدت در زمان و تلاش ارزشمند شما صرفه‌جویی می‌کند.

به آن به عنوان یک بررسی سریع فکر کنید که به تضمین راه‌اندازی روان و یک تجربه کاربری عالی کمک می‌کند.

با شناسایی و رسیدگی به هرگونه مشکل از قبل، می‌توانید از ناامیدی ناشی از رد شدن و ارسال مجدد اجتناب کنید.

برای ارسال APK خود، باید یک اسکرین‌شات از برنامه خود ارسال کنید که نشان دهد برنامه شما مراحل تأیید را با موفقیت پشت سر گذاشته است.

اشتباهات رایجی که باید در طول ادغام مراقب آنها باشید چیست؟

این اپلیکیشن تأیید هویت به گونه‌ای طراحی شده است که مشکلات احتمالی مربوط به ادغام Engage شما را شناسایی کند. در اینجا چند اشتباه رایج که توسعه‌دهندگان اغلب با آن مواجه می‌شوند، آورده شده است:

برای همه انواع محتوا (فیلم، سریال تلویزیونی، پخش زنده، کلیپ ویدیویی):

  • پیوندهای گمشده: مطمئن شوید که URI های (لینک های) معتبر مختص پلتفرم را برای محتوای خود ارائه می‌دهید. این پیوندها به سیستم می‌گویند که محتوای شما را در هر پلتفرم کجا پیدا کند.
  • عنوان‌های از قلم افتاده: فراموش نکنید که برای تمام محتوای خود عنوان قرار دهید. این به کاربران کمک می‌کند تا آنچه را که تماشا می‌کردند، شناسایی کنند.
  • نسبت ابعاد تصویر: بررسی کنید که تمام تصاویر مرتبط با محتوای شما نسبت ابعادی نزدیک به ۱۶:۹ داشته باشند. این کار تضمین می‌کند که تصاویر شما در صفحه نمایش‌های مختلف به درستی نمایش داده می‌شوند.

برای قسمت‌های تلویزیونی:

  • اطلاعات کامل قسمت: حتماً عنوان سریال، شماره قسمت و شماره فصل را ذکر کنید. این به سازماندهی قسمت‌ها کمک می‌کند و به کاربران اجازه می‌دهد تا در یک مجموعه حرکت کنند.
  • موقعیت پخش دقیق: دوباره بررسی کنید که آخرین موقعیت پخش کمتر یا مساوی کل مدت زمان قسمت باشد. این کار باعث می‌شود کاربران از نقطه صحیح پخش را از سر بگیرند.

برای فیلم‌ها:

  • موقعیت پخش دقیق: مشابه قسمت‌های تلویزیونی، از دقیق بودن آخرین موقعیت پخش اطمینان حاصل کنید.

برای ویدیوهای پخش زنده:

  • اطلاعات پخش‌کننده: نام پخش‌کننده را برای پخش زنده وارد کنید.

برای کلیپ‌های ویدیویی:

  • اطلاعات سازنده: سازنده کلیپ ویدیویی را مشخص کنید.

به یاد داشته باشید: برنامه تأیید، این مشکلات را علامت‌گذاری می‌کند و به شما امکان می‌دهد قبل از ارسال برنامه خود، آنها را برطرف کنید. این باعث صرفه‌جویی در وقت شما می‌شود و تجربه‌ای روان‌تر را برای کاربران شما تضمین می‌کند.

سوالات مربوط به حساب کاربری و پروفایل

برنامه من از ورود کاربران ناشناس استفاده می‌کند. آیا AccountProfile هنوز برای Engage لازم است؟

AccountProfile برای برنامه‌هایی طراحی شده است که از حساب‌های کاربری شخصی استفاده می‌کنند. با این حال، ما درک می‌کنیم که برخی از برنامه‌ها، مانند برنامه شما، ممکن است به ورودهای ناشناس متکی باشند. در اینجا نحوه عملکرد Engage در این سناریو آمده است:

  • AccountProfile از نظر فنی مورد نیاز است، اما حتی اگر برنامه شما سیستم حساب کاربری نداشته باشد، می‌توانید Engage را ادغام کنید.
  • محدود به استفاده روی دستگاه: قابلیت‌های بین دستگاهی Engage به شناسایی کاربران در دستگاه‌های مختلف متکی است. از آنجایی که ورود ناشناس این امکان را فراهم نمی‌کند، این ویژگی به دستگاه فعلی کاربر محدود خواهد شد.
  • نحوه پیکربندی: برای تنظیم این مورد، باید همگام‌سازی بین دستگاه‌ها را غیرفعال کنید. این کار تضمین می‌کند که ورودی‌های ادامه فقط در دستگاه خاصی که محتوا از آنجا شروع شده است، ظاهر می‌شوند.

خلاصه: اگرچه می‌توانید Engage را با ورودهای ناشناس ادغام کنید، کاربران فقط می‌توانند محتوا را در همان دستگاه از سر بگیرند.

آیا می‌توانم از AccountProfile فقط با accountId و بدون profileId استفاده کنم، حتی وقتی برنامه من از accountId و profileId پشتیبانی می‌کند؟

AccountProfile برای عملکرد صحیح به هر دو accountId و profileId نیاز دارد. دلیل آن به شرح زیر است:

  • شناسایی یکپارچه: accountId کاربر را شناسایی می‌کند، در حالی که profileId بین پروفایل‌های مختلف درون حساب آن کاربر (در صورت وجود) تمایز قائل می‌شود. ارائه هر دو تضمین می‌کند که Engage به طور دقیق محتوای هر پروفایل را ردیابی و نمایش می‌دهد.
  • جلوگیری از خطاها: استفاده‌ی ناهماهنگ از accountId و profileId در فراخوانی‌های مختلف API می‌تواند منجر به رفتار و خطاهای غیرمنتظره شود. برای مثال، اگر هنگام اضافه کردن محتوا به Engage هر دو را وارد کنید اما هنگام حذف محتوا فقط accountId استفاده کنید، ممکن است سیستم نتواند موارد مورد نظر را به درستی شناسایی و حذف کند.

آیا برای Engage profileId نیاز است؟

  • accountId الزامی است. این شناسه، کاربر را در بین دستگاه‌ها شناسایی می‌کند.
  • profileId برای یک تجربه کاربری خوب بسیار مهم است. اگرچه از نظر فنی اختیاری است، اما اگر سرویس شما از چندین پروفایل پشتیبانی می‌کند (مانند بسیاری از سرویس‌های پخش جریانی)، profileId اکیداً توصیه می‌شود. چرا اینقدر مهم است؟ زیرا بدون profileId ، ردیف ادامه تماشا ممکن است محتوای سایر پروفایل‌ها را در همان حساب نشان دهد. این می‌تواند منجر به یک تجربه گیج‌کننده و ناامیدکننده برای کاربران شما شود.
  • به طور خلاصه: ارائه profileId تضمین می‌کند که محتوای ارائه شده به ردیف «ادامه تماشا» به طور دقیق سابقه مشاهده هر فرد را منعکس می‌کند. مگر اینکه برنامه شما از مفهوم پروفایل در یک حساب پشتیبانی نکند، باید آن را ارائه دهید.

گوگل چگونه از profileId در سمت خود استفاده می‌کند؟

اگر سرویس، پروفایل‌های مختلفی برای تماشای محتوا ارائه دهد، accountId و profileId برای مرتبط کردن محتوای تماشا شده در دستگاه با حساب گوگل وارد شده در دستگاه استفاده می‌شود. گوگل داده‌های ContinueWatching را در مقابل ترکیبی از accountId و profileId ثبت می‌کند. هر دستگاه گوگلی که همان حساب گوگل را در آن وارد کرده باشد، آخرین داده‌های به‌روز شده را از همان accountId و profileId مرتبط، در ردیف ContinueWatching خود دریافت می‌کند.

آیا لینک کردن حساب کاربری برای پیاده‌سازی Engage الزامی است؟

اتصال حساب کاربری ضروری نیست. این قابلیت در حال حذف اولویت است و تمام موارد استفاده مرتبط توسط API جدید Device Entitlements پوشش داده خواهد شد.

سوالات مربوط به همگام‌سازی بین دستگاه‌ها

با رضایت کاربر در «همگام‌سازی بین دستگاه‌ها»، محتوایی که تماشا می‌کنند در سرورهای گوگل تی‌وی ذخیره می‌شود و به آنها اجازه می‌دهد تا به طور یکپارچه از جایی که متوقف شده‌اند، در هر دستگاهی که به آن وارد شده‌اند، ادامه دهند. بدون رضایت، تاریخچه تماشای آنها به صورت محلی در دستگاه فعلی باقی می‌ماند.

آیا می‌توانیم «همگام‌سازی بین دستگاه‌ها» را روی نادرست تنظیم کنیم؟

پرچم setUserConsentToSyncAcrossDevices کنترل می‌کند که آیا داده‌های ContinuationCluster کاربر در دستگاه‌های او (تلویزیون، تلفن، تبلت و غیره) همگام‌سازی شود یا خیر. اگر این پرچم روی false تنظیم شود، محتوای «ادامه تماشای» فقط در همان دستگاه نمایش داده می‌شود.

برای بهره‌مندی هرچه بیشتر از قابلیت چنددستگاهی ما، اکیداً به برنامه شما توصیه می‌کنیم که رضایت کاربر را دریافت کرده و SyncAcrossDevices را روی true تنظیم کند.

چه نقاط داده‌ای از دستگاه‌های غیراندرویدی با سرورهای شخص ثالث به اشتراک گذاشته می‌شوند؟

رضایت در سطح کاربر (سطح پروفایل یا حساب کاربری) جمع‌آوری می‌شود. پس از اخذ رضایت، می‌توان بسته‌های اطلاعاتی مربوط به ادامه تماشای ویدیو را بر اساس تعامل به هر جایی ارسال کرد تا گوگل بتواند وضعیت از سرگیری حضور فراگیر کاربران را در تمام موجودیت‌هایی که با آنها تعامل جزئی یا بعدی دارند، در هر دستگاهی (بدون نیاز به درخواست مجدد رضایت در هر دستگاه یا پلتفرمی) منعکس کند. شرکا آخرین وضعیت ادامه تماشای ویدیو (مطابق مشخصات) مرتبط با شناسه پروفایل (که در اندروید ثبت شده است) را برای کاربران ارسال خواهند کرد.

سوالات مربوط به REST API

آیا مستنداتی در مورد REST API وجود دارد؟

زمان تقریبی انتشار REST API مارس ۲۰۲۵ است، این موضوع در مستندات توسعه‌دهندگان Engage ثبت شده است.

سوالات بعدی ساعت قدیمی

آیا Engage جایگزین Watch Next API می‌شود؟

Engage با تمام دستگاه‌های اندروید تی‌وی که از Watch Next API پشتیبانی می‌کنند، سازگار خواهد بود. برای ادغام در گوگل تی‌وی و سایر سطوحی که از Engage پشتیبانی می‌کنند، توسعه‌دهندگان باید از Engage SDK استفاده کنند.

سوالات تست و ادغام

تفاوت بین LastPlayBackPositionTimeMillis و duration چیست؟

LastPlayBackPositionTimeMillis باید مدت زمان پخش را بر حسب میلی‌ثانیه، جایی که کاربر تماشای آن را متوقف کرده است، نشان دهد (مثلاً ۶۰۵۰۰۰ میلی‌ثانیه برای ۱۰ دقیقه و ۵ ثانیه). این مدت زمان هرگز نباید از کل مدت زمان موجودیت بیشتر باشد.

در حالی که، LastEngagementTime نشانگر زمانی است که کاربر آخرین بار با محتوا تعامل داشته است.

چه موارد آزمایشی باید انجام دهیم؟

موارد زیر نمونه‌های آزمایشی هستند که تیم تضمین کیفیت ما برای گوگل تی‌وی انجام می‌دهد. نمونه‌های آزمایشی مشابه را می‌توان روی سطوح دیگر نیز انجام داد.

  1. یک ویدیو که بیشتر از ۲۰ دقیقه است را حدود ۵ دقیقه تماشا کنید. از برنامه خارج شوید. کارت ویدیو باید در ردیف «ادامه تماشا» نمایش داده شود. توجه: ما فقط ۵ کارت را در هر برنامه ۳p در CW نمایش می‌دهیم.
  2. با انتخاب کارت جدید ظاهر شده در ردیف «ادامه تماشا»، پخش ویدیو از نقطه صحیح در ویدیو ادامه می‌یابد. توجه: هر محتوای جدید یا قدیمی باید پخش را از جایی که آخرین بار متوقف شده بود، از سر بگیرد.
  3. تغییر حساب‌ها در دستگاه GTV باید کارت‌های ردیف «ادامه تماشا» را تغییر دهد. فقط ویدیوهای حساب فعلی باید نمایش داده شوند. به ترتیب اخیر مرتب شده‌اند. CW ​​پروفایل برنامه 3p با هم ترکیب خواهد شد. توجه: CW برای GoogleAccount2، محتوای 3P را که GoogleAccount2 مشغول تماشای آنها بوده است، نشان می‌دهد.
  4. با دکمه برگشت از برنامه خارج شوید > کارت تأیید در ردیف «ادامه تماشا» نمایش داده می‌شود
  5. ویدیو را در ردیف «ادامه تماشا» پنهان کنید، نباید دوباره نمایش داده شود. بررسی کنید که آیا محتوای پنهان‌شده بیش از ۲۴ ساعت و حتی پس از باز شدن برنامه پس از ۲۴ ساعت پنهان می‌ماند یا خیر. تأیید کنید که پنهان کردن یک مورد، چندین مورد را پنهان نمی‌کند.
  6. در دسترس بودن محتوا در ردیف «ادامه تماشا» با ابرداده کامل: تصویر کارت، نام برنامه، عنوان، شماره قسمت فصل برای محتوای تلویزیونی
  7. نمایش پیشرفت در نوار پیشرفت را بررسی کنید
  8. کاربر محتوا را تا پایان تیتراژ تماشا کرد - محتوا در ردیف «ادامه تماشا» نمایش داده نمی‌شود
  9. تأیید کنید که هیچ مورد مشاهده نشده‌ای در ردیف «ادامه مشاهده» نمایش داده نشود
  10. تأیید کنید که موارد CW به ترتیب زمانی بر اساس زمان وقوع فعالیت ساعت مرتب شده‌اند و نه بر اساس آخرین باز شدن برنامه یا آخرین روز.
  11. تأیید کنید که جزئیات قسمت و فصل در کارت CW با آنچه در محتوای اپیزودیک تماشا شده است مطابقت دارد
  12. موارد تکمیل‌شده (موارد در قسمت اعتبارات یا فراتر از آن) را تأیید کنید، موارد در ردیف ادامه تماشا نمایش داده نمی‌شوند
  13. در اواسط تماشای قسمت/فیلم/نمایش، دستگاه را خاموش کنید. "در اواسط تماشای قسمت/فیلم/نمایش، دستگاه را خاموش کنید. با روشن کردن دستگاه و تلویزیون دیگر، تأیید کنید که CW کارت درست را در موقعیت درست و نوار پیشرفت نمایش می‌دهد."
  14. بعد از تماشای کامل قسمت ۱، دستگاه را خاموش کنید و بررسی کنید
  15. قسمت ۱ پخش نمی‌شود و در ردیف «ادامه تماشا» دوباره ظاهر نمی‌شود [در دستگاه دوم و با روشن کردن دستگاه آزمایشی]
    1. قسمت ۲ (در صورت وجود)، باید در ردیف «ادامه تماشا» [در دستگاه دوم و با روشن کردن دستگاه آزمایشی] ظاهر شود.
  16. سناریوی اول: TV1: حساب گوگل: مادر، حساب کاربری سوم / پروفایل: حساب کاربری ۱ / پروفایل_۱. محتوا را تماشا کنید و نمایش داده‌های CW را که توسط حساب کاربری سوم مشاهده شده است، تأیید کنید.

  17. TV2: حساب گوگل: مامان. داده‌های CW را از سناریوی اول تأیید کنید. اکنون به عنوان یک حساب دیگر به برنامه 3p وارد شوید. حساب 3p / پروفایل: account_2 / profile_2. محتوا را تماشا کنید و نمایش داده‌های CW را تأیید کنید. محتویات تماشا شده توسط 3p account_2/profile_2

  18. حساب گوگل: مامان. قاب دستگاه جدید / برنامه 3P نصب نشده است. در یک دستگاه جدید (FDR دستگاه)، Verify CW داده‌های آخرین برنامه 3P استفاده شده که توسط حساب گوگل استفاده شده است را نمایش می‌دهد. توجه: اگر GAIA هنوز با یک پروفایل 3P در دستگاه دیگر مرتبط نشده باشد، ردیف CW نباید محتوای 3P را نشان دهد.

    1. حساب گوگل: مامان. قاب دستگاه جدید / برنامه 3P نصب شده اما وارد سیستم نشده است. در یک دستگاه جدید (FDR دستگاه)، Verify CW داده‌های آخرین برنامه 3P استفاده شده که توسط حساب گوگل استفاده شده است را نمایش می‌دهد.
    1. توجه: اگر حساب گوگل هنوز با یک پروفایل 3P مرتبط نشده باشد، ردیف «ادامه تماشا» نباید محتوای 3P را نشان دهد.

ما محتوای ادامه‌دار را در اپلیکیشن iOS گوگل تی‌وی مشاهده نمی‌کنیم. چه اتفاقی افتاده است؟

برای نمایش محتوا در ردیف «ادامه تماشا» در دستگاه‌های iOS، باید لینک‌های عمیق iOS ارسال کنید.

هر چند وقت یکبار باید اطلاعات محتوا را برای ردیف «ادامه تماشا» به‌روزرسانی کنم؟ آیا باید مرتباً آن را به‌روزرسانی کنم، مثلاً هر ۱۵ ثانیه؟

خیر، به‌روزرسانی‌های مکرر توصیه نمی‌شود. دلیلش این است:

  • تأثیر بر عملکرد: ارسال مداوم به‌روزرسانی‌ها فشار غیرضروری بر سرورهای ما وارد می‌کند و به‌طور بالقوه سرعت سیستم را برای همه کاهش می‌دهد.
  • داده‌های غیرضروری: در حالی که کاربر به طور فعال در حال تماشا است، موقعیت پخش آنها دائماً تغییر می‌کند. ارسال به‌روزرسانی‌ها هر چند ثانیه یکبار، داده‌های اضافی زیادی ایجاد می‌کند که برای از سرگیری پخش مفید نیست.

چه زمانی اطلاعات محتوا را برای ردیف «ادامه تماشا» به‌روزرسانی کنیم:

روی ثبت تغییرات معنادار در پیشرفت مشاهده کاربر تمرکز کنید. در اینجا سناریوهای کلیدی آمده است:

  • پخش متوقف یا متوقف شد: وقتی کاربر تماشای ویدیو را متوقف می‌کند یا متوقف می‌کند، یک به‌روزرسانی برای ذخیره موقعیت فعلی او ارسال می‌شود.
  • برنامه بسته یا غیرفعال است: اگر کاربر هنگام تماشای ویدیو از برنامه خارج شود یا به برنامه دیگری برود، برای ذخیره پیشرفت او، به‌روزرسانی ارسال کنید.
  • وقتی کاربر موردی را از ردیف «ادامه تماشا» در برنامه حذف می‌کند

نحوه بروزرسانی کارآمد:

به جای به‌روزرسانی‌های زمان‌بندی‌شده، از رویدادهای درون پخش‌کننده ویدیو یا چرخه عمر برنامه خود برای راه‌اندازی به‌روزرسانی‌ها استفاده کنید. برای مثال:

  • onPause ، onStop : وقتی پخش ویدیو مکث یا متوقف می‌شود.
  • onAppClose ، onAppBackgrounded : وقتی برنامه بسته می‌شود یا به پس‌زمینه می‌رود.

با پیروی از این دستورالعمل‌ها، شما از استفاده کارآمد از منابع اطمینان حاصل خواهید کرد و در عین حال یک تجربه بی‌نقص در ردیف «ادامه تماشا» برای کاربران خود فراهم خواهید کرد.