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

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

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

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

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

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

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

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

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

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

שאלות נפוצות בנושא Broadcast Intent

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

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

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

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

אין הרשאה להרצה ברקע

בזמן הרישום של ה-intent לשידור, יכול להיות שתופיע השגיאה הבאה:

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?

התכונה 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?

  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. אם אתם שותפים בתוכנית הגישה המוקדמת או רוצים להצטרף בקרוב, צרו איתנו קשר כדי שנוכל להגדיר את הרשאות הגישה לפני שתתחילו לשלב את Engage SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

התאריך המשוער להשקת ה-API בארכיטקטורת REST הוא מרץ 2025, והוא מתועד במסמכי התיעוד למפתחים של Engage.

שאלות קודמות בקטע "הצעות לצפייה"

האם Engage מחליף את הצעות לצפייה API?

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

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

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

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

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

אילו מקרי בדיקה צריך לבצע?

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

  1. צפייה בסרטון שאורכו יותר מ-20 דקות במשך כ-5 דקות. יוצאים מהאפליקציה. כרטיס הסרטון אמור להופיע בשורה "המשך צפייה". הערה: אנחנו מציגים רק 5 כרטיסים לכל אפליקציה של צד שלישי ב-CW
  2. כשבוחרים בכרטיס החדש שמופיע בשורת "המשך צפייה", הסרטון אמור להמשיך לפעול מהנקודה הנכונה. הערה: כל תוכן חדש או ישן אמור להמשיך לפעול מהנקודה שבה הוא הופסק בפעם האחרונה.
  3. כשמחליפים חשבון במכשיר GTV, הכרטיסים בשורת "המשך צפייה" אמורים להשתנות. יוצגו רק סרטונים מהחשבון הנוכחי. המיון הוא לפי סדר כרונולוגי. פרופיל האפליקציה של צד שלישי יתערבב עם פרופיל ה-CW. הערה: בשורת "המשך צפייה" של GoogleAccount2 יוצג תוכן של צד שלישי ש-GoogleAccount2 צפה בו.
  4. יוצאים מהאפליקציה באמצעות הכפתור "הקודם" > מוודאים שהכרטיס מוצג בשורה "המשך צפייה"
  5. הסתרת הסרטון בשורת "המשך צפייה", הוא לא אמור להופיע שוב. צריך לבדוק אם התוכן המוסתר נשאר מוסתר אחרי 24 שעות, וגם אחרי שפותחים את האפליקציה אחרי 24 שעות. מוודאים שהסתרת פריט אחד לא מסתירה כמה פריטים.
  6. זמינות התוכן בשורת "המשך צפייה" עם מטא-נתונים מלאים: תמונת כרטיס, שם האפליקציה, שם התוכנית, מספר העונה והפרק של תוכני טלוויזיה
  7. ההתקדמות של הבדיקה מוצגת בסרגל ההתקדמות
  8. המשתמש צפה בתוכן עד לכתוביות הסיום – התוכן לא מוצג בשורת "המשך צפייה"
  9. מוודאים שפריטים שלא נצפו לא מופיעים בשורת "המשך צפייה"
  10. מוודאים שהפריטים ב-CW מסודרים בסדר כרונולוגי לפי הזמן שבו התרחשה פעילות הצפייה, ולא לפי הפעם האחרונה שהאפליקציה נפתחה או לפי היום האחרון.
  11. מוודאים שפרטי הפרק והעונה בכרטיס "המשך צפייה" תואמים למה שנצפה בתוכן הפרק.
  12. מוודאים שפריטים שהצפייה בהם הושלמה (פריטים שהגיעו לשלב הקרדיטים או מעבר לכך) לא מופיעים בשורת "המשך צפייה".
  13. מכבים את המכשיר באמצע הצפייה בפרק, בסרט או בתוכנית. "כבו את המכשיר באמצע הצפייה בפרק, בסרט או בתוכנית. צריך לוודא שכשמפעילים את המכשיר ובטלוויזיה אחרת, מוצג הכרטיס הנכון של CW , במיקום הנכון ובסרגל ההתקדמות הנכון"
  14. מכבים את המכשיר אחרי שצופים בפרק 1 עד הסוף, מוודאים
  15. פרק 1 נעלם ולא מופיע שוב בשורת "המשך צפייה" [במכשיר השני ובהפעלת מכשיר הבדיקה]
    1. פרק 2 (אם הוא זמין) אמור להופיע בשורת "המשך צפייה" [במכשיר השני ובהפעלת מכשיר הבדיקה]
  16. תרחיש ראשון: טלוויזיה 1: חשבון Google: אמא, חשבון או פרופיל של צד שלישי: חשבון 1 / פרופיל 1. צופים בתוכן ובודקים אם בנתוני CW מוצג התוכן שנצפה על ידי חשבון צד ג'_1/פרופיל_1
  17. TV2: GoogleAccount: mom. מאמתים את נתוני ה-CW מהתרחיש הראשון. עכשיו מתחברים לאפליקציה של הצד השלישי באמצעות חשבון אחר. חשבון או פרופיל של צד שלישי: account_2 או profile_2. צופים בתוכן ובודקים אם נתוני CW מציגים את התוכן שנצפה על ידי חשבון_2/פרופיל_2 של הצד השלישי

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

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

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

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

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

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

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

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

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

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

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

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

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

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