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

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

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

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

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

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

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

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

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

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

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

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

כדי להציג למשתמשים תוכן עדכני, צריך להשתמש ב-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>

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

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

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

שאלות כלליות

מה זה Engage?

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

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

האם Video Discovery API זהה ל-Engage?

כן, הן זהות. Engage SDK היא ספרייה שכוללת תמיכה בשורה 'המשך צפייה'.‏ Engage תומכת בסוגים נוספים של ישויות תוכן מלבד סרטונים, ולכן השילוב לא נקרא יותר 'גילוי סרטונים'.

מה היתרונות בשימוש ב-Engage?

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

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

הערה חשובה: כל השילובים החדשים של התכונה 'המשך צפייה' חייבים להשתמש ב-Engage. מערכת 'הפעלת השיר הבא במכשירים שלך' הישנה יוצאת משימוש.

באילו פלטפורמות יש תמיכה ב-Engage?

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

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

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

האם Engage זמין לכולם?

ההשקה של Engage מתבצעת בשלבים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לסרטים:

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

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

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

לקליפים:

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

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

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

האפליקציה שלי משתמשת בהתחברויות של משתמשים לא רשומים. האם עדיין נדרש 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 תתעד את הנתונים של 'המשך צפייה' בשילוב של accountId ושל profileId. כל מכשיר Google שמחובר אליו אותו חשבון Google יקבל את הנתונים העדכניים ביותר מאותו שילוב משויך של accountId ושל profileId בשורה 'המשך צפייה'.

האם צריך לקשר חשבון כדי להטמיע את Engage?

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

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

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

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

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

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

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

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

שאלות לגבי API בארכיטקטורת REST

יש תיעוד של ה-API בארכיטקטורת REST?

התאריך המשוער להשקת REST API הוא מרץ 2025. המידע הזה מופיע במאמרי העזרה למפתחים של Engage.

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

האם Engage מחליף את Watch Next API?

התכונה 'הצגת תוכן מעניין' תהיה תואמת לאחור בכל מכשירי Android TV שתומכים ב-Watch Next API. כדי לשלב את Engage ב-Google TV ובפלטפורמות אחרות שתומכות ב-Engage, מפתחים צריכים להשתמש ב-Engage SDK.

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

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

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

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

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

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

  1. צופים בסרטון שאורכו יותר מ-20 דקות למשך כ-5 דקות. יוצאים מהאפליקציה. כרטיס הסרטון אמור להופיע בשורה 'המשך צפייה'. הערה: אנחנו מציגים רק 5 כרטיסים לכל אפליקציית צד שלישי בשורה 'המשך צפייה'
  2. אם תבחרו בכרטיס החדש שהופיע בשורה 'המשך צפייה', הסרטון ימשיך לפעול מהנקודה הנכונה בסרטון.הערה: כל תוכן חדש או ישן ימשיך לפעול מהמקום שבו הוא הופסק בפעם האחרונה
  3. שינוי החשבון במכשיר GTV אמור לשנות את הכרטיסים בשורה 'המשך צפייה'. אמורים להופיע רק סרטונים מהחשבון הנוכחי. המיון הוא לפי הסדר של התאריכים האחרונים. הנתונים של פרופיל האפליקציה של צד שלישי יתערבבו עם נתוני ה-CW. הערה: ב-CW עבור GoogleAccount2 יוצג תוכן של צד שלישי ש-GoogleAccount2 צפה בו
  4. יוצאים מהאפליקציה באמצעות הלחצן 'הקודם' > מוודאים שהכרטיס מוצג בשורה 'המשך צפייה'
  5. להסתיר את הסרטון בשורה 'המשך צפייה'. הוא לא אמור להופיע שוב. לבדוק אם תוכן מוסתר נשאר מוסתר למשך יותר מ-24 שעות, ואפילו אחרי שהאפליקציה נפתחת אחרי 24 שעות. חשוב לוודא שאישור ההסתרה של פריט אחד לא גורם להסתרה של כמה פריטים.
  6. זמינות התוכן בשורה 'המשך צפייה' עם מטא-נתונים מלאים: תמונה בכרטיס, שם האפליקציה, שם התוכן, מספר העונה ומספר הפרק של תוכן לטלוויזיה
  7. ההתקדמות מוצגת בסרגל ההתקדמות
  8. המשתמש צפה בתוכן עד לסיום הקרדיטים – התוכן לא מוצג בשורה 'המשך צפייה'
  9. מוודאים שלא מופיעים פריטים שלא נצפו בשורה 'המשך צפייה'
  10. לוודא שפריטי הפעילות בצפייה מסודרים לפי סדר כרונולוגי על סמך הזמן שבו התרחשה הפעילות בצפייה, ולא על סמך הפעם האחרונה שבה האפליקציה נפתחה או היום האחרון
  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 שמציגים את התוכן שנצפה על ידי 3P account_1/profile_1

  17. ‫TV2: GoogleAccount: mom. בודקים את נתוני ה-CW מהתרחיש הראשון. עכשיו צריך להתחבר לאפליקציה של צד שלישי באמצעות חשבון אחר. חשבון או פרופיל של צד שלישי: account_2 / profile_2. צפייה בתוכן ואימות של נתוני CW שמוצגים בתוכן שנצפה על ידי 3p account_2/profile_2

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

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

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

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

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

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

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

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

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

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

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

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

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

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