基本的なプッシュ通知開発者統合ガイドをお探しの場合は、こちらでご確認ください。
上級実装ガイド
このオプションの高度な実装ガイドでは、プッシュメッセージを最大限に活用するために通知コンテンツアプリの拡張機能を活用する方法について説明します。
このガイドでは、通知コンテンツアプリ拡張の3 つの実装例を提供します。それぞれに、概念のウォークスルー、潜在的なユースケース、およびBraze ダッシュボードでプッシュ通知変数がどのように表示され、使用されるかを調べます。
この記事では、これらのカスタム実装のログ分析 に関する[ ガイダンスも提供します。
この実装ガイドは、Swift 実装を中心に扱っていますが、興味のある人のために Objective-C のスニペットが提供されています。
通知コンテンツアプリの拡張
![2つのプッシュメッセージが並んで表示されます。左側のメッセージには、デフォルトのUI でのプッシュの外観が表示されます。右側のメッセージには、カスタムプッシュ UI 1 を実装して作成したコーヒーパンチカードプッシュが表示されます。
通知コンテンツアプリの拡張機能は、プッシュ通知のカスタマイズに優れたオプションを提供します。通知コンテンツアプリの拡張機能は、プッシュ通知が展開されたときに、アプリの通知用のカスタムインターフェイスを表示します。
プッシュ通知は、次の 3 つの方法で展開できます。 - プッシュバナーを長押しする - プッシュバナーを下にスワイプする - バナーを左にスワイプし、[表示] を選択する
これらのカスタムビューは、インタラクティブな通知、ユーザデータが入力された通知、電話番号や電子メールなどの情報をキャプチャできるプッシュメッセージなど、異なる種類のコンテンツを表示することで、顧客を引きつけるスマートな方法を提供します。Brazeでよく知られている機能の1つ、Push Storiesは、プッシュ通知コンテンツアプリの拡張機能がどのように見えるかの素晴らしい例です!
要件
- プッシュ通知 がアプリに正常に統合されました - ご利用のコード言語に基づいて Xcode によって生成される以下のファイル:
Swift
NotificationViewController.swift
MainInterface.storyboard
Objective-C
NotificationViewController.h
NotificationViewController.m
MainInterface.storyboard
インタラクティブなプッシュ通知
プッシュ通知は、コンテンツアプリ拡張内のユーザアクションに応答できます。iOS 12 以降を実行しているユーザーの場合、プッシュ通知を完全なインタラクティブメッセージに変換できます。これは、プロモーションやアプリケーションにインタラクティブ性を導入するためのエキサイティングなオプションを提供します。たとえば、プッシュ通知には、ユーザーがプレイするゲーム、割引のためのスピン・ツー・ウィンのホイール、またはリストや曲を保存するための”ボタンなどが含まれます。
次の例は、ユーザが拡張通知内でマッチゲームを再生できるプッシュ通知を示しています。
ダッシュボード設定
インタラクティブなプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。
- Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
- Composeタブで、Notification Buttonsを切り替えます。
- iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
- 通知コンテンツ拡張ターゲットの
.plist
で、UNNotificationExtensionCategory
属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。 - プッシュ通知でユーザインタラクションを有効にするには、
UNNotificationExtensionInteractionEnabled
キーをtrue
に設定します。
分析をログに記録する準備ができましたか?
Logging Analytics セクション を参照して、データの流れをよりよく理解してください。
パーソナライズされたプッシュ通知
![2 台の iPhone を並べて表示。最初の iPhone には、プッシュメッセージの展開されていないビューが表示されます。2 番目のiPhone には、プッシュメッセージの拡張バージョンが表示され、” progress” は、コースを通過する距離、次のセッションの名前、および次のセッションが完了しなければならない時間のショットを表示します。6
プッシュ通知では、コンテンツ拡張の内部にユーザ固有の情報を表示できます。これにより、さまざまなプラットフォーム間で進行状況を共有したり、ロック解除された達成を表示したり、オンボーディングチェックリストを表示したりするオプションを追加するなど、ユーザー重視のプッシュコンテンツを作成できます。この例では、 Braze ラーニングコースで特定のタスクを完了した後にユーザに表示されるプッシュ通知を示します。通知を展開することで、ユーザーは学習パスを通じて進捗状況を確認できます。ここで提供される情報はユーザー固有であり、セッションが完了するか、API トリガーを利用して特定のユーザーアクションが実行されたときに呼び出すことができます。
ダッシュボード設定
パーソナライズされたプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。
- Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
- Composeタブで、Notification Buttonsを切り替えます。
- iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
- Settingsタブで、標準液体を使用してキーと値のペアを作成します。メッセージに表示する適切なユーザー属性を設定します。これらのビューは、特定のユーザープロファイルの特定のユーザー属性に基づいてカスタマイズできます。
- 通知コンテンツ拡張ターゲットの
.plist
で、UNNotificationExtensionCategory
属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。
キーと値のペアの処理
通知コンテンツアプリの拡張が通知を受け取ったときに、メソッドdidReceive
が呼び出されます。このメソッドはNotificationViewController
内にあります。ダッシュボードで提供されるキーと値のペアは、userInfo
辞書を使用してコードで表されます。
プッシュ通知からのキーと値のペアの解析
``` swift func didReceive(_ notification:UNNotification) { let userInfo = notification.request.content.userInfo
guard let value = userInfo[“YOUR-KEY-VALUE-PAIR”] as?String, let otherValue = userInfo[“YOUR-OTHER-KEY-VALUE-PAIR”] as?String, else { fatalError(“Key-Value Pairs are incorrect.”)}
… } ```
```objc - (void)didReceiveNotification:(nonnull UNNotification *)notification { NSDictionary *userInfo = notification.request.content.userInfo;
if (userInfo[@”YOUR-KEY-VALUE-PAIR”] && userInfo[@”YOUR-OTHER-KEY-VALUE-PAIR”]) {
…
} else { [NSException raise:NSGenericException format:@”Key-Value Pairs are incorrect”]; } } ```
分析をログに記録する準備ができましたか?
Logging Analytics セクション を参照して、データの流れをよりよく理解してください。
情報取得プッシュ通知
プッシュ通知は、コンテンツアプリ拡張内のユーザ情報をキャプチャし、プッシュで可能なものの制限をプッシュできます。プッシュ通知を使用してユーザー入力を要求すると、名前や電子メールなどの基本的な情報を要求するだけでなく、ユーザーにフィードバックを送信したり、未完のユーザープロファイルを完了するように促すことができます。
次のフローでは、カスタムビューは状態の変更に応答できます。これらの状態変更コンポーネントは、各画像に表示されます。
- ユーザーはプッシュ通知を受信します。
- プッシュが開きます。展開後、プッシュプロンプトはユーザーに情報の入力を求めます。この例では、ユーザーの電子メールアドレスが要求されますが、どのような種類の情報でもリクエストできます。
- 情報が提供され、予期される形式であれば、登録ボタンが表示されます。
- 確認画面が表示され、プッシュが解除されます。
ダッシュボード設定
情報キャプチャプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。
- Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
- Composeタブで、Notification Buttonsを切り替えます。
- iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
- Settingsタブで、標準液体を使用してキーと値のペアを作成します。メッセージに表示する適切なユーザー属性を設定します。
- 通知コンテンツ拡張ターゲットの
.plist
で、UNNotificationExtensionCategory
属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。
例に示すように、プッシュ通知にイメージを含めることもできます。これを行うには、リッチプッシュ通知を統合し、キャンペーンの通知スタイルをリッチプッシュ通知に設定し、リッチプッシュ画像を含める必要があります。
ボタンアクションの処理
各アクションボタンは一意に識別されます。コードは、応答識別子が actionIndentifier
と等しいかどうかをチェックし、等しい場合は、ユーザーがアクションボタンをクリックしたことと認識します。
プッシュ通知アクションボタンの応答の処理
1
2
3
4
5
6
7
func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
if response.actionIdentifier == "YOUR-REGISTER-IDENTIFIER" {
// do something
} else {
// do something else
}
}
1
2
3
4
5
6
7
- (void)didReceiveNotificationResponse:(UNNotificationResponse *)response completionHandler:(void (^)(UNNotificationContentExtensionResponseOption))completion {
if ([response.actionIdentifier isEqualToString:@"YOUR-REGISTER-IDENTIFIER"]) {
completion(UNNotificationContentExtensionResponseOptionDismiss);
} else {
completion(UNNotificationContentExtensionResponseOptionDoNotDismiss);
}
}
プッシュの解除
プッシュ通知は、アクションボタンを押すと自動的に解除できます。あらかじめ構築されたプッシュ解雇オプションは3 つあり、以下をお勧めします。
completion(.dismiss)
- 通知を解除しますcompletion(.doNotDismiss)
- 通知は開いたままですcompletion(.dismissAndForward)
- プッシュが解除され、ユーザーがアプリケーションに転送されます。
分析をログに記録する準備ができましたか?
以下のセクションを参照して、データのフローがどうあるべきかを理解してください。
ロギング分析
Braze API を使用したロギング (推奨)
ロギング分析は、Braze API /users/track
endpoint を使用してリアルタイムで実行できます。分析をログに記録するには、braze_id
値をキーと値のペアフィールド (次のスクリーンショットを参照) に送信し、更新するユーザープロファイルを識別します。
手動ロギング
手動でログを記録するには、まずXcode 内でワークスペースを設定し、次に分析を作成、保存、および取得する必要があります。これには、お客様の側でカスタム開発者の作業が必要になります。以下に示すコードスニペットは、これを解決するのに役立ちます。
また、モバイルアプリケーションが後で起動されるまで、分析は Braze に送信されないことに注意してください。つまり、削除設定に応じて、プッシュ通知が破棄されてモバイルアプリが起動し、分析が取得されるまでに不確定な期間が存在することがよくあります。この時間バッファはすべてのユースケースに影響するわけではありませんが、この影響を考慮して、必要に応じてユーザのジャーニーを調整し、アプリケーションを開いてこの問題に対処する必要があります。
ステップ 1:Xcode 内でのアプリケーショングループの設定
Xcode で、App Groups
機能を追加します。アプリにワークスペースがない場合は、メインアプリターゲットの機能に移動し、App Groups
をオンにして、+ Add ボタンをクリックします。次に、アプリのバンドルID を使用してワークスペースを作成します。たとえば、アプリのバンドルID がcom.company.appname
の場合、ワークスペースにgroup.com.company.appname.xyz
という名前を付けることができます。メインアプリターゲットとコンテンツ拡張ターゲットの両方で App Groups
がオンになっていることを確認します。
ステップ2:コードスニペットの統合
以下のコードスニペットは、カスタムイベント、カスタム属性、およびユーザー属性を保存および送信する方法についての役立つ参考情報です。このガイドは、UserDefaults
で説明しますが、コード表現はヘルパーファイルRemoteStorage
の形式になります。追加のヘルパーファイルUserAttributes
とEventName Dictionary
があり、ユーザ属性の送信と保存に使用されます。
カスタムイベントの保存
カスタムイベントを保存するには、分析を最初から作成する必要があります。これを行うには、辞書を作成し、メタデータを入力し、ヘルパーファイルを使用してデータを保存します。
- イベントメタデータを使用して辞書を初期化します
- イベントデータを取得して保存するには、
userDefaults
を初期化します - 既存の配列がある場合は、既存の配列に新しいデータを追加して保存します
- 既存の配列がない場合は、新しい配列を
userDefaults
に保存します
``` swift func saveCustomEvent(with properties: [String:Any]? = nil) { // 1 let customEventDictionary = Dictionary(eventName:”YOUR-EVENT-NAME”, properties: properties)
// 2 let remoteStorage = RemoteStorage(storageType: .suite)
// 3
if var pendingEvents = remoteStorage.retrieve(forKey: .pendingCustomEvents) as? [[String:Any]] {
pendingEvents.append(contentsOf: [customEventDictionary])
remoteStorage.store(pendingEvents, forKey: .pendingCustomEvents)
} else {
// 4
remoteStorage.store([customEventDictionary], forKey: .pendingCustomEvents)
}
}
```
```objc - (void)saveCustomEvent:(NSDictionary<NSString *, id> *)properties { // 1 NSDictionary<NSString *, id> *customEventDictionary = [[NSDictionary alloc] initWithEventName:@”YOUR-EVENT-NAME” properties:properties];
// 2 RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite]; NSMutableArray *pendingEvents = [[remoteStorage retrieveForKey:RemoteStorageKeyPendingCustomEvents] mutableCopy];
// 3 if (pendingEvents) { [pendingEvents addObject:customEventDictionary]; [remoteStorage store:pendingEvents forKey:RemoteStorageKeyPendingCustomAttributes]; } else { // 4 [remoteStorage store:@[ customEventDictionary ] forKey:RemoteStorageKeyPendingCustomAttributes]; } } ```
カスタムイベントの Braze への送信
通知コンテンツアプリの拡張機能から保存された分析をログに記録する最適な時間は、SDK が初期化された直後です。これは、保留中のイベントをループして、「Event Name」キーをチェックし、Braze で適切な値を設定し、次回この関数が必要になったときに備えてストレージをクリアすることで実行できます。
- 保留中のイベントの配列をループします
pendingEvents
辞書の各キーと値のペアをループします- 「イベント名」のキーを明示的に確認し、それに応じて値を設定します
- 他のすべてのキー値が
properties
辞書に追加されます - 個別のカスタムイベントを記録します
- すべての保留中のイベントをストレージから削除します
``` swift func logPendingCustomEventsIfNecessary() { let remoteStorage = RemoteStorage(storageType: .suite) guard let pendingEvents = remoteStorage.retrieve(forKey: .pendingCustomEvents) as? [[String: Any]] else { return }
// 1
for event in pendingEvents {
var eventName:String?
var properties: [AnyHashable:Any] = [:]
// 2
for (key, value) in event {
if key == PushNotificationKey.eventName.rawValue {
// 3
if let eventNameValue = value as?String {
eventName = eventNameValue
} else {
print(“Invalid type for event_name key”)
}
} else {
// 4
properties[key] = value
}
}
// 5
if let eventName = eventName {
AppDelegate.braze?.logCustomEvent(eventName, properties: properties)
}
}
// 6
remoteStorage.removeObject(forKey: .pendingCustomEvents)
}
```
```objc - (void)logPendingEventsIfNecessary { RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite]; NSArray *pendingEvents = [remoteStorage retrieveForKey:RemoteStorageKeyPendingCustomEvents];
// 1 for (NSDictionary<NSString *, id> *event in pendingEvents) { NSString *eventName = nil; NSMutableDictionary *properties = [NSMutableDictionary dictionary];
// 2
for (NSString* key in event) {
if ([key isEqualToString:@”event_name”]) {
// 3
if ([[event objectForKey:key] isKindOfClass:[NSString class]]) {
eventName = [event objectForKey:key];
} else {
NSLog(@”Invalid type for event_name key”);
}
} else {
// 4
properties[key] = event[key];
}
}
// 5
if (eventName != nil) {
[AppDelegate.braze logCustomEvent:eventName properties:properties];
}
}
// 6
[remoteStorage removeObjectForKey:RemoteStorageKeyPendingCustomEvents];
}
```
カスタム属性の保存
カスタム属性を保存するには、分析を最初から作成する必要があります。これを行うには、辞書を作成し、メタデータを入力し、ヘルパーファイルを使用してデータを保存します。
- 属性メタデータを使用してディクショナリを初期化します
- 属性データを取得して格納するには、
userDefaults
を初期化します - 既存の配列がある場合は、既存の配列に新しいデータを追加して保存します
- 既存の配列がない場合は、新しい配列を
userDefaults
に保存します
``` swift func saveCustomAttribute() { // 1 let customAttributeDictionary: [String:Any] = [“YOUR-CUSTOM-ATTRIBUTE-KEY”:”YOUR-CUSTOM-ATTRIBUTE-VALUE”]
// 2 let remoteStorage = RemoteStorage(storageType: .suite)
// 3 if var pendingAttributes = remoteStorage.retrieve(forKey: .pendingCustomAttributes) as? [[String: Any]] { pendingAttributes.append(contentsOf: [customAttributeDictionary]) remoteStorage.store(pendingAttributes, forKey: .pendingCustomAttributes) } else { // 4 remoteStorage.store([customAttributeDictionary], forKey: .pendingCustomAttributes) } } ```
``` objc - (void)saveCustomAttribute { // 1 NSDictionary<NSString *, id> *customAttributeDictionary = @{ @”YOUR-CUSTOM-ATTRIBUTE-KEY”: @”YOUR-CUSTOM-ATTRIBUTE-VALUE” };
// 2
RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite];
NSMutableArray *pendingAttributes = [[remoteStorage retrieveForKey:RemoteStorageKeyPendingCustomAttributes] mutableCopy];
// 3 if (pendingAttributes) { [pendingAttributes addObject:customAttributeDictionary]; [remoteStorage store:pendingAttributes forKey:RemoteStorageKeyPendingCustomAttributes]; } else { // 4 [remoteStorage store:@[ customAttributeDictionary ] forKey:RemoteStorageKeyPendingCustomAttributes]; } } ```
カスタム属性の Braze への送信
通知コンテンツアプリの拡張機能から保存された分析をログに記録する最適な時間は、SDK が初期化された直後です。これは、保留中の属性をループし、Braze で適切なカスタム属性を設定し、次回この関数が必要になったときに備えてストレージをクリアすることで実行できます。
- 保留中の属性の配列をループスルーします
pendingAttributes
辞書の各キーと値のペアをループします- 対応するキーと値を持つ個々のカスタム属性をログに記録する
- ストレージからすべての保留中の属性を削除します
``` swift func logPendingCustomAttributesIfNecessary() { let remoteStorage = RemoteStorage(storageType: .suite) guard let pendingAttributes = remoteStorage.retrieve(forKey: .pendingCustomAttributes) as? [[String: Any]] else { return }
// 1 pendingAttributes.forEach { setCustomAttributesWith(keysAndValues: $0) }
// 4 remoteStorage.removeObject(forKey: .pendingCustomAttributes) }
func setCustomAttributesWith(keysAndValues: [String:Any]) { // 2 for (key, value) in keysAndValues { // 3 if let value = value as? [String] { setCustomAttributeArrayWithKey(key, andValue: value) } else { setCustomAttributeWithKey(key, andValue: value) } } } ```
```objc - (void)logPendingCustomAttributesIfNecessary { RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite]; NSArray *pendingAttributes = [remoteStorage retrieveForKey:RemoteStorageKeyPendingCustomAttributes];
// 1 for (NSDictionary<NSString*, id> *attribute in pendingAttributes) { [self setCustomAttributeWith:attribute]; }
// 4 [remoteStorage removeObjectForKey:RemoteStorageKeyPendingCustomAttributes]; }
- (void)setCustomAttributeWith:(NSDictionary<NSString *, id> *)keysAndValues { // 2 for (NSString *key in keysAndValues) { // 3 [self setCustomAttributeWith:key andValue:[keysAndValues objectForKey:key]]; } } ```
ユーザー属性の保存
ユーザー属性を保存する場合は、カスタムオブジェクトを作成して、更新されている属性のタイプを解読することをお勧めします(email
、first_name
、phone_number
など)。オブジェクトは、UserDefaults
からの保管 / 取得に対応している必要があります。これを行う方法の一例については、UserAttribute
ヘルパーファイルを参照してください。
- エンコードされた
UserAttribute
オブジェクトを対応する型で初期化します - イベントデータを取得して保存するには、
userDefaults
を初期化します - 既存の配列がある場合は、既存の配列に新しいデータを追加して保存します
- 既存の配列がない場合は、新しい配列を
userDefaults
に保存します
``` swift func saveUserAttribute() { // 1 guard let data = try?PropertyListEncoder().encode(UserAttribute.userAttributeType(“USER-ATTRIBUTE-VALUE”)) else { return }
// 2
let remoteStorage = RemoteStorage(storageType: .suite)
// 3
if var pendingAttributes = remoteStorage.retrieve(forKey: .pendingUserAttributes) as? [Data] {
pendingAttributes.append(contentsOf: [data])
remoteStorage.store(pendingAttributes, forKey: .pendingUserAttributes)
} else {
// 4
remoteStorage.store([data], forKey: .pendingUserAttributes)
}
}
```
```objc - (void)saveUserAttribute { // 1 UserAttribute *userAttribute = [[UserAttribute alloc] initWithUserField:@”USER-ATTRIBUTE-VALUE” attributeType:UserAttributeTypeEmail];
NSError *error; NSData *data = [NSKeyedArchiver archivedDataWithRootObject:userAttribute requiringSecureCoding:YES error:&error];
if (error != nil) {
// log error
}
// 2
RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite];
NSMutableArray *pendingAttributes = [[remoteStorage retrieveForKey:RemoteStorageKeyPendingUserAttributes] mutableCopy];
// 3 if (pendingAttributes) { [pendingAttributes addObject:data]; [remoteStorage store:pendingAttributes forKey:RemoteStorageKeyPendingUserAttributes]; } else { // 4 [remoteStorage store:@[data] forKey:RemoteStorageKeyPendingUserAttributes]; } } ```
Braze へのユーザー属性の送信
通知コンテンツアプリの拡張機能から保存された分析をログに記録する最適な時間は、SDK が初期化された直後です。これは、保留中の属性をループし、Braze で適切なカスタム属性を設定し、次回この関数が必要になったときに備えてストレージをクリアすることで実行できます。
pendingAttributes
データの配列をループします- 属性データからエンコードされた
UserAttribute
オブジェクトを初期化します - ユーザー属性タイプ (電子メール) に基づいて特定のユーザーフィールドを設定します
- ストレージからすべての保留中のユーザー属性を削除します
``` swift func logPendingUserAttributesIfNecessary() { let remoteStorage = RemoteStorage(storageType: .suite) guard let pendingAttributes = remoteStorage.retrieve(forKey: .pendingUserAttributes) as? [Data] else { return }
// 1
for attributeData in pendingAttributes {
// 2
guard let userAttribute = try? PropertyListDecoder().decode(UserAttribute.self, from: attributeData) else { continue }
// 3
switch userAttribute {
case .email(let email):
user?.email = email
}
}
// 4
remoteStorage.removeObject(forKey: .pendingUserAttributes)
}
```
```objc - (void)logPendingUserAttributesIfNecessary { RemoteStorage *remoteStorage = [[RemoteStorage alloc] initWithStorageType:StorageTypeSuite]; NSArray *pendingAttributes = [remoteStorage retrieveForKey:RemoteStorageKeyPendingUserAttributes];
// 1
for (NSData *attributeData in pendingAttributes) {
NSError *error;
// 2 UserAttribute *userAttribute = [NSKeyedUnarchiver unarchivedObjectOfClass:[UserAttribute class] fromData:attributeData error:&error];
1
2
3
if (error != nil) {
// log error
}
// 3
if (userAttribute) {
switch (userAttribute.attributeType) {
case UserAttributeTypeEmail:
[self user].email = userAttribute.userField;
break;
}
}
}
// 4
[remoteStorage removeObjectForKey:RemoteStorageKeyPendingUserAttributes];
}
```
ヘルパーファイル
RemoteStorage Helper File
```swift enum RemoteStorageKey:String, CaseIterable {
// MARK: - 通知内容拡張分析 case pendingCustomEvents = “pending_custom_events” case pendingCustomAttributes = “pending_custom_attributes” case pendingUserAttributes = “pending_user_attributes” }
enum RemoteStorageType { case standard case suite }
class RemoteStorage:NSObject { private var storageType: RemoteStorageType = .standard private lazy var defaults: UserDefaults = { switch storageType { case .standard: return .standard case .suite: return UserDefaults(suiteName: “YOUR-DOMAIN-IDENTIFIER”)! } }()
init(storageType:RemoteStorageType = .standard) { self.storageType = storageType }
func store(_ value:Any, forKey key:RemoteStorageKey) { defaults.set(value, forKey: key.rawValue) }
func retrieve(forKey key:RemoteStorageKey) -> Any? { return defaults.object(forKey: key.rawValue) }
func removeObject(forKey key:RemoteStorageKey) { defaults.removeObject(forKey: key.rawValue) }
func resetStorageKeys() { for key in RemoteStorageKey.allCases { defaults.removeObject(forKey: key.rawValue) } } } ```
```objc @interface RemoteStorage ()
@property (nonatomic) StorageType storageType; @property (nonatomic, strong) NSUserDefaults *defaults;
@end
@implementation RemoteStorage
-
(id)initWithStorageType:(StorageType)storageType { if (self = [super init]) { self.storageType = storageType; } return self; }
-
(void)store:(id)value forKey:(RemoteStorageKey) キー { [[self defaults] setValue:value forKey:[self rawValueForKey:key]]; }
-
(id)retrieveForKey:(RemoteStorageKey) key { return [[self defaults] objectForKey:[self rawValueForKey:key]]; }
-
(void)removeObjectForKey:(RemoteStorageKey) キー { [[self defaults] removeObjectForKey:[self rawValueForKey:key]]; }
-
(void)resetStorageKeys { [[self defaults] removeObjectForKey:[self rawValueForKey:RemoteStorageKeyPendingCustomEvents]]; [[self defaults] removeObjectForKey:[self rawValueForKey:RemoteStorageKeyPendingCustomAttributes]]; [[self defaults] removeObjectForKey:[self rawValueForKey:RemoteStorageKeyPendingUserAttributes]]; }
-
(NSUserDefaults *)defaults { if (!self.defaults) { switch (self.storageType) { case StorageTypeStandard: return [NSUserDefaults standardUserDefaults]; break; case StorageTypeSuite: return [[NSUserDefaults alloc] initWithSuiteName:@”YOUR-DOMAIN-IDENTIFIER”]; } } else { return self.defaults; } }
-
(NSString*)rawValueForKey:(RemoteStorageKey)remoteStorageKey { switch(remoteStorageKey) { case RemoteStorageKeyPendingCustomEvents: return @”pending_custom_events”; case RemoteStorageKeyPendingCustomAttributes: return @”pending_custom_attributes”; case RemoteStorageKeyPendingUserAttributes: return @”pending_user_attributes”; default: [NSException raise:NSGenericException format:@”Unexpected FormatType.”]; } } ```
UserAttribute Helper File
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
enum UserAttribute:Hashable {
case email(String?)
}
// MARK:-コード可能
拡張 UserAttribute:コード可能 {
private enum CodingKeys: String, CodingKey {
case email
}
func encode(to encoder:Encoder) throws {
var values = encoder.container(keyedBy:CodingKeys.self)
switch self {
case .email(let email):
try values.encode(email, forKey: .email)
}
}
init(from decoder:Decoder) throws {
let values = try decoder.container(keyedBy:CodingKeys.self)
let email = try values.decode(String.self, forKey: .email)
self = .email(email)
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
@implementation UserAttribute
- (id)initWithUserField:(NSString \*)userField attributeType:(UserAttributeType)attributeType {
if (self = [super init]) {
self.userField = userField;
self.attributeType = attributeType;
}
return self;
}
- (void)encodeWithCoder:(NSCoder \*)encoder {
[encoder encodeObject:self.userField forKey:@"userField"];
[encoder encodeInteger:self.attributeType forKey:@"attributeType"];
}
- (id)initWithCoder:(NSCoder \*)decoder {
if (self = [super init]) {
self.userField = [decoder decodeObjectForKey:@"userField"];
NSInteger attributeRawValue = [decoder decodeIntegerForKey:@"attributeType"];
self.attributeType = (UserAttributeType) attributeRawValue;
}
return self;
}
@end
EventName Dictionary Helper File
1
2
3
4
5
6
7
8
9
10
11
12
extension Dictionary where Key == String, Value == Any {
init(eventName:String, properties: [String:Any]? = nil) {
self.init()
self[PushNotificationKey.eventName.rawValue] = eventName
if let properties = properties {
for (key, value) in properties {
self[key] = value
}
}
}
}
```objc @implementation NSDictionary (Helper)
-
(id)initWithEventName:(NSString *)eventName properties:(NSDictionary *)properties { self = [self init]; if (self) { dict[@”event_name”] = eventName;
for(id key in properties) { dict[key] = properties[key]; } } return self; }
@end ```