モバイルアプリケーションのイベント

Amazon SNS は、特定のアプリケーションイベントが発生したときに通知をトリガーするサポートを提供します。その場合、そのイベントでプログラムによるいくつかのアクションを実行することができます。アプリケーションには、Apple Push Notification Service (APNs）、Firebase Cloud Messaging ()、Windows Push Notification Services (FCM) などのプッシュ通知サービスのサポートが含まれている必要がありますWNS。Amazon SNSコンソール AWS CLI、または を使用してアプリケーションイベント通知を設定します AWS SDKs。

使用可能なアプリケーションイベント

アプリケーションイベント通知は、個々のプラットフォームエンドポイントがいつ作成、削除、更新、配信エラーとなったかを追跡します。アプリケーションイベントの属性名は次のとおりです。

属性名	通知トリガー
EventEndpointCreated	新しいエンドポイントがアプリケーションに追加されます。
EventEndpointDeleted	アプリケーションに関連付けられたすべてのプラットフォームエンドポイントが削除されます。
EventEndpointUpdated	アプリケーションに関連付けられたプラットフォームエンドポイントのすべての属性が変更されます。
EventDeliveryFailure	アプリケーションに関連付けられた任意のプラットフォームエンドポイントへの配信は、永続的にエラーとなります。 注記 プラットフォームアプリケーション側で配信エラーを追跡するには、アプリケーションのメッセージ配信ステータスイベントにサブスクライブします。詳細については、「Amazon SNS Application Attributes for Message Delivery Status の使用」を参照してください。

アプリケーションには任意の属性を関連付けることができ、これでそのイベント通知を受け取れるようになります。

モバイルプッシュ通知を送信する

アプリケーションイベント通知を送信するには、各タイプのイベントの通知を受信できるよう、トピックを指定します。Amazon が通知SNSを送信すると、トピックはプログラムによるアクションを実行するエンドポイントにそれらをルーティングできます。

重要

大容量アプリケーションは多数のアプリケーションイベント通知 (例えば、数万回) を作成するので、E メールアドレス、電話番号、モバイルアプリケーションなど、人間が使用するためのエンドポイントに負荷をかけます。アプリケーションイベント通知をトピックに送信する場合は、以下のガイドラインを検討してください。

• 通知を受信する各トピックには、 HTTP エンドポイント、Amazon SQSキューHTTPS、 AWS Lambda 関数などのプログラムエンドポイントのサブスクリプションのみを含める必要があります。

• 通知によってトリガーされる処理量を減らすために、各トピックのサブスクリプションを少数 (例えば、5 以下) に制限します。

Amazon SNSコンソール、 AWS Command Line Interface （AWS CLI）、または を使用して、アプリケーションイベント通知を送信できます AWS SDKs。

AWS Management Console

1. Amazon SNSコンソール にサインインします。

2. ナビゲーションパネルで [モバイル]、[プッシュ通知] を選択します。

3. モバイルプッシュ通知ページのプラットフォームアプリケーションセクションで、アプリケーションを選択し、編集 を選択します。

4. [イベント通知] セクションを展開します。

5. [アクション]、[イベントの設定] を選択します。

6. 次のイベントに使用するトピックARNsの を入力します。

   • 作成されたエンドポイント

   • 削除されたエンドポイント

   • 更新されたエンドポイント

   • 配信失敗

7. [Save changes] (変更の保存) をクリックします。

AWS CLI

set-platform-application-attributes コマンドを実行します。

次の例では、4 つのアプリケーションイベントすべてに同じ Amazon SNSトピックを設定します。

aws sns set-platform-application-attributes
--platform-application-arn arn:aws:sns:us-east-1:12345EXAMPLE:app/FCM/MyFCMPlatformApplication
--attributes EventEndpointCreated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventEndpointDeleted="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventEndpointUpdated="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents",
EventDeliveryFailure="arn:aws:sns:us-east-1:12345EXAMPLE:MyFCMPlatformApplicationEvents"

AWS SDKs

SNS API を使用して Amazon にSetPlatformApplicationAttributesリクエストを送信して、アプリケーションイベント通知を設定します AWS SDK。

デベロッパーガイドとコード例の完全なリスト AWS SDKについては、「」を参照してくださいSNS での Amazon の使用 AWS SDK。