@aws-amplify/analytics
Version:
Analytics category of aws-amplify
55 lines (54 loc) • 1.76 kB
TypeScript
import { KinesisFirehoseConfigureAutoTrackInput } from '../types';
/**
* Configures automatic event tracking for Kinesis Data Firehose. This API will automatically transmit an analytic
* event to the configured Firehose delivery stream when configured events are detected within your application.
* This can include: DOM element events (via the `event` tracker), session events (via the `session` tracker), and
* page view events (via the `pageView` tracker).
*
* Auto-tracked events are recorded with a data payload of the shape `{ name: eventName, attributes }`.
*
* @remark Only session tracking is currently supported on React Native.
*
* @param {KinesisFirehoseConfigureAutoTrackInput} input The input object to configure auto track behavior.
*
* @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
* configuration is incorrect, or when `streamName` is missing while enabling a tracker.
*
* @example
* ```ts
* // Enable session tracking
* configureAutoTrack({
* enable: true,
* type: 'session',
* options: {
* streamName: 'myFirehoseStream',
* },
* });
* ```
*
* @example
* ```ts
* // Enable page view tracking for a single-page application
* configureAutoTrack({
* enable: true,
* type: 'pageView',
* options: {
* streamName: 'myFirehoseStream',
* appType: 'singlePage',
* },
* });
* ```
*
* @example
* ```ts
* // Enable DOM element event tracking
* configureAutoTrack({
* enable: true,
* type: 'event',
* options: {
* streamName: 'myFirehoseStream',
* },
* });
* ```
*/
export declare const configureAutoTrack: (input: KinesisFirehoseConfigureAutoTrackInput) => void;