Name:
interface
Value:
Amplify has re-imagined the way frontend developers build fullstack applications. Develop and deploy without the hassle.
Gen1 DocsLegacy

Page updated Mar 26, 2026

イベントを記録する

AWS will end support for Amazon Pinpoint on October 30, 2026,, and is no longer accepting any new users as of May 20 (see the linked doc). The guidance is to use AWS End User Messaging for push notifications and SMS, Amazon Simple Email Service for sending emails, Amazon Connect for campaigns, journeys, endpoints, and engagement analytics. Pinpoint recommends Amazon Kinesis for event collection and mobile analytics.

イベントを記録する

Amplify Analyticsプラグインは、アプリ内でカスタムイベントを記録するための簡単なインターフェースを提供します:

let properties: AnalyticsProperties = [
"eventPropertyStringKey": "eventPropertyStringValue",
"eventPropertyIntKey": 123,
"eventPropertyDoubleKey": 12.34,
"eventPropertyBoolKey": true
]
let event = BasicAnalyticsEvent(
name: "eventName",
properties: properties
)
Amplify.Analytics.record(event: event)

Amazon Pinpointのイベント数は、イベントを記録してから数分以内に更新されます。

ただし、フィルターセクションにイベントが表示されたり、カスタム属性がPinpointに表示されたりするには、最大30分かかる場合があります。

イベントをフラッシュする

デフォルトでは、イベントは60秒ごとに自動的にネットワークにフラッシュされます。

プラグインを初期化するときにoptionsパラメータを通じてこれを変更できます。AWSPinpointAnalyticsPlugin.Optionsインスタンスを作成し、そのautoFlushEventsIntervalプロパティを、目的の値(秒単位)に設定します:

let options = AWSPinpointAnalyticsPlugin.Options(
autoFlushEventsInterval: 60
)
try Amplify.add(plugin: AWSPinpointAnalyticsPlugin(options: options))

注意

autoFlushEventsIntervalを0に設定すると、イベントの自動フラッシュは無効化され、イベントの送信はあなたが責任を持つことになります。

記録されたイベントをバックエンドに手動で送信するには、以下を呼び出します:

Amplify.Analytics.flushEvents()

プラグインはリクエストを自動的にバッチ処理してネットワーク帯域幅を削減し、デバイスが接続を失った場合の再試行ロジックを処理します。

認証イベント

ユーザーがアプリケーションで認証を行う頻度を示します。

アナリティクスページで、ユーザータブにサインイン、サインアップ、および認証失敗のグラフが表示されます。

ユーザーがアプリで認証を行う頻度を学習するには、アプリケーションコードを更新して、Pinpointが以下の標準イベントタイプを受け取るようにします:

  • _userauth.sign_in
  • _userauth.sign_up
  • _userauth.auth_fail

これらのイベントは、以下の方法で報告できます:

let event = BasicAnalyticsEvent(
name: "_userauth.sign_in" // または受け入れられている値のいずれか
)
Amplify.Analytics.record(event: event)

グローバルプロパティ

すべてのAmplify.Analytics.record(event:)呼び出しに含まれるプロパティを登録できます。

let globalProperties: AnalyticsProperties = [
"globalPropertyKey": "value"
]
Amplify.Analytics.registerGlobalProperties(globalProperties)

グローバルプロパティの登録を解除するには、Amplify.Analytics.unregisterGlobalProperties()を呼び出します:

// 引数がない場合、すべてのグローバルプロパティの登録が解除されます
Amplify.Analytics.unregisterGlobalProperties()
// または、登録を解除するプロパティを指定できます
let globalProperties = ["globalPropertyKey1", "globalPropertyKey2"]
Amplify.Analytics.unregisterGlobalProperties(globalProperties)