برچسب (Tag)

هر کاربری که در لیست نصب‌های برنامه قرار گیرد می‌تواند یک جیسون به همراه خود داشته باشد که نمایانگر ویژگی‌های مختلف مختص آن کاربر باشد. برای ارسال اعلان و ... می‌توان از این تگ‌ها استفاده کرد و دسته‌ی خاصی از کاربران را مشخص کرد.

مثال:

• کاربرانی که در تاریخ خاصی متولد شده‌اند برای ارسال اعلان تبریک تولد.
• کاربرانی که نام آنها محمد است و ۲۵ سال دارند.
• و ...

اضافه‌کردن تگ

@objc(addTags:) func addTags(with keysAndValues: [String: String])

پارامتر ورودی	استفاده
keysAndValues	یک دیکشنری به فرم [String: String]

Swift

let tags: [String: String] = ["name": "Mohammad",
                              "age": "25",
                              "birthday": "1435187386"]
PusheClient.shared.addTags(with: tags)

Objective-C

NSDictionary<NSString *, NSString *> * _Nonnull tags = @{@"name": @"Mohammad",
                                                         @"age": @"25",
                                                         @"birthday": @"1435187386"};
[PusheClient.shared addTags:tags];

هر کاربر می‌تواند تا ۱۰ تگ داشته باشد

حذف تگ از لیست تگ‌ها

@objc(removeTags:) func removeTags(with keys: [String])

برای حذف می‌توانید لیست کلید‌هایی که می‌خواهید از جیسون تگ حذف کنید را به ورودی تابع بدهید.

پارامتر ورودی	استفاده
keys	آرایه‌ای از کلید‌هایی که می‌خواهید از جیسون تگ حذف کنید

Swift

let tags: [String] = ["name", "age" , "birthday"]
PusheClient.shared.removeTags(with: tags)

Objective-C

NSArray<NSString *> * _Nonnull tags = @[@"name", @"age" , @"birthday"];
[PusheClient.shared removeTags:tags];

گرفتن لیست تگ‌ها

func getSubscribedTags() -> [String: String]

خروجی این تابع یک دیکشنری به فرم [String: String] متشکل از تمام tagهایی است که برای کاربر ثبت شده‌اند.

Swift

let tags: [String: String] = ["name": "Ali"]
PusheClient.shared.addTags(with: tags);
let subscribedtags = PusheClient.shared.getSubscribedTags()    
// subscribedtags: ["name": "Ali"]

Objective-C

NSDictionary<NSString *, NSString *> * _Nonnull tags = @{@"name": @"Ali"};
    [PusheClient.shared addTags:tags];
    NSDictionary<NSString *, NSString *> * _Nonnull subscribedTags = [PusheClient.shared getSubscribedTags];    // subscribedtags: {@"name": @"Ali"}