よくある質問

この記事では、ライブ・アクティビティに関するよくある質問に対する回答を紹介する。

機能性とサポート

ライブアクティビティをサポートしているプラットフォームは？

ライブアクティビティは現在、iOS 特有の機能です。ライブアクティビティの記事では、Braze Swift SDK を使用してライブアクティビティを管理するための前提条件について説明しています。

React Nativeアプリはライブ・アクティビティをサポートしているか？

はい、React Native SDK 3.0.0 以降は、Braze Swift SDK 経由でライブアクティビティをサポートしています。つまり、Braze Swift SDK の上に直接 React Native iOS のコードを記述する必要があります。

Apple が提供するライブアクティビティ機能は、JavaScript では翻訳不可能な言語 (例えば、Swift Concurrency、generics、SwiftUI) を使用しているため、ライブアクティビティ用の React Native 固有のJavaScript の便利な API は存在しません。

Brazeはキャンペーンやキャンバスのステップとしてのライブ活動をサポートしているか？

いや、これは現在サポートされていない。

プッシュ通知とライブ活動

ライブ・アクティビティがアクティブな状態でプッシュ通知が送信された場合はどうなるのか？

ライブアクティビティとプッシュ通知は、異なる画面領域を占有するため、ユーザーの画面上で競合することはありません。

ライブ・アクティビティがプッシュ・メッセージ機能を活用する場合、ライブ・アクティビティを受信するためにプッシュ通知を有効にする必要があるか？

ライブアクティビティはプッシュ通知に依存して更新を行いますが、それらは異なるユーザー設定によってコントロールされています。ユーザーはライブアクティビティにオプトインできますが、プッシュ通知はオプトアウトでき、その逆も可能です。

ライブアクティビティ更新トークンは8 時間後に期限切れになります。

ライブアクティビティにはプッシュプライマーが必要ですか？

プッシュプライマーは、ユーザーにアプリからのプッシュ通知をオプトインするよう促すベストプラクティスです。しかし、ライブアクティビティにオプトインするためのシステムプロンプトはありません。デフォルトでは、ユーザーがiOS 16.1 以降でそのアプリをインストールすると、個々のアプリのLive Activities にユーザーが選択されます。この権限は、アプリごとにデバイス設定で無効化または再有効化することができます。

技術的な話題とトラブルシューティング

ライブアクティビティにエラーがあるかどうかを知るには？

ライブアクティビティエラーは、Braze ダッシュボードのメッセージアクティビティログに記録されます。ここでは、「LiveActivity Errors」でフィルターできます。

Push-to-start 通知を送信した後、Live Activity を受信していないのはなぜですか?

まず、messages/live_activity/start エンドポイントで説明されているすべての必須フィールドがペイロードに含まれていることを確認します。activity_attributes およびcontent_state フィールドは、プロジェクトのコードで定義されているプロパティと一致する必要があります。ペイロードが正しいことが確かな場合は、APNによってレート制限される可能性があります。この制限は、Braze ではなくApple によって課されます。

プッシュ・トゥ・スタート通知がデバイスに正常に届いたが、レート制限のために表示されなかったことを確認するには、Macのコンソール・アプリを使用してプロジェクトをデバッグします。目的のデバイスの録音プロセスをアタッチし、検索バーのprocess:liveactivitiesd でログをフィルタリングします。

live_activity/update エンドポイントを使おうとすると、アクセス拒否応答が表示されます。なぜでしょう？

使用するAPIキーには、さまざまなBraze APIエンドポイントにアクセスするための適切なパーミッションを与える必要がある。以前に作成したAPIキーを使用している場合、その権限の更新を怠っている可能性がある。API キーセキュリティの概要を読んで再確認してください。

messages/send エンドポイントは、messages/live_activity/update エンドポイントとレート制限を共有しているか？

デフォルトでは、messages/live_activity/update エンドポイントのレート制限は、ワークスペースごとに、複数のエンドポイントにわたって、1時間あたり250,000リクエストです。詳細については、APIレート制限を参照してください。

なぜプッシュ・トゥ・スタートのトークンが生成されないのか？

Apple は、iOS 17.2 で導入されたpushToStartToken およびpushToStartTokenUpdates API を制限しています。実際には、「push-to-start」トークンは、初回インストール後のアプリケーション application(_:didFinishLaunchingWithOptions:) での初回アプリ起動時にのみ生成されます。この手順を繰り返す必要がある場合は、そのLive Activity の新しいインスタンスを手動で作成するか、アプリを再起動して再インストールした後にのみ、トークンを再度生成できます。

アプリのLive Activities をいくつ開始できますか?

制限はApple によって定義されており、さまざまな要因に基づいて異なる場合があります。また、将来変更される可能性があります。実際には、特定の時間にアプリごとに起動できる同時アクティビティインスタンスは5 つに制限されています。それ以降、この制限を超えて新しいインスタンスを起動しようとすると、システムは無視します。

トラブルシューティング中に他に気をつけるべきことは？

• .p12 または.pem ファイルではなく、.p8 キーを認証に使用していることを確認します。
• プッシュ・プロビジョニング・プロファイルがテストしている環境と一致していることを確認する。ユニバーサル証明書は、開発または実稼働の Apple Push Notification service (APNs) 環境のいずれかに送信するように Braze ダッシュボードで構成できます。実稼働アプリ用の開発証明書または開発アプリ用の実稼働証明書は動作しません。