پرسشگان انتشار
چه کسی کار انتشار محتوا را مدیریت می‌کند؟
توسعه‌دهنده برنامه کار انتشار محتوا را مدیریت می‌کند و درخواست‌ها را به «سرویس تعامل» ارسال می‌کند. به این ترتیب، شرکای توسعه‌دهنده کنترل بیشتری بر زمان و نحوه انتشار محتوا برای کاربران دارند. این کار از بیدار شدن مکرر برنامه شریک برای انتشار محتوا جلوگیری می‌کند.
آیا توسعه‌دهنده باید همه انواع خوشه‌ها را منتشر کند؟
اگرچه ازنظر فنی توسعه‌دهندگان آزادند که فقط یک خوشه منتشر کنند، ما اکیداً توصیه می‌کنیم که خوشه‌های بیشتری اضافه کنید. درغیراین‌صورت، توسعه‌دهندگان فرصت ایجاد تعامل بهتر با محتوایشان را ازدست می‌دهند. اکیداً توصیه می‌کنیم همه انواع خوشه‌ها را برای هر عمودی منتشر کنید.
توسعه‌دهنده شریک هر چند وقت یک‌بار باید داده‌ها را بااستفاده از مدیر کار درحین اجرای برنامه منتشر کند؟
این مورد را شریک توسعه‌دهنده تعیین می‌کند. Google توصیه می‌کند برای محتوای توصیه‌شده عمومی، یک یا دو بار در روز منتشر کنید و برای سبد خرید، سفارش مجدد، و سایر محتواهای ادامه‌دار از روش رویدادمحور استفاده کنید (برای مثال، کارگر را به‌عنوان فراخوان برگشتی کاربر درحال افزودن موارد به سبد خرید یا کاربر درحال متوقف کردن فیلم در نیمه راه شروع کنید). برای برنامه‌های اجتماعی، انتشار خوشه‌های توصیه‌شده به‌روزشده پس‌از هر بار استفاده از برنامه بسیار مهم است. کاربران برنامه اجتماعی بیشتر به جدیدترین توصیه‌ها علاقه دارند و در حالت ایده‌آل دوست دارند هر پست را حداکثر یک بار ببینند.
توسعه‌دهنده چه زمانی باید میاناهای برنامه‌سازی کاربردی حذف را فراخوانی کند؟
میاناهای برنامه‌سازی کاربردی حذف فقط باید زمانی فراخوانده شوند که محتوایی برای انتشار وجود نداشته باشد. نباید برای جایگزین کردن محتوا، API حذف و انتشار را به‌دنبال هم فراخوانی کنید؛ API انتشار محتوای قبلی را به‌طور خودکار برمی‌دارد.
پرسشگان هدف همه‌فرستی
چرا توسعه‌دهندگان برنامه Android باید برای هدف‌های همه‌فرستی ثبت‌نام کنند؟
برای ارائه محتوای جدید به کاربر، باید از هدف‌های همه‌فرستی برای راه‌اندازی همگام‌سازی داده‌ها در مواردی که کاربران ممکن است به‌طور مکرر از برنامه استفاده نکنند، استفاده کنید.
قصد همه‌فرستی آزمایش نشد
برنامه درستی‌سنجی از آزمایش هدف همه‌فرستی با اجازه پشتیبانی نمی‌کند. باید اجازه‌ها را درطول آزمایش بردارید و قبل‌از تغییر کیت توسعه نرم‌افزار به نسخه تولید در مرحله ۶، آن‌ها را دوباره اضافه کنید.
اجرا در پس‌زمینه مجاز نیست
هنگام ثبت هدف همه‌فرستی، ممکن است با خطای زیر مواجه شوید:
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>
چگونه می‌توانم تأثیر ادغام را محاسبه کنم؟
پیوندهای عمیق روشی عالی برای پیگیری اسناد است. نشانی‌های وب پیوند عمیق که کاربران را به برنامه‌تان هدایت می‌کنند می‌توانند با پارامترهای ردیابی اضافی گنجانده شوند. برای مثال - «http://xx/deeplink?source_tag=engage».
توسعه‌دهندگان می‌توانند پارامترهای ردیابی خودشان را اضافه کنند و برای محاسبه تأثیر، ارجاع ارائه دهند.
پرسشگان Engage for TV 2.0
پرسش‌های عمومی
Engage چیست؟
Engage تجربه «از همان‌جا که رها کردید شروع کنید» را به سطح بالاتری می‌برد! این یک ارتقای قابل‌توجه است که به بینندگان اجازه می‌دهد به‌طور یکپارچه محتوای خود را در طیف وسیع‌تری از دستگاه‌ها ازسر بگیرند. تصور کنید فیلمی را در Google TV شروع می‌کنید و سپس به‌راحتی آن را در تلفنتان درطول رفت‌وآمد ادامه می‌دهید – این قدرت Engage است.
این سیستم جدید برای تقویت تعامل و حفظ بیننده طراحی شده است و تجربه‌ای روان و بدون اصطکاک را در سراسر بوم‌سازگان Google ارائه می‌دهد.
آیا Video Discovery API همان Engage است؟
بله، این دو مورد یکسان هستند. Engage SDK کتابخانه‌ای است که از ردیف ادامه تماشا پشتیبانی می‌کند. Engage از انواع بیشتری از نهادهای محتوا نسبت‌به ویدیو پشتیبانی می‌کند، به‌همین دلیل است که این ادغام دیگر «کاوش ویدیو» نامیده نمی‌شود.
مزایای استفاده از Engage چیست؟
پاسخ: Engage ادامه دادن تماشای محتوای شما را از جایی که بینندگان آن را رها کرده‌اند، صرف‌نظر از دستگاهی که استفاده می‌کنند، آسان‌تر از همیشه می‌کند. روش کار این‌طور است:
- تجربه یکپارچه در سراسر Google: تماشا را در Google TV شروع کنید و به‌طور یکپارچه در تلفن Android، iPhone، یا رایانه لوحی Android ادامه دهید. این ویژگی حتی در دستگاه‌هایی که هنوز برنامه را در آن‌ها نصب نکرده‌اید کار می‌کند!
- افزایش تعامل و حفظ کاربر: Engage کمک می‌کند کاربران به برنامه‌تان برگردند، حتی در دستگاه‌های جدید. با اجازه دادن به کاربران برای ازسر گرفتن نمایش‌های دلخواهشان، احتمال ادامه تماشای آن‌ها را افزایش می‌دهید.
- دسترسی گسترده‌تر: Engage علاوه‌بر Google TV، در دیگر تجربه‌های رسانه‌ای Android، مثل «مجموعه‌های Play» و دیگر برنامه‌های رسانه‌ای Google، کار می‌کند.
- سازگار با نسخه قدیمی: اگر درحال‌حاضر از ویژگی قدیمی‌تر «تماشای بعدی» استفاده می‌کنید، مشکلی نیست! Engage با نسخه‌های قدیمی سازگار است، بنابراین ادغام موجود شما همچنان کار خواهد کرد.
نکته مهم: همه ادغام‌های جدید «ادامه تماشا» باید از Engage استفاده کنند. سیستم قدیمی‌تر «پخش بعدی بین‌دستگاهی» درحال حذف تدریجی است.
کدام سطوح از Engage پشتیبانی می‌کنند؟
- Google TV
- Android TV (فقط در دستگاه اما از کیت توسعه نرم‌افزار Engage پشتیبانی می‌کند)
- برنامه تلفن همراه Google TV Android
- برنامه تلفن همراه Google TV برای iOS
- مجموعه‌های Play
- فضای سرگرمی Google
- دستگاه‌های iOS (با یکپارچه‌سازی REST API).
آیا Engage SDK برای «ادامه تماشا» است؟
بله، Engage SDK از محتوا برای ردیف «ادامه تماشا» پشتیبانی می‌کند. برای ادغام با Engage لازم است.
آیا Engage برای همه دردسترس است؟
Engage در چند فاز عرضه می‌شود.
- دسترسی زودرس: در ابتدا، دسترسی را ازطریق «برنامه دسترسی زودرس» (EAP) به گروه منتخبی از شرکا اعطا می‌کنیم.
- گسترش دسترسی: سخت در تلاشیم تا Engage را به‌زودی دردسترس همه توسعه‌دهندگان قرار دهیم.
برای عرضه موفق و بدون مشکل، تدابیر امنیتی‌ای برای مدیریت عرضه درنظر گرفته‌ایم. این شامل هم یک فهرست مجاز در سمت Engage و هم یک بررسی جداگانه در Engage SDK است. چه شریک EAP باشید یا بخواهید به‌زودی به ما بپیوندید، لطفاً با ما تماس بگیرید تا بتوانیم قبل‌از شروع ادغام Engage SDK، اجازه‌های دسترسی را تنظیم کنیم.
آیا اندازه تصویر توصیه‌شده‌ای وجود دارد که باید ارائه دهیم؟
الزامات تصویر در بخش ایجاد نهادها به‌روز شده است.
با این سند API جدید، آیا داده‌های «ادامه تماشا» توسط سرور Google از کارخواه دریافت می‌شود و در همه دستگاه‌ها منعکس خواهد شد؟
میانای برنامه‌سازی کاربردی جدید بهبودهای قابل‌توجهی برای محتوا در ردیف «ادامه تماشا» ارائه می‌دهد، ازجمله:
تجربه یکپارچه در Google TV: کاربران می‌توانند تماشا کردن را در یک Google TV شروع کنند و در هر Google TV دیگری که با همان حساب به سیستم آن وارد شده‌اند ادامه دهند. این ویژگی با نسخه‌های قدیمی‌تر Android TV نیز کار می‌کند.
ادغام برنامه تلفن همراه: محتوای Engage در برنامه تلفن همراه Google TV برای Android و iOS نمایش داده می‌شود و به کاربران امکان می‌دهد به‌طور یکپارچه بین تلویزیون و دستگاه‌های همراه خود جابه‌جا شوند.
حفظ کاربر بهبودیافته: حتی در دستگاه‌هایی که برنامه نصب نشده است یا کاربر به سیستم وارد نشده است، محتوای ردیف «ادامه تماشا» کاربران را تشویق می‌کند تا دوباره با برنامه شما تعامل داشته باشند و این امر باعث افزایش حفظ کاربر می‌شود.
گسترش به پلاتفرم‌های دیگر: Engage به پلاتفرم‌های رسانه‌ای دیگر Google مانند Android، «مجموعه‌های Play»، رایانه‌های لوحی، و دیگر برنامه‌ها و سطوح رسانه‌ای Google در Android گسترش می‌یابد و تعامل کاربر را در دستگاه‌های مختلف به حداکثر می‌رساند.
محدودیت تعداد نهادهایی که می‌توانم در خوشه «ادامه» منتشر کنم چقدر است؟
هر شریک توسعه‌دهنده به حداکثر ۵ نهاد در خوشه «ادامه» محدود می‌شود. این محدودیت برای توزیع عادلانه محتوا در ردیف «ادامه تماشا» در Google TV است که فضایی مشترک برای چندین ارائه‌دهنده رسانه است.
اگر بخواهم بیش‌از ۵ نهاد منتشر کنم چه اتفاقی می‌افتد؟
اگر درخواست انتشار شما از حد ۵ نهاد فراتر رود، Engage SDK آن را رد خواهد کرد. برای انتشار موفقیت‌آمیز، باید تعداد نهادها را در درخواستتان کاهش دهید. فقط باید موجودیت‌هایی را اضافه کنید که کاربران تماشای آن‌ها را متوقف کرده‌اند، بنابراین در اکثر موارد، فقط چند موجودیت از این نوع وجود خواهد داشت. وقتی بیش‌از ۵ مورد از این نهادها وجود دارد، می‌توانید موارد جدیدتر را برای انتشار انتخاب کنید.
چرا برای تعداد نهادها محدودیت وجود دارد؟
ردیف «ادامه تماشا» در Google TV محتوای ارائه‌دهندگان رسانه مختلف را نمایش می‌دهد. محدود کردن تعداد نهادها برای هر ارائه‌دهنده به‌گونه‌ای که کاربران انتخاب متنوعی از محتوا را از همه منابع موردعلاقه‌شان ببینند، که این امر تجربه کاربری منصفانه و متعادلی را ترویج می‌کند.
سؤالات برنامه درستی‌سنجی
آیا آزمایش کردن برنامه‌ام با برنامه درستی‌سنجی قبل‌از ارسال الزامی است؟
بله، آزمایش کردن برنامه با برنامه درستی‌سنجی قبل‌از ارسال 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استفاده کنید، سیستم ممکن است نتواند موارد موردنظر را به‌درستی شناسایی و حذف کند.
آیا profileId برای Engage لازم است؟
accountIdالزامی است. این شناسه کاربر را در دستگاه‌های مختلف شناسایی می‌کند.profileIdبرای تجربه کاربری خوب بسیار مهم است. اگرچه ازنظر فنی اختیاری است، اما اگر سرویس شما از چندین نمایه پشتیبانی می‌کند (مانند بسیاری از سرویس‌های جاری‌سازی)،profileIdبه‌شدت توصیه می‌شود. چرا این موضوع این‌قدر مهم است؟ چون بدونprofileId، ردیف «ادامه تماشا» ممکن است محتوای نمایه‌های دیگر را در همان حساب نشان دهد. این کار می‌تواند منجر به تجربه‌ای گیج‌کننده و ناامیدکننده برای کاربران شما شود.- به‌طور خلاصه: ارائه
profileIdتضمین می‌کند که محتوای ارائه‌شده به ردیف «ادامه تماشا» به‌طور دقیق سابقه مشاهده هر فرد را منعکس می‌کند. اگر برنامه‌تان از مفهوم نمایه در حساب پشتیبانی نمی‌کند، باید آن را ارائه دهید.
Google چگونه از profileId در سمت خود استفاده می‌کند؟
اگر سرویس نمایه‌های مختلفی برای تماشای محتوا ارائه دهد، از accountId و profileId برای مرتبط کردن محتوای تماشاشده در دستگاه با «حساب Google» واردشده به سیستم در دستگاه استفاده می‌شود. Google داده‌های ContinueWatching را در ترکیب accountId و profileId ثبت می‌کند. هر دستگاه Google که با همان «حساب Google» به سیستم وارد شده باشد، جدیدترین داده‌های به‌روزشده را از همان accountId و profileId مرتبط در ردیف «ادامه تماشا» دریافت می‌کند.
آیا پیوند دادن حساب برای پیاده‌سازی Engage لازم است؟
به «پیوند دادن حساب» نیازی نیست. اولویت آن کاهش یافته است و همه موارد استفاده مرتبط با آن توسط Device Entitlements API جدید پوشش داده خواهد شد.
سؤالات مربوط به همگام‌سازی بین دستگاه‌ها
وقتی کاربران موافقت می‌کنند، «همگام‌سازی در همه دستگاه‌ها» چه معنایی دارد؟
با رضایت کاربر برای «همگام‌سازی در دستگاه‌ها»، محتوایی که تماشا می‌کند در سرورهای Google TV ذخیره می‌شود و به او اجازه می‌دهد به‌طور یکپارچه از جایی که در هر دستگاهی که به سیستم وارد شده است، ادامه دهد. بدون رضایت، سابقه تماشای آن‌ها در دستگاه فعلی محلی باقی می‌ماند.
Can we set "sync across devices" to false?
پرچم setUserConsentToSyncAcrossDevices کنترل می‌کند که آیا داده‌های ContinuationCluster کاربر در دستگاه‌های او (تلویزیون، تلفن، رایانه لوحی، و غیره) همگام‌سازی شود یا نه. اگر این پرچم روی false تنظیم شده باشد، محتوای ادامه تماشا فقط در همان دستگاه نمایش داده می‌شود.
برای بهره‌برداری حداکثری از ویژگی بین‌دستگاهی، اکیداً توصیه می‌کنیم برنامه‌تان رضایت کاربر را کسب کند و SyncAcrossDevices را روی true تنظیم کند.
رضایت کاربر برای هم‌رسانی سابقه تماشا در دستگاه‌های غیرAndroid چگونه دریافت می‌شود
دستگاه‌ها؟ چه نقاط داده‌ای از دستگاه‌های غیرAndroid با سرورهای شخص ثالث هم‌رسانی می‌شود؟
رضایت در سطح کاربر (سطح نمایه یا حساب) جمع‌آوری می‌شود. پس‌از دریافت رضایت، محموله‌های ادامه تماشا براساس تعامل می‌توانند به هر جایی ارسال شوند تا Google بتواند وضعیت ازسرگیری همه‌جایی کاربران را در تمام نهادهایی که با آن‌ها تعامل جزئی یا بعدی دارند، در هر دستگاهی منعکس کند (بدون نیاز به درخواست مجدد رضایت در هر دستگاه یا پلتفرم). شرکا جدیدترین وضعیت ادامه تماشا را (طبق مشخصات) که با شناسه نمایه (که در Android ذخیره شده است) مرتبط است برای کاربران ارسال خواهند کرد.
سؤالات REST API
آیا مستنداتی درباره REST API وجود دارد؟
زمان تخمینی برای REST API مارس ۲۰۲۵ است، این موضوع در «اسناد توسعه‌دهنده Engage» مستند شده است.
Legacy Watch Next Questions
آیا Engage جایگزین Watch Next API می‌شود؟
Engage با همه دستگاه‌های Android TV که از Watch Next API پشتیبانی می‌کنند سازگار با نسخه قدیمی خواهد بود. برای ادغام در Google TV و سایر سطوحی که از Engage پشتیبانی می‌کنند، توسعه‌دهندگان باید از Engage SDK استفاده کنند.
سؤالات مربوط به آزمایش و یکپارچه‌سازی
تفاوت بین LastPlayBackPositionTimeMillis و مدت چیست؟
LastPlayBackPositionTimeMillis باید مدت بازپخش را برحسب میلی‌ثانیه در جایی که کاربر تماشا را متوقف کرده است نشان دهد (برای مثال، ۶۰۵۰۰۰ میلی‌ثانیه برای ۱۰ دقیقه و ۵ ثانیه). این مقدار نباید از مدت کل نهاد بیشتر باشد.
درحالی‌که LastEngagementTime مُهر زمان آخرین باری است که کاربر با محتوا تعامل داشته است.
چه چارچوب‌های تستی را باید اجرا کنیم؟
موارد زیر چارچوب‌های تست Google TV هستند که تضمین کیفیت ما انجام می‌دهد. چارچوب‌های تست مشابه را می‌توان در سطوح دیگر نیز اجرا کرد.
- ویدیویی را که طولانی‌تر از ۲۰ دقیقه است حدود ۵ دقیقه تماشا کنید. از برنامه خارج شوید. کارت ویدیو باید در ردیف «ادامه تماشا» نمایش داده شود. توجه: ما فقط ۵ کارت برای هر برنامه شخص ثالث در CW نمایش می‌دهیم
- با انتخاب کارت جدیدی که در ردیف «ادامه تماشا» ظاهر شده است، پخش ویدیو باید از نقطه درست در ویدیو ادامه یابد. توجه: هر محتوای جدید یا قدیمی باید از جایی که آخرین‌بار متوقف شده بود ازسر گرفته شود.
- تغییر حساب در دستگاه GTV باید کارت‌های ردیف «ادامه تماشا» را تغییر دهد. فقط ویدیوهای حساب فعلی باید نشان داده شود. مرتب‌شده براساس ترتیب اخیر. 3p app profile CW will be intermixed. توجه: CW برای GoogleAccount2 محتوای شخص ثالثی را نشان می‌دهد که GoogleAccount2 درحال تماشای آن بوده است
- با دکمه «برگشتن» از برنامه خارج شوید > بررسی کنید کارت در ردیف «ادامه تماشا» نمایش داده شود
- Hide the video in the continue watching row, it shouldn't show again Test if hidden content stays hidden beyond 24 hours and even after the app opens after 24 hrs. تأیید کنید که پنهان کردن یک مورد باعث پنهان شدن چند مورد نمی‌شود.
- دردسترس بودن محتوا در ردیف «ادامه تماشا» با فراداده کامل: تصویر کارت، نام برنامه، عنوان، شماره قسمت فصل برای محتوای تلویزیونی
- «بررسی پیشرفت» در نوار پیشرفت نمایش داده می‌شود
- کاربر محتوا را تا تیتراژ پایانی تماشا کرده است - محتوا در ردیف «ادامه تماشا» نمایش داده نمی‌شود
- مطمئن شوید هیچ مورد تماشانشده‌ای در ردیف «ادامه تماشا» نشان داده نمی‌شود
- تأیید کنید که موارد CW به‌ترتیب زمانی براساس زمان وقوع فعالیت تماشا چیده شده‌اند و نه براساس آخرین باری که برنامه باز شده است یا آخرین روز
- تأیید کنید که جزئیات قسمت و فصل در کارت CW با آنچه در محتوای قسمتی تماشا شده است مطابقت دارد
- تأیید کنید که موارد تکمیل‌شده (مواردی که در بخش تیتراژ پایانی یا بعداز آن هستند) در ردیف «ادامه تماشا» نشان داده نمی‌شوند
- دستگاه را در نیمه تماشای قسمت/فیلم/نمایش خاموش کنید. «دستگاه را در نیمه تماشای قسمت/فیلم/نمایش خاموش کنید. درستی‌سنجی در روشن کردن دستگاه و در تلویزیون دیگر، CW کارت درست را در موقعیت درست و نوار پیشرفت نمایش می‌دهد»
- پس‌از تماشای کامل قسمت ۱، دستگاه را خاموش کنید، درستی‌سنجی کنید
- episode 1 drops and doesn't reappear in continue watching row [on second
device and on turning on the test device]
- قسمت ۲ (درصورت دردسترس بودن) باید در ردیف «ادامه تماشا» نشان داده شود [در دستگاه دوم و هنگام روشن کردن دستگاه آزمایشی]
- سناریو اول: TV1: حساب Google: مادر، حساب شخص ثالث / نمایه: حساب ۱ / نمایه_۱. Watch content and verify CW data displays contents watched by 3P account_1/profile_1
TV2: GoogleAccount: mom. داده‌های CW را از سناریو اول درستی‌سنجی کنید. اکنون با حساب دیگری به سیستم برنامه شخص ثالث وارد شوید. حساب / نمایه شخص ثالث: account_2 / profile_2. Watch content and verify CW data displays contents watched by 3p account_2/profile_2
GoogleAccount: mom. New device case /3P app not installed. در دستگاه جدید(بازنشانی داده‌های کارخانه دستگاه)، «تأیید CW» داده‌های آخرین برنامه شخص ثالث استفاده‌شده را که توسط «حساب Google» استفاده شده است نمایش می‌دهد. Note: CW row shouldn't show 3P contents if the GAIA is not yet associated with a 3P profile on other device
- GoogleAccount: mom. قاب دستگاه جدید /برنامه شخص ثالث نصب شده است اما به سیستم وارد نشده است. در دستگاه جدید(دستگاه FDR)، «تأیید CW» داده‌های آخرین برنامه شخص ثالثی را که «حساب Google» از آن استفاده کرده است نمایش می‌دهد.
-
- توجه: اگر «حساب Google» هنوز با نمایه شخص ثالث مرتبط نشده باشد، ردیف «ادامه تماشا» نباید محتوای شخص ثالث را نشان دهد
محتوای ادامه دادن را در برنامه Google TV iOS نمی‌بینیم. چه اتفاقی افتاده است؟
برای اینکه محتوا در ردیف «ادامه تماشا» در دستگاه‌های iOS نشان داده شود، باید پیوندهای عمیق iOS را ارسال کنید.
هر چند وقت یک‌بار باید اطلاعات محتوا را برای ردیف «ادامه تماشا» به‌روز کنم؟ آیا باید آن را به‌طور مکرر، مثلاً هر ۱۵ ثانیه، به‌روز کنم؟
نه، به‌روزرسانی‌های مکرر توصیه نمی‌شود. علت این است:
- تأثیر بر عملکرد: ارسال مداوم به‌روزرسانی‌ها فشار غیرضروری بر سرورهای ما وارد می‌کند و ممکن است سرعت سیستم را برای همه کاهش دهد.
- داده‌های غیرضروری: وقتی کاربر درحال تماشا است، موقعیت بازپخش او به‌طور مداوم تغییر می‌کند. ارسال به‌روزرسانی‌ها هر چند ثانیه یک‌بار، داده‌های زائد زیادی ایجاد می‌کند که برای ازسرگیری بازپخش مفید نیست.
زمان به‌روزرسانی اطلاعات محتوا برای ردیف ادامه تماشا:
بر ثبت تغییرات معنادار در پیشرفت مشاهده کاربر تمرکز کنید. سناریوهای کلیدی در اینجا آمده است:
- بازپخش موقتاً متوقف یا متوقف شده است: وقتی کاربر تماشا را موقتاً متوقف یا متوقف می‌کند، به‌روزرسانی ارسال کنید تا موقعیت فعلی او ذخیره شود.
- برنامه بسته یا به پس‌زمینه منتقل شده است: اگر کاربر از برنامه خارج شود یا درحین تماشای ویدیو به برنامه دیگری برود، به‌روزرسانی ارسال کنید تا پیشرفت او ذخیره شود.
- وقتی کاربر موردی را از ردیف «ادامه تماشا» در برنامه برمی‌دارد
نحوه به‌روزرسانی کارآمد:
به‌جای به‌روزرسانی‌های زمان‌بندی‌شده، از رویدادهای درون پخش‌کننده ویدیو یا چرخه حیات برنامه برای راه‌اندازی به‌روزرسانی‌ها استفاده کنید. برای مثال:
-
onPause،onStop: وقتی بازپخش ویدیو موقتاً متوقف یا متوقف می‌شود. -
onAppClose،onAppBackgrounded: وقتی برنامه بسته می‌شود یا به پس‌زمینه منتقل می‌شود.
با دنبال کردن این دستورالعمل‌ها، از استفاده کارآمد از منابع اطمینان حاصل خواهید کرد و درعین‌حال تجربه‌ای یکپارچه در ردیف «ادامه تماشا» برای کاربران خود فراهم می‌کنید.