שאלות נפוצות בנושא Engage SDK

פרסום שאלות נפוצות

מי מנהל את משימת פרסום התוכן?

מפתח האפליקציה מנהל את משימת פרסום התוכן ושולח בקשות ל-Engage Service. כך, לשותפי הפיתוח יש יותר שליטה על התוכן שמתפרסם למשתמשים, ועל התזמון והאופן שבהם הוא מתפרסם. כך נמנעת הפעלה של אפליקציית השותף בתדירות גבוהה מדי לצורך פרסום תוכן.

האם מפתח צריך לפרסם את כל סוגי האשכולות?

מבחינה טכנית, מפתחים יכולים לפרסם רק קלאסטר אחד, אבל אנחנו ממליצים בחום לכלול יותר. אחרת, המפתחים יחמיצו את ההזדמנות להגביר את המעורבות עם התוכן שלהם. מומלץ מאוד לפרסם את כל סוגי האשכולות לכל תחום.

מה התדירות שבה שותף הפיתוח צריך לפרסם נתונים באמצעות הכלי לניהול עבודות בזמן שהאפליקציה פועלת?

ההחלטה הזו מתקבלת על ידי שותף המפתחים. ‫Google ממליצה לפרסם פעם או פעמיים ביום תוכן המלצות כללי, ולהשתמש במתודולוגיה מבוססת-אירועים לתוכן שקשור לעגלת קניות, להזמנה מחדש ולהמשכיות (לדוגמה, הפעלת ה-worker כקריאה חוזרת של המשתמש שמוסיף פריטים לעגלה או של המשתמש שמפסיק סרט באמצע). באפליקציות חברתיות, חשוב לפרסם אשכולות המלצות מעודכנים אחרי כל שימוש באפליקציה. משתמשים באפליקציות לרשתות חברתיות מתעניינים יותר בהמלצות האחרונות, והם מעדיפים לראות כל פוסט פעם אחת לכל היותר.

מתי המפתח צריך להפעיל ממשקי API למחיקה?

צריך להפעיל את ממשקי ה-API של המחיקה רק כשאין תוכן לפרסום. אל תתקשרו לממשקי ה-API של המחיקה והפרסום ברצף כדי להחליף תוכן. ממשקי ה-API של הפרסום מסירים את התוכן הקודם באופן אוטומטי.

שאלות נפוצות בנושא כוונת שידור

למה מפתחי אפליקציות ל-Android צריכים להירשם ל-broadcast intents?

כדי להציג למשתמשים תוכן עדכני, צריך להשתמש בשידורי כוונות כדי להפעיל סנכרון נתונים במקרים שבהם המשתמשים לא משתמשים באפליקציה לעיתים קרובות.

לא ניתן לבדוק את ה-Intent של השידור

אפליקציית האימות לא תומכת בבדיקת Intent של שידור עם הרשאה. צריך להסיר את ההרשאות במהלך הבדיקה ולהוסיף אותן מחדש לפני שמחליפים את גרסת ה-SDK לגרסת הייצור בשלב 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>

קישורי העומק הם דרך מצוינת לעקוב אחרי השיוך (Attribution). אפשר לכלול בכתובות ה-URL של קישורי העומק שמפנים את המשתמשים לאפליקציה פרמטרים נוספים למעקב. לדוגמה – http://xx/deeplink?source_tag=engage.

מפתחים יכולים להוסיף פרמטרים משלהם למעקב ולספק שיוך כדי לחשב את ההשפעה.

שאלות נפוצות בנושא Engage for TV 2.0

שאלות כלליות

מהי התכונה 'המשך צפייה 2.0'?

התכונה 'המשך צפייה 2.0' (Video Discovery API) משדרגת את חוויית הצפייה ומאפשרת לכם להמשיך לצפות בסרטונים בדיוק מהמקום שבו הפסקתם. זהו שדרוג משמעותי שמאפשר לצופים להמשיך לצפות בתוכן בצורה חלקה במגוון רחב יותר של מכשירים. תארו לעצמכם שאתם מתחילים לצפות בסרט ב-Google TV ואז ממשיכים לצפות בו בקלות בטלפון במהלך הנסיעה לעבודה – זו העוצמה של 'המשך צפייה' 2.0.

המערכת החדשה הזו נועדה לשפר את המעורבות של הצופים ואת שיעור הצופים שחוזרים לצפות בערוץ, על ידי מתן חוויה חלקה ונוחה בכל האקוסיסטם של Google.

מהם היתרונות של התכונה 'המשך צפייה' בגרסה 2.0?

תשובה: התכונה 'המשך צפייה' בגרסה 2.0 מאפשרת לצופים להמשיך לצפות בתוכן שלכם בקלות רבה מאיפה שהם הפסיקו, לא משנה באיזה מכשיר הם משתמשים. כך זה עובד:

  • חוויה חלקה ב-Google: אפשר להתחיל לצפות ב-Google TV ולהמשיך בצפייה בצורה חלקה בטלפון Android, באייפון או בטאבלט Android. הוא אפילו פועל במכשירים שבהם עדיין לא התקנתם את האפליקציה.
  • שיפור המעורבות והשימור: התכונה 'המשך צפייה' 2.0 עוזרת למשתמשים לחזור לאפליקציה שלכם, גם במכשירים חדשים. אם תאפשרו למשתמשים להמשיך לצפות בתוכניות האהובות עליהם, יש סיכוי גבוה יותר שהם ימשיכו לצפות.
  • המשך צפייה 2.0 זמין במגוון רחב יותר של מכשירים: מעבר ל-Google TV, התכונה פועלת גם במכשירים אחרים עם Android, כמו Play Cubes ואפליקציות מדיה אחרות של Google.
  • תאימות לאחור: אם אתם כבר משתמשים בתכונה הישנה הסרטון הבא, אין בעיה! התכונה 'המשך צפייה' 2.0 תואמת לאחור, כך שהשילוב הקיים שלכם ימשיך לפעול.

הערה חשובה: כל השילובים החדשים של התכונה 'המשך צפייה' חייבים להשתמש בגרסה 2.0 של התכונה. אנחנו מפסיקים את השימוש במערכת הישנה יותר של 'הפעלת השיר הבא במכשירים אחרים'.

באילו פלטפורמות יש תמיכה בתכונה 'המשך צפייה' בגרסה 2.0?

  1. Google TV
  2. ‫Android TV (במכשיר בלבד, אבל יש תמיכה ב-Engage SDK)
  3. אפליקציית Google TV לנייד ב-Android
  4. האפליקציה לנייד של Google TV ל-iOS
  5. קוביות משחק
  6. חבילת הבידור של Google
  7. מכשירי iOS (עם שילוב של API ל-REST).

האם Engage SDK מיועד לתכונה 'המשך צפייה' בגרסה 2.0?

כן, Engage SDK מיועד ל'המשך צפייה' גרסה 2.0. חובה לשלב את התכונה 'המשך צפייה 2.0'.

האם התכונה 'המשך צפייה 2.0' זמינה לכולם?

ההשקה של התכונה 'המשך צפייה 2.0' מתבצעת בשלבים.

  • גישה מוקדמת: בשלב הראשון, אנחנו מעניקים גישה לקבוצה נבחרת של שותפים באמצעות תוכנית גישה מוקדמת (EAP).
  • הרחבת הגישה: אנחנו משקיעים מאמצים רבים כדי להשיק בקרוב את התכונה 'המשך צפייה' 2.0 לכל המפתחים.

כדי שההשקה תהיה חלקה ומוצלחת, אנחנו משתמשים באמצעי הגנה לניהול ההשקה. התהליך כולל גם רשימת היתרים בצד של התכונה 'המשך צפייה' 2.0 וגם בדיקה נפרדת ב-Engage SDK. אם אתם שותפים בתוכנית הגישה המוקדמת או שאתם רוצים להצטרף אליה בקרוב, אתם מוזמנים ליצור איתנו קשר כדי שנוכל להגדיר את הרשאות הגישה לפני שתתחילו בשילוב של Engage SDK.

עדכנו את הדרישות לגבי תמונות בקטע יצירת ישויות.

האם בעזרת מסמכי ה-API החדשים, הנתונים של 'המשך צפייה' יימשכו על ידי השרת של Google מהלקוח ויוצגו בכל המכשירים?

לממשק ה-API החדש יש יתרונות משמעותיים ל'המשך צפייה', כולל:

  • חוויה חלקה בכל מכשירי Google TV: משתמשים יכולים להתחיל לצפות בתוכן במכשיר Google TV אחד ולהמשיך לצפות בו בכל מכשיר Google TV אחר שמחובר לאותו חשבון. התכונה הזו פועלת גם בגרסאות ישנות יותר של Android TV.

  • שילוב עם אפליקציה לנייד: התכונה 'המשך צפייה' זמינה באפליקציית Google TV לנייד ב-Android וב-iOS, ומאפשרת למשתמשים לעבור בצורה חלקה בין הטלוויזיה לבין המכשירים הניידים שלהם.

  • שיפור שימור המשתמשים: גם במכשירים שבהם האפליקציה לא מותקנת או שהמשתמש לא מחובר לחשבון, התכונה 'המשך צפייה' מעודדת את המשתמשים לחזור לאפליקציה, וכך משפרת את שימור המשתמשים.

  • הרחבה לפלטפורמות אחרות: השילוב הזה מרחיב את התכונה 'המשך צפייה' לפלטפורמות מדיה אחרות של Google, כמו Android, ‏ Play Cubes, טאבלטים ואפליקציות וממשקים אחרים של Google למדיה ב-Android, כדי למקסם את מעורבות המשתמשים במכשירים.

מה המגבלה על מספר הישויות שאפשר לפרסם באוסף ההמשכים?

כל שותף מפתח מוגבל למקסימום של 5 ישויות באשכול ההמשכיות. המגבלה הזו נועדה להבטיח חלוקה הוגנת של תוכן בשורה 'המשך צפייה' ב-Google TV, שמשמשת כמרחב משותף לכמה ספקי מדיה.

מה קורה אם מנסים לפרסם יותר מ-5 ישויות?

אם תחרגו ממגבלת 5 הישויות, מערכת EngageSDK תדחה את בקשת הפרסום. כדי לפרסם בהצלחה, צריך לצמצם את מספר הישויות בבקשה. צריך לכלול רק את הישויות שבהן המשתמשים הפסיקו לצפות, כך שברוב המקרים יהיו רק כמה ישויות כאלה. אם יש יותר מ-5 ישויות כאלה, אפשר לבחור את הישויות העדכניות יותר לפרסום.

למה יש הגבלה על מספר הישויות?

בשורה 'המשך צפייה' ב-Google TV מוצג תוכן מספקי מדיה שונים. הגבלת מספר הישויות לכל ספק, כדי שהמשתמשים יראו מבחר מגוון של תוכן מכל המקורות המועדפים שלהם, וכך תתאפשר חוויית משתמש הוגנת ומאוזנת.

שאלות לגבי אפליקציית האימות

האם חובה לבדוק את האפליקציה באמצעות אפליקציית האימות לפני השליחה?

כן, חובה לבדוק את האפליקציה באמצעות אפליקציית האימות לפני ששולחים את קובץ ה-APK.

אנחנו מבינים שאתם בטוחים בהטמעה שלכם, אבל לשילוב של התכונה 'המשך צפייה' בגרסה 2.0 יש הרבה רכיבים מורכבים. אפליקציית האימות משמשת כרשת ביטחון, ומאפשרת לזהות בעיות פוטנציאליות בשלב מוקדם ולחסוך לכם זמן ומאמץ יקרים בטווח הארוך.

אפשר לחשוב על זה כעל בדיקה מהירה שעוזרת להבטיח השקה חלקה וחוויית משתמש מצוינת.

אם תזהו ותפתרו את הבעיות מראש, תוכלו להימנע מהתסכול של דחיות ושליחות מחדש.

כדי לשלוח את קובץ ה-APK, צריך לכלול צילום מסך שמוכיח שהאפליקציה עברה את תהליך האימות.

מהן כמה שגיאות נפוצות שכדאי להיזהר מהן במהלך ההטמעה?

אפליקציית האימות נועדה לזהות בעיות פוטנציאליות בשילוב של התכונה 'המשך צפייה' בגרסה 2.0. אלה כמה שגיאות נפוצות שמפתחים נתקלים בהן לעיתים קרובות:

לכל סוגי התוכן (סרטים, פרקים בסדרות טלוויזיה, שידורים חיים, קליפים):

  • קישורים חסרים: צריך לוודא שסיפקתם כתובות URI (קישורים) תקפות שספציפיות לפלטפורמה לתוכן שלכם. הקישורים האלה מציינים למערכת איפה התוכן שלכם נמצא בכל פלטפורמה.
  • חסרות כותרות: אל תשכחו לכלול כותרות לכל התוכן. כך המשתמשים יכולים לזהות את התוכן שהם צפו בו.
  • יחסי גובה-רוחב של תמונות: צריך לוודא שלכל התמונות שמשויכות לתוכן יש יחס גובה-רוחב שקרוב ל-16:9. כך תוכלו לוודא שהתמונות יוצגו בצורה תקינה במסכים שונים.

לפרקים של תוכניות טלוויזיה:

  • פרטי הפרק המלאים: חשוב לכלול את שם התוכנית, מספר הפרק ומספר העונה. הערך הזה עוזר לארגן פרקים ומאפשר למשתמשים לנווט בסדרה.
  • מיקום מדויק בהפעלה: בודקים שוב שמיקום ההפעלה האחרון קטן ממשך הפרק הכולל או שווה לו. כך המשתמשים יוכלו להמשיך לצפות מהמקום שבו הם הפסיקו.

לסרטים:

  • מיקום הפעלה מדויק: בדומה לפרקים בטלוויזיה, צריך לוודא שמיקום ההפעלה האחרון מדויק.

לסרטונים בשידור חי:

  • פרטי השידור: כולל את שם המשדר של שידורים חיים.

לקליפים:

  • פרטי היוצר: מציינים את היוצר של הקליפ.

חשוב לזכור: אפליקציית האימות תסמן את הבעיות האלה, ותאפשר לכם לתקן אותן לפני שליחת האפליקציה. כך תוכלו לחסוך זמן ולהבטיח חוויה חלקה יותר למשתמשים.

שאלות לגבי חשבון ופרופיל

האפליקציה שלי משתמשת בהתחברויות אנונימיות של משתמשים. האם עדיין נדרש AccountProfile כדי להשתמש בתכונה 'המשך צפייה' בגרסה 2.0?

ה-API‏ AccountProfile מיועד לאפליקציות שמשתמשות בחשבונות משתמשים פרטיים. עם זאת, אנחנו מבינים שאפליקציות מסוימות, כמו שלך, עשויות להסתמך על התחברויות אנונימיות. כך פועלת התכונה 'המשך צפייה' 2.0 בתרחיש הזה:

  • השימוש ב-AccountProfile נדרש מבחינה טכנית, אבל... עדיין אפשר לשלב את התכונה 'המשך צפייה' 2.0 גם אם באפליקציה שלכם אין מערכת חשבונות משתמשים.
  • השימוש מוגבל למכשיר: היכולות של התכונה 'המשך צפייה' בגרסה 2.0 בין מכשירים מסתמכות על זיהוי משתמשים במכשירים שונים. מכיוון שלכניסות אנונימיות אין את הנתונים האלה, התכונה תהיה מוגבלת למכשיר הנוכחי של המשתמש.
  • איך מגדירים: כדי להגדיר את התכונה הזו, צריך להשבית את הסנכרון בין מכשירים. כך אפשר לוודא שהאפשרות 'המשך צפייה' תופיע רק במכשיר הספציפי שבו התחלתם לצפות בתוכן.

לסיכום: אפשר לשלב את התכונה 'המשך צפייה' 2.0 עם כניסות אנונימיות, אבל המשתמשים יוכלו להמשיך לצפות בתוכן רק באותו מכשיר.

האם אפשר להשתמש ב-AccountProfile רק עם accountId בלי profileId, גם אם האפליקציה שלי תומכת גם ב-accountId וגם ב-profileId?

כדי שהרכיב AccountProfile יפעל בצורה תקינה, צריך להגדיר גם את accountId וגם את profileId. הנה תיאור הסיבות לכך:

  • זיהוי עקבי: הערך accountId מזהה את המשתמש, והערך profileId מבחין בין פרופילים שונים בחשבון של אותו משתמש (אם רלוונטי). אם תספקו את שניהם, התכונה 'המשך צפייה' תעקוב אחרי התוכן ותציג אותו בצורה מדויקת בכל פרופיל בנפרד.
  • מניעת שגיאות: שימוש לא עקבי ב-accountId וב-profileId בקריאות שונות ל-API עלול להוביל להתנהגות לא צפויה ולשגיאות. לדוגמה, אם אתם כוללים את שניהם כשאתם מוסיפים תוכן לרשימת הצפייה בהמשך, אבל משתמשים רק ב-accountId כשאתם מוחקים תוכן, יכול להיות שהמערכת לא תוכל לזהות ולהסיר את הפריטים הרצויים בצורה נכונה.

האם צריך להשתמש ב-profileId כדי להפעיל את התכונה 'המשך צפייה 2.0'?

  • חובה לציין את accountId. הזיהוי הזה מאפשר לזהות את המשתמש במכשירים שונים.
  • הפרמטר profileId חיוני לחוויית משתמש טובה. למרות שבאופן טכני מדובר בפרמטר אופציונלי, מומלץ מאוד להשתמש בפרמטר profileId אם השירות שלכם תומך במספר פרופילים (כמו שקורה בהרבה שירותי סטרימינג). למה זה כל כך חשוב? כי בלי profileId, יכול להיות שבקטע 'המשך צפייה' יוצג תוכן מפרופילים אחרים באותו חשבון. מצב כזה עלול ליצור חוויה מבלבלת ומתסכלת למשתמשים.
  • בקיצור: כשמספקים את הערך profileId, התכונה 'המשך צפייה' משקפת בצורה מדויקת את היסטוריית הצפייה של כל משתמש. אלא אם האפליקציה שלך לא תומכת במושג של פרופיל בתוך חשבון, עליך לספק אותו.

איך Google משתמשת ב-profileId בצד שלה?

אם השירות מציע פרופילים שונים לצפייה בתוכן, המערכת תשתמש ב-accountId וב-profileId כדי לשייך את התוכן שנצפה במכשיר לחשבון Google שמחוברים אליו במכשיר. ‫Google תתעד את נתוני ContinueWatching בהתאם לשילוב של accountId ו-profileId. כל מכשיר Google שמחובר לאותו חשבון Google יקבל את הנתונים העדכניים ביותר מאותו חשבון משויך עם מזהה חשבון ומזהה פרופיל, בשורה 'המשך צפייה'.

האם צריך לקשר חשבון כדי להטמיע את התכונה 'המשך צפייה' גרסה 2.0?

אין צורך בקישור חשבון. השימוש בו יצומצם, וכל תרחישי השימוש שקשורים אליו יכוסו על ידי Device Entitlements API החדש.

שאלות בנושא סנכרון בין מכשירים

אם המשתמשים יביעו הסכמה לסנכרון בין מכשירים, התוכן שבו הם צופים יישמר בשרתים של Google TV, והם יוכלו להמשיך לצפות בו בצורה חלקה בכל מכשיר שמחובר לחשבון שלהם. ללא הסכמה, היסטוריית הצפייה שלהם נשארת מקומית למכשיר הנוכחי.

האם אפשר להגדיר את האפשרות 'סנכרון בין מכשירים' כ-false?

הדגל UserConsentToSyncAcrossDevices קובע אם נתוני ContinuationCluster של המשתמש מסונכרנים בין המכשירים שלו (טלוויזיה, טלפון, טאבלט וכו'). אם הדגל הזה מוגדר כ-false, האפשרות 'המשך צפייה' זמינה רק באותו מכשיר.

כדי להפיק את המרב מהתכונה שלנו למעקב המרות בכמה מכשירים, מומלץ מאוד לוודא שהאפליקציה מקבלת את הסכמת המשתמשים ולהגדיר את SyncAcrossDevices כ-true.

מכשירים? אילו נקודות נתונים משותפות לשרתים של צד שלישי ממכשירים שאינם Android?

ההסכמה נאספת ברמת המשתמש (ברמת הפרופיל או החשבון). אחרי קבלת ההסכמה, אפשר לשלוח את מטען הנתונים של התכונה 'המשך צפייה' על סמך האינטראקציות עם התוכן לכל מקום, כדי ש-Google תוכל לשקף את מצב ההפעלה של התכונה 'המשך צפייה' בכל הישויות שהמשתמשים מקיימים איתן אינטראקציות חלקיות או הבאות, בכל מכשיר (בלי לבקש שוב את ההסכמה בכל מכשיר או פלטפורמה). שותפים ישלחו את הסטטוס האחרון של המשתמשים לגבי צפייה בהמשך (בהתאם למפרט) שמשויך למזהה הפרופיל (שהופקד ב-Android).

שאלות לגבי REST API

יש תיעוד של ה-API ל-REST?

התאריך המשוער להשקת REST API הוא מרץ 2025. התאריך הזה מופיע במסמכי התיעוד למפתחים של התכונה 'המשך צפייה' גרסה 2.0.

שאלות מדור קודם בנושא 'במה לצפות עכשיו'

האם ממשק ה-API של איתור סרטונים מחליף את ממשק ה-API של 'הצעות לצפייה'?

‫Video Discovery API יהיה תואם לאחור בכל מכשירי Android TV שתומכים ב-Watch Next API. כל המפתחים צריכים להשתמש ב-Video Discovery API (המשך צפייה 2.0) כדי לפרסם בשורה 'המשך צפייה'.

שאלות בנושא בדיקות ושילוב

מה ההבדל בין LastPlayBackPositionTimeMillis לבין duration?

הערך של LastPlayBackPositionTimeMillis צריך לשקף את משך ההפעלה באלפיות השנייה שבהן המשתמש הפסיק לצפות (למשל, ‫605,000 אלפיות השנייה ל-10 דקות ו-5 שניות). הערך הזה אף פעם לא יכול להיות גדול ממשך הזמן הכולל של הישות.

לעומת זאת, LastEngagementTime היא חותמת הזמן שבה הייתה האינטראקציה האחרונה של המשתמש עם התוכן.

אילו תרחישי בדיקה עלינו לבצע?

בהמשך מפורטים מקרי בדיקה ל-Google TV שצוות בקרת האיכות שלנו מבצע. אפשר לבצע תרחישי בדיקה דומים גם בפלטפורמות אחרות.

  1. צופים בסרטון שאורכו יותר מ-20 דקות במשך כ-5 דקות. יוצאים מהאפליקציה. הכרטיס של הסרטון אמור להופיע בשורה 'המשך צפייה'. הערה: אנחנו מציגים רק 5 כרטיסים לכל אפליקציה של צד שלישי ב-CW
  2. אם תבחרו בכרטיס החדש שמופיע בשורה 'המשך צפייה', הסרטון ימשיך לפעול מהנקודה הנכונה.הערה: כל התוכן החדש או הישן ימשיך לפעול מהמקום שבו הוא הופסק בפעם האחרונה
  3. שינוי החשבון במכשיר GTV אמור לשנות את הכרטיסים בשורה 'המשך צפייה'. צריכים להופיע רק סרטונים מהחשבון הנוכחי. המיון הוא לפי הסדר הכרונולוגי, מהחדש לישן. הנתונים של פרופיל האפליקציה של צד שלישי יתערבבו עם הנתונים של פרופיל העבודה. הערה: ב-CW עבור GoogleAccount2 יוצג תוכן של צד שלישי ש-GoogleAccount2 צפה בו.
  4. יוצאים מהאפליקציה באמצעות הלחצן 'הקודם' > מוודאים שהכרטיס מוצג בשורה 'המשך צפייה'
  5. להסתיר את הסרטון בשורה 'המשך צפייה', הוא לא אמור להופיע שוב Test if hidden content stays hidden beyond 24 hours and even after the app opens after 24 hrs. מוודאים שאישור ההסתרה של פריט אחד לא גורם להסתרה של כמה פריטים.
  6. זמינות התוכן בקטע 'המשך צפייה' עם מטא נתונים מלאים: תמונה של הכרטיס, שם האפליקציה, שם התוכן, מספר העונה ומספר הפרק של תוכן לטלוויזיה
  7. ההתקדמות מוצגת בסרגל ההתקדמות
  8. המשתמש צפה בתוכן עד לסיום הקרדיטים – התוכן לא מוצג בקטע 'המשך צפייה'
  9. לוודא שלא מופיעים פריטים שלא נצפו בשורה 'המשך צפייה'
  10. לוודא שהפריטים ב-CW מסודרים לפי סדר כרונולוגי על סמך מתי התרחשה פעילות הצפייה, ולא על סמך מתי האפליקציה נפתחה לאחרונה או על סמך היום האחרון
  11. מוודאים שפרטי הפרק והעונה בכרטיס CW תואמים לתוכן הפרקים שנצפה
  12. מוודאים שפריטים שהושלמו (פריטים עם קרדיטים או מעבר לכך) לא מופיעים בקטע 'המשך צפייה'
  13. מכבים את המכשיר באמצע הצפייה בפרק, בסרט או בתוכנית. ‫"Turn off the device halfway through watching the episode/movie/show. צריך לוודא שכשמפעילים את המכשיר ובטלוויזיה אחרת, הכרטיס הנכון מוצג , במיקום הנכון ועם סרגל ההתקדמות"
  14. מכבים את המכשיר אחרי שצופים בפרק 1 עד הסוף, מאמתים
  15. פרק 1 מופיע ונעלם מהשורה 'המשך צפייה' [במכשיר השני ובהפעלה של מכשיר הבדיקה]
    1. פרק 2 (אם זמין) אמור להופיע בשורה 'המשך צפייה' [במכשיר השני ובהפעלה של מכשיר הבדיקה]
  16. תרחיש ראשון: TV1: GoogleAccount: mom, 3p account / profile: account 1 / profile_1. צפייה בתוכן ואימות של נתוני CW שמציגים תוכן שנצפה על ידי חשבון_1/פרופיל_1 של צד שלישי
  17. TV2: GoogleAccount: mom. בודקים את נתוני ה-CW מהתרחיש הראשון. עכשיו צריך להיכנס לאפליקציית הצד השלישי באמצעות חשבון אחר. חשבון או פרופיל של צד שלישי: account_2 / profile_2. צפייה בתוכן ואימות של נתוני CW שמוצגים בתוכן שנצפה על ידי חשבון_2/פרופיל_2 של צד שלישי

  18. ‫GoogleAccount: mom. לא מותקנת אפליקציית צד שלישי או כיסוי חדש למכשיר. במכשיר חדש(איפוס להגדרות היצרן), בודקים אם ב-CW מוצגים נתונים מאפליקציית צד שלישי שהייתה בשימוש האחרון בחשבון Google. הערה: שורת ה-CW לא אמורה להציג תוכן של צד שלישי אם מספר ה-GAIA עדיין לא משויך לפרופיל של צד שלישי במכשיר אחר

    1. ‫GoogleAccount: mom. הותקן כיסוי חדש למכשיר /אפליקציית צד שלישי, אבל לא בוצעה כניסה. במכשיר חדש(איפוס להגדרות היצרן), הכלי Verify CW מציג נתונים מהאפליקציה האחרונה של צד שלישי שהייתה בשימוש בחשבון Google.
    1. הערה: אם חשבון Google עדיין לא משויך לפרופיל של צד שלישי, התוכן של הצד השלישי לא אמור להופיע בשורה 'המשך צפייה'

התכונה 'המשך צפייה' לא מופיעה באפליקציית Google TV ל-iOS. מה קרה?

כדי שהאפשרות 'המשך צפייה' תופיע במכשירי iOS, צריך לשלוח קישורים עמוקים של iOS.

באיזו תדירות צריך לעדכן את המידע של 'המשך צפייה'? האם כדאי לעדכן את המידע על הצפייה בהמשך בתדירות גבוהה, למשל כל 15 שניות?

לא, לא מומלץ לבצע עדכונים בתדירות גבוהה. הנה תיאור הסיבות לכך:

  • השפעה על הביצועים: שליחת עדכונים באופן רציף יוצרת עומס מיותר על השרתים שלנו, ועלולה להאט את המערכת לכולם.
  • נתונים מיותרים: בזמן שמשתמש צופה באופן פעיל, מיקום ההפעלה שלו משתנה כל הזמן. שליחת עדכונים כל כמה שניות יוצרת הרבה נתונים מיותרים שלא עוזרים להמשך ההפעלה.

מתי כדאי לעדכן את המידע בקטע 'המשך צפייה':

התמקדו בתיעוד שינויים משמעותיים בהתקדמות הצפייה של המשתמש. אלה התרחישים העיקריים:

  • ההפעלה הושהתה או נעצרה: כשמשתמש משהה את הצפייה או מפסיק לצפות, צריך לשלוח עדכון כדי לשמור את המיקום הנוכחי שלו.
  • האפליקציה נסגרה או הועברה לרקע: אם משתמש יוצא מהאפליקציה או עובר לאפליקציה אחרת בזמן צפייה בסרטון, צריך לשלוח עדכון כדי לשמור את ההתקדמות שלו.
  • כשמשתמש מסיר פריט מהשורה 'המשך צפייה' באפליקציה

איך לעדכן ביעילות:

במקום להשתמש בעדכונים מתוזמנים, כדאי להשתמש באירועים במהלך מחזור החיים של נגן הווידאו או האפליקציה כדי להפעיל עדכונים. לדוגמה:

  • onPause, ‏ onStop: כשהפעלת הסרטון מושהית או מופסקת.
  • onAppClose, onAppBackgrounded: כשהאפליקציה נסגרת או עוברת לרקע.

אם תפעלו לפי ההנחיות האלה, תוכלו להשתמש במשאבים בצורה יעילה ועדיין לספק למשתמשים חוויה חלקה של 'המשך צפייה'.