דלג לתוכן הראשי

אפליקציות ומעקב רב־פלטפורמי

אפליקציות מאפשרות לעקוב אחרי משתמשים בפלטפורמות שונות (ווב, iOS, Android) עם מפתחות SDK נפרדים, תוך ניהול הכל במקום אחד.

מהן אפליקציות?​

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

  • אפליקציית ווב: האתר או אפליקציית הווב שלכם
  • אפליקציית iOS: אפליקציית המובייל ב־iOS
  • אפליקציית Android: אפליקציית המובייל באנדרואיד

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

למה להשתמש בכמה אפליקציות?​

מעקב בין פלטפורמות​

ראו אילו משתמשים פעילים בווב לעומת מובייל:

מסע משתמש:
1. ביקור באתר (Web App)
2. הרשמה בווב
3. הורדת אפליקציית iOS
4. רכישה ב־iOS

סגמנטציה לפי פלטפורמה​

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

יעד: משתמשים שהשתמשו באפליקציית iOS אך לא באפליקציית Android
קמפיין: "נסו את אפליקציית Android שלנו"

ניתוח ביצועים לפי פלטפורמה​

השוו מדדים בין פלטפורמות:

אפליקציית ווב:
  - 10,000 משתמשים פעילים
  - 50,000 אירועים ביום
  - יכולת נפוצה: Export

iOS:
  - 5,000 משתמשים פעילים
  - 25,000 אירועים ביום
  - יכולת נפוצה: Camera

יצירת אפליקציה​

שלב 1: מעבר לעמוד Apps​

  1. עברו אל Settings → Apps
  2. לחצו על Create App

שלב 2: הגדרת אפליקציה​

  • Name: שם תיאורי (למשל, "My Website", "iOS App")
  • Platform: בחרו web, iOS או Android

שלב 3: קבלת מפתח SDK​

לאחר היצירה תקבלו מפתח SDK ייחודי:

jry_sdk_web_abc123...     (Web)
jry_sdk_ios_def456...     (iOS)
jry_sdk_android_ghi789... (Android)
פורמט מפתח SDK

מפתחות SDK כוללים את הפלטפורמה במפתח עצמו לזיהוי קל.

שימוש במפתחות SDK​

import JoryioSDK from '@joryio/web-sdk';

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_abc123...' // Your web app SDK key
});

מטא־נתונים אוטומטיים של אפליקציה​

כל האירועים שנשלחים דרך ה־SDK כוללים אוטומטית מטא־נתונים של אפליקציה:

{
  "eventName": "Page Viewed",
  "properties": {
    "page": "/pricing",
    // Automatically added:
    "$app_id": "app_123",
    "$app_name": "My Website",
    "$platform": "web",
    "$session_id": "session_456"
  }
}

זה מאפשר סגמנטציה חזקה לפי אפליקציה/פלטפורמה.

אנליטיקה לאפליקציה​

צפו באנליטיקה לכל אפליקציה:

  1. עברו אל Settings → Apps
  2. לחצו View Analytics עבור האפליקציה

מדדים זמינים​

סטטיסטיקות כלליות:

  • סך האירועים שנרשמו
  • משתמשים פעילים (30 הימים האחרונים)
  • זמן האירוע האחרון

אירועים לאורך זמן:

  • נפח אירועים יומי
  • ניתוח מגמות

אירועים מובילים:

  • האירועים הנפוצים ביותר
  • ספירות ואחוזים

סגמנטציה לפי שימוש באפליקציה​

צרו סגמנטים עם המסנן App / site usage (אופרטורים: used app / did not use app). כיוון שאפליקציה כבר קובעת את הפלטפורמה שלה, ממקדים פלטפורמה על ידי בחירת האפליקציות המתאימות:

דוגמה 1: משתמשי מובייל בלבד​

Used app "iOS App"
AND
Did NOT use app "My Website"

דוגמה 2: משתמשים חוצי פלטפורמות​

Used app "My Website"
AND
Used app "iOS App"

דוגמה 3: התנהגות ספציפית לאפליקציה​

Used app "iOS App"
AND
Performed "Order Completed" within last 30 days

שימוש: עידוד אימוץ אפליקציית מובייל, מסרים ייחודיים לפלטפורמה

ניהול אפליקציות​

צפייה בכל האפליקציות​

Settings → Apps מציג את כל האפליקציות עם:

  • שם אפליקציה ופלטפורמה
  • מפתח SDK (עם כפתור העתקה)
  • תאריך יצירה
  • פעולות מהירות

עריכת אפליקציה​

  1. לחצו על שם האפליקציה או על סמל העריכה
  2. עדכנו את השם
  3. לחצו Save
אי אפשר לשנות פלטפורמה

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

יצירת מפתח SDK מחדש​

אם מפתח SDK נחשף:

  1. לחצו Regenerate Key לאפליקציה
  2. אשרו את הפעולה
  3. עדכנו את האפליקציה עם המפתח החדש
שינוי שאינו תואם לאחור

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

מחיקת אפליקציה​

  1. לחצו Delete לאפליקציה
  2. אשרו מחיקה
השפעה על הנתונים

מחיקת אפליקציה:

  • מבטלת את מפתח ה־SDK (המעקב נעצר)
  • אירועים שכבר נקלטו נשארים במאגר האנליטיקה
  • לא ניתן לשחזר

שיטות עבודה מומלצות​

1. אפליקציה אחת לכל פלטפורמה​

צרו אפליקציות נפרדות לכל פלטפורמה:

טוב

  • "My Website" (web)
  • "iOS App" (iOS)
  • "Android App" (Android)

לא טוב

  • "All Platforms" (web) - ערבוב פלטפורמות

2. שמות תיאוריים​

השתמשו בשמות ברורים וקלים לזיהוי:

טוב: "Production Web App", "iOS - App Store" לא טוב: "App 1", "Test"

3. אבטחת מפתחות SDK​

  • אל תכניסו מפתחות SDK למאגרים ציבוריים
  • השתמשו במשתני סביבה
  • צרו מחדש אם נחשפו
// Good: Use environment variables
const joryio = new JoryioSDK({
  sdkKey: process.env.JORYIO_SDK_KEY
});

// Bad: Hardcoded key
const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_abc123...'
});

מקרי שימוש נפוצים​

1. קמפיינים לפי פלטפורמה​

שלחו הודעות ממוקדות לפי פלטפורמה:

Segment: iOS users who haven't updated in 30 days
Campaign: "New features in latest iOS app update"

2. אנליטיקה חוצת פלטפורמות​

השוו מעורבות משתמשים בין פלטפורמות:

Query: How many users are active on both web and mobile?
Segment: Has used platform "web" AND has used platform "ios"

3. מעבר בין פלטפורמות​

עודדו משתמשים לנסות פלטפורמות נוספות:

Segment: Active web users who haven't downloaded mobile app
Campaign: "Take us on the go - download our mobile app"

4. יכולות ייחודיות לפלטפורמה​

עקבו אחרי שימוש ביכולות לפי פלטפורמה:

Event: Feature Used
Properties: { feature: "camera", platform: "ios" }

Analysis: Camera feature only available on mobile

מסע משתמש חוצה אפליקציות​

עקבו אחר המשתמש לאורך המסע כולו:

Timeline for user_123:

Day 1 (Web App):
  - Signup Completed
  - Profile Created
  - Viewed Pricing

Day 3 (iOS App):
  - App Installed
  - Login
  - First Purchase

Day 7 (Web App):
  - Login
  - Settings Updated

Day 14 (Android App):
  - App Installed
  - Login
  - Feature Used

הכל נעקב אוטומטית עם מטא־נתוני אפליקציה!

אבטחה ובקרת גישה​

הרשאות מפתח SDK​

מפתחות SDK (צד הלקוח) יכולים רק:

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

הרשאות מפתח API​

מפתחות API (צד השרת) מנוהלים תחת Settings → API Keys ונושאים את ההרשאות שאתם מעניקים להם, שיכולות לכלול:

  • כל פעולות ה־SDK
  • ניהול קמפיינים
  • שאילתות משתמשים
  • גישה לאנליטיקה
אל תשתמשו במפתחות API בקוד לקוח

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

פתרון תקלות​

אירועים לא מופיעים​

בדקו שמפתח ה־SDK נכון:

// Enable debug mode
const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_...',
  enableDebug: true // See logs in console
});

ודאו שהאפליקציה פעילה:

  • עברו ל־Settings → Apps
  • בדקו סטטוס אפליקציה
  • ודאו שהמפתח תואם

האנליטיקה לא מתעדכנת​

האנליטיקה מתעדכנת בזמן אמת אבל ייתכן עיכוב של כמה שניות:

  • בדקו חותמת זמן של "Last Event"
  • ודאו שאירועים נשלחים
  • נסו לרענן את העמוד

שיוך משתמשים חוצה פלטפורמות​

משתמשים משויכים לפי:

  1. מזהה משתמש (אם זוהה)
  2. מזהה אנונימי (לפני זיהוי)

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

// Web
joryio.identify('user_123');
joryio.setAttributes({
  email: 'user@example.com',
  name: 'John Doe'
});

// iOS (same user ID)
Joryio.shared.identify("user_123")
Joryio.shared.setAttributes([
  "email": "user@example.com",
  "name": "John Doe"
])

צעדים הבאים​