Target Apps

Overview

SDK Keys support two attributes that restrict their access to certain configs: Environments and Target Apps. A Target App is a user-defined abstraction tied to entities in your Statsig project and can be linked to one or more SDK Keys. Target Apps represent things like your “Android” or “iOS” apps, or more specific services like “Search” and “Feed” that may span both client and server usage.

Defining and using Target Apps is a best practice at large scale. The two main benefits are:

• Performance: removing unused entities from the SDK payload speeds up initialization time and reduces the data stored in local caches or data stores.
• Security: you may not want to expose certain gates, experiments, or configs to client-side code or to a client key that is easily discoverable in your app. Specifying a target app for your client key and linking only client-specific configs to it keeps those configs from being visible.

Before using Target Apps, consider whether separate Statsig projects might be a better fit:

• If you need to share gates, experiments, or metrics across apps or services, use a Target App. Entities are restricted within a single Statsig project.
• If your services or apps always have distinct gates, experiments, and metrics, a separate Statsig project may be a better solution.

For existing Statsig projects with multiple SDK integrations, Statsig suggests entities to tag based on historical checks from each SDK, to help you set up Target Apps.

Configuring target apps

Project setup

Create a target app, or use one that Statsig suggests based on your current SDK exposure logs.

Associating a feature gate with a target app

To verify suggestions from initial setup or add more entities to a target app, navigate to the entity directly.

Navigate to the Feature Gates tab and select a specific gate. In the right rail for that gate, view and edit the target apps applied to it.

Repeat this flow for the Dynamic Configs and Experiments that are used by this Target App.

Associating an SDK key with a target app

Select the SDK Key you want to restrict to a Target App.

Under Actions, open the dropdown menu.

Then select the target app(s) to apply to that key.

Debugging

To debug SDK evaluations that may be affected by your Target App configuration, use the Diagnostics tab for any entity.

In the Exposure Stream at the bottom, each check shows the Target App associated with the SDK key used. If any exposure doesn't have a matching Target App, Statsig flags it with a warning.