@aws-amplify/analytics

Configures automatic event tracking for Pinpoint. This API will automatically transmit an analytic event 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).

Only session tracking is currently supported on React Native.

Parameter params

The input object to configure auto track behavior.

Throws

service: UpdateEndpointException - Thrown when the underlying Pinpoint service returns an error.

Throws

validation: AnalyticsValidationErrorCode - Thrown when the provided parameters or library configuration is incorrect.

Disables the Analytics category.

When Analytics is disabled events will not be buffered or transmitted to your selected service. Any auto-tracking behavior that you have configured via configureAutoTrack will not have any effect while Analytics is disabled.

Enables the Analytics category to permit the transmission of events.

Analytics is enabled by default. You do not need to call this API unless you have disabled Analytics.

Flushes all buffered Pinpoint events to the service.

This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking this API may not be included in the flush.

Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user profile and activities or actions in your application. Activity can be tracked across devices & platforms by using the same userId.

Parameter params

The input object used to construct requests sent to Pinpoint's UpdateEndpoint API.

Returns

A promise that will resolve when the operation is complete.

Throws

service: UpdateEndpointException - Thrown when the underlying Pinpoint service returns an error.

Throws

validation: AnalyticsValidationErrorCode - Thrown when the provided parameters or library configuration is incorrect.

Example 1

// Identify a user with Pinpoint
await identifyUser({
    userId,
    userProfile: {
        email: 'userEmail@example.com'
        customProperties: {
            phoneNumber: ['555-555-5555'],
        },
    }
});

Example 2

```ts // Identify a user with Pinpoint with some additional demographics await identifyUser({ userId, userProfile: { email: 'userEmail@example.com' customProperties: { phoneNumber: ['555-555-5555'], }, demographic: { platform: 'ios', timezone: 'America/Los_Angeles' } } });

Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.

Parameter params

The input object used to construct the request.

Throws

validation: AnalyticsValidationErrorCode - Thrown when the provided parameters or library configuration is incorrect.

Example 1

// Send an event to Pinpoint
record({ name: eventName })

Example 2

// Send an event to Pinpoint with metrics & custom attributes
record({
    name: eventName,
    attributes: {
        'my-attribute': attributeValue
    },
    metrics: {
        'my-metric': metricValue
    }
})

Input type for Pinpoint configureAutoTrack API.

Input type for Pinpoint identifyUser API.

Input type for Pinpoint record API.