/// <summary>
/// Record an application exception, along with a message.
/// </summary>
/// <param name="message">The message to record along with the exception.</param>
/// <param name="exception">The exception to record.</param>
public static void LogError(string message, System.Exception exception)
{
#if __IOS__
NativeFlurry.LogError(
string.Format(exception.GetType().FullName, message),
exception.ToString(),
new NSException(exception.GetType().FullName, exception.Message, null));
#elif __ANDROID__
Java.Lang.Exception javaEx = new Java.Lang.Exception(exception.Message);
StackTrace stackTrace = new StackTrace(exception, true);
StackTraceElement[] trace = new StackTraceElement[stackTrace.FrameCount];
for (int index = 0; index < stackTrace.FrameCount; ++index)
{
StackFrame frame = stackTrace.GetFrame(index);
trace[index] = new StackTraceElement(frame.GetMethod().DeclaringType.Name, frame.GetMethod().Name, frame.GetFileName(), frame.GetFileLineNumber());
}
javaEx.SetStackTrace(trace);
NativeFlurry.OnError(
string.Format(exception.GetType().FullName, message),
exception.ToString(),
javaEx);
#elif WINDOWS_PHONE
NativeFlurry.LogError(message, exception);
#endif
}
/// <summary>
/// Explicitly track a page view during a session.
/// </summary>
public static void LogPageView()
{
#if WINDOWS_PHONE || __IOS__
NativeFlurry.LogPageView();
#elif __ANDROID__
NativeFlurry.OnPageView();
#endif
}
/// <summary>
/// Specifies the timeout for expiring a Flurry session.
/// The default value is 10 seconds.
/// </summary>
/// <param name="seconds">The timeout in seconds.</param>
public static void SetSessionContinueTimeout(int seconds)
{
#if WINDOWS_PHONE
NativeFlurry.SetSessionContinueSeconds(seconds);
#elif __ANDROID__
NativeFlurry.SetContinueSessionMillis(seconds * 1000);
#elif __IOS__
NativeFlurry.SetSessionContinueSeconds(seconds);
#endif
}
// Methods
/// <summary>
/// Explicitly specifies the App Version that Flurry Analytics will use to group collected analytics data.
/// </summary>
/// <param name="version">The app version to use for the app.</param>
public static void SetAppVersion(string version)
{
#if WINDOWS_PHONE
NativeFlurry.SetVersion(version);
#elif __ANDROID__
NativeFlurry.SetVersionName(version);
#elif __IOS__
NativeFlurry.SetAppVersion(version);
#endif
}
/// <summary>
/// Specifies the location of the session
/// </summary>
/// <param name="latitude">The latitude coordinate.</param>
/// <param name="longitude">The longitude coordinate.</param>
/// <param name="accuracy">The location accuracy.</param>
public static void SetLocation(float latitude, float longitude, float accuracy)
{
#if WINDOWS_PHONE
NativeFlurry.SetLocation(latitude, longitude, accuracy);
#elif __ANDROID__
NativeFlurry.SetLocation(latitude, longitude);
#elif __IOS__
NativeFlurry.SetLocation(latitude, longitude, accuracy, accuracy);
#endif
}
/// <summary>
/// Ends a timed event specified by the event name or ID, along with parameters.
/// </summary>
/// <param name="eventId">The event name or ID.</param>
/// <param name="parameters">The parameters to update the event with.</param>
public static void EndTimedEvent(string eventId, IDictionary <string, string> parameters)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeParameterCollection p = GetParameters(parameters);
if (p == null)
{
EndTimedEvent(eventId);
}
else
{
NativeFlurry.EndTimedEvent(eventId, p);
}
#endif
}
/// <summary>
/// Ends a timed event specified by the event name or ID.
/// </summary>
/// <param name="eventId">The event name or ID.</param>
public static void EndTimedEvent(string eventId)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeFlurry.EndTimedEvent(eventId);
#endif
}
/// <summary>
/// Record a custom timed event specified by the event name or ID.
/// </summary>
/// <param name="eventId">The event name or ID.</param>
/// <param name="timed">True if the event is a timed event, or False otherwise.</param>
public static void LogEvent(string eventId, bool timed)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeFlurry.LogEvent(eventId, timed);
#endif
}
/// <summary>
/// Specifes the gender of the user.
/// </summary>
/// <param name="gender">The user's gender.</param>
public static void SetGender(Gender gender)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeFlurry.SetGender((NativeGender)gender);
#endif
}
/// <summary>
/// Specifies the age of the user.
/// </summary>
/// <param name="age">The user's age.</param>
public static void SetAge(int age)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeFlurry.SetAge(age);
#endif
}
/// <summary>
/// This method serves as the entry point to Flurry Analytics collection.
/// The session will continue for the period the app is in the foreground until your app is backgrounded for the
/// time specified in <see cref="SetSessionContinueTimeout"/>. If the app is resumed in that period the session
/// will continue, otherwise a new session will begin.
/// </summary>
/// <remarks>
/// This method requires that the <see cref="ApiKey"/> property has been set prior to calling this method. If
/// not, an ArgumentException will be thrown.
/// </remarks>
/// <exception cref="ArgumentException">
/// This method requires that the <see cref="ApiKey"/> property has been set prior to calling this method. If
/// not, an ArgumentException will be thrown.
/// </exception>
public static void StartSession()
{
NativeFlurry.StartSession(ApiKey);
}
/// <summary>
/// Assigns the unique ID for a user in the app.
/// </summary>
/// <param name="userid">The unique user ID.</param>
/// <remarks>
/// Private or confidential information about the user should not be used.
/// </remarks>
public static void SetUserId(string userid)
{
#if WINDOWS_PHONE || __ANDROID__ || __IOS__
NativeFlurry.SetUserId(userid);
#endif
}
/// <summary>
/// End a Flurry Analytics session.
/// </summary>
/// <param name="context">
/// A reference to a <see cref="Android.Content.Context"/> object such as an <see cref="Android.App.Activity"/>
/// or an <see cref="Android.App.Activity"/>.
/// </param>
public static void EndSession(Context context)
{
NativeFlurry.OnEndSession(context);
}
/// <summary>
/// This method serves as the entry point to Flurry Analytics collection.
/// The session will continue for the period the app is in the foreground until your app is backgrounded for the
/// time specified in <see cref="SetSessionContinueTimeout"/>. If the app is resumed in that period the session
/// will continue, otherwise a new session will begin.
/// </summary>
/// <param name="context">
/// A reference to a <see cref="Android.Content.Context"/> object such as an <see cref="Android.App.Activity"/>
/// or an <see cref="Android.App.Activity"/>.
/// </param>
/// <remarks>
/// This method requires that the <see cref="ApiKey"/> property has been set prior to calling this method. If
/// not, an ArgumentException will be thrown.
/// </remarks>
/// <remarks>
/// The session implementation for the Android SDK is implemented as a stack. It is important to match any call
/// to <see cref="StartSession"/> in the Android <see cref="Android.App.Activity.OnStart"/> method with a call
/// to <see cref="EndSession"/> in the Android <see cref="Android.App.Activity.OnStop"/> method.
/// </remarks>
/// <exception cref="ArgumentException">
/// This method requires that the <see cref="ApiKey"/> property has been set prior to calling this method. If
/// not, an ArgumentException will be thrown.
/// </exception>
public static void StartSession(Context context)
{
NativeFlurry.OnStartSession(context);
}
/// <summary>
/// This method initializes Flurry Analytics.
/// On Android 4.0 and above, this will automatically register to track sessions.
/// </summary>
/// <param name="context">
/// A reference to a <see cref="Android.Content.Context"/> object such as an <see cref="Android.App.Activity"/>
/// or an <see cref="Android.App.Activity"/>.
/// </param>
public static void Init(Context context)
{
NativeFlurry.Init(context, ApiKey);
}
/// <summary>
/// This method initializes Flurry Analytics.
/// On Android 4.0 and above, this will automatically register to track sessions.
/// </summary>
/// <param name="context">
/// A reference to a <see cref="Android.Content.Context"/> object such as an <see cref="Android.App.Activity"/>
/// or an <see cref="Android.App.Activity"/>.
/// </param>
/// <param name="apiKey">
/// The Flurry Analytics application API key to use. This parameter will update the <see cref="ApiKey"/>
/// property.
/// </param>
public static void Init(Context context, string apiKey)
{
ApiKey = apiKey;
NativeFlurry.Init(context, ApiKey);
}
// Platform specific methods
#if WINDOWS_PHONE
/// <summary>
/// This method serves as the entry point to Flurry Analytics collection.
/// The session will continue for the period the app is in the foreground until your app is backgrounded for the
/// time specified in <see cref="SetSessionContinueTimeout"/>. If the app is resumed in that period the session
/// will continue, otherwise a new session will begin.
/// </summary>
/// <param name="apiKey">
/// The Flurry Analytics application API key to use. This parameter will update the <see cref="ApiKey"/>
/// property.
/// </param>
public static void StartSession(string apiKey)
{
ApiKey = apiKey;
NativeFlurry.StartSession(ApiKey);
}
/// <summary>
/// End a Flurry Analytics session.
/// </summary>
public static void EndSession()
{
NativeFlurry.EndSession();
}
