Get Started for Android

8min
Cooee's Android SDK enables app developers to track and retain their customers with template-less in-apps. This guide will walk you through the easy steps of installing the Cooee SDK, configuring it, and verifying the data within Cooee's dashboard while you finish your coffee.
Configure Repository
This step is not required for v1.4.1 and above.
If you use an older Gradle (<v7.0), add the below maven link to your project-level build.gradle file.
Groovy
allprojects {
    repositories {
        maven { url "https://letscooee.jfrog.io/artifactory/default-maven-local" }
    }
}
allprojects {
    repositories {
        maven { url "https://letscooee.jfrog.io/artifactory/default-maven-local" }
    }
}
﻿
For the newer version, add below to settings.gradle file-
Groovy
dependencyResolutionManagement {
    repositories {
        maven { url "https://letscooee.jfrog.io/artifactory/default-maven-local" }
    }
}
dependencyResolutionManagement {
    repositories {
        maven { url "https://letscooee.jfrog.io/artifactory/default-maven-local" }
    }
}
﻿
Install Dependency
Update your app-level build.gradle with the following changes to install the Cooee SDK.
Groovy
android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    ...
    implementation 'com.letscooee:cooee-android-sdk:x.y.z'
}
android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    ...
    implementation 'com.letscooee:cooee-android-sdk:x.y.z'
}
﻿
Replace x.y.z with the latest release of the SDK
﻿
Configure Credentials
Add the following in AndroidManifest.xml inside the application tag:
XML
<meta-data
    android:name="COOEE_APP_ID"
    android:value="MY_COOEE_APP_ID"/>
<meta-data
    android:name="COOEE_APP_ID"
    android:value="MY_COOEE_APP_ID"/>
﻿
Replace MY_COOEE_APP_ID with the App ID which is present at Cooee Portal.
Permissions Setup (Optional)
Cooee SDK supports prompting the following permissions via engagement. To make it work, you need to add the following to the app's AndroidManifest.xml file:
XML
<!-- Cooee SDK use this permission to run Augmented Reality engagements -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Cooee SDK use this permission to run Location based engagements -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Cooee SDK use this permission to post an notification(required only on Android 13 and above) -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- Cooee SDK use this permission to run Augmented Reality engagements -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Cooee SDK use this permission to run Location based engagements -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Cooee SDK use this permission to post an notification(required only on Android 13 and above) -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
﻿
Initialize the Cooee SDK
In the onCreate() method of your application’s main activity, add the below line. This will initialize the Cooee SDK.
Java
Kotlin
CooeeSDK cooeeSDK = CooeeSDK.getDefaultInstance(this);
CooeeSDK cooeeSDK = CooeeSDK.getDefaultInstance(this);
﻿
﻿Android 13 and above needs permission to be granted to Post a Notification. You will need to add the below code once you initialize CooeeSDK.
Java
Kotlin
private void requestNotificationPermission() {
    cooeeSDK.requestNotificationPermission(activity);
}
private void requestNotificationPermission() {
    cooeeSDK.requestNotificationPermission(activity);
}
﻿
﻿
Updated 25 Mar 2024
Did this page help you?
Android Native
Tracking Events on Android