イベントを記録する
イベントを記録する
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)イベントをフラッシュする
デフォルトでは、イベントは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)