סקירה כללית
שכבת הנתונים היא מילון שמכיל מידע כללי על האפליקציה.
הוא משתמש בקבוצה סטנדרטית של מפתחות, כך שכל גורם שמבין את המפרט יוכל לקרוא אותו. המצב של שכבת הנתונים מתעדכן באמצעות ה-API שלה. לדוגמה, אפליקציה עשויה להתחיל עם ה-dataLayer הבא:
{
title: "Original screen title"
}
המצב או הנתונים של האפליקציה עשויים להשתנות, ולכן האפליקציה יכולה לעדכן את ה-dataLayer באמצעות קריאה. למשל:
[dataLayer push:@{@"title": @"New screen title"}];
עכשיו שכבת הנתונים מכילה:
{
title: "New screen title"
}
לאחר דחיפה נוספת:
[dataLayer push:@{@"xyz": @3}];
ה-dataLayer כולל:
{
"title": "New screen title",
"xyz": 3
}
הדוגמה הבאה ממחישה איך פועל מיזוג מערכים ומפות. אם ה-dataLayer המקורי מכיל:
{
"items": @[@"item1", [NSNull null], @"item2", @{@"a": @"aValue", @"b": @"bValue"}]
}
לאחר שהדחיפה מתבצעת:
[dataLayer push:@{@"items":
@[[NSNull null], @"item6", kTAGDataLayerObjectNotPresent, @{@"a": [NSNull null]}]}
ה-dataLayer כולל:
{
"items": @[[NSNull null], @"item6", @"item2", @{@"a": [NSNull null], @"b": @"bValue"}]}
}
דחיפות מתרחשות באופן סינכרוני; לאחר הדחיפה, השינויים באים לידי ביטוי במודל.
כשמפתח event מועבר לשכבת הנתונים, מתבצעת הערכה של הכללים של התגים וכל התגים שתואמים לאירוע הזה יופעלו. לדוגמה, בהינתן מאגר עם תג שכללי ההפעלה שלו הם ה'אירוע' הוא שווה ל-'openScreen', אחרי הדחיפה הזו:
[dataLayer push:@{@"event", @"openScreen"}];
שהתג יופעל.
פונקציות חברים ציבוריים | |
| (מבוטל) | - pushValue:forKey: |
| דוחף צמד מפתח/ערך לשכבת הנתונים. | |
| (מבוטל) | - push: |
ממזג את האובייקט update הנתון עם מודל הנתונים הקיים, וקורא לכל המאזינים עם העדכון (לאחר המיזוג). | |
| (NSObject *) | - get: |
| מחזירה את האובייקט במודל שמשויך למפתח הנתון. | |
מסמכי תיעוד בנושא פונקציות של חברים
| - (ריק) pushValue: | (NSObject *) | ערך | |
| forKey: | (NSObject *) | מפתח | |
דוחף צמד מפתח/ערך לשכבת הנתונים.
זו רק שיטה נוחה שקוראת ל-push:@{key: value}.
| - (ריק) push: | (NSמילון *) | עדכון |
ממזג את האובייקט update הנתון עם מודל הנתונים הקיים, וקורא לכל המאזינים עם העדכון (לאחר המיזוג).
הוא תקף לערכים במילון (או למערךים מוטמעים) מסוג NSNull. כדי לייצג ערך חסר (כמו אינדקס ריק ברשימה), אפשר להשתמש באובייקט kTAGDataLayerObjectNotPresent.
בדרך כלל זוהי שיחה מסונכרנת. עם זאת, אם בזמן שהשרשור מבצע את הדחיפה, מתרחשת דחיפה נוספת מאותו השרשור, הדחיפה השנייה היא אסינכרונית (הדחיפה השנייה תחזור לפני שבוצעו שינויים בשכבת הנתונים). הדחיפה השנייה מאותו שרשור יכולה להתרחש, למשל, אם דחיפת שכבת נתונים מתבצעת בתגובה להפעלת תג. עם זאת, כל העדכונים יעובדו לפני ההחזרה החיצונית ביותר.
אם update מכיל את המפתח event, הכללים יעברו הערכה ותגים תואמים יופעלו.
- פרמטרים:
-
עדכון אובייקט העדכון לעיבוד
| - (NSObject*) get: | (NSString *) | מפתח |
מחזירה את האובייקט במודל שמשויך למפתח הנתון.
אם אין מפתח, הפונקציה מחזירה את הערך nil. אם השדה key קיים אבל NSNull, הפונקציה מחזירה NSNull.
למפתח יכולות להיות נקודות מוטמעות. לדוגמה: מפתח של "a.b.c" מחזיר את הערך של c. מקש במילון עם המקש b במילון עם המפתח 'a' במודל.