Use the SDK

Import the Library

import PlaytimeMonetize

Set Up PlaytimeOptions and ShowCatalog

In your main activity, you can set up playtimeOptions and call showCatalog .

Task {
    do {
    
        let params = PlaytimeParamsBuilder()
                .setUANetwork("uaNetwork")
                .setUAChannel("uaChannel")
                .setUASubPublisherCleartext("uaSubPublisherCleartext")
                .setUASubPublisherEncrypted("uaSubPublisherEncrypted")
                .setPlacement("placement")
                .setPromotionTag("promotion-id")
                .build()
        
        let subIds = PlaytimeExtensionsBuilder()
                .setSubId1("subId1")
                .setSubId2("subId2")
                .setSubId3("subId3")
                .setSubId4("subId4")
                .setSubId5("subId5")
                .build()
       
        let options = PlaytimeOptionsBuilder()
                .setUserId("your_user_id")
                .setSDKHash("your_sdk_hash")
                .setParams(params)
                .setExtensions(subIds)
                .setUserProfile(userProfile)
                .build()
        
        try await Playtime.showCatalog(
                 options: options
        )
    } catch {
        // handle errors / retry if needed
    }
}

Using setPlaytimeOptions

The SDK also provides an option to independently set up the playtimeOptions before calling showCatalog. Calling setPlaytimeOptions will reinitialize the SDK.

static func setPlaytimeOptions(options: PlaytimeOptions) async throws

Using getStatus to showCatalog

The SDK that ensures that showCatalog and other methods that trigger SDK re-initialization wait until the previous init request finishes before executing. Regardless, you still also have the option to conditionally call showCatalog based on the SDK's initialization status.

          let isSDKInitialized = try await Playtime.getStatus().isInitialized
            if !isSDKInitialized {
                // the SDK is not initialized, either wait
                // try await Task.sleep(seconds: 1)
                // or trigger re-initialization
                // try await Playtime.setPlaytimeOptions(options: options)                
            }
        
        try await Playtime.showCatalog(
                 options: options
        )
    } catch {
        // handle errors / retry if needed
    }

Parameters

You should include additional User Acquisition and placement parameters. These parameters allow you to track and analyze Playtime's performance within your app.

You can provide these parameters in any combination, both at any point in the app's lifecycle—such as when a user launches the Playtime Catalog interacts with a campaign or requests a payout.

These values must be url-safe as they could potentially be returned as query parameters in the S2S Payout request.

To make the most of the Playtime SDK, to maximize your revenue and provide the best user experience, use all of these parameters for data-driven optimizations. For instance, you can monitor the performance of different Playtime button placements or determine the effectiveness of different UA sources.

Parameter

Explanation

userId

A custom identifier you can assign to each user. If you haven't set one, the Playtime SDK generates it automatically. This ID is necessary for S2S payouts, thus required. Ensure this value is url-safe and that the value is never empty.

uaNetwork

User Acquisition Network. The network through which the user was acquired, e.g., Adwords, Facebook, or Organic.

uaChannel

User Acquisition Channel. The channel within the network from which the user was acquired, e.g. incentivized or video campaigns.

uaSubPublisherCleartext

The cleartext package name of the sub-publisher's app ID within the network from which the user was acquired, e.g., com.domain.appName.

uaSubPublisherEncrypted

The encrypted package name or app ID of the sub-publisher's app from the network where the user was acquired.

placement

The placement of the Playtime Catalog inside your app, e.g., "Main Screen", "Shop", "Interstitial", "More Diamonds Screen", etc.

You can also choose to use adjoe's Apps feature, showing the Playtime catalog with distinct gaming or app experiences.

promotionTag

An optional field that can be sent to adjoe to determine if the user should receive a targeted "user-level" promo.

subId1