‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

מיומנויות ב-Android

הצגת הקוד ב-GitHub

שילוב של Engage SDK

כדי לשלב, לנפות באגים ולפתור בעיות בהטמעה, אתם יכולים להשתמש במיומנות Android של Engage SDK.

כדי להתקין את המיומנות מ-Android CLI, מריצים את הפקודה:

android skills add engage-sdk-integration

פרטי השילוב

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

הסברים על המונחים

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

אשכולות המלצות מציגים הצעות מותאמות אישית משותף פיתוח ספציפי. זוהי תצוגה בממשק המשתמש שמכילה קבוצה של המלצות מאותו שותף פיתוח.
- ‫ArticleEntity: מייצג המלצה מבוססת-טקסט לתוכן שרלוונטי ליותר מקטגוריית תוכן אחת. הפריט ArticleEntity מאפשר למפתחים לספק מגוון של תוכן טקסט ותמונות עם יותר מטא-נתונים כדי להציג את המידע למשתמשים בהשוואה ל-GenericFeaturedEntity. לדוגמה: תוכן שיווקי, תקציר חדשות
  
  איור 1: ממשק משתמש שבו מוצג ArticleEntity יחיד באשכול Recommendations.
- ‫EventEntity: מייצג אירוע שיתרחש בעתיד. שעת ההתחלה של האירוע היא מידע קריטי שצריך להעביר למשתמשים.
  
  איור 2: ממשק משתמש שבו מוצג EventEntity יחיד בתוך אשכול המלצות.
- ‫LodgingEntity: הישות LodgingEntity מייצגת מקום לינה, כמו מלון, דירה או בית נופש להשכרה לטווח קצר או ארוך.
  
  איור 3: ממשק משתמש שבו מוצג LodgingEntity אחד באשכול ההמלצות.
- ‫StoreEntity: הישות StoreEntity מייצגת חנות, מסעדה, בית קפה וכו'. היא מדגישה תוכן שבו מקום האוכל או החנות הם המידע החשוב שצריך להעביר למשתמשים.
  
  איור 4: ממשק משתמש שבו מוצג StoreEntity יחיד בתוך אשכול Recommendations.
- ‫PointOfInterestEntity: הישות PointOfInterestEntity מייצגת מקום מעניין, כמו תחנת דלק, מקום לאירועים, פארק שעשועים, מוזיאון, אטרקציה תיירותית, מסלול טיול וכו'. היא מדגישה תוכן שבו המיקום הוא מידע קריטי שצריך להעביר למשתמשים. הוא לא מיועד ללינה, לחנות או למסעדה.
  
  איור 5: ממשק משתמש שבו מוצג PointOfInterestEntity יחיד באשכול Recommendations.
- ‫PersonEntity: מייצג אדם. ההמלצות יכולות להיות להדגיש אדם בקטגוריות כמו בריאות וכושר, ספורט, היכרויות וכו'.
  
  איור 5: ממשק משתמש שבו מוצג PersonEntity אחד באשכול Recommendations.
אוסף ההמשכים מציג תוכן שהמשתמשים צפו בו לאחרונה מכמה שותפי פיתוח בקבוצה אחת בממשק המשתמש. כל שותף פיתוח יוכל לשדר עד 10 ישויות באשכול ההמשך.

התוכן של ההמשך יכול להיות במבנה הבא:
- ‫ArticleEntity: מייצג המלצה מבוססת-טקסט לתוכן שרלוונטי ליותר מקטגוריית תוכן אחת. אפשר להשתמש בישות הזו כדי לייצג כתבות חדשותיות או תוכן אחר שהמשתמש לא סיים לקרוא, ורוצה להמשיך לקרוא מהמקום שבו הפסיק. לדוגמה: תוכן שיווקי, תקציר חדשות
  
  איור 6. ממשק משתמש שמוצג בו ArticleEntity אחד בתוך אוסף המשכים.
- ‫RestaurantReservationEntity: הישות RestaurantReservationEntity מייצגת הזמנה למסעדה או לבית קפה, ועוזרת למשתמשים לעקוב אחרי הזמנות קרובות או פעילות למסעדות.
  
  איור 7. ממשק משתמש שמוצג בו RestaurantReservationEntity אחד בתוך אשכול המשך.
- ‫EventReservationEntity: הישות EventReservationEntity מייצגת הזמנה לאירוע ועוזרת למשתמשים לעקוב אחרי הזמנות לאירועים קרובים או לאירועים שמתקיימים כרגע. האירועים יכולים לכלול, בין היתר:
  - אירועי ספורט, כמו הזמנת כרטיסים למשחק כדורגל
  - אירועי גיימינג, כמו הזמנת מקום לספורט אלקטרוני
  - אירועי בידור, כמו הזמנת כרטיסים לסרט בקולנוע, להופעה, להצגה בתיאטרון או לאירוע חתימה על ספרים
  - הזמנות של נסיעות או נקודות עניין, כמו סיורים מודרכים, כרטיסים למוזיאון
  - הזמנות לאירועים חברתיים, סמינרים וכנסים
  - הזמנת מקום במפגשי הדרכה או לימודים
  איור 8. ממשק משתמש שמוצג בו EventReservationEntity אחד בתוך אשכול המשך.
- ‫LodgingReservationEntity: הישות LodgingEntityReservation מייצגת הזמנה של מקום לינה בנסיעה, ועוזרת למשתמשים לעקוב אחרי הזמנות קרובות או פעילות של מלונות או יחידות אירוח.
  
  איור 9. ממשק משתמש שמוצגת בו ישות אחת מסוג LodgingReservationEntity באוסף ההמשכים.
- ‫TransportationReservationEntity: הישות TransportationReservationEntity מייצגת הזמנה של נסיעה בכל אמצעי תחבורה, ועוזרת למשתמשים לעקוב אחרי הזמנות של טיסות, מעבורות, רכבות, אוטובוסים, נסיעות בהזמנה או הפלגות קרובות או פעילות.
  
  איור 10. ממשק משתמש שמוצגת בו ישות אחת מסוג TransportationReservationEntity בתוך אוסף המשכים.
- ‫VehicleRentalReservationEntity: הישות VehicleRentalReservationEntity מייצגת הזמנה של השכרת רכב, ועוזרת למשתמשים לעקוב אחרי הזמנות קרובות או פעילות של השכרת רכב.
  
  איור 11. ממשק משתמש שמוצגת בו ישות אחת מסוג VehicleRentalReservationEntity בתוך אוסף המשכים.
האשכול מומלצים הוא תצוגה בממשק המשתמש שמציגה את ה-GenericFeaturedEntity הראשי שנבחר מהרבה שותפים מפתחים בקבוצה אחת בממשק המשתמש. יש רק קבוצת תוכן מומלץ אחת, שמופיעה בחלק העליון של ממשק המשתמש, במיקום בולט מעל כל קבוצות ההמלצות. כל שותף פיתוח יכול לשדר ישות אחת מסוג נתמך באוסף "מומלצים", עם ישויות רבות (ייתכן מסוגים שונים) ממפתחי אפליקציות מרובים באוסף "מומלצים".
- ‫GenericFeaturedEntity: בניגוד לפריט Recommendation, פריט Featured צריך לשמש לתוכן מוביל יחיד של מפתחים, ולייצג את התוכן החשוב ביותר שיהיה מעניין ורלוונטי למשתמשים.
  
  איור 12: ממשק משתמש שמוצג בו כרטיס GenericFeaturedEntity ראשי אחד באשכול Featured

הכנה

רמת 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.6.0'
}

סיכום

העיצוב מבוסס על הטמעה של שרת מאגד (bound service).

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

סוג האשכול	מגבלות על אשכולות	מספר הישויות המינימלי באשכול	מגבלות מקסימליות על ישויות באשכול
אשכולות של המלצות	עד 7	לפחות אחד	עד 50 (`ArticleEntity`,‏ `EventEntity`,‏ `LodgingEntity`,‏ `StoreEntity`,‏ `PointOfInterestEntity` או `PersonEntity`)
אוסף ההמשכים	לכל היותר 1	לפחות אחד	עד 20 (`ArticleEntity`, `EventReservationEntity`, `LodgingReservationEntity`, `TransportationReservationEntity` או `VehicleRentalReservationEntity`)
אשכול מומלץ	לכל היותר 1	לפחות אחד	עד 20 (`GenericFeaturedEntity`)

שלב 1: מסירת נתוני הישות

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

GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
PersonEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity

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

`GenericFeaturedEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
תמונות של פוסטרים	חובה	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: אם מוסיפים תג, צריך להקפיד על אזור בטוח של 24 dps בחלק העליון והתחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
כותרת	אופציונלי	שם הישות.	טקסט חופשי גודל טקסט מומלץ: 50 תווים
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה. עיצוב מיוחד של חוויית המשתמש מעל התמונה או הסרטון, למשל, שכבת-על של תג על התמונה "עדכון בזמן אמת" משך הקריאה של המאמר
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימת טיפוסים בני מנייה (enum) אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`ArticleEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	טקסט חופשי גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: מומלץ מאוד להוסיף תמונה. אם יש תג, צריך לוודא שיש אזור בטוח של 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מקור – כותרת	אופציונלי	שם המחבר, הארגון או הכתב	טקסט חופשי גודל טקסט מומלץ: פחות מ-25 תווים
מקור – תמונה	אופציונלי	תמונה של המקור, כמו המחבר, הארגון או הכתב	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה. טיפול מיוחד בחוויית המשתמש מעל התמונה או הסרטון, למשל שכבת-על של תג על התמונה "עדכון בזמן אמת" משך הקריאה של המאמר
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מועד פרסום התוכן	אופציונלי	חותמת הזמן של התקופה במילי-שניות שבה התוכן פורסם או עודכן באפליקציה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מועד ההתעניינות האחרון	חובה בתנאים מסוימים	חותמת הזמן של התקופה באלפיות השנייה שבה המשתמש היה באינטראקציה עם הישות הזו בפעם האחרונה. הערה: השדה הזה הוא חובה אם הישות הזו היא חלק מאשכול ההמשך.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
אחוז ההתקדמות	חובה בתנאים מסוימים	אחוז התוכן המלא שהמשתמש צרך עד היום. הערה: השדה הזה הוא חובה אם הישות הזו היא חלק מאשכול ההמשך.	ערך int בין 0 ל-100, כולל.
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימת טיפוסים בני מנייה (enum) אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`EventEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
שעת התחלה	חובה	חותמת הזמן של התאריך והשעה שבהם האירוע צפוי להתחיל. הערה: הערך הזה יוצג באלפיות השנייה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מצב אירוע	חובה	שדה שמציין אם האירוע יהיה וירטואלי, פרונטלי או גם וגם.	דוגמאות: VIRTUAL,‏ IN_PERSON או HYBRID
תמונות של פוסטרים	חובה	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: מומלץ מאוד להוסיף תמונה. אם יש תג, צריך לוודא שיש אזור בטוח של 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מיקום – מדינה	חובה בתנאים מסוימים	המדינה שבה האירוע מתקיים. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה בתנאים מסוימים	העיר שבה האירוע מתקיים. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה בתנאים מסוימים	הכתובת או שם המקום שבו האירוע יתקיים, שיוצגו למשתמש. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) של המיקום שבו מתקיים האירוע.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם האירוע מתקיים.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של המיקום שבו מתקיים האירוע.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) שבה האירוע מתקיים.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
שעת סיום	אופציונלי	חותמת הזמן של מערכת Unix של השעה שבה האירוע צפוי להסתיים. הערה: הערך הזה יוצג באלפיות השנייה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של הכרטיס לאירוע. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של הכרטיס לאירוע.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימה של טיפוסים בני מנייה (enum) שעומדים בדרישות TYPE_MOVIES_AND_TV_SHOWS (דוגמה – קולנוע) TYPE_DIGITAL_GAMES (לדוגמה: ספורט אלקטרוני) TYPE_MUSIC (לדוגמה: הופעה) TYPE_TRAVEL_AND_LOCAL (לדוגמה: סיור, פסטיבל) TYPE_HEALTH_AND_FITENESS (לדוגמה: שיעור יוגה) TYPE_EDUCATION (לדוגמה – כיתה) TYPE_SPORTS (דוגמה: משחק כדורגל) TYPE_DATING (לדוגמה – meetup) אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`LodgingEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטרים	חובה	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: אם מוסיפים תג, צריך להקפיד על אזור בטוח של 24 dps בחלק העליון והתחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מיקום – מדינה	חובה	המדינה שבה נמצא מקום הלינה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה	העיר שבה נמצא מקום הלינה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה	הכתובת של מקום האירוח שתוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) של מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של מקום הלינה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) שבה נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
‫AvailabilityTimeWindow – שעת התחלה	אופציונלי	חותמת הזמן של התקופה באלפיות השנייה שבה מקום האירוח צפוי להיות פתוח או זמין.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
‫AvailabilityTimeWindow – שעת סיום	אופציונלי	חותמת הזמן של התקופה באלפיות השנייה שעד אליה מקום הלינה צפוי להיות פתוח או זמין.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
דירוג – ערך מקסימלי	אופציונלי	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	אופציונלי	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם האפליקציה שולטת באופן שבו הספירה מוצגת למשתמשים. השתמשו במחרוזת תמציתית. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצור כמו 1M כדי שהמספר לא ייחתך במסכים קטנים יותר.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם אתם לא מטפלים בלוגיקה של קיצור התצוגה בעצמכם. אם גם Count וגם Count Value קיימים, Count מוצג למשתמשים.	ארוך
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של מקום האירוח. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של מקום הלינה, שיוצג עם קו חוצה בממשק המשתמש.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)

`StoreEntity`

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

מאפיין	דרישה	תיאור	פורמט
תמונות של פוסטרים	חובה	צריך להוסיף לפחות תמונה אחת.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	אופציונלי	שם החנות.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (אם הטקסט ארוך מדי, יכול להיות שיוצגו שלוש נקודות)
מיקום	אופציונלי	המיקום של החנות.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (אם הטקסט ארוך מדי, יכול להיות שיוצגו שלוש נקודות)
יתרונות מרכזיים	אופציונלי	הסבר קצר על מבצע, אירוע או עדכון לגבי החנות, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
האותיות הקטנות של היתרונות המרכזיים	אופציונלי	האותיות הקטנות של היתרון המרכזי.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
תיאור	אופציונלי	תיאור של החנות.	טקסט חופשי גודל טקסט מומלץ: פחות מ-90 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
דירוג – ערך מקסימלי	אופציונלי	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	אופציונלי	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם רוצים שהאפליקציה תשלוט באופן שבו הוא מוצג למשתמשים. צריך לספק מחרוזת תמציתית שאפשר להציג למשתמש. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצורים כמו 1M, כדי שהמספר לא ייחתך בגדלים קטנים יותר של מסכים.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם אתם לא רוצים לטפל בעצמכם בלוגיקה של קיצור התצוגה. אם גם Count וגם Count Value קיימים, נשתמש ב-Count כדי להציג למשתמשים	ארוך

`PointOfInterestEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטרים	חובה	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: מומלץ מאוד להוסיף תמונה. אם יש תג, צריך לוודא שיש אזור בטוח של 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מיקום – מדינה	חובה	המדינה שבה נמצאת נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה	העיר שבה נמצאת נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה	הכתובת של נקודת העניין שתוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) של נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם נמצאת נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) של נקודת העניין.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
‫AvailabilityTimeWindow – שעת התחלה	אופציונלי	חותמת הזמן של התקופה באלפיות השנייה שבה נקודת העניין צפויה להיות פתוחה או זמינה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
‫AvailabilityTimeWindow – שעת סיום	אופציונלי	חותמת הזמן של נקודת ההתחלה באלפיות השנייה, שעד אליה נקודת העניין צפויה להיות פתוחה או זמינה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
דירוג – ערך מקסימלי	אופציונלי	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	אופציונלי	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של נקודת העניין. הערה: צריך לספק את השדה הזה אם האפליקציה שולטת באופן שבו הספירה מוצגת למשתמשים. השתמשו במחרוזת תמציתית. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצור כמו 1M כדי שהמספר לא ייחתך במסכים קטנים יותר.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של נקודת העניין. הערה: צריך לספק את השדה הזה אם אתם לא מטפלים בלוגיקה של קיצור התצוגה בעצמכם. אם גם Count וגם Count Value קיימים, Count מוצג למשתמשים	ארוך
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של הכרטיסים/כרטיסי הכניסה לנקודת העניין. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של הכרטיסים או כרטיסי הכניסה לנקודת העניין.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (אם הטקסט ארוך מדי, יכול להיות שיוצגו שלוש נקודות)
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימה של טיפוסים בני מנייה (enum) שעומדים בדרישות TYPE_TRAVEL_AND_LOCAL TYPE_MOVIES_AND_TV_SHOWS (דוגמה: תיאטרון) TYPE_MEDICAL (לדוגמה: בית חולים) TYPE_EDUCATION (לדוגמה: בית ספר) TYPE_SPORTS (לדוגמה – אצטדיון) אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`PersonEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
פרופיל – שם	חובה	שם הפרופיל, המזהה או הכינוי, למשל "ישראל ישראלי", "‎@TeamPixel" וכו'.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
פרופיל – אווטאר	חובה	תמונת הפרופיל או תמונת הדמות של המשתמש. הערה: התמונה חייבת להיות ריבועית (1:1).	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
פרופיל – טקסט נוסף	אופציונלי	טקסט חופשי כמו הכינוי בפרופיל.	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
פרופיל – תמונה נוספת	אופציונלי	תמונה קטנה כמו תג אימות.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תמונת כותרת	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: מומלץ מאוד להוסיף תמונה. אם יש תג, צריך לוודא שיש אזור בטוח של 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
פופולריות – מספר	אופציונלי	מציינים את מספר העוקבים או את ערך הפופולריות, לדוגמה – "3.7M". הערה: אם צוינו גם Count וגם Count Value, המערכת תשתמש ב-Count.	מחרוזת גודל טקסט מומלץ: עד 20 תווים לספירה ולתווית ביחד
פופולריות – ערך הספירה	אופציונלי	מספר העוקבים או ערך הפופולריות. הערה: צריך לספק ערך מספרי אם לא רוצים שהאפליקציה תטפל בלוגיקה של אופטימיזציה של מספר גדול לגדלים שונים של תצוגה. אם צוינו גם "ספירה" וגם "ערך ספירה", המערכת תשתמש ב"ספירה".	ארוך
פופולריות – תווית	אופציונלי	מציינים מהי תווית הפופולריות. לדוגמה: "לייקים".	מחרוזת גודל טקסט מומלץ: עד 20 תווים לספירה ולתווית ביחד
פופולריות – חזותי	אופציונלי	מציינים את מטרת האינטראקציה. לדוגמה – תמונה שמוצג בה סמל לייקים, אמוג'י. אפשר לספק יותר מתמונה אחת, אבל יכול להיות שלא כולן יוצגו בכל גורמי הצורה. הערה: התמונה חייבת להיות ריבועית (1:1)	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
דירוג – ערך מקסימלי	חובה	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	חובה	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של הישות. הערה: צריך לספק את השדה הזה אם רוצים שהאפליקציה תשלוט באופן שבו הוא מוצג למשתמשים. צריך לספק מחרוזת תמציתית שאפשר להציג למשתמש. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצורים כמו 1M, כדי שהמספר לא ייחתך בגדלים קטנים יותר של מסכים.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של הישות. הערה: צריך לספק את השדה הזה אם אתם לא רוצים לטפל בעצמכם בלוגיקה של קיצור התצוגה. אם גם Count וגם Count Value קיימים, נשתמש ב-Count כדי להציג למשתמשים	ארוך
מיקום – מדינה	אופציונלי	המדינה שבה האדם נמצא או משרת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	אופציונלי	העיר שבה האדם נמצא או משרת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	אופציונלי	הכתובת שבה האדם נמצא או משרת תוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) שבה האדם נמצא או משרת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (אם רלוונטי) שבה האדם נמצא או משרת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של המקום שבו האדם נמצא או משרת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) שבה האדם נמצא או מספק שירות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימה של טיפוסים בני מנייה (enum) שעומדים בדרישות TYPE_HEALTH_AND_FITENESS (לדוגמה: מאמן יוגה או כושר) TYPE_HOME_AND_AUTO (דוגמה: שרברב) TYPE_SPORTS (לדוגמה – שחקן) TYPE_DATING אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`RestaurantReservationEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
שעת ההתחלה של ההזמנה	חובה	חותמת הזמן של מערכת Unix באלפיות השנייה שבה שמירת המקום צפויה להתחיל.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מיקום – מדינה	חובה	המדינה שבה המסעדה נמצאת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה	העיר שבה המסעדה נמצאת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה	הכתובת של המסעדה שתוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הרחוב ומספר הבית (אם רלוונטי) של המסעדה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם המסעדה נמצאת.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד של המסעדה (אם רלוונטי).	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה שבה נמצאת המסעדה (אם רלוונטי).	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
גודל השולחן	אופציונלי	מספר האנשים בקבוצה שהוזמן לה מקום	מספר שלם > 0

`EventReservationEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	מחרוזת גודל טקסט מומלץ: עד 50 תווים
שעת התחלה	חובה	חותמת הזמן של התאריך והשעה שבהם האירוע צפוי להתחיל. הערה: הערך הזה יוצג באלפיות השנייה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מצב אירוע	חובה	שדה שמציין אם האירוע יהיה וירטואלי, פרונטלי או גם וגם.	דוגמאות: VIRTUAL,‏ IN_PERSON או HYBRID
מיקום – מדינה	חובה בתנאים מסוימים	המדינה שבה האירוע מתקיים. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה בתנאים מסוימים	העיר שבה האירוע מתקיים. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה בתנאים מסוימים	הכתובת או שם המקום שבו האירוע יתקיים, שיוצגו למשתמש. הערה: השדה הזה נדרש לאירועים מסוג IN_PERSON או HYBRID	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) של המיקום שבו מתקיים האירוע.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם האירוע מתקיים.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של המיקום שבו מתקיים האירוע.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) שבה האירוע מתקיים.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: מומלץ מאוד להוסיף תמונה. אם יש תג, צריך לוודא שיש אזור בטוח של 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
שעת סיום	אופציונלי	חותמת הזמן של מערכת Unix של השעה שבה האירוע צפוי להסתיים. הערה: הערך הזה יוצג באלפיות השנייה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
ספק שירות – שם	אופציונלי	השם של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	טקסט חופשי. לדוגמה, שם מארגן האירוע או הסיור
ספק שירות – תמונה	אופציונלי	הלוגו או התמונה של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
תגים	אופציונלי	כל תג יכול להיות טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט	אופציונלי	כותרת התג הערה: חובה להוסיף טקסט או תמונה לתג	טקסט חופשי גודל טקסט מומלץ: עד 15 תווים
תג – תמונה	אופציונלי	תמונה קטנה טיפול מיוחד בחוויית המשתמש, למשל שכבת-על של תג על התמונה הממוזערת של התמונה או הסרטון. הערה: חובה להוסיף טקסט או תמונה לתג	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
מזהה ההזמנה	אופציונלי	מזהה ההזמנה של האירוע.	טקסט חופשי
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של הכרטיס לאירוע. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של הכרטיס לאירוע.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
דירוג – ערך מקסימלי	אופציונלי	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	אופציונלי	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של האירוע. הערה: צריך לספק את השדה הזה אם רוצים שהאפליקציה תשלוט באופן שבו הוא מוצג למשתמשים. צריך לספק מחרוזת תמציתית שאפשר להציג למשתמש. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצורים כמו 1M, כדי שהמספר לא ייחתך בגדלים קטנים יותר של מסכים.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של האירוע. הערה: צריך לספק את השדה הזה אם אתם לא רוצים לטפל בעצמכם בלוגיקה של קיצור התצוגה. אם גם Count וגם Count Value קיימים, נשתמש ב-Count כדי להציג למשתמשים	ארוך
קטגוריות תוכן	אופציונלי	תארו את קטגוריית התוכן בישות.	רשימה של טיפוסים בני מנייה (enum) שעומדים בדרישות TYPE_MOVIES_AND_TV_SHOWS (דוגמה – קולנוע) TYPE_DIGITAL_GAMES (לדוגמה: ספורט אלקטרוני) TYPE_MUSIC (לדוגמה: הופעה) TYPE_TRAVEL_AND_LOCAL (לדוגמה: סיור, פסטיבל) TYPE_HEALTH_AND_FITENESS (לדוגמה: שיעור יוגה) TYPE_EDUCATION (לדוגמה – כיתה) TYPE_SPORTS (דוגמה: משחק כדורגל) TYPE_DATING (לדוגמה – meetup) אפשר לעיין בקטע "קטגוריית תוכן" כדי לקבל הנחיות.

`LodgingReservationEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	טקסט חופשי. לדוגמה, "השהות שלך החל מ-12 בדצמבר" גודל טקסט מומלץ: עד 50 תווים
שעת הצ'ק-אין	חובה	חותמת הזמן של התקופה באלפיות השנייה שמייצגת את שעת הצ'ק-אין של ההזמנה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
שעת הצ'ק-אאוט	חובה	חותמת הזמן של התקופה באלפיות השנייה שמייצגת את שעת הצ'ק-אאוט של ההזמנה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מיקום – מדינה	חובה	המדינה שבה נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – עיר	חובה	העיר שבה נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת לתצוגה	חובה	הכתובת של מקום האירוח שתוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – כתובת	אופציונלי	הכתובת (אם רלוונטי) של מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מדינה (State)	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) שבהם נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של מקום הלינה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום – שכונה	אופציונלי	השכונה (אם רלוונטי) שבה נמצא מקום האירוח.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9 הערה: אם מוסיפים תג, צריך להקפיד על אזור בטוח של 24 dps בחלק העליון והתחתון של התמונה.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
מזהה ההזמנה	אופציונלי	מזהה ההזמנה של מקום הלינה.	טקסט חופשי
דירוג – ערך מקסימלי	אופציונלי	הערך המקסימלי בסולם הדירוג. חובה לציין את המאפיין הזה אם מציינים גם את הערך הנוכחי של הדירוג.	מספר >= 0.0
דירוג – ערך נוכחי	אופציונלי	הערך הנוכחי של סולם הדירוג. חובה לציין את הערך הזה אם מציינים גם את ערך הדירוג המקסימלי.	מספר >= 0.0
דירוג – מספר	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם רוצים שהאפליקציה תשלוט באופן שבו הוא מוצג למשתמשים. צריך לספק מחרוזת תמציתית שאפשר להציג למשתמש. לדוגמה, אם המספר הוא 1,000,000, כדאי להשתמש בקיצורים כמו 1M, כדי שהמספר לא ייחתך בגדלים קטנים יותר של מסכים.	מחרוזת
דירוג – ערך הספירה	אופציונלי	מספר הדירוגים של מקום האירוח. הערה: צריך לספק את השדה הזה אם אתם לא רוצים לטפל בעצמכם בלוגיקה של קיצור התצוגה. אם גם Count וגם Count Value קיימים, נשתמש ב-Count כדי להציג למשתמשים	ארוך
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של מקום האירוח. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של מקום הלינה, שיוצג עם קו חוצה בממשק המשתמש.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)

`TransportationReservationEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	טקסט חופשי. לדוגמה, "SFO to SAN" גודל טקסט מומלץ: עד 50 תווים
סוג התחבורה	חובה	אמצעי התחבורה או סוג התחבורה של ההזמנה.	טיפוסים בני מנייה (enum): FLIGHT,‏ TRAIN,‏ BUS או FERRY
שעת היציאה	חובה	חותמת הזמן של נקודת ההתחלה באלפיות השנייה שמייצגת את שעת היציאה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
זמן הגעה	חובה	חותמת הזמן של נקודת ההתחלה באלפיות השנייה שמייצגת את זמן ההגעה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
מיקום המוצא – מדינה	אופציונלי	מדינת המוצא.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום המוצא – עיר	אופציונלי	העיר שממנה ממריאים.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום היציאה – כתובת לתצוגה	אופציונלי	מיקום היציאה שיוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום היציאה – כתובת	אופציונלי	כתובת הרחוב (אם רלוונטי) של מיקום היציאה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום המוצא – מדינה (State)	אופציונלי	המדינה או המחוז (אם רלוונטי) של מיקום היציאה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום היציאה – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של מיקום היציאה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום היציאה – שכונה	אופציונלי	השכונה (אם רלוונטי) של מיקום היציאה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – מדינה	אופציונלי	מדינת היעד.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – עיר	אופציונלי	עיר היעד.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – כתובת לתצוגה	אופציונלי	מיקום ההגעה שיוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – כתובת	אופציונלי	הכתובת (אם רלוונטי) של מיקום היעד.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – מדינה	אופציונלי	המדינה או המחוז (אם רלוונטי) של מיקום ההגעה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של מיקום ההגעה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
מיקום ההגעה – שכונה	אופציונלי	השכונה (אם רלוונטי) של מיקום ההגעה.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
ספק שירות – שם	אופציונלי	השם של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	טקסט חופשי. לדוגמה, שם חברת התעופה
ספק שירות – תמונה	אופציונלי	הלוגו או התמונה של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
מזהה ההזמנה	אופציונלי	מזהה ההזמנה של הנסיעה.	טקסט חופשי
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של ההזמנה. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של ההזמנה, שיוצג עם קו חוצה בממשק המשתמש.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)
מספר אמצעי התחבורה	חובה	מספר הטיסה, האוטובוס, הרכבת, המעבורת או השיט.	טקסט חופשי
זמן העלייה למטוס	חובה	חותמת הזמן של התקופה שמייצגת את מועד העלייה למטוס של ההזמנה (אם רלוונטי)	חותמת זמן של תקופת זמן המערכת באלפיות השנייה

`VehicleRentalReservationEntity`

מאפיין	דרישה	תיאור	פורמט
‫URI של פעולה	חובה	קישור עומק לישות באפליקציה של הספק. הערה: אפשר להשתמש בקישורי עומק לצורך שיוך (Attribution). כדאי לעיין בשאלות הנפוצות האלה	URI
כותרת	חובה	שם הישות.	טקסט חופשי. לדוגמה, "Avis Union Square SF" גודל טקסט מומלץ: עד 50 תווים
זמן האיסוף	חובה	חותמת הזמן של התקופה שמייצגת את זמן האיסוף של ההזמנה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
זמן החזרה	אופציונלי	חותמת הזמן של התקופה שמייצגת את שעת הצ'ק-אאוט של ההזמנה.	חותמת זמן של תקופת זמן המערכת באלפיות השנייה
כתובת האיסוף – מדינה	אופציונלי	המדינה שבה נמצאת נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – עיר	אופציונלי	העיר שבה נמצאת נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – כתובת לתצוגה	אופציונלי	מיקום האיסוף שיוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – רחוב ומספר בית	אופציונלי	כתובת הרחוב (אם רלוונטי) של נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – מדינה	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) של נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת האיסוף – שכונה	אופציונלי	השכונה (אם רלוונטי) של נקודת האיסוף.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – מדינה	אופציונלי	המדינה שבה נמצא המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – עיר	אופציונלי	העיר שבה נמצא המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – כתובת לתצוגה	אופציונלי	המיקום להחזרות שיוצג למשתמש.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – רחוב ומספר בית	אופציונלי	כתובת הרחוב (אם רלוונטי) של המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – מדינה	אופציונלי	המדינה (State) או המחוז (אם רלוונטי) של המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – מיקוד	אופציונלי	המיקוד (אם רלוונטי) של המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
כתובת להחזרה – שכונה	אופציונלי	השכונה (אם רלוונטי) של המיקום להחזרות.	טקסט חופשי גודל טקסט מומלץ: עד כ-20 תווים
ספק שירות – שם	אופציונלי	השם של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	טקסט חופשי. לדוגמה, "השכרת רכב שלמה סיקסט"
ספק שירות – תמונה	אופציונלי	הלוגו או התמונה של ספק השירות. הערה: חובה להזין טקסט או תמונה של ספק השירות.	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תמונות של פוסטרים	אופציונלי	אם תספקו כמה תמונות, נציג רק תמונה אחת. יחס הגובה-רוחב המומלץ הוא 16:9	כדי לקבל הנחיות, כדאי לעיין במפרט לתמונות.
תיאור	אופציונלי	פסקה אחת של טקסט שמתארת את הישות. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל טקסט מומלץ: 180 תווים
רשימת כתוביות	אופציונלי	עד 3 כותרות משנה, כשכל כותרת משנה היא שורת טקסט אחת. הערה: למשתמש יוצג התיאור או רשימת כותרות המשנה, אבל לא שניהם.	טקסט חופשי גודל הטקסט המומלץ לכל כתובית: עד 50 תווים
מזהה האישור	אופציונלי	מזהה האישור של הזמנת הרכב השכור.	טקסט חופשי
Price - CurrentPrice	חובה בתנאים מסוימים	המחיר הנוכחי של ההזמנה. חובה לציין את המאפיין הזה אם מציינים מחיר קודם מחוק.	טקסט חופשי
Price - StrikethroughPrice	אופציונלי	המחיר המקורי של ההזמנה, שיוצג עם קו חוצה בממשק המשתמש.	טקסט חופשי
יתרון מרכזי של מחיר	אופציונלי	הצגת מחיר בולט כדי להציג מבצע, אירוע או הנחה לחברי מועדון, אם יש כאלה.	טקסט חופשי אורך הטקסט המומלץ: פחות מ-45 תווים (טקסט ארוך מדי עלול להופיע עם שלוש נקודות)

מפרט לתמונות

בטבלה הזו מפורטות הדרישות לגבי נכסי תמונות:

יחס גובה-רוחב	מספר פיקסלים מינימלי	מספר פיקסלים מומלץ
תמונה ריבועית (1x1) מועדף	300x300	1,200x1,200
תמונה לרוחב (1.91X1)	600x314	1,200x628
לאורך (4x5)	480x600	960x1,200

יחס גובה-רוחב

מספר פיקסלים מינימלי

מספר פיקסלים מומלץ

תמונה ריבועית (1x1)

מועדף

300x300

1,200x1,200

תמונה לרוחב (1.91X1)

600x314

1,200x628

לאורך (4x5)

480x600

960x1,200

התמונות צריכות להתארח ברשתות CDN ציבוריות כדי ש-Google תוכל לגשת אליהן.

פורמט קובץ

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

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

5,120KB

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

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

קטגוריית התוכן

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

TYPE_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING

התמונות צריכות להתארח ברשתות CDN ציבוריות כדי ש-Google תוכל לגשת אליהן.

הנחיות לשימוש בקטגוריות התוכן

ישויות מסוימות, כמו ArticleEntity ו-GenericFeaturedEntity, יכולות להשתמש בכל אחת מקטגוריות התוכן. לישויות אחרות כמו EventEntity,‏ EventReservationEntity ו-PointOfInterestEntity, רק קבוצת משנה של הקטגוריות האלה עומדת בדרישות. לפני שאתם ממלאים את הרשימה, בדקו את רשימת הקטגוריות שמתאימות לסוג הישות.
בקטגוריות תוכן מסוימות, כדאי להשתמש בסוג הישות הספציפי במקום בשילוב של ישויות גנריות ו-ContentCategory:
- ‫TYPE_MOVIES_AND_TV_SHOWS – לפני שמשתמשים בישויות הגנריות, כדאי לעיין בישויות שמופיעות במדריך לשילוב של Watch.
- ‫TYPE_BOOKS – לפני שמשתמשים בישויות הגנריות, כדאי לבדוק את EbookEntity.
- ‫TYPE_AUDIOBOOKS – לפני שמשתמשים בישויות הגנריות, כדאי לבדוק את AudiobookEntity.
- ‫TYPE_SHOPPING – כדאי לעיין ב-ShoppingEntity לפני שמשתמשים בישויות הגנריות.
- ‫TYPE_FOOD_AND_DRINK – לפני שמשתמשים בישויות הגנריות, כדאי לעיין בישויות שבמדריך לשילוב אוכל.
השדה ContentCategory הוא אופציונלי, ואפשר להשאיר אותו ריק אם התוכן לא שייך לאף אחת מהקטגוריות שצוינו קודם.
אם אתם מספקים כמה קטגוריות תוכן, ספקו אותן לפי סדר הרלוונטיות לתוכן, כך שקטגוריית התוכן הרלוונטית ביותר תופיע ראשונה ברשימה.

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

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

‫AppEngagePublishClient אחראי לפרסום של אוספים.

אלה ממשקי ה-API לפרסום אשכולות בלקוח:

isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters

`isServiceAvailable`

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

ל-Engage SDK מגרסה 1.6.0 ואילך (מומלץ)

מיומנויות ב-Android

הצגת הקוד ב-GitHub

שילוב של Engage SDK

כדי להתקין את המיומנות מ-Android CLI, מריצים את הפקודה:

android skills add engage-sdk-integration

אם הצוות שלכם משתמש בכלי תכנות מבוססי-AI (כמו Gemini ב-Android Studio), אתם יכולים להפוך את ההעברה הזו לאוטומטית על ידי הנחיה של העוזר האישי מבוסס-AI:

Use the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.

אתם יכולים לבדוק את זמינות השירות לכל סוג אשכול שאתם מתכוונים לפרסם. ‫isServiceAvailable API מקבל אובייקט בקשה, ServiceAvailabilityRequest, שמכיל את סוגי האשכולות שצריך לבדוק את זמינות השירות שלהם. בטבלה הבאה מפורטים ערכי ה-enum של ClusterType שנדרשים ל-ServiceAvailabilityRequest.

סוג האשכול	קבוע של סוג האשכול	ערך של מספר שלם
לא ידוע	`TYPE_UNKNOWN`	0
אשכול המלצות	`TYPE_RECOMMENDATION`	1
אשכול מומלץ	`TYPE_FEATURED`	2
אוסף ההמשכים	`TYPE_CONTINUATION`	3
אשכול עגלת קניות	`TYPE_SHOPPING_CART`	4
אשכול הזמנה חוזרת של אוכל	`TYPE_FOOD_REORDER`	5
אשכול של עגלות קניות עם אוכל	`TYPE_FOOD_SHOPPING_CART`	6
אשכול של רשימת קניות של אוכל	`TYPE_FOOD_SHOPPING_LIST`	7
אשכול ניהול משתמשים	`TYPE_ENGAGEMENT`	8
אשכול של רשימת קניות	`TYPE_SHOPPING_LIST`	9
אשכול הזמנה חוזרת של שופינג	`TYPE_SHOPPING_REORDER`	10
אשכול מעקב אחר הזמנות בשופינג	`TYPE_SHOPPING_ORDER_TRACKING`	11
אשכול מינויים	`TYPE_SUBSCRIPTION`	12
המשך החיפוש באשכול	`TYPE_CONTINUE_SEARCH`	13
אשכול הזמנות	`TYPE_RESERVATION`	14

Kotlin

val request = ServiceAvailabilityRequest.Builder()
    .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
    .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
    .build()

client.isServiceAvailable(request).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val availabilityMap = task.result
        if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
            // Proceed with publishing continuation content
        }
        if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
}

Java

ServiceAvailabilityRequest request =
    new ServiceAvailabilityRequest.Builder()
        .addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
        .addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
        .build();

client.isServiceAvailable(request).addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        Map<Integer, Boolean> availabilityMap = task.getResult();
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
            // Proceed with publishing continuation content
        }
        if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
            // Proceed with publishing recommendation content
        }
    } else {
        // The IPC call itself fails, proceed with error handling logic here,
        // such as retry.
    }
});

תכונה: זמינות מותנית של שירותים

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

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

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

אם הגדרת ברירת המחדל הזו לא מתאימה לצרכים שלכם, אתם יכולים לפנות לכתובת engage-developers@google.com.

לגרסאות SDK שקדמו לגרסה 1.6.0 (הוצאה משימוש)

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

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

`publishFeaturedCluster`

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

Kotlin

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

Java

client.publishFeaturedCluster(
            new PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    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 קיימים של שותף הפיתוח יוסרו.
הנתונים מהבקשה מנותחים ונשמרים באשכול ההמשך המעודכן.

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

`publishUserAccountManagementRequest`

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

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

מאפיין	דרישה	תיאור
‫URI של פעולה	חובה	קישור עומק לפעולה (למשל, מעבר לדף הכניסה לאפליקציה)
תמונה	אופציונלי – אם לא מציינים את המאפיין הזה, צריך לציין את מאפיין שם הפריט	התמונה שמוצגת בכרטיס תמונות ביחס גובה-רוחב של 16:9 וברזולוציה של 1,264x712
כותרת	אופציונלי – אם לא מספקים את המאפיין הזה, צריך לספק את מאפיין התמונה	השם שמופיע בכרטיס
טקסט פעולה	אופציונלי	הטקסט שמוצג ב-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());

`deleteRecommendationsClusters`

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

Kotlin

client.deleteRecommendationsClusters()

Java

client.deleteRecommendationsClusters();

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

`deleteFeaturedCluster`

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

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

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

`deleteContinuationCluster`

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

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

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

`deleteUserManagementCluster`

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

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: טיפול בכוונות שידור

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

המטרה של כוונות שידור היא בעיקר להפעיל מחדש את האפליקציה ולאלץ סנכרון נתונים. כוונות שידור לא נועדו להישלח בתדירות גבוהה מאוד. הוא מופעל רק כששירות 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. ההרשאה הזו מאפשרת לאפליקציה לקבל כוונות שידור כשהיא לא פועלת, וגם לפרסם את התוכן.

<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>

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

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

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

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

שאלות נפוצות

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

יצירת קשר

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

השלבים הבאים

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

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

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

פרטי השילוב

הסברים על המונחים

הכנה

סיכום

שלב 1: מסירת נתוני הישות

GenericFeaturedEntity

ArticleEntity

EventEntity

LodgingEntity

StoreEntity

PointOfInterestEntity

PersonEntity

RestaurantReservationEntity

EventReservationEntity

LodgingReservationEntity

TransportationReservationEntity

VehicleRentalReservationEntity

מפרט לתמונות

קטגוריית התוכן

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

isServiceAvailable

ל-Engage SDK מגרסה 1.6.0 ואילך (מומלץ)

Kotlin

Java

תכונה: זמינות מותנית של שירותים

לגרסאות SDK שקדמו לגרסה 1.6.0 (הוצאה משימוש)

Kotlin

Java

publishRecommendationClusters

Kotlin

Java

publishFeaturedCluster

Kotlin

Java

publishContinuationCluster

Kotlin

Java

publishUserAccountManagementRequest

Kotlin

Java

updatePublishStatus

Kotlin

Java

deleteRecommendationsClusters

Kotlin

Java

deleteFeaturedCluster

Kotlin

Java

deleteContinuationCluster

Kotlin

Java

deleteUserManagementCluster

Kotlin

Java

deleteClusters

Kotlin

Java

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

Kotlin

Java

שלב 3: טיפול בכוונות שידור

Kotlin

Java

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

שאלות נפוצות

יצירת קשר

השלבים הבאים

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

`GenericFeaturedEntity`

`ArticleEntity`

`EventEntity`

`LodgingEntity`

`StoreEntity`

`PointOfInterestEntity`

`PersonEntity`

`RestaurantReservationEntity`

`EventReservationEntity`

`LodgingReservationEntity`

`TransportationReservationEntity`

`VehicleRentalReservationEntity`

`isServiceAvailable`

`publishRecommendationClusters`

`publishFeaturedCluster`

`publishContinuationCluster`

`publishUserAccountManagementRequest`

`updatePublishStatus`

`deleteRecommendationsClusters`

`deleteFeaturedCluster`

`deleteContinuationCluster`

`deleteUserManagementCluster`

`deleteClusters`