Package io.appmetrica.analytics

Interface IReporter

public interface IReporter

IReporter can send events to an alternative api key, differ from api key, passed to AppMetrica.activate(android.content.Context, AppMetricaConfig)

Instance of object, implements IReporter, can be obtained via AppMetrica.getReporter(android.content.Context, String) method call.

For every api key only one IReporter instance is created. You can either query it each time you need it, or save the reference by yourself.

See Also:

  • Method Details

    • sendEventsBuffer

      void sendEventsBuffer()
      Initiates forced sending of all stored events from the buffer.

      AppMetrica SDK doesn't send events immediately after they occurred. It stores events data in the buffer. This method forcibly initiates sending all the data from the buffer and flushes it.

      Use the method after important checkpoints of user scenarios.

      WARNING: Frequent use of the method can lead to increasing outgoing internet traffic and energy consumption.

      See Also:

    • reportEvent

      void reportEvent(@NonNull String eventName)
      Sends report by event name.
      Parameters:
      eventName - Event name. In the eventName parameter, pass a short name or description of the event.
      Throws:
      IllegalArgumentException - If eventName is null.
      See Also:

    • reportEvent

      void reportEvent(@NonNull String eventName, @Nullable String jsonValue)
      Sends report by event name and event value.
      Parameters:
      eventName - Event name. In the eventName parameter, pass a short name or description of the event.
      jsonValue - Event value. In the eventValue parameter, pass a JSONObject represented as a String object or pass a String object represented in the Java JSON format. Maximum level of nesting (for JSON object) - 5.

      EXAMPLE:

                        
                   {
                       "firstName": "John",
                       "lastName": "Smith",
                       "age": 25,
                       "nickname": "JS"
                       "address": {
                           "streetAddress": "21 2nd Street",
                           "city": "New York",
                           "state": "NY",
                       },
                       "phoneNumbers": [
                           {
                               "type": "HOME",
                               "number": "212 555-1234"
                           },
                           {
                               "type": "FAX",
                               "number": "646 555-4567"
                           }
                       ]
                    }
      Throws:
      IllegalArgumentException - If eventName or jsonValue is null.
      See Also:

    • reportEvent

      void reportEvent(@NonNull String eventName, @Nullable Map<String,Object> attributes)
      Sends report by dictionary.
      Parameters:
      eventName - Event name. In the eventName parameter, pass a short name or description of the event.
      attributes - Event value. In the attributes parameter, pass a Map whose keys are of type String and whose values are of supported types: Boolean, String, and the wrappers for the primitive number types Double, Integer, ...
      Throws:
      IllegalArgumentException - If eventName or attributes is null.
      See Also:

    • reportError

      void reportError(@NonNull String message, @Nullable Throwable error)
      Sends an error. Use this method to report un unexpected situation. If you use this method errors will be grouped by error stacktrace. If you want to influence the way errors are grouped use reportError(String, String, Throwable) or reportError(String, String)
      Parameters:
      message - Short description or name of the error.
      error - Throwable object for the error. Can be null.
      Throws:
      IllegalArgumentException - If message is null.
      See Also:

    • reportError

      void reportError(@NonNull String identifier, @Nullable String message)
      Sends an error. Use this method to report un unexpected situation. This method should be used if you want to customize error grouping. If not use reportError(String, Throwable)
      Parameters:
      identifier - An identifier used for grouping errors. Errors that have the same identifiers will belong in one group. Do not use dynamically formed strings or exception messages as identifiers to avoid having too many small crash groups. Cannot be null.
      message - Short description or name of the error. Can be null.
      Throws:
      IllegalArgumentException - If identifier is null.

    • reportError

      void reportError(@NonNull String identifier, @Nullable String message, @Nullable Throwable error)
      Sends an error. Use this method to report un unexpected situation. This method should be used if you want to customize error grouping. If not use reportError(String, Throwable) error stacktrace will NOT be used for grouping, only identifier.
      Parameters:
      identifier - An identifier used for grouping errors. Errors that have the same identifiers will belong in one group. Do not use dynamically formed strings or exception messages as identifiers to avoid having too many small crash groups. Cannot be null.
      message - Short description or name of the error. Can be null.
      error - Throwable object for the error. Its stacktrace will not be considered for error grouping. Can be null.
      Throws:
      IllegalArgumentException - If identifier is null.

    • reportUnhandledException

      void reportUnhandledException(@NonNull Throwable exception)
      Sends unhandled exception by Throwable object.
      Parameters:
      exception - Throwable object for the unhandled exception.
      Throws:
      IllegalArgumentException - If exception is null.
      See Also:

    • resumeSession

      void resumeSession()

      Helper method for sessions tracking.

      Usually, it should be called into Activity.onResume().
      See Also:

    • pauseSession

      void pauseSession()

      Helper method for sessions tracking.

      Usually, it should be called into Activity.onPause().
      See Also:

    • setUserProfileID

      void setUserProfileID(@Nullable String profileID)
      Sets the ID of the user profile. NOTE: The string value can contain up to 200 characters.
      Parameters:
      profileID - The custom user profile ID.

    • reportUserProfile

      void reportUserProfile(@NonNull UserProfile profile)
      Sends information about the user profile.
      Parameters:
      profile - The UserProfile object. Contains user profile information.

    • reportRevenue

      void reportRevenue(@NonNull Revenue revenue)
      Sends information about the purchase.
      Parameters:
      revenue - The Revenue object. It contains purchase information.

    • reportECommerce

      void reportECommerce(@NonNull ECommerceEvent event)
      Sends e-commerce event.
      Parameters:
      event - The ECommerceEvent object to be sent.
      See Also:

    • setDataSendingEnabled

      void setDataSendingEnabled(boolean enabled)
      Enables/disables data sending to the AppMetrica server. By default, the sending is enabled.

      NOTE: Disabling this option doesn't affect data sending from the main apiKey and other reporters.

      Parameters:
      enabled - true to allow AppMetrica sending data, otherwise false.

    • getPluginExtension

      @NonNull IPluginReporter getPluginExtension()

      Creates an IPluginReporter that can send plugin events to this reporter.

      For every reporter only one IPluginReporter instance is created. You can either query it each time you need it, or save the reference by yourself.
      Returns:
      plugin extension instance for this reporter

    • reportAdRevenue

      void reportAdRevenue(@NonNull AdRevenue adRevenue)
      Sends information about ad revenue.
      Parameters:
      adRevenue - Object containing the information about ad revenue.
      See Also:

    • putAppEnvironmentValue

      void putAppEnvironmentValue(@NonNull String key, @Nullable String value)
      Sets key - value pair to be used as additional information, associated with your application runtime's environment. This environment is unique for every unique APIKey and shared between processes. Application's environment persists to storage and retained between application launches. To reset environment use AppMetrica.clearAppEnvironment()

      If called before metrica initialization, environment will be added right after metrica initialize

      WARNING: Application's environment is a global permanent state and can't be changed too often. For frequently changed parameters use extended reportMessage methods.

      Parameters:
      key - the environment key.
      value - the environment value. To remove pair from environment pass null value.
      See Also:

    • clearAppEnvironment

      void clearAppEnvironment()
      Clears app environment and removes it from storage.

      If called before metrica initialization, app environment will be cleared right after init

    • reportAnr

      void reportAnr(@NonNull Map<Thread,StackTraceElement[]> allThreads)
      Sends an ANR event (the application is not responding) manually.
      Parameters:
      allThreads - A snapshot of all streams with stack traces. Can be received by calling Thread.getAllStackTraces().