מעורבות SDK Watch: הוראות לשילוב טכני של צד שלישי

כדי להגביר את רמת העניין באפליקציה, כדאי להגיע למשתמשים במקומות שבהם הם נמצאים. אפשר לשלב את Engage SDK כדי להציג תוכן של 'המשך צפייה' והמלצות מותאמות אישית ישירות למשתמשים בכמה פלטפורמות במכשיר, כמו אוספים, חבילת הבידור וחנות Play. השילוב מוסיף פחות מ-50KB (דחוס) לקובץ ה-APK הממוצע, וברוב האפליקציות הוא דורש כשבוע של זמן פיתוח. מידע נוסף זמין באתר העסקים שלנו.

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

פרטי השילוב

טרמינולוגיה

השילוב הזה כולל את שלושת סוגי האשכולות הבאים: המלצה, המשך ומומלצים.

  • באשכולות המלצות מוצגות הצעות מותאמות אישית לתוכן לצפייה משותף פיתוח ספציפי.

    ההמלצות שלכם בנויות באופן הבא:

    • אוסף המלצות: תצוגה בממשק המשתמש שמכילה קבוצה של המלצות מאותו שותף מפתח.

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

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

    איור 3. ממשק המשתמש של מרכז הבידור שבו מוצג אוסף ההמשכים עם המלצות שלא סיימתם לצפות בהן מכמה שותפים (רק המלצה אחת מוצגת כרגע).
  • באשכול מומלצים מוצגת קבוצה של ישויות מכמה שותפי פיתוח בממשק משתמש אחד. יהיה אשכול אחד של המלצות נבחרות, שיוצג בחלק העליון של ממשק המשתמש עם מיקום עדיפות מעל כל אשכולות ההמלצות. כל שותף מפתח יוכל לשדר עד 10 ישויות באשכול 'מומלצים'.

    איור 4. ממשק המשתמש של Entertainment Space שבו מוצג מקבץ של תוכן מומלץ עם המלצות מכמה שותפים (רק המלצה אחת מוצגת כרגע).

עבודה מקדימה

רמת ה-API המינימלית: 19

להוסיף את ספריית com.google.android.engage:engage-core לאפליקציה:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

מידע נוסף זמין במאמר בנושא חשיפת חבילות ב-Android 11.

סיכום

העיצוב מבוסס על הטמעה של שירות קשור.

הנתונים שלקוח יכול לפרסם כפופים למגבלות הבאות עבור סוגים שונים של אשכולות:

סוג האשכול מגבלות על אשכולות מגבלות מקסימליות על ישויות באשכול
אשכולות של המלצות עד 7 עד 50
אשכול המשכיות עד 1 עד 20
אשכול מוצג עד 1 עד 20

שלב 0: מעבר משילוב קיים של Media Home SDK

מיפוי מודלים של נתונים משילוב קיים

אם אתם מבצעים מיגרציה משילוב קיים של Media Home, בטבלה הבאה מפורטות דרכים למיפוי מודלים של נתונים בערכות SDK קיימות ל-Engage SDK החדש:

MediaHomeVideoContract integration equivalent שילוב מקביל של Engage SDK
com.google.android.mediahome.video.PreviewChannel com.google.android.engage.common.datamodel.RecommendationCluster
com.google.android.mediahome.video.PreviewChannel.Builder com.google.android.engage.common.datamodel.RecommendationCluster.Builder
com.google.android.mediahome.video.PreviewChannelHelper com.google.android.engage.video.service.AppEngageVideoClient
com.google.android.mediahome.video.PreviewProgram מחולק למחלקות נפרדות: EventVideo, LiveStreamingVideo, Movie, TvEpisode, TvSeason, TvShow, VideoClipEntity
com.google.android.mediahome.video.PreviewProgram.Builder מחולק ל-builders במחלקות נפרדות: EventVideo, LiveStreamingVideo, Movie, TvEpisode, TvSeason, TvShow, VideoClipEntity
com.google.android.mediahome.video.VideoContract כבר אין לי צורך בפגישה
com.google.android.mediahome.video.WatchNextProgram מחולק למאפיינים במחלקות נפרדות: EventVideoEntity, LiveStreamingVideoEntity, MovieEntity, TvEpisodeEntity, TvSeasonEntity, TvShowEntity, VideoClipEntity
com.google.android.mediahome.video.WatchNextProgram.Builder מחולק למאפיינים במחלקות נפרדות: EventVideoEntity, LiveStreamingVideoEntity, MovieEntity, TvEpisodeEntity, TvSeasonEntity, TvShowEntity, VideoClipEntity

פרסום אשכולות ב-Media Home SDK לעומת Engage SDK

ב-Media Home SDK, אשכולות וישויות פורסמו באמצעות ממשקי API נפרדים:

// 1. Fetch existing channels
List<PreviewChannel> channels = PreviewChannelHelper.getAllChannels();

// 2. If there are no channels, publish new channels
long channelId = PreviewChannelHelper.publishChannel(builder.build());

// 3. If there are existing channels, decide whether to update channel contents
PreviewChannelHelper.updatePreviewChannel(channelId, builder.build());

// 4. Delete all programs in the channel
PreviewChannelHelper.deleteAllPreviewProgramsByChannelId(channelId);

// 5. publish new programs in the channel
PreviewChannelHelper.publishPreviewProgram(builder.build());

באמצעות Engage SDK, פרסום של קלאסטרים וישויות משולב בקריאה אחת ל-API. כל הישויות ששייכות לאשכול מתפרסמות יחד עם האשכול:

Kotlin

RecommendationCluster.Builder()
            .addEntity(MOVIE_ENTITY)
            .addEntity(MOVIE_ENTITY)
            .addEntity(MOVIE_ENTITY)
            .setTitle("Top Picks For You")
            .build()

Java

new RecommendationCluster.Builder()
                        .addEntity(MOVIE_ENTITY)
                        .addEntity(MOVIE_ENTITY)
                        .addEntity(MOVIE_ENTITY)
                        .setTitle("Top Picks For You")
                        .build();

שלב 1: הזנת נתוני הישות

ב-SDK מוגדרות ישויות שונות שמייצגות כל סוג פריט. אנחנו תומכים בישויות הבאות בקטגוריה 'צפייה':

  1. MovieEntity
  2. TvShowEntity
  3. TvSeasonEntity
  4. TvEpisodeEntity
  5. LiveStreamingVideoEntity
  6. VideoClipEntity

בטבלה הבאה מפורטים המאפיינים והדרישות של כל סוג.

MovieEntity

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של ההפעלה חובה

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

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

‫URI של דף המידע אופציונלי

קישור העומק לאפליקציה של הספק כדי להציג פרטים על הסרט.

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

תאריך הפצה אופציונלי באפוקה באלפיות השנייה.
זמינות חובה

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

FREE_WITH_SUBSCRIPTION: התוכן זמין אחרי שהמשתמש רוכש מינוי.

PAID_CONTENT: התוכן מחייב את המשתמשים לקנות או לשכור אותו.

נרכש: המשתמש רכש או שכר את התוכן.

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

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

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

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

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

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

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

TvShowEntity

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של דף המידע חובה

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

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

‫URI של ההפעלה אופציונלי

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

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

תאריך שידור הפרק הראשון אופציונלי באפוקה באלפיות השנייה.
תאריך השידור של הפרק האחרון אופציונלי באפוקה באלפיות השנייה.
זמינות חובה

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

FREE_WITH_SUBSCRIPTION: התוכן זמין אחרי שהמשתמש רוכש מינוי.

PAID_CONTENT: התוכן מחייב את המשתמשים לקנות או לשכור אותו.

נרכש: המשתמש רכש או שכר את התוכן.

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

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

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

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

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

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

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

TvSeasonEntity

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של דף המידע חובה

קישור עומק לאפליקציה של הספק כדי להציג את הפרטים של העונה של תוכנית הטלוויזיה (TV show).

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

‫URI של ההפעלה אופציונלי

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

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

הצגת מספר העונה

אופציונלי

זמין בגרסה 1.3.1

מחרוזת
תאריך שידור הפרק הראשון אופציונלי באפוקה באלפיות השנייה.
תאריך השידור של הפרק האחרון אופציונלי באפוקה באלפיות השנייה.
זמינות חובה

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

FREE_WITH_SUBSCRIPTION: התוכן זמין אחרי שהמשתמש רוכש מינוי.

PAID_CONTENT: התוכן מחייב את המשתמשים לקנות או לשכור אותו.

נרכש: המשתמש רכש או שכר את התוכן.

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

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

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

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

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

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

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

TvEpisodeEntity

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של ההפעלה חובה

קישור העומק לאפליקציית הספק כדי להתחיל להפעיל את הפרק.

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

‫URI של דף המידע אופציונלי

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

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

הצגת מספר הפרק

אופציונלי

זמין בגרסה 1.3.1

מחרוזת
תאריך השידור חובה באפוקה באלפיות השנייה.
זמינות חובה

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

FREE_WITH_SUBSCRIPTION: התוכן זמין אחרי שהמשתמש רוכש מינוי.

PAID_CONTENT: התוכן מחייב את המשתמשים לקנות או לשכור אותו.

נרכש: המשתמש רכש או שכר את התוכן.

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

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

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

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

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

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

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

LiveStreamingVideoEntity

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של ההפעלה חובה

קישור העומק לאפליקציה של הספק כדי להתחיל להפעיל את הסרטון.

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

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

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

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

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

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

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

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

VideoClipEntity

אובייקט VideoClipEntity מייצג ישות של סרטון שמגיעה ממדיה חברתית, כמו טיקטוק או YouTube.

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

הנחיות זמינות במאמר בנושא מפרט לתמונות.

‫URI של ההפעלה חובה

קישור העומק לאפליקציה של הספק כדי להתחיל להפעיל את הסרטון.

הערה: אפשר להשתמש בקישורי עומק לשיוך (Attribution). אפשר לעיין בשאלות הנפוצות

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

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

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

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

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

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

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

מפרט לתמונות

בקטע הבא מפורטים המפרטים הנדרשים לנכסי תמונות:

פורמטים של קבצים

‫PNG, ‏ JPG, ‏ GIF סטטי, WebP

גודל קובץ מקסימלי

‎5120 KB

המלצות נוספות

  • האזור הבטוח לתמונות: התוכן החשוב צריך להופיע ב-80% המרכזיים של התמונה.

דוגמה

Kotlin

var movie = MovieEntity.Builder()
    .setName("Avengers")
    .addPosterImage(Image.Builder()
                          .setImageUri(Uri.parse("http://www.x.com/image.png"))
                          .setImageHeightInPixel(960)
                          .setImageWidthInPixel(408)
                          .build())
    .setPlayBackUri(Uri.parse("http://tv.com/playback/1"))
    .setReleaseDateEpochMillis(1633032895L)
    .setAvailability(ContentAvailability.AVAILABILITY_AVAILABLE)
    .setDurationMillis(12345678L)
    .addGenre("action")
    .addContentRating("R")
    .setWatchNextType(WatchNextType.TYPE_NEW)
    .setLastEngagementTimeMillis(1664568895L)
    .build()

Java

MovieEntity movie = new MovieEntity.Builder()
                  .setName("Avengers")
                  .addPosterImage(
                      new Image.Builder()
                          .setImageUri(Uri.parse("http://www.x.com/image.png"))
                          .setImageHeightInPixel(960)
                          .setImageWidthInPixel(408)
                          .build())
                  .setPlayBackUri(Uri.parse("http://tv.com/playback/1"))
                  .setReleaseDateEpochMillis(1633032895L)
                  .setAvailability(ContentAvailability.AVAILABILITY_AVAILABLE)
                  .setDurationMillis(12345678L)
                  .addGenre("action")
                  .addContentRating("R")
                  .setWatchNextType(WatchNextType.TYPE_NEW)
                  .setLastEngagementTimeMillis(1664568895L)
                  .build();

שלב 2: ציון נתונים של אוסף

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

AppEngagePublishClient אחראי לפרסום של אוספים. ממשקי ה-API הבאים זמינים בלקוח:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishContinuationCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteContinuationCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

ה-API הזה משמש כדי לבדוק אם השירות זמין לשילוב ואם אפשר להציג את התוכן במכשיר.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

ה-API הזה משמש לפרסום רשימה של אובייקטים מסוג RecommendationCluster.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

כשהשירות מקבל את הבקשה, הפעולות הבאות מתבצעות במסגרת עסקה אחת:

  • הנתונים הקיימים של RecommendationCluster משותף המפתחים יוסרו.
  • הנתונים מהבקשה מנותחים ומאוחסנים ב-RecommendationCluster המעודכן.

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

publishFeaturedCluster

ה-API הזה משמש לפרסום רשימה של אובייקטים מסוג FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

כשהשירות מקבל את הבקשה, הפעולות הבאות מתבצעות במסגרת עסקה אחת:

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

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

publishContinuationCluster

משתמשים ב-API הזה כדי לפרסם אובייקט ContinuationCluster.

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

כשהשירות מקבל את הבקשה, הפעולות הבאות מתבצעות במסגרת עסקה אחת:

  • הנתונים הקיימים של ContinuationCluster משותף המפתחים יוסרו.
  • הנתונים מהבקשה מנותחים ומאוחסנים ב-ContinuationCluster המעודכן.

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

publishUserAccountManagementRequest

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

המטא-נתונים הבאים הם חלק מכרטיס הכניסה –

מאפיין דרישה תיאור
‫URI של הפעולה חובה קישור עומק לפעולה (כלומר, מעבר לדף הכניסה לאפליקציה)
תמונה אופציונלי – אם לא מספקים את הערך הזה, חובה לספק את הערך Title (שם).

התמונה שמוצגת בכרטיס

תמונות ביחס גובה-רוחב של 16x9 וברזולוציה של ‎1264x712

כותרת אופציונלי – אם לא מספקים את הערך הזה, חובה לספק את הערך של תמונה השם שמופיע בכרטיס
טקסט הפעולה אופציונלי הטקסט שמוצג ב-CTA (למשל: כניסה)
כותרת משנה אופציונלי כתובית אופציונלית בכרטיס

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

כשהשירות מקבל את הבקשה, הפעולות הבאות מתבצעות במסגרת עסקה אחת:

  • נתוני UserAccountManagementCluster קיימים מהשותף המפתח יוסרו.
  • הנתונים מהבקשה מנותחים ומאוחסנים באשכול UserAccountManagementCluster המעודכן.

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

updatePublishStatus

אם מסיבה עסקית פנימית כלשהי אף אחת מהקבוצות לא פורסמה, מומלץ מאוד לעדכן את סטטוס הפרסום באמצעות API‏ updatePublishStatus. הדבר חשוב כי :

  • חשוב לספק את הסטטוס בכל התרחישים, גם כשהתוכן מתפרסם (STATUS == PUBLISHED), כדי לאכלס לוחות בקרה שמשתמשים בסטטוס המפורש הזה כדי להציג את מצב השילוב ומדדים אחרים.
  • אם לא מתפרסם תוכן אבל סטטוס השילוב לא שבור (STATUS == NOT_PUBLISHED), ‏ Google יכולה להימנע מהפעלת התראות בלוחות הבקרה של תקינות האפליקציה. ההודעה מאשרת שהתוכן לא פורסם בגלל מצב צפוי מנקודת המבט של הספק.
  • היא עוזרת למפתחים לקבל תובנות לגבי המועד שבו הנתונים מתפרסמים לעומת המועד שבו הם לא מתפרסמים.
  • יכול להיות ש-Google תשתמש בקודי הסטטוס כדי לעודד את המשתמש לבצע פעולות מסוימות באפליקציה כדי שיוכל לראות את התוכן שלה או להתגבר על הבעיה.

רשימת קודי הסטטוס של פרסום שעומדים בדרישות :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

אם התוכן לא פורסם כי המשתמש לא מחובר לחשבון, Google תמליץ לפרסם את כרטיס הכניסה. אם מסיבה כלשהי הספקים לא יכולים לפרסם את כרטיס הכניסה, מומלץ לקרוא ל-API‏ updatePublishStatus עם קוד הסטטוס NOT_PUBLISHED_REQUIRES_SIGN_IN.

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

ממשק ה-API הזה משמש למחיקת התוכן של קבוצות המלצות.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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

deleteFeaturedCluster

ממשק ה-API הזה משמש למחיקת התוכן של קבוצת מוצרים נבחרים.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

deleteContinuationCluster

ממשק ה-API הזה משמש למחיקת התוכן של Continuation Cluster.

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

כשהשירות מקבל את הבקשה, הוא מסיר את הנתונים הקיימים מ-Continuation Cluster. במקרה של שגיאה, הבקשה כולה נדחית והמצב הקיים נשמר.

deleteUserManagementCluster

ממשק ה-API הזה משמש למחיקת התוכן של UserAccountManagement Cluster.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

כשהשירות מקבל את הבקשה, הוא מסיר את הנתונים הקיימים מהאשכול UserAccountManagement. במקרה של שגיאה, הבקשה כולה נדחית והמצב הקיים נשמר.

deleteClusters

ממשק ה-API הזה משמש למחיקת התוכן של סוג מסוים של אשכול.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

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

טיפול בשגיאות

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

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

השגיאה מוחזרת כ-AppEngageException עם הסיבה שכלולה כקוד שגיאה.

קוד שגיאה שם השגיאה הערה
1 SERVICE_NOT_FOUND השירות לא זמין במכשיר הנתון.
2 SERVICE_NOT_AVAILABLE השירות זמין במכשיר הנתון, אבל הוא לא זמין בזמן השיחה (לדוגמה, הוא מושבת באופן מפורש).
3 SERVICE_CALL_EXECUTION_FAILURE הפעלת המשימה נכשלה בגלל בעיות בשרשור. במקרה כזה, אפשר לנסות שוב.
4 SERVICE_CALL_PERMISSION_DENIED למתקשר אין הרשאה לבצע את הקריאה לשירות.
5 SERVICE_CALL_INVALID_ARGUMENT הבקשה מכילה נתונים לא תקינים (לדוגמה, מספר האשכולות חורג מהמספר המותר).
6 SERVICE_CALL_INTERNAL יש שגיאה בצד השירות.
7 SERVICE_CALL_RESOURCE_EXHAUSTED הקריאה לשירות מתבצעת בתדירות גבוהה מדי.

שלב 3: טיפול ב-Intents של שידור

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

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

צריך להגדיר את BroadcastReceiver באחת משתי הדרכים הבאות:

  • רישום דינמי של מופע של המחלקה BroadcastReceiver באמצעות Context.registerReceiver(). ההרשאה הזו מאפשרת תקשורת מאפליקציות שעדיין פעילות בזיכרון.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

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

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

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

Java

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

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION 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);

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

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

}
  • מצהירים באופן סטטי על הטמעה באמצעות התג <receiver> בקובץ AndroidManifest.xml. ההרשאה הזו מאפשרת לאפליקציה לקבל שידורי Intent כשהיא לא פועלת, וגם מאפשרת לאפליקציה לפרסם את התוכן.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

השירות שולח את ה-Intents הבאים:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION מומלץ להתחיל שיחת publishRecommendationClusters כשמתקבלת הכוונה הזו.
  • com.google.android.engage.action.PUBLISH_FEATURED מומלץ להתחיל שיחת publishFeaturedCluster כשמתקבלת הכוונה הזו.
  • com.google.android.engage.action.PUBLISH_CONTINUATION מומלץ להתחיל שיחת publishContinuationCluster כשמקבלים את הכוונה הזו.

תהליך עבודה של שילוב

מדריך מפורט לאימות השילוב אחרי שהוא הושלם זמין במאמר בנושא תהליך העבודה של שילוב Engage למפתחים.

שאלות נפוצות

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

איש/אשת הקשר

אם יש שאלות במהלך תהליך השילוב, אפשר לפנות אל engage-developers@google.com.

השלבים הבאים

אחרי שמסיימים את השילוב, השלבים הבאים הם:

  • שולחים אימייל לכתובת engage-developers@google.com ומצרפים את קובץ ה-APK המשולב שמוכן לבדיקה על ידי Google.
  • ‫Google מבצעת אימות ובדיקה פנימית כדי לוודא שהשילוב פועל כמו שצריך. אם צריך לבצע שינויים, Google תיצור איתכם קשר ותספק את כל הפרטים הנדרשים.
  • בסיום הבדיקה, אם לא צריך לבצע שינויים, Google תיצור איתכם קשר כדי להודיע לכם שאתם יכולים להתחיל לפרסם את קובץ ה-APK המעודכן והמשולב ב-Play Store.
  • אחרי ש-Google תאשר שה-APK המעודכן פורסם ב-Play Store, יכול להיות שקטעי ההמלצות, האפליקציות המומלצות וההמשך יפורסמו ויוצגו למשתמשים.