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

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

פרטי השילוב

טרמינולוגיה

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

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

    • אפשר ליצור אשכול המלצות מהסוגים ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity או StoreEntity דפים עסקיים, אבל לא שילוב של סוגי ישויות שונים.

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

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

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

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

        איור 1: ממשק המשתמש שבו מוצגת ArticleEntity אחד באשכול ההמלצות.

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

        איור 2: ממשק משתמש שמציג ישות אחת מסוג EventEntity בתוך אשכול ההמלצות.

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

        איור 3: ממשק משתמש שבו מוצגת ישות LodgingEntity אחת באשכול ההמלצות.

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

        איור 4: ממשק משתמש שבו מוצגת ישות StoreEntity אחת בתוך אשכול ההמלצות.

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

        איור 5: ממשק משתמש שמציג PointOfInterestEntity באשכול 'המלצות'.

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

    תוכן ההמשך יכול להיות במבנה הבא:

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

      איור 6. ממשק משתמש שמציג ArticleEntity אחד בתוך אשכול המשך.

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

      איור 7. ממשק משתמש שמציג סינגל מסעדת הזמנת מקומות באשכול המשך.

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

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

    • LodgingOrderEntity: LodgingEntityבקשה מייצגת להזמנת לינה לנסיעה שעוזרת למשתמשים לעקוב אחר אירועים עתידיים או הזמנות מתמשכות של מלונות או יחידות אירוח.

      איור 9. ממשק משתמש שמציג סינגל LodgingorderEntity באשכול המשך.

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

      איור 10. ממשק משתמש שמציג סינגל TransportOrderEntity באשכול המשך.

    • VehiclerentalserveEntity: השכרת רכב בהזמנה מייצג הזמנה של השכרת רכב ועוזר למשתמשים לעקוב אחר או הזמנות מתמשכות של השכרת רכב.

      איור 11. ממשק משתמש שמציג סינגל השכרת רכב בהזמנה באשכול המשך.

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

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

      איור 12: ממשק משתמש שמציג אשכול מומלץ עם רשימה של GeneralFeaturedEntity

הכנה לעבודה

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

סיכום

התכנון מבוסס על הטמעה של שירות העברות.

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

סוג האשכול מגבלות של אשכולות מגבלות מינימליות לישויות באשכול תקרות של ישויות באשכול
אשכולות של המלצות 5 לכל היותר 5 לפחות 25 לכל היותר (ArticleEntity, EventEntity, LodgingEntity, StoreEntity, או PointOfInterestEntity)
אשכול המשך 1 לכל היותר אחד לפחות 10 לכל היותר (ArticleEntity, RestaurantReservationEntity EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity, או VehicleRentalReservationEntity)
אשכול נבחר 1 לכל היותר אחד לפחות 10 לכל היותר (GenericFeaturedEntity)

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

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

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

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

GenericFeaturedEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
תמונות של פוסטר חובה

נציג רק תמונה אחת אם יסופקו כמה תמונות. יחס הגובה-רוחב המומלץ הוא 16:9

הערה:אם סופקו תג, יש לוודא שהמקום הבטוח הוא 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה

 הנחיות ליצירת תמונות מפורטות במפרט התמונות.
כותרת אופציונלי השם של הישות.

טקסט חופשי

גודל טקסט מומלץ: 50 תווים
תיאור אופציונלי

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.

טיפול מיוחד בחוויית המשתמש מעל תמונה או סרטון, למשל, כתג כשכבת-על בתמונה

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

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

הנחיות ליצירת תמונות מפורטות במפרט התמונות.
קטגוריות תוכן אופציונלי צריך לתאר את קטגוריית התוכן בישות.

רשימת טיפוסים בני מנייה (enum)

לעיון בקטע 'קטגוריית תוכן' לקבלת הנחיות.

ArticleEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

טקסט חופשי

גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטר אופציונלי

נציג רק תמונה אחת אם יסופקו כמה תמונות. יחס הגובה-רוחב המומלץ הוא 16:9

הערה: מומלץ מאוד להוסיף תמונה. אם התג הוא יש לוודא שיש מרווח בטוח של 24dps גם בחלק העליון וגם בחלק התחתון של קובץ אימג'

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

טקסט חופשי

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.

טיפול מיוחד בחוויית המשתמש מעל לתמונה או לסרטון, למשל כתג כשכבת-על בתמונה

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

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

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

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

הערה: השדה הזה הוא חובה אם הישות הזו היא חלק את אשכול ההמשך.

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

האחוז מהתוכן המלא שהמשתמש צרך עד היום.

הערה: השדה הזה הוא חובה אם הישות הזו היא חלק את אשכול ההמשך.

 ערך int בין 0 ל-100, כולל.
קטגוריות תוכן אופציונלי צריך לתאר את קטגוריית התוכן בישות.

רשימת טיפוסים בני מנייה (enum)

לעיון בקטע 'קטגוריית תוכן' לקבלת הנחיות.

EventEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

מחרוזת

גודל טקסט מומלץ: עד 50 תווים
שעת התחלה חובה

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

הערה: הערך הזה יוצג באלפיות שנייה.

 חותמת זמן של תקופה מסוימת באלפיות השנייה
מצב אירוע חובה

שדה שמציין אם האירוע יהיה וירטואלי, פנים-אל-פנים או ובשניהם.

 דוגמאות: VIRTUAL, IN_PERSON או HYBRID
תמונות של פוסטר חובה

נציג רק תמונה אחת אם יסופקו כמה תמונות. יחס הגובה-רוחב המומלץ הוא 16:9

הערה: מומלץ מאוד להוסיף תמונה. אם התג הוא יש לוודא שיש מרווח בטוח של 24dps גם בחלק העליון וגם בחלק התחתון של קובץ אימג'

 הנחיות ליצירת תמונות מפורטות במפרט התמונות.
מיקום – מדינה נדרש באופן מותנה

המדינה שבה האירוע מתרחש.

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר נדרש באופן מותנה

העיר שבה מתקיים האירוע.

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה נדרש באופן מותנה

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

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום - רחוב אופציונלי הרחוב (אם רלוונטי) של המיקום שבו האירוע מתקיים להתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם האירוע מתרחש מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של המיקום שבו האירוע מתרחש מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) שבה האירוע מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
שעת סיום אופציונלי

חותמת הזמן של התקופה שבה האירוע צפוי להסתיים.

הערה: הערך הזה יוצג באלפיות שנייה.

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט אופציונלי

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

הנחיות ליצירת תמונות מפורטות במפרט התמונות.
מחיר – מחיר נוכחי נדרש באופן מותנה

המחיר הנוכחי של הכרטיס לאירוע.

יש לציין אם צוין מחיר עם קו חוצה.

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

טקסט חופשי

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

רשימת מספרים שעומדים בדרישות

  • TYPE_MOVIES_AND_TV_SHOWS (דוגמה – קולנוע)
  • TYPE_DIGITAL_GAMES (דוגמה – ספורט אלקטרוני)
  • TYPE_MUSIC (דוגמה – קונצרט)
  • TYPE_TRAVEL_AND_LOCAL (דוגמה - סיור, פסטיבל)
  • TYPE_HEALTH_AND_FITEness (דוגמה - שיעור יוגה)
  • TYPE_EDUCATION (דוגמה – כיתה)
  • TYPE_SPORTS (דוגמה - משחק פוטבול)
  • TYPE_DATING (דוגמה - מפגש)

לעיון בקטע 'קטגוריית תוכן' לקבלת הנחיות.

LodgingEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

מחרוזת

גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטר חובה

נציג רק תמונה אחת אם יסופקו כמה תמונות. אפשרות מומלצת יחס הגובה-רוחב הוא 16:9

הערה:אם סופקו תג, יש לוודא שהמקום הבטוח הוא 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה

הנחיות ליצירת תמונות מפורטות במפרט התמונות.
מיקום – מדינה חובה המדינה שבה המלון מתרחש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר חובה העיר שבה מתקיימים המלון.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה חובה הכתובת של מקום הלינה שתוצג למשתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום - רחוב אופציונלי הרחוב (אם רלוונטי) של מקום הלינה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם מקום האירוח נמצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של מקום הלינה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) של מקום הלינה

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט אופציונלי

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

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

הערך המקסימלי של סולם הדירוג.

חובה לציין אם גם ערך הדירוג הנוכחי הוא שניתנו.

 מספר >= 0.0
דירוג - ערך נוכחי אופציונלי

הערך הנוכחי של סולם הדירוג.

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

 מספר >= 0.0
דירוג – מספר אופציונלי

מספר הדירוגים של מקום הלינה.

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

 מחרוזת
דירוג - ערך ספירה אופציונלי

מספר הדירוגים של מקום הלינה.

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

 ארוך
מחיר – מחיר נוכחי נדרש באופן מותנה

המחיר הנוכחי של המלון.

אם צוין מחיר עם קו חוצה, חובה לספק אותו.

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

טקסט חופשי

גודל טקסט מומלץ: פחות מ-45 תווים (הטקסט ארוך מדי יכול להיות שיוצגו שלוש נקודות)

StoreEntity

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

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

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

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

URI
כותרת אופציונלי שם החנות.

טקסט חופשי

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

טקסט חופשי

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

טקסט חופשי

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

טקסט חופשי

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

טקסט חופשי

גודל טקסט מומלץ: עד 90 תווים (טקסט אם הטקסט ארוך מדי, ייתכן שיוצגו שלוש נקודות)
דירוג – ערך מקסימלי אופציונלי

הערך המקסימלי של סולם הדירוג.

חובה לציין אם גם ערך הדירוג הנוכחי הוא שניתנו.

 מספר >= 0.0
דירוג - ערך נוכחי אופציונלי

הערך הנוכחי של סולם הדירוג.

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

 מספר >= 0.0
דירוג – מספר אופציונלי

מספר הדירוגים של מקום הלינה.

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

 מחרוזת
דירוג - ערך ספירה אופציונלי

מספר הדירוגים של מקום הלינה.

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

 ארוך

PointOfInterestEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

מחרוזת

גודל טקסט מומלץ: עד 50 תווים
תמונות של פוסטר חובה

נציג רק תמונה אחת אם יסופקו כמה תמונות. יחס הגובה-רוחב המומלץ הוא 16:9

הערה: מומלץ מאוד להוסיף תמונה. אם התג הוא יש לוודא שיש מרווח בטוח של 24dps גם בחלק העליון וגם בחלק התחתון התמונה

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר חובה העיר שבה נמצאת נקודת העניין.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה חובה הכתובת של נקודת העניין שתוצג משתמש.

טקסט חופשי

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם נקודת העניין נמצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של נקודת העניין.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) של נקודת העניין.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
AvailabilityTimeWindow – שעת התחלה אופציונלי חותמת הזמן של תקופה של זמן מערכת (epoch) באלפיות השנייה שבה נקודת העניין היא אמור להיות פתוח או זמין. חותמת זמן של תקופה מסוימת באלפיות השנייה
AvailabilityTimeWindow – שעת סיום אופציונלי חותמת הזמן של תקופה של זמן מערכת (epoch) באלפיות השנייה שעד אליה נקודת העניין אמור להיות פתוח או זמין. חותמת זמן של תקופה מסוימת באלפיות השנייה
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט אופציונלי

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
דירוג – ערך מקסימלי אופציונלי

הערך המקסימלי של סולם הדירוג.

חובה לציין אם גם ערך הדירוג הנוכחי הוא שניתנו.

 מספר >= 0.0
דירוג - ערך נוכחי אופציונלי

הערך הנוכחי של סולם הדירוג.

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

 מספר >= 0.0
דירוג – מספר אופציונלי

מספר הדירוגים של נקודת העניין.

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

 מחרוזת
דירוג - ערך ספירה אופציונלי

מספר הדירוגים של נקודת העניין.

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

 ארוך
מחיר – מחיר נוכחי נדרש באופן מותנה

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

יש לציין אם צוין מחיר עם קו חוצה.

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

טקסט חופשי

גודל טקסט מומלץ: פחות מ-45 תווים (טקסט ארוך מדי עשוי הצגת שלוש נקודות)

קטגוריות תוכן אופציונלי צריך לתאר את קטגוריית התוכן בישות.

רשימת מספרים שעומדים בדרישות

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (דוגמה – קולנוע)
  • TYPE_MEDical (דוגמה - בית חולים)
  • TYPE_EDUCATION (דוגמה - בית ספר)
  • TYPE_SPORTS (דוגמה - אצטדיון)

לעיון בקטע 'קטגוריית תוכן' לקבלת הנחיות.

RestaurantReservationEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

מחרוזת

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר חובה העיר שבה המסעדה מתרחשת.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה חובה כתובת המסעדה שתוצג משתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום - רחוב אופציונלי רחוב (אם רלוונטי) של המסעדה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם המסעדה ממוקמת נמצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של המסעדה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) של המסעדה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
תמונות של פוסטר אופציונלי נציג רק תמונה אחת אם יסופקו כמה תמונות. אפשרות מומלצת יחס הגובה-רוחב הוא 16:9 הנחיות ליצירת תמונות מפורטות במפרט התמונות.
תיאור אופציונלי

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
גודל השולחן אופציונלי מספר האנשים בקבוצת ההזמנה מספר שלם > 0

EventReservationEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

מחרוזת

גודל טקסט מומלץ: עד 50 תווים
שעת התחלה חובה

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

הערה: הערך הזה יוצג באלפיות שנייה.

 חותמת זמן של תקופה מסוימת באלפיות השנייה
מצב אירוע חובה

שדה שמציין אם האירוע יהיה וירטואלי, פנים-אל-פנים או ובשניהם.

 דוגמאות: VIRTUAL, IN_PERSON או HYBRID
מיקום – מדינה נדרש באופן מותנה

המדינה שבה האירוע מתרחש.

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר נדרש באופן מותנה

העיר שבה מתקיים האירוע.

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה נדרש באופן מותנה

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

הערה: המאפיין הזה נדרש לאירועים IN_PERSON או היברידים

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום - רחוב אופציונלי הרחוב (אם רלוונטי) של המיקום שבו האירוע מתקיים להתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם האירוע מתרחש מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של המיקום שבו האירוע מתרחש מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) שבה האירוע מתארח.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
תמונות של פוסטר אופציונלי

נציג רק תמונה אחת אם יסופקו כמה תמונות. יחס הגובה-רוחב המומלץ הוא 16:9

הערה: מומלץ מאוד להוסיף תמונה. אם התג הוא יש לוודא שיש מרווח בטוח של 24dps גם בחלק העליון וגם בחלק התחתון של קובץ אימג'

 הנחיות ליצירת תמונות מפורטות במפרט התמונות.
שעת סיום אופציונלי

חותמת הזמן של התקופה שבה האירוע צפוי להסתיים.

הערה: הערך הזה יוצג באלפיות שנייה.

 חותמת זמן של תקופה מסוימת באלפיות השנייה
ספק שירות – שם אופציונלי

השם של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

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

הלוגו או התמונה של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ לכל כותרת משנה: מקסימום 50 תווים
תגים אופציונלי

כל תג הוא טקסט חופשי (עד 15 תווים) או תמונה קטנה.
תג – טקסט אופציונלי

שם התג

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

טקסט חופשי

גודל טקסט מומלץ: עד 15 תווים
תג – תמונה אופציונלי

תמונה קטנה

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

הערה: כדי לקבל את התג צריך להזין טקסט או תמונה

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

המחיר הנוכחי של הכרטיס לאירוע.

יש לציין אם צוין מחיר עם קו חוצה.

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

טקסט חופשי

גודל טקסט מומלץ: פחות מ-45 תווים (הטקסט ארוך מדי יכול להיות שיוצגו שלוש נקודות)
דירוג – ערך מקסימלי אופציונלי

הערך המקסימלי של סולם הדירוג.

חובה לציין אם גם ערך הדירוג הנוכחי הוא שניתנו.

 מספר >= 0.0
דירוג - ערך נוכחי אופציונלי

הערך הנוכחי של סולם הדירוג.

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

 מספר >= 0.0
דירוג – מספר אופציונלי

ספירת הדירוגים של האירוע.

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

 מחרוזת
דירוג - ערך ספירה אופציונלי

ספירת הדירוגים של האירוע.

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

 ארוך
קטגוריות תוכן אופציונלי צריך לתאר את קטגוריית התוכן בישות.

רשימת מספרים שעומדים בדרישות

  • TYPE_MOVIES_AND_TV_SHOWS (דוגמה – קולנוע)
  • TYPE_DIGITAL_GAMES (דוגמה – ספורט אלקטרוני)
  • TYPE_MUSIC (דוגמה – קונצרט)
  • TYPE_TRAVEL_AND_LOCAL (דוגמה - סיור, פסטיבל)
  • TYPE_HEALTH_AND_FITEness (דוגמה - שיעור יוגה)
  • TYPE_EDUCATION (דוגמה – כיתה)
  • TYPE_SPORTS (דוגמה - משחק פוטבול)
  • TYPE_DATING (דוגמה - מפגש)

לעיון בקטע 'קטגוריית תוכן' לקבלת הנחיות.

LodgingReservationEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

טקסט חופשי. לדוגמה, "השהייה שלך מ-12 בדצמבר"

גודל טקסט מומלץ: עד 50 תווים
שעת הצ'ק-אין חובה חותמת הזמן של תקופת הזמן המוגדרת באלפיות השנייה שמייצגת את מועד הבדיקה עבור ההזמנה. חותמת זמן של תקופה מסוימת באלפיות השנייה
שעת הצ'ק-אאוט חובה חותמת הזמן של תקופה של זמן מערכת (epoch) באלפיות השנייה שמייצגת את זמן התשלום עבור ההזמנה. חותמת זמן של תקופה מסוימת באלפיות השנייה
מיקום – מדינה חובה המדינה שבה נמצא מקום הלינה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – עיר חובה העיר שבה המלון נמצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – כתובת לתצוגה חובה הכתובת של מקום הלינה שתוצג למשתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום - רחוב אופציונלי הרחוב (אם רלוונטי) של מקום הלינה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) שבהם מקום האירוח נמצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – מיקוד אופציונלי המיקוד (אם רלוונטי) של מקום הלינה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום – שכונה אופציונלי השכונה (אם רלוונטי) של מקום הלינה

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
תמונות של פוסטר אופציונלי

נציג רק תמונה אחת אם יסופקו כמה תמונות. אפשרות מומלצת יחס הגובה-רוחב הוא 16:9

הערה: אם מוענק תג, יש להקפיד על סביבה בטוחה 24 dps גם בחלק העליון וגם בחלק התחתון של התמונה

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

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

הערך המקסימלי של סולם הדירוג.

חובה לציין אם גם ערך הדירוג הנוכחי הוא שניתנו.

 מספר >= 0.0
דירוג - ערך נוכחי אופציונלי

הערך הנוכחי של סולם הדירוג.

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

 מספר >= 0.0
דירוג – מספר אופציונלי

מספר הדירוגים של מקום הלינה.

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

 מחרוזת
דירוג - ערך ספירה אופציונלי

מספר הדירוגים של מקום הלינה.

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

 ארוך
מחיר – מחיר נוכחי נדרש באופן מותנה

המחיר הנוכחי של המלון.

אם צוין מחיר עם קו חוצה, חובה לספק אותו.

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

טקסט חופשי

גודל טקסט מומלץ: פחות מ-45 תווים (הטקסט ארוך מדי יכול להיות שיוצגו שלוש נקודות)

TransportationReservationEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

טקסט חופשי. לדוגמה, "SFO to SAN"

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום היציאה – עיר אופציונלי עיר המוצא.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום יציאה – כתובת לתצוגה אופציונלי מיקום היציאה שיוצג למשתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום היציאה – רחוב אופציונלי הרחוב (אם רלוונטי) של מיקום היציאה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום יציאה – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) של מיקום היציאה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום היציאה – מיקוד אופציונלי המיקוד (אם רלוונטי) של מיקום היציאה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום היציאה – שכונה אופציונלי השכונה (אם רלוונטי) של מיקום היציאה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – מדינה אופציונלי מדינת ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – עיר אופציונלי עיר ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – כתובת לתצוגה אופציונלי מיקום ההגעה שיוצג למשתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – כתובת אופציונלי רחוב (אם רלוונטי) של מיקום ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) של מיקום ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה - מיקוד אופציונלי המיקוד (אם רלוונטי) של מיקום ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
מיקום ההגעה – שכונה אופציונלי השכונה (אם רלוונטי) של מיקום ההגעה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
ספק שירות – שם אופציונלי

השם של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

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

הלוגו או התמונה של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

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

נציג רק תמונה אחת אם יסופקו כמה תמונות. אפשרות מומלצת יחס הגובה-רוחב הוא 16:9

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

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

המחיר הנוכחי של ההזמנה.

אם צוין מחיר עם קו חוצה, חובה לספק אותו.

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

טקסט חופשי

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

VehicleRentalReservationEntity

מאפיין דרישה תיאור פורמט
URI של פעולה חובה

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

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

URI
כותרת חובה השם של הישות.

טקסט חופשי. לדוגמה, "Avis Union Square SF"

גודל טקסט מומלץ: עד 50 תווים
שעת האיסוף חובה חותמת הזמן של התקופה שמייצגת את שעת האיסוף של ההזמנה. חותמת זמן של תקופה מסוימת באלפיות השנייה
שעת החזרה אופציונלי חותמת הזמן של התקופה שמייצגת את שעת הצ'ק-אאוט של ההזמנה. חותמת זמן של תקופה מסוימת באלפיות השנייה
כתובת איסוף – מדינה אופציונלי המדינה שבה נמצא נקודת האיסוף.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת איסוף – עיר אופציונלי העיר שבה נמצא האיסוף.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת איסוף – כתובת לתצוגה אופציונלי מיקום האיסוף שיוצג למשתמש.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת לאיסוף – רחוב אופציונלי הרחוב (אם רלוונטי) של מיקום האיסוף.

טקסט חופשי

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת האיסוף – מיקוד אופציונלי המיקוד (אם רלוונטי) של מיקום האיסוף.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת איסוף – שכונה אופציונלי השכונה (אם רלוונטי) של נקודת האיסוף.

טקסט חופשי

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

טקסט חופשי

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

טקסט חופשי

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

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת להחזרה – רחוב אופציונלי הרחוב (אם רלוונטי) של מיקום ההחזרה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת להחזרה – מדינה אופציונלי המדינה או המחוז (אם רלוונטי) של מיקום ההחזרה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
כתובת להחזרה – מיקוד אופציונלי המיקוד (אם רלוונטי) של מיקום ההחזרה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
הכתובת להחזרה – שכונה אופציונלי השכונה (אם רלוונטי) של מיקום ההחזרה.

טקסט חופשי

גודל טקסט מומלץ: עד 20 תווים
ספק שירות – שם אופציונלי

השם של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

טקסט חופשי. לדוגמה, "השכרת רכב של Avis"
ספק שירות – תמונה אופציונלי

הלוגו או התמונה של ספק השירות.

הערה: צריך להוסיף לשירות טקסט או תמונה ספק.

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

נציג רק תמונה אחת אם יסופקו כמה תמונות. אפשרות מומלצת יחס הגובה-רוחב הוא 16:9

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

פסקה אחת של טקסט לתיאור הישות.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

גודל טקסט מומלץ: 180 תווים
רשימת כתוביות אופציונלי

עד 3 כתוביות, כאשר כל כותרת משנה היא שורת טקסט אחת.

הערה: התיאור או רשימת הכתוביות יהיו שמוצגות למשתמש, לא גם וגם.

טקסט חופשי

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

המחיר הנוכחי של ההזמנה.

אם צוין מחיר עם קו חוצה, חובה לספק אותו.

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

טקסט חופשי

גודל טקסט מומלץ: פחות מ-45 תווים (הטקסט ארוך מדי יכול להיות שיוצגו שלוש נקודות)

מפרט לתמונות

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

יחס גובה-רוחב מספר פיקסלים מינימלי מספר פיקסלים מומלץ

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

מועדף

 300x300 1,200x1,200
תמונה לרוחב (1.91X1) 600x314 1,200x628
לאורך (4x5) 480x600 960 x 1,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 תוכל לגשת אותם.

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

  1. ישויות מסוימות, כמו ArticleEntity ו-GeneralFeaturedEntity כשיר להשתמש בכל אחת מקטגוריות התוכן. לגבי ישויות אחרות כמו EventEntity, EventOrderEntity, PointOfInterestEntity, בלבד רק חלק מהקטגוריות האלה עומדות בדרישות. בדיקה של רשימת הקטגוריות כשיר לסוג ישות לפני אכלוס הרשימה.

  2. שימוש בסוג הישות הספציפי בחלק מקטגוריות התוכן בשילוב עם שילוב של הישויות הכלליות והקטגוריה ContentCategory:

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

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

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

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

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

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

publishUserAccountManagementRequest

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

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

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

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

תמונות ביחס גובה-רוחב של 16x9 עם רזולוציה של 1264x712
כותרת אופציונלי – אם אין תמונה, חובה לספק תמונה כותרת על הכרטיס
טקסט פעולה אופציונלי טקסט שמוצג בקריאה לפעולה (כלומר, כניסה לחשבון)
כותרת משנה אופציונלי כתוביות אופציונליות בכרטיס

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

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

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 הזה משמש למחיקת התוכן של אשכול ההמשך.

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 עם הסיבה קוד שגיאה.

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

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

בנוסף לביצוע קריאות לפרסום Content 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))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

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

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}
  • הצהרה סטטית על יישום עם התג <receiver> ב- קובץ AndroidManifest.xml. ההרשאה הזו מאפשרת לאפליקציה לקבל שידור את ה-Intent כאשר הוא לא פועל, וגם מאפשרת לאפליקציה לפרסם את התוכן.
<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      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>

הכוונות הבאות נשלחות על ידי service:

  • 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 SDK בנושא שאלות נפוצות.

יצירת קשר

פרטים ליצירת קשר engagement-developers@google.com, אם יש בזמן תהליך ההטמעה.

השלבים הבאים

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

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