Subscription Product ID

What is Subscription Product ID

Subscription Product ID is a Native element that represents a priced product identifier used to offer subscriptions in the application.

A subscription grants users access to features or content for a specific period of time and may automatically renew based on the app store configuration.

You can see an example of a created Subscription Product ID in the demo application here.

Key characteristics

• Subscription Product ID represents a paid product.
• A price is required.
• Used for subscription-based products with recurring access.
• Does not need to be created manually in the system only — it must correspond to a product configured in app stores.
• Subscription Product ID must be linked to a Subscription Product ID Context.
• The default context (Customs) is optional and may be left empty.
• In some cases (by agreement with development or SDK logic), values such as trial / non-trial may be required in the default context.

Supported campaigns

Subscription Product ID can be used only in the following campaign types:

• Subscription
• Subscription LTO
• Mixed
• Mixed LTO
• A/B test campaigns for the listed types

Usage example

This product can be used to offer a monthly premium subscription with recurring access to paid features.

How to create a Subscription Product ID

How to find it:

Configuration > Remote Config > Native elements

Creation steps

1. Click Create new.
2. Fill in the product creation form:

Application

Select the application the Subscription Product ID belongs to.

Name

A unique product identifier. Used in analytics and reports as a Product ID filter.

It is recommended to follow the same naming style as other Product IDs (for example, Consumable Product ID).

Human-readable name

An internal name used only inside the system for convenience. Not included in analytics.

Recommended to use the same value as Name or provide a clearer internal description if needed.

Native element type

Select Subscription Product ID.

Cost

The Cost field is required for Subscription Product ID.

• Defines the subscription price in USD.
• Must match the price configured in the app stores.
• Used for:
  • displaying the price in campaigns;
  • subscription validation;
  • revenue analytics.

If the Cost field is not set, the product cannot be saved.

Customs

The Customs field defines the default context for the Subscription Product ID.

• The field is required, but it may be saved empty by enabling the Confirm empty option.
• Used when:
  • a subscription is activated using a promo code;
  • a subscription is activated directly inside the application;
  • the subscription flow cannot be resolved via a campaign context.
• The value must be provided as a JSON object.
• The JSON structure must match the Subscription Product ID Context.

If the final JSON structure is not yet known, you may enable Confirm empty and save the product with an empty Customs value.

Subscription Product ID Context

Each Subscription Product ID must be associated with a Subscription Product ID Context.

Subscription Product ID Context is not selected on the product creation page. Contexts are configured separately and are used in campaigns together with the Subscription Product ID.

The context is used in subscription campaign logic and defines subscription-related behavior and parameters.

A default context may be left empty, unless required by application or SDK logic.

More details will be available in the Product ID Context article (coming soon).

Optional fields

Default image

Optional. Used for reference or documentation purposes only and does not affect campaign behavior.

Status

• Default value — Active.
• If the product is no longer needed, it can be set to Archived.
• Once archived, it cannot be used in campaigns or restored. To use it again, create a new Subscription Product ID with a unique name.

Final step

Click Save to create the Subscription Product ID.

Once created, the Subscription Product ID can be used in Subscription, Subscription LTO, Mixed, and Mixed LTO campaigns, including their A/B test variants, and will be available in analytics as a Product ID filter.