Ringkasan
Lapisan data adalah kamus yang menyimpan informasi umum tentang aplikasi.
Kunci ini menggunakan seperangkat kunci standar sehingga dapat dibaca oleh pihak mana pun yang memahami spesifikasi tersebut. Status lapisan data diperbarui melalui API-nya. Misalnya, aplikasi mungkin dimulai dengan dataLayer berikut:
{
title: "Original screen title"
}
Karena status/data aplikasi dapat berubah, aplikasi dapat memperbarui dataLayer dengan panggilan seperti:
[dataLayer push:@{@"title": @"New screen title"}];
Sekarang lapisan data berisi:
{
title: "New screen title"
}
Setelah push berikutnya terjadi:
[dataLayer push:@{@"xyz": @3}];
dataLayer berisi:
{
"title": "New screen title",
"xyz": 3
}
Contoh berikut menunjukkan cara kerja penggabungan array dan peta. Jika dataLayer asli berisi:
{
"items": @[@"item1", [NSNull null], @"item2", @{@"a": @"aValue", @"b": @"bValue"}]
}
Setelah push ini dilakukan:
[dataLayer push:@{@"items":
@[[NSNull null], @"item6", kTAGDataLayerObjectNotPresent, @{@"a": [NSNull null]}]}
dataLayer berisi:
{
"items": @[[NSNull null], @"item6", @"item2", @{@"a": [NSNull null], @"b": @"bValue"}]}
}
Push terjadi secara sinkron; setelah push, perubahan telah dicerminkan dalam model.
Saat kunci event didorong ke lapisan data, aturan untuk tag akan dievaluasi dan semua tag yang cocok dengan peristiwa ini akan diaktifkan. Misalnya, pada penampung dengan tag yang aturan pengaktifannya adalah "peristiwa" sama dengan "openScreen", setelah push ini:
[dataLayer push:@{@"event", @"openScreen"}];
tag tersebut akan diaktifkan.
Fungsi Anggota Publik | |
| (void) | - pushValue:forKey: |
| Mendorong key-value pair ke lapisan data. | |
| (void) | - push: |
Menggabungkan objek update yang ditentukan ke dalam model data yang ada, memanggil pemroses apa pun dengan pembaruan (setelah penggabungan terjadi). | |
| (NSObject *) | - dapatkan: |
| Menampilkan objek dalam model yang terkait dengan kunci yang diberikan. | |
Dokumentasi Fungsi Anggota
| - (void) pushValue: | (NSObject *) | value | |
| untukKunci: | (NSObject *) | kunci | |
Mendorong key-value pair ke lapisan data.
Ini hanyalah metode praktis yang memanggil push:@{key: value}.
| - (void) push: | (NSDictionary *) | pembaruan |
Menggabungkan objek update yang ditentukan ke dalam model data yang ada, memanggil pemroses apa pun dengan pembaruan (setelah penggabungan terjadi).
Ini valid untuk nilai dalam kamus (atau Array tersemat) yang berjenis NSNull. Jika Anda ingin menampilkan nilai yang hilang (seperti indeks kosong dalam Daftar), gunakan objek kTAGDataLayerObjectNotPresent.
Ini biasanya merupakan panggilan sinkron. Namun, jika, saat thread mengeksekusi push, push lain terjadi dari thread yang sama, maka push kedua tersebut asinkron (push kedua akan ditampilkan sebelum perubahan dilakukan pada lapisan data). Dorongan kedua dari thread yang sama ini dapat terjadi, misalnya, jika push lapisan data dibuat sebagai respons terhadap pengaktifan tag. Namun, semua pembaruan akan diproses sebelum push terluar ditampilkan.
Jika update berisi kunci event, aturan akan dievaluasi dan tag yang cocok akan diaktifkan.
- Parameter:
-
ubah Objek update yang akan diproses
| - (NSObject*) get: | (NSString *) | key |
Menampilkan objek dalam model yang terkait dengan kunci yang diberikan.
Jika kunci tidak ada, nil akan ditampilkan. Jika key ada, tetapi NSNull, akan menampilkan NSNull.
Kunci dapat memiliki titik tersemat. Misalnya: kunci "a.b.c" menampilkan nilai kunci "c" dalam kamus dengan kunci "b" dalam kamus dengan kunci "a" dalam model.