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 Google Pay to complete a purchase.

Install

Install the In-App Purchase module using Maven (recommended) or manually.

Maven

To install the module using Maven:

1. In your project’s top-level build.gradle file, add the following Maven repository:

   allprojects {
     repositories {
       jcenter()
       maven {
         url "https://maven.tealiumiq.com/android/releases/"
       }
     }
   }
   

2. In your project module’s build.gradle file, add the following Maven dependencies:

   dependencies {
     implementation 'com.tealium:kotlin-core:1.X.X'
     implementation 'com.tealium:kotlin-inapppurchase:1.0.0'
   }
   

   Ensure you are using the latest version of kotlin-core.

Manual

To install the In-App Purchase module manually:

1. Download the Tealium In-App Purchase module.

2. Copy the file tealium-kotlin.inapppurchase-1.0.0.aar into your project’s <PROJECT_ROOT>/<MODULE>/libs directory.

3. Add the Tealium library dependency to your project module’s build.gradle file:

   dependencies {
     implementation(name:'tealium-kotlin.inapppurchase-1.0.0', ext:'aar')
   }
   

Initialize

Initialize the In-App Purchase module, as shown in the following example:

val config = TealiumConfig(application,
              "ACCOUNT",
              "PROFILE",
              ENVIRONMENT,
              modules = mutableSetOf(Modules.InAppPurchase),
              dispatchers = mutableSetOf(
                Dispatchers.Collect,
                Dispatchers.RemoteCommands)
)

Data Layer

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