שאלות נפוצות

איך אפשר ליצור קובץ מצורף נהדר?

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

כדי למקסם את היעילות, הקבצים המצורפים צריכים:

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

הקובץ המצורף שלי לא מופיע בקטע 'בקרבת מקום' בהגדרות Google. למה?

• יש כמה אילוצים על ההודעות שאנחנו מציגים, כמו לאפשר רק HTTPS כתובות URL ואיסורים על פרסום תוכן שמפר את המדיניות.
• אין תמיכה בקישורים אל play.google.com. במקום זאת, השתמשו קבצים מצורפים של כוונות רכישה כדי לאפשר חוויה שמופעלת באמצעות אפליקציה.

ההודעה שלי לא מוצגת כהתראה. למה?

יש כמה סיבות אפשריות לכך שלא מוצגת התראה.

1. לא תוצג התראה אם המשתמשים לא יקבלו את הקובץ המצורף. ראו למעלה טיפים ליצירת קובץ מצורף טוב.
2. לרוב, התכונה 'התראות בקרבת מקום' סורקת את האותות למשך כמה שניות אחרי המסך פועל. אם המסך לא נדלק למשך זמן מה, המכשיר לא יגלה איתותי Bluetooth חדשים.
3. קובץ מצורף במצב ניפוי באגים יופיע רק בניפוי באגים מכשירים במצב. מידע נוסף מופיע במאמר מצב ניפוי באגים
4. אם ההתראה נסגרה במכשיר לאחרונה, ייתכן שהמכשיר הזה לא להציג התראה נוספת במשך פרק זמן מסוים. גם מדיניות ההשהיה לפני ניסיון חוזר (backoff) אופסה אם המשתמש פותח את הקטע 'בקרבת מקום' בהגדרות Google.
5. ייתכן שהתראה לא תוצג אם היא מפירה את התראות בקרבת מקום .

אילו גרסאות של Android תומכות בהתראות בקרבת מקום?

התכונה 'התראות בקרבת מקום' נתמכת ב-Android 4.4 (KitKat) ואילך.

מה הקשר בין התכונה 'התראות בקרבת מקום' לבין Eddystone-URL או אינטרנט פיזי?

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

מה הפורמט הנדרש לקבצים מצורפים של 'התראות בקרבת מקום' ב-Proximity Beacon API?

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

    {
      "title": "Example",
      "url": "https://www.example.com"
    }

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

הכותרת תופיע בהתראות וברשימות המוצגות על ידי התראות בקרבת מקום. לדוגמה, אם הכותרת היא "דוגמה לפעולה במקום", טקסט ההתראה יופיע כך "Example action at place" בנוסף לשם האפליקציה או לכתובת ה-URL.

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

לא. התראות בקרבת מקום יפנו את המשתמשים לחנות Google Play כדי להתקין משם.

איך אפשר לדעת אם משתמש הגיע לאפליקציה שלי דרך התראות בקרבת מקום?

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

האם התכונה 'התראות בקרבת מקום' תומכת ב-iBeacon?

כן, כל עוד לאותת יש מזהה iBeacon סטטי. ניתן לרשום את המזהים האלה ב-Proximity Beacon API, והוא יכול לכלול קבצים מצורפים של 'התראות בקרבת מקום'.

איפה ומתי הסריקה מתרחשת, אם היא לא באפליקציה שלי?

הסריקה מתבצעת על ידי Google Play Services ורק במצב "מופעל במסך" אירועים.

מי אחראי על רישום האותות ב-Proximity Beacon API?

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

מהו הפורמט של ה-URI של ה-Intent באפליקציה?

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

אם רוצים שהתכונה 'התראות של מכשירים בקרבת מקום' תפעיל את הפעילות באפליקציה מסנן Intent הבא:

    <data android:host="item"
          android:pathPrefix="/scanner"
          android:scheme="myapp" />

ה-URI התואם של Intent:// יהיה:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;end

כלומר, אפשר לפצל את ה-URI כך:

    intent://<host>/<path>#Intent;scheme=<scheme>;package=<package name>;end

אם בפעילות שלך נדרשות תוספות על כוונות, יש להוסיף אותן ממש לפני ;end:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;S.string_extra=value%20one;B.bool_extra=true;end

ניתן להשתמש בסוגים הבאים עם תוספות:

• בוליאני
• בייט
• צ'אר
• כפול
• Float
• Int
• ארוך
• סרטון Shorts

ראו גם Intent.java#parseUri() ו-Intent.java#toUri(int) בהקשר של URI_INTENT_SCHEME לקבלת פרטים נוספים על כתובת ה-URL הזו של Intent.

מה לגבי התאמה לשוק המקומי של הכותרת שבה נעשה שימוש בהתראות בקרבת מקום?

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