In-App Purchase Module

What is an in-app purchase?

An in-app purchase is additional content, services, or a subscription that you buy inside the app. Some examples of in-app purchases include:

• Upgrade to remove ads
• Game credits
• Virtual currency
• Extra game levels
• Unlock more features

Examples of purchases that are not considered in-app purchases include:

• Purchasing clothes or other items in an e-commerce app.
• Using Apple Pay to complete a purchase.

Learn more about in-app purchases in the Apple developer portal.

Install

Install the In-App Purchase module with Swift Package Manager, CocoaPods, or Carthage.

Swift Package Manager (Recommended)

Swift Package Manager is the recommended way to install the Tealium Swift library:

1. In your Xcode project, select File > Swift Packages > Add Package Dependency.
2. Enter the repository URL: https://github.com/tealium/tealium-swift.
3. Configure the version rules. The default, "Up to next major", is recommended. If the current Tealium Swift library version does not appear in the list, reset your Swift package cache.
4. Select the InAppPurchase module from the list of modules to install. Add the module to each of your app targets in your Xcode project under Frameworks > Libraries & Embedded Content.

Learn more about the Swift Package Manager installation for iOS.

CocoaPods

To install the In-App Purchase module with CocoaPods, add the following pod to your Podfile:

pod 'tealium-swift/InAppPurchase'

Learn more about the CocoaPods installation for iOS.

Carthage

Follw these steps to install the In-App Purchase module with Carthage:

1. Navigate to the General configuration pane for the target app in Xcode.
2. Add the following framework to the Embedded Binaries section:

   TealiumInAppPurchase.xcframework
   

3. To import the In-App Purchase library, add the following import statement to your project:

   import TealiumInAppPurchase
   

Learn more about the Carthage installation for iOS.

Configure

To instantiate the In-App Purchase module, you must specify it in your TealiumConfig object when initializing the SDK:

import TealiumCore
import TealiumInAppPurchase

let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           datasource: "DATASOURCE")

config.collectors = [Collectors.InAppPurchase]
tealium = Tealium(config: config) { _ in }

Review the Collectors documentation to understand how to correctly specify the collectors you require.

Data Layer

The In-App Purchase module sends the following attributes in the event: