Usage examples
Sending statistics to an additional API key
Sending data to an additional API key allows you to collect own statistics for these API keys. You can use this to control access to information for other users. For example, to provide access to statistics for analysts you can duplicate sending marketing data for the additional API key. Thus they will only have access to the information they need.
To send data to an additional API key, you must use reporters. Just like for the main API key, you can set up an extended startup configuration for a reporter, send events, profile information, and data about in-app purchases. The reporter can work without the AppMetrica SDK initialization.
Step 1. (Optional) Initialize a reporter with an extended configuration
To initialize a reporter with the extended configuration, create a ReporterConfig class object with the settings you need and activate the reporter using the AppMetrica.activateReporter(ReporterConfig reporterConfig); method. This configuration is used for a reporter with the specified API key. You can set up your own configuration for each additional API key.
Alert
The reporter with the extended configuration should be initialized before the first call to the reporter. Otherwise, the reporter will be initialized without a configuration.
// Creating extended configuration of the reporter.
// To create it, pass a ANOTHER_API_KEY that is different from the app's API_KEY.
ReporterConfig reporterConfig = ReporterConfig("ANOTHER_API_KEY",
// Setting up the configuration. For example, to enable logging.
logs: true);
// Initializing a reporter.
AppMetrica.activateReporter(reporterConfig);
Step 2. Configure sending data using a reporter
To send data using a reporter, get an object that implements the Reporter abstract class with the AppMetrica.getReporter(String apiKey); method and use the interface methods for sending reports. If the reporter was not initialized with the extended configuration, calling this method will initialize the reporter for the specified API key.
Example of sending an event:
AppMetrica.getReporter("ANOTHER_API_KEY").reportEvent("Updates installed");
For correct tracking, manually configure the reporters to send events about the start and the pause of the session for each reporter. For this, use the resumeSession() and pauseSession() methods:
Reporter reporter = AppMetrica.getReporter("ANOTHER_API_KEY");
reporter.resumeSession();
reporter.reportEvent("Updates installed");
reporter.pauseSession();
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.