com.amazonaws.mobileconnectors.pinpoint.analytics

Class AnalyticsClient

java.lang.Object

com.amazonaws.mobileconnectors.pinpoint.analytics.AnalyticsClient

All Implemented Interfaces:

com.amazonaws.mobileconnectors.pinpoint.internal.core.util.JSONSerializable

public class AnalyticsClient
extends java.lang.Object
implements com.amazonaws.mobileconnectors.pinpoint.internal.core.util.JSONSerializable

AnalyticsClient is the entry point into the Amazon Pinpoint SDK where AnalyticsEvent objects are created, recorded, and submitted to the Amazon Pinpoint Service. Recording Events Example: // get the event client from your PinpointManager instance AnalyticsClient analyticsClient = pinpointManager.getAnalyticsClient(); // create and record an event Event level1CompleteEvent = analyticsClient.createEvent("level1Complete"); analyticsClient.recordEvent(level1CompleteEvent); Submitting Events: The example below demonstrates how to submit events to the Amazon Pinpoint Service. You have direct control over when events are submitted in your app. Events are submitted in a background thread. Example: // submit events to the website AnalyticsClient analyticsClient = pinpointManager.getAnalyticsClient(); analyticsClient.submitEvents(); Amazon recommends that you call submitEvents once you stop the session. Note: This client will store at most 5MiB of event data locally. Past that events will be dropped. When events successfully submitted, they are removed from the local database.

Constructor Summary

Constructors

Constructor and Description
AnalyticsClient(com.amazonaws.mobileconnectors.pinpoint.internal.core.PinpointContext context) A client to manage creating and sending analytics events.

Method Summary

Modifier and Type	Method and Description
void	addGlobalAttribute(java.lang.String attributeName, java.lang.String attributeValue) Adds the specified attribute to all subsequently created events Note: The maximum allowed attributes and metrics on a single event is 40.
void	addGlobalAttribute(java.lang.String eventType, java.lang.String attributeName, java.lang.String attributeValue) Adds the specified attribute to all subsequently created events with the specified event type Note: The maximum allowed attributes and metrics on a single event is 40.
void	addGlobalMetric(java.lang.String metricName, java.lang.Double metricValue) Adds the specified metric to all subsequently created events Note: The maximum allowed attributes and metrics on a single event is 40.
void	addGlobalMetric(java.lang.String eventType, java.lang.String metricName, java.lang.Double metricValue) Adds the specified metric to all subsequently created events with the specified event type Note: The maximum allowed attributes and metrics on a single event is 40.
void	closeDB() Closes the database
AnalyticsEvent	createEvent(java.lang.String eventType) Create an event with the specified eventType.
java.util.List<org.json.JSONObject>	getAllEvents() Returns a list of all events
java.lang.String	getSessionId() Get the current sessionId
long	getSessionStartTime() Get the session start time
void	recordEvent(AnalyticsEvent event) Record the specified event to the local filestore Please note if the amount of data stored events takes up EXCEEDS 5MiB further recordings will be dropped
void	removeGlobalAttribute(java.lang.String attributeName) Removes the specified attribute.
void	removeGlobalAttribute(java.lang.String eventType, java.lang.String attributeName) Removes the specified attribute.
void	removeGlobalMetric(java.lang.String metricName) Removes the specified metric.
void	removeGlobalMetric(java.lang.String eventType, java.lang.String metricName) Removes the specified metric.
void	setCampaignAttributes(java.util.Map<java.lang.String,java.lang.String> campaign) Deprecated. see updateEventSourceGlobally(Map)
void	setSessionId(java.lang.String sessionId) Sets the sessionId
void	setSessionStartTime(long sessionStartTime) Set the session start time
void	submitEvents() Submit all recorded events.
org.json.JSONObject	toJSONObject()
java.lang.String	toString()
void	updateEventSourceGlobally(java.util.Map<java.lang.String,java.lang.String> attributes) Replaces the current event source attributes (if any) with a new set of event source attributes

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AnalyticsClient

public AnalyticsClient(com.amazonaws.mobileconnectors.pinpoint.internal.core.PinpointContext context)

A client to manage creating and sending analytics events.

Parameters:

context - The PinpointContext of the Pinpoint Manager

Method Detail

createEvent

public AnalyticsEvent createEvent(java.lang.String eventType)

Create an event with the specified eventType. The eventType is a developer defined String that can be used to distinguish between different scenarios within an application. Note: You can have at most 1,500 different eventTypes per app.

Parameters:

eventType - the type of event to create

Returns:

an Event with the specified eventType

recordEvent

public void recordEvent(AnalyticsEvent event)

Record the specified event to the local filestore Please note if the amount of data stored events takes up EXCEEDS 5MiB further recordings will be dropped

Parameters:

event - The event to persist

submitEvents

public void submitEvents()

Submit all recorded events. If the device is off line, this is a no-op. See PinpointConfiguration for customizing which Internet connection the SDK can submit on.

addGlobalAttribute

public void addGlobalAttribute(java.lang.String attributeName,
                               java.lang.String attributeValue)

Adds the specified attribute to all subsequently created events Note: The maximum allowed attributes and metrics on a single event is 40. Attempts to add more may be ignored

Parameters:

attributeName - the name of the attribute to add

attributeValue - the value of the attribute

addGlobalAttribute

public void addGlobalAttribute(java.lang.String eventType,
                               java.lang.String attributeName,
                               java.lang.String attributeValue)

Adds the specified attribute to all subsequently created events with the specified event type Note: The maximum allowed attributes and metrics on a single event is 40. Attempts to add more may be ignored

Parameters:

eventType - the type of events to add the attribute to

attributeName - the name of the attribute to add

attributeValue - the value of the attribute

addGlobalMetric

public void addGlobalMetric(java.lang.String metricName,
                            java.lang.Double metricValue)

Adds the specified metric to all subsequently created events Note: The maximum allowed attributes and metrics on a single event is 40. Attempts to add more may be ignored

Parameters:

metricName - the name of the metric to add

metricValue - the value of the metric

addGlobalMetric

public void addGlobalMetric(java.lang.String eventType,
                            java.lang.String metricName,
                            java.lang.Double metricValue)

Adds the specified metric to all subsequently created events with the specified event type Note: The maximum allowed attributes and metrics on a single event is 40. Attempts to add more may be ignored

Parameters:

eventType - the type of events to add the metric to

metricName - the name of the metric to add

metricValue - the value of the metric

removeGlobalAttribute

public void removeGlobalAttribute(java.lang.String attributeName)

Removes the specified attribute. All subsequently created events will no longer have this global attribute.

Parameters:

attributeName - the name of the attribute to remove

removeGlobalAttribute

public void removeGlobalAttribute(java.lang.String eventType,
                                  java.lang.String attributeName)

Removes the specified attribute. All subsequently created events with the specified event type will no longer have this global attribute.

Parameters:

eventType - the type of events to remove the attribute from

attributeName - the name of the attribute to remove

removeGlobalMetric

public void removeGlobalMetric(java.lang.String metricName)

Removes the specified metric. All subsequently created events will no longer have this global metric.

Parameters:

metricName - the name of the metric to remove

removeGlobalMetric

public void removeGlobalMetric(java.lang.String eventType,
                               java.lang.String metricName)

Removes the specified metric. All subsequently created events with the specified event type will no longer have this global metric.

Parameters:

eventType - the type of events to remove the metric from

metricName - the name of the metric to remove

setCampaignAttributes

@Deprecated
public void setCampaignAttributes(java.util.Map<java.lang.String,java.lang.String> campaign)

Deprecated. see updateEventSourceGlobally(Map)

Parameters:

campaign -

updateEventSourceGlobally

public void updateEventSourceGlobally(java.util.Map<java.lang.String,java.lang.String> attributes)

Replaces the current event source attributes (if any) with a new set of event source attributes

Parameters:

attributes - map of attribute values

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toJSONObject

public org.json.JSONObject toJSONObject()

Specified by:

toJSONObject in interface com.amazonaws.mobileconnectors.pinpoint.internal.core.util.JSONSerializable

closeDB

public void closeDB()

Closes the database

getAllEvents

public java.util.List<org.json.JSONObject> getAllEvents()

Returns a list of all events

Returns:

List of events

getSessionId

public java.lang.String getSessionId()

Get the current sessionId

Returns:

the sessionId

setSessionId

public void setSessionId(java.lang.String sessionId)

Sets the sessionId

Parameters:

sessionId - The sessionId

getSessionStartTime

public long getSessionStartTime()

Get the session start time

Returns:

The Session Start Time

setSessionStartTime

public void setSessionStartTime(long sessionStartTime)

Set the session start time

Parameters:

sessionStartTime - The sessionStartTime