上級実装ガイド

このオプションの高度な実装ガイドでは、プッシュメッセージを最大限に活用するために通知コンテンツアプリの拡張機能を活用する方法について説明します。

このガイドでは、通知コンテンツアプリ拡張の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 以降を実行しているユーザーの場合、プッシュ通知を完全なインタラクティブメッセージに変換できます。これは、プロモーションやアプリケーションにインタラクティブ性を導入するためのエキサイティングなオプションを提供します。たとえば、プッシュ通知には、ユーザーがプレイするゲーム、割引のためのスピン・ツー・ウィンのホイール、またはリストや曲を保存するための”ボタンなどが含まれます。

次の例は、ユーザが拡張通知内でマッチゲームを再生できるプッシュ通知を示しています。

ダッシュボード設定

インタラクティブなプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。

1. Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
2. Composeタブで、Notification Buttonsを切り替えます。
3. iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
4. 通知コンテンツ拡張ターゲットの.plist で、UNNotificationExtensionCategory 属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。
5. プッシュ通知でユーザインタラクションを有効にするには、UNNotificationExtensionInteractionEnabled キーをtrue に設定します。

分析をログに記録する準備ができましたか?

Logging Analytics セクション を参照して、データの流れをよりよく理解してください。

パーソナライズされたプッシュ通知

![2 台の iPhone を並べて表示。最初の iPhone には、プッシュメッセージの展開されていないビューが表示されます。2 番目のiPhone には、プッシュメッセージの拡張バージョンが表示され、” progress” は、コースを通過する距離、次のセッションの名前、および次のセッションが完了しなければならない時間のショットを表示します。6

プッシュ通知では、コンテンツ拡張の内部にユーザ固有の情報を表示できます。これにより、さまざまなプラットフォーム間で進行状況を共有したり、ロック解除された達成を表示したり、オンボーディングチェックリストを表示したりするオプションを追加するなど、ユーザー重視のプッシュコンテンツを作成できます。この例では、 Braze ラーニングコースで特定のタスクを完了した後にユーザに表示されるプッシュ通知を示します。通知を展開することで、ユーザーは学習パスを通じて進捗状況を確認できます。ここで提供される情報はユーザー固有であり、セッションが完了するか、API トリガーを利用して特定のユーザーアクションが実行されたときに呼び出すことができます。

ダッシュボード設定

パーソナライズされたプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。

1. Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
2. Composeタブで、Notification Buttonsを切り替えます。
3. iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
4. Settingsタブで、標準液体を使用してキーと値のペアを作成します。メッセージに表示する適切なユーザー属性を設定します。これらのビューは、特定のユーザープロファイルの特定のユーザー属性に基づいてカスタマイズできます。
5. 通知コンテンツ拡張ターゲットの.plist で、UNNotificationExtensionCategory 属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。

キーと値のペアの処理

通知コンテンツアプリの拡張が通知を受け取ったときに、メソッドdidReceive が呼び出されます。このメソッドはNotificationViewController 内にあります。ダッシュボードで提供されるキーと値のペアは、userInfo 辞書を使用してコードで表されます。

プッシュ通知からのキーと値のペアの解析

• swift
• objective-c

分析をログに記録する準備ができましたか?

Logging Analytics セクション を参照して、データの流れをよりよく理解してください。

情報取得プッシュ通知

プッシュ通知は、コンテンツアプリ拡張内のユーザ情報をキャプチャし、プッシュで可能なものの制限をプッシュできます。プッシュ通知を使用してユーザー入力を要求すると、名前や電子メールなどの基本的な情報を要求するだけでなく、ユーザーにフィードバックを送信したり、未完のユーザープロファイルを完了するように促すことができます。

次のフローでは、カスタムビューは状態の変更に応答できます。これらの状態変更コンポーネントは、各画像に表示されます。

1. ユーザーはプッシュ通知を受信します。
2. プッシュが開きます。展開後、プッシュプロンプトはユーザーに情報の入力を求めます。この例では、ユーザーの電子メールアドレスが要求されますが、どのような種類の情報でもリクエストできます。
3. 情報が提供され、予期される形式であれば、登録ボタンが表示されます。
4. 確認画面が表示され、プッシュが解除されます。

ダッシュボード設定

情報キャプチャプッシュ通知を作成するには、ダッシュボードでカスタムビューを設定する必要があります。

1. Campaignsページで、Create Campaignをクリックして新しいプッシュ通知キャンペーンを開始します。
2. Composeタブで、Notification Buttonsを切り替えます。
3. iOS Notification CategoryフィールドにカスタムiOS カテゴリを入力します。
4. Settingsタブで、標準液体を使用してキーと値のペアを作成します。メッセージに表示する適切なユーザー属性を設定します。
5. 通知コンテンツ拡張ターゲットの.plist で、UNNotificationExtensionCategory 属性をカスタムiOS カテゴリに設定します。ここで指定する値は、iOS Notification Category の下のBraze ダッシュボードで設定されている値と一致する必要があります。

例に示すように、プッシュ通知にイメージを含めることもできます。これを行うには、リッチプッシュ通知を統合し、キャンペーンの通知スタイルをリッチプッシュ通知に設定し、リッチプッシュ画像を含める必要があります。

ボタンアクションの処理

各アクションボタンは一意に識別されます。コードは、応答識別子が actionIndentifier と等しいかどうかをチェックし、等しい場合は、ユーザーがアクションボタンをクリックしたことと認識します。

プッシュ通知アクションボタンの応答の処理

• swift
• objective-c

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 つあり、以下をお勧めします。

1. completion(.dismiss) - 通知を解除します
2. completion(.doNotDismiss) - 通知は開いたままです
3. 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 があり、ユーザ属性の送信と保存に使用されます。

• custom events
• custom attributes
• user attributes
• helper files

1
2
3
if (error != nil) {
  // log error
}

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

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
      }
    }
  }
}