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 you can link it 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's 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. Statsig restricts entities to a single 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 this Target App uses.

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 your Target App configuration might affect, 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.