Solar Engine

Integrate Purchases SDK with Solar Engine for precise revenue tracking

Ask AI

Copied as markdown!

With our Solar Engine integration you can:

• Attribute subscription revenue and lifecycle events to the campaigns that drove them.
• Stream trial conversions, renewals, cancellations, and more directly from RevenueCat without relying on an app in the foreground.
• Continue measuring long-tail revenue from each campaign as subscriptions renew over time.

Integration at a Glance

Includes Revenue	Supports Negative Revenue	Sends Sandbox Events	Includes Customer Attributes	Sends Transfer Events	Optional Event Types
✅	✅	✅	Standard Reserved Attributes	❌	non_subscription_purchase_event uncancellation_event subscription_paused_event expiration_event billing_issue_event product_change_event

1. Install the Solar Engine SDK

Set up the latest Solar Engine SDK in every platform where you collect purchases before enabling the integration. Refer to the Solar Engine developer documentation for the most up-to-date installation instructions.

2. Send device data to RevenueCat

Solar Engine matches RevenueCat events to campaign cohorts using device and advertising identifiers. Make sure your app collects and sends the following Customer Attributes to RevenueCat before the first purchase occurs:

Key	Description	Recommended Platforms
$idfa	iOS advertising identifier UUID	iOS
$idfv	iOS vendor identifier UUID	iOS
$gpsAdId	Google advertising identifier	Android
$ip	Device IP address, gathered server-side when enabled	iOS & Android

These identifiers can be set manually like any other attribute, or by calling collectDeviceIdentifiers() after configuring the Purchases SDK. Call it again if a user later grants Ads Tracking permission so the $idfa value is updated.

Solar Engine also uses specific identifiers to associate lifecycle events with campaign cohorts. Use the Purchases SDK helpers to forward these identifiers to RevenueCat:

• setSolarEngineDistinctId() - The Solar Engine Distinct ID (primary identifier)
• setSolarEngineAccountId() - The Solar Engine Account ID (optional)
• setSolarEngineVisitorId() - The Solar Engine Visitor ID (optional)

Swift

import Purchases

// ...
Purchases.configure(withAPIKey: "public_sdk_key")
// ...

// Collect device identifiers (important for attribution matching)
Purchases.shared.collectDeviceIdentifiers()

// Retrieve the identifiers from the Solar Engine SDK
let distinctId = /* Solar Engine SDK Distinct ID (optional) */
let accountId = /* Solar Engine SDK Account ID (optional) */
let visitorId = /* Solar Engine SDK Visitor ID (optional) */

// Forward them to RevenueCat
Purchases.shared.attribution.setSolarEngineDistinctId(distinctId)
Purchases.shared.attribution.setSolarEngineAccountId(accountId)
Purchases.shared.attribution.setSolarEngineVisitorId(visitorId)

Kotlin

// ...
Purchases.configure(this, "public_sdk_key")
// ...

// Collect device identifiers (important for attribution matching)
Purchases.sharedInstance.collectDeviceIdentifiers()

// Retrieve the identifiers from the Solar Engine SDK
val distinctId = /* Solar Engine SDK Distinct ID (optional) */
val accountId = /* Solar Engine SDK Account ID (optional) */
val visitorId = /* Solar Engine SDK Visitor ID (optional) */

// Forward them to RevenueCat
Purchases.sharedInstance.setSolarEngineDistinctId(distinctId)
Purchases.sharedInstance.setSolarEngineAccountId(accountId)
Purchases.sharedInstance.setSolarEngineVisitorId(visitorId)

3. Configure Solar Engine in the RevenueCat dashboard

After your SDK is ready and device data is flowing, finish the setup in RevenueCat:

1. Navigate to your project settings in the RevenueCat dashboard and choose Solar Engine from the Integrations menu.

2. Enter your iOS App Key and/or Android App Key. These keys authenticate requests from RevenueCat to Solar Engine. You can find them in your Solar Engine dashboard under Attribution > App > Edit App.

3. If your app targets users in China mainland, enable the Use China Mainland Storage Region option to ensure data is stored in the appropriate region.

4. Provide event names for each lifecycle event RevenueCat will send, or choose Use default event names to populate the recommended mapping:

   RevenueCat lifecycle event	Default Solar Engine event name	Event Type	Required
   Initial purchase	initial_purchase_event	In-App Purchase + rc_event_name	✅
   Trial started	trial_started_event	Custom event	✅
   Trial converted	trial_converted_event	In-App Purchase + rc_event_name	✅
   Trial cancelled	trial_cancelled_event	Custom event	✅
   Renewal	renewal_event	In-App Purchase + rc_event_name	✅
   Cancellation	cancellation_event	Custom event	✅
   Non-renewing purchase	non_renewing_purchase_event	In-App Purchase + rc_event_name	Optional
   Uncancellation	uncancellation_event	Custom event	Optional
   Subscription paused	subscription_paused_event	Custom event	Optional
   Expiration	expiration_event	Custom event	Optional
   Billing issue	billing_issue_event	Custom event	Optional
   Product change	product_change_event	Custom event	Optional

5. Select how RevenueCat should report revenue totals using the Revenue reporting mode menu:

   • Gross reports transaction amounts before app store commission and taxes.
   • Net reports revenue after estimated store commission and/or taxes.

6. Click Add integration (or Save) to enable the connection.

4. Test the Solar Engine integration

Before rolling out the integration, run through an end-to-end test:

1. Make a sandbox purchase with a new user after confirming the device identifiers from step 2 are present.
2. Visit the Customer View for the tester and confirm the Solar Engine attributes are listed.
3. Open the test transaction in Customer History and ensure a Solar Engine event was delivered successfully. You can also review the Last dispatched events panel in the integration settings for a delivery log.

👍You're all set!

Once configured, you should begin to see RevenueCat lifecycle events appear in Solar Engine aligned with the campaigns that sourced those users.