This app provides source code examples of how to:
- send an event to Extole
- get a resource (text, url, data) describing a marketing campaign configured in Extole
- share via email through Extole
- share using Android native share
Screenshot:
- Clone this repository
- Open it with Android Studio
- Run it in a simulator or real device
- Declare ENV variables
GITHUB_USERandGITHUB_PERSONAL_ACCESS_TOKENfor more details refer to: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-gradle-registry
Note: dependencies for this project are not published to a public repository at this moment.
To your project build.gradle under the repositories configuration, add:
maven {
name "github"
url "https://maven.pkg.github.com/extole/android-sdk"
}
On your application build.gradle file Add a dependency on Extole Android SDK:
implementation 'com.extole.mobile:android-sdk:1.0.0'
Modify AndroidManifest.xml, add:
<meta-data
android:name="com.extole.PROGRAM_DOMAIN"
android:value="YOUR_PROGRAM_DOMAIN" />
<receiver
android:name=".android.sdk.impl.ExtoleShareBroadcastReceiver"
android:exported="false" />
We recommend that you keep a reference to the extole and share it between activities.
val extole = Extole.builder()
.withPersistance(SharedPreferencesPersistance(context))
.withAppName("YOUR-APPLICATION-NAME")
.addData("version", "YOUR-APPLICATION-VERSION")
.build()
Allowing the marketer to manage the call to action messaging to align with the marketing campaign.
GlobalScope.launch {
val (zone, campaign) = extole.getZone("promotional_menu")
runOnUiThread {
findViewById<EditText>(R.id.promotional_menu_item).setText(
zone.get("menu_text").toString(), TextView.BufferType.NORMAL
)
}
}
This example assumes you have configured the 'promotional_menu' zone with 'menu_text' in Extole.
A webview is a convenient way to support a rich campaign experience, while minimizing mobile development. Extole, supports tracking important events in the webview, like tracking native sharing events.
GlobalScope.launch {
val (zone, campaign) = extole.getZone("promotional_menu")
runOnUiThread {
val menuItemButton = findViewById<Button>(R.id.menu_item_button)
menuItemButton.text = zone.get("menu_item_text").toString()
menuItemButton.setOnClickListener {
val intent = Intent(this@Activity, WebViewActivity::class.java)
intent.putExtra("webViewItem", menuItemButton.get("webViewItem").toString())
startActivity(intent)
}
}
}
Where WebViewActivity layout contains a WebView and when Activity is initilized we are doing:
val extras = intent.extras
val webViewItem = extras!!.getString("webViewItem").orEmpty()
val webView = findViewById<WebView>(R.id.webview)
val context: Context = this
GlobalScope.launch {
val webViewBuilder = extole.webViewBuilder(webView)
runOnUiThread {
val extoleWebView = webViewBuilder.create()
extoleWebView.load("microsite")
}
}
This example assumes you have configured a 'microsite' zone to server content.
extole.sendEvent("purchase", mapOf("order_id" to "123", "cart_value" to "120.30"))
GlobalScope.launch {
val (_, campaign) = extole.getZone("promotional_email")
campaign.emailShare(recipient, subject, message);
}