Crash Reporter Module

Requirements

• Tealium for Android (5.0.0+)

Install

Install the Crash Reporter module with Maven or manually.

Maven

To install the Crash Reporter module with Maven:

1. In your project’s top-level build.gradle file, add the following Maven repository:

   // Top-level build file where you add configuration options common to all sub-projects/modules.
   allprojects {
     repositories {
       jcenter()
       // Tealium Maven repo directive
       maven {
           url "https://maven.tealiumiq.com/android/releases/"
       }
     }
   }

2. In your project module’s build.gradle file, add the following Maven dependency:

   dependencies {
     // only add if not already present
     implementation 'com.tealium:library:5.6.1'
     // add crash reporter to list of dependencies
     implementation 'com.tealium:crashreporter:1.0.1'
   }

Manual

To install the Crash Reporter module manually:

1. Download the Tealium Crash Reporter module.

2. Copy the file tealium.crashreporter-1.0.1.aar into your project’s <PROJECT_ROOT>/<MODULE>/libs directory.

3. Add the Tealium library dependency to your project module’s build.gradle file:

   dependencies {
     implementation (name:'tealium.crashreporter-1.0.1', ext:'aar')
   }

Initialize

Initialize the Crash Reporter module, as shown in the following example::

Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");

//Enable Crash Reporter
CrashReporter.initialize(BuildConfig.TEALIUM_MAIN, config, true);

//Standard Tealium instance
Tealium.createInstance("INSTANCE_NAME", config);

Tracked Events

Once initialized, the Crash Reporter module automatically captures crash data. If a thread abruptly terminates, .uncaughtExceptionHandler() is invoked and a tracking call is triggered with the corresponding crash data.

Crash events are tracked as tealium_event="crash".

Crash Reporter is a singleton instance call. Chaining handlers is not currently supported.

Data Layer

The Crash Reporter module sends the following crash attributes in the event:

Integrations

• New Relic Mobile Crash Tracking Connector

API Reference

For the complete reference of methods for the Crash Reporter module, see the CrashReporter class in the Tealium SDK for Android API.