Changelog

Added support for grouping notifications.

Resolved crash when initial launch of app is with an intent containing a non-hierarchical URI scheme.

Resolved issue which could result in some previously received notifications being treated as though they were copies of the more recently received notifications on Android 4-10 devices.

Resolved bug which could prevent Teak.Notification.schedule from correctly scheduling notifications while an app is being backgrounded.

No changes. Version bump to match wrapper SDKs.

Fixed player interactions with buttons on notifications on Android >= 11

Resolved issue that could result in an extra unattributed 'play' event when returning to the game from a push notification or link after two minutes of backgrounding

Resolved issue which could result in failing to track clicks in sessions starting from a notification or link with a non-hierarchical out of game link, such as mailto:example@example.com

Local notification personalization: Using Teak.Notification.Schedule you can now pass a dictionary of additional data which can be templated into the local notification.

Session time tracking: The Teak SDK now automatically tracks the duration of game sessions and reports this data to the Teak Dashboard and any configured data syncs.

Opt-Out Categories: You can now categorize push notifications and emails into different Opt-Out Categories, and provide players with an in-game communication preferences UI so that your players can manage what kinds of messaging they receive.

Push Opt-Out Tracking: The Teak SDK can now detects and reports when a player has opted out of push notifications through their device settings to the Teak Dashboard for upcoming reports.

Uninstall Tracking: The Teak SDK and Teak Dashboard can now detect and report when a player has uninstalled the game from their device for upcoming reports.

Notification Channels: Opt-Out Categories automatically map to Notification Channels, which provides players with a familiar UI in Settings to manage the kinds of messaging they receive.

Badging: From the Teak Dashboard you can enable an app icon badge when push notifications are delivered. Note that this will only apply to non-default Opt-Out Categories, or the default Opt-Out category on new installs made after integrating Teak SDK 4.3.0.

Image+Text Notification Layout: Teak now supports a new notification layout which places a square image to the right of the text content of the notification.

Deprecated TeakNotification.scheduleNotification. Use Teak.Notification.schedule instead.

Improved notification display on Samsung devices running Android 12+.

Fixed Missing class com.unity3d.player.UnityPlayerActivity warning in non-Unity projects.

Resolved several potential race conditions that could prevent updated player contact information from being submitted to the Teak Dashboard

Resolved issue when setting a player’s email address back to original value after calling Teak.Instance.deleteEmail()

Resolved potential failure to initialize the Teak SDK when launching from a link or push notification that deep links to an unknown custom URL scheme

Resolved race condition that could result in an extra 'play' event when updating player contact information while the game is being backgrounded

Fixed bug that could result in an extra 'play' event when changing game assigned player id through a new call to Teak.Instance.identifyUser().

Teak$AdditionalDataEvent has been deprecated, and will be removed in the SDK 5 family. Please use Teak$UserDataEvent.

Google Play Billing v3 support has been removed

Now requires EventBus 3.3.1

SDK 5 Behaviors now enabled by default (io_teak_sdk5_behaviors)

Teak#handleDeepLinkPath has been added to allow you manually resolve a deep link path, e.g. /foo/bar?fizz=buzz

Teak#setChannelState has been added to let users opt in/out of Teak marketing channels

Teak$UserDataEvent has been added to provide user specific state, including opt-out status for Teak email and push campaigns and the 'additional data' for the user. This supercedes [Teak$AdditionalDataEvent], which has been deprecated.

Teak#canOpenNotificationSettings and Teak#openNotificationSettings to allow users to open the settings app directly to the notification settings for their app

Teak#canOpenSettingsAppToThisAppsSettings has been added

Teak#deleteEmail has been added

Google Play Billing v5 support has been added

Added pushRegistration to Teak$UserDataEvent

Fixed trace log output for identifyUser to include parameter names

Resolved crash when initial launch of app is with an intent containing a non-hierarchical URI scheme.

Added android.permission.POST_NOTIFICATIONS for Android 13.

Reverted change to use StandardCharsets.UTF_8 because that requires API 19.

Resolve bug which resulted in all previously received notifications being treated as though they were copies of the most recently received notification on Android 11 and 12 devices.

If client deep link resolution fails, server resolution can now properly resolve and attribute a launch properly.

Add Google Play Billing v4 to proguard.txt

If there’s a notification/link launch on 'first launch' use that instead of the install referrer

Added io_teak_no_auto_track_purchase to prevent automatic purchase collection

Added support for Google Play Billing v4

Fix Android 12 formatting of text-only notifications

Fix issue of opening browser when launched with the host for a teak shortlink, but no path

Fix for crash when an Amazon build did not contain Google Play Billing references.

Fixes null Iterator exception when a purchase is cancled in Google Play Billing

Fixes issue in Android 12 compatibility that prevented push notifications from displaying when the app was not running.

Mark GooglePlayBillingV3 and Amazon store classes Unobfuscatable.

If you target Android 12, you must add android:exported specifications to the receiver definition for io.teak.sdk.push.ADMPushProvider$MessageAlertReceiver

Added support for targeting Android 12 (API level 31)

Added a flag to preview SDK 5 changes, io_teak_sdk5_behaviors

Added Teak$PostLaunchSummaryEvent which will contain launch information for both Teak attributed, and non-Teak attributed launches

When app is launched via an email link Teak$NotificationEvent event is now correctly posted.

If you target Android 12, you must add android:exported specifications to the receiver definition for io.teak.sdk.push.ADMPushProvider$MessageAlertReceiver

Added support for targeting Android 12 (API level 31)

Fixed a bug where handling links would only report the creative name for links and not email links.

Deprecated method Teak.onNewIntent removed

Support for Adobe AIR removed

support-v4 is no longer supported, AndroidX is now required

If you use the Facebook SDK, version 4 is now the minimum supported version

Teak will no longer create a Firebase instance if one does not exist

Minimum target SDK is now API 30

com.android.installreferrer version used is now 2.2

Now using v2 Signatures for request signing (this is not a user-facing change).

Now supports out-of-memory fallbacks for all notifiation images.

Added teakScheduleId and teakCreativeId to NotificationEvent

Added teakScheduleId and teakCreativeId to RewardClaimEvent

Now automatically tracks purchases from Google Play Billing v3

Fixed a bug where links created on the Teak Dashboard could only link to the teakXXXXX:// scheme.

Fixed a bug where links created on the Teak Dashboard could only link to the teakXXXXX:// scheme.

Requires Firebase Messaging 21 minimum

Resets firstSendTime on UserProfile after send.

Fix deadlock when a UnitySendMessage call would cause another callback into Teak under certain circumstances

Fix singleton FCMPushProvider to allow operation before Teak initialization

Let users use their own FirebaseMessagingService

Added isTeakNotification

Added onMessageReceivedExternal

Fix mutex lock order to resolve potential deadlock

Supports Amazon Device Messaging 1.1.0

LaunchedFromLink event

Fixes deadlock in Session.isCurrentSession

If using Teak to create a separate Firebase instance, you must add io_teak_firebase_project_id and

Support Firebase Project Id for Firebase 20.1.6+

Push state chain limited to a length of 50

Fix public static void identifyUser(final String userIdentifier) overloaded method

No longer process deep links which are not Teak links

Reduce thread allocations, and add further measurement around thread and executor allocations

Supports Facebook SDK 6.x

Added io_teak_log_trace, enable to log out every Teak call with parameters

Added logout

Added teakChannelName to the dictionary reported by notification and reward claim events

Fixes compatibility with Firebase 20.1+

No longer will call deep links again, or resolve rewards again, when the user id is changed.

/teak_internal/app_settings deep link added. Opens Android settings to the settings for this app.

Foreground notification support.

Added additional proguard keep paterns.

Teak can now optionally ignore the default Firebase configuration, use <meta-data android:name="io_teak_ignore_default_firebase_configuration" android:value="true" />

minSdkVersion is now 16

targetSdkVersion must now be 28 or higher

Teak can now use androidx or the support-v4 libraries for its dependencies.

Can now use the 5.x series of the Facebook SDK.

The incoming path used to parse a deep link is sent along to the handler in the key __incoming_path

The full url used to parse a deep link is sent along to the handler in the key __incoming_url

identifyUser now takes email as a parameter

FOREGROUND_NOTIFICATION_INTENT is broadcast when a Push Notification is recieved while the app is in the foreground.

ms_since_first_event is now sent with batched requests.

Added deviceBoard and deviceProduct to device information.

Teak.setLogListener for getting callbacks when the Teak SDK would log an event.

Suppress some log spam when looking to see if NotificationManagerCompat.areNotificationsEnabled is supported.

Stopped some of the fine-grain checking for what IInAppBillingService supports, to prevent possible ANRs.

All threads and executors are now named, so that any ANR/crash report which includes thread names will clearly show what Teak is doing in that ANR/crash.

io_teak_enable_caching has been removed

app_version reported to Sentry should be a string, not int

Sentry reporting Job is now working properly

Support trackEvent for Adobe AIR

Added incrementEvent

Now tracking PackageInfo.versionName (instead of just PackageInfo.versionCode)

Added support for Google Play’s com.android.installreferrer.api.InstallReferrerClient

Added support for specifying the Android store, using io_teak_store_id. Will detect Amazon automatically; defaults to Google Play.

Properly handle deep links with '?' or '#' in a URL path element

ADMPushProvider$MessageAlertReceiver no longer obfuscated.

Direct GCM support removed, now using Firebase

Firebase Job Dispatcher is now used for a unified Teak worker

userHasDisabledNotifications → getNotificationStatus

ShortcutBadger @ 50d422d1792b394a5a6cda10cc358ba58436fe29

io_teak_enable_caching now defaults to true

If an OutOfMemoryError is thrown during construction of a notification’s expanded view the expanded view will simply be omitted instead of not showing the entire notification.

ADMPushProvider$MessageAlertReceiver no longer obfuscated.

Notification asset downloads can be cached, if io_teak_enable_caching is enabled. It is disabled by default, but everyone is encouraged to try using it.

Long Distance notifications

Now defaults to Google Play Store if there is no installer package, instead of disabling tracking

Video notifications should no longer get sorted to the bottom after refresh on Android 8+

Notifications will now retry asset loading if an asset fails to load. Delay is 2, 4, and 8 seconds.

Android P support

android.os.Build.SERIAL will not be used under Android P

Updated Sentry exception reporting properties

Tracks historical changes in the state of push permissions

Per-user opt-out of tracking, configured via identifyUser

In the ZIP distribution of the Android SDK, the UUID for the ProGuard file sent to Sentry was not being included, this is fixed

Rarely a deadlock could occur when a GCM registration update came in during a Session state change, this is fixed

Ability to disable collection of IDFA, Push Key, and/or Facebook Access Token

If Teak.onCreate fails, don’t crash with a null pointer

Requires io.teak.sdk.service.JobService for Android 8 job compatibility.

Unity requires no changes.

Adobe AIR requires adding <service android:name="io.teak.sdk.service.JobService" android:permission="android.permission.BIND_JOB_SERVICE" android:exported="true"/> to XML

Renamed some public static final fields (This should have no impact unless you were using these for some very strange reason)

Android 8 job compatibility

Reward Link Name is now the ‘creative name’ if the on reward callback was triggered from a deep link

Fix corner case where GCM reg would not get sent if it came in during identifyUser (for real this time)

Fixes integration checker when <activity-alias> is used

User Profile support

Request batchfing for trackEvent, user profile

Fix corner case where GCM reg would not get sent if it came in during identifyUser

Notification buttons in expanded view

Aspect ratio now preserved in small view notifications

Launch deep-link now takes precedence over install-attribution deep link on first launch of app

Added userHasDisabledNotifications

Added openSettingsAppToThisAppsSettings

Added setApplicationBadgeNumber

teakRewardId now included in the REWARD_CLAIM_ATTEMPT event

Enhanced Integration Checks

Schedule/Cancel notification returns id as a string

Purchase tracking works once again

Send common payload during reward claim

RetryableTask now immediately fails if ClassNotFoundException (if GCM isn’t linked)

Fix crash when changing user id due to locking Session A and unlocking Session B

Fix non-delivery of push notifications when app had been killed in the background

Try and catch initialization errors from TeakWrapper and report them

You can now load images in push notifications from your Android assets, example assets:///pixelgrid_2000x2000.png (note triple slash)

Using NONE for an image resource will now remove it from the layout

Notifications will no longer combine into a single notification (in as much as is possible to control) on Android 8+ only

If you are compiling with a target SDK of Android 26 or greater, Teak will now check requirements and throw an exception if the Android v4 support lib doesn’t support Android 26 features (required features for push functionality)

Support explicit intents for Android 26+

Support notification categories for Android 26+

ADM listener fixed

Deadlock due to very slow network conditions fixed

Unity/Air wrapper classes now included in core for testability and better continuous integration performance

Hotfix from 0.12.9 integrated

Internal system re-write

io.teak.sdk.TeakUnityPlayerNativeActivity renamed to io.teak.sdk.wrapper.unity.TeakUnityPlayerNativeActivity

io.teak.sdk.TeakUnityPlayerActivity renamed to io.teak.sdk.wrapper.unity.TeakUnityPlayerActivity

io.teak.sdk.Application renamed to io.teak.sdk.wrapper.Application

Use Teak.registerDeepLink instead of DeepLink.registerRoute

TeakNotification.cancelAll

TeakNotification calls now return a JSON string with status and data

Setting verbose logging will immediately take effect

Corner-case crash fix in Logs

Attach additional info to exception reporting, teakCreativeName

Fixed caught-exception in GCM if the OS kills the GCM service

Additional info in the notification & reward payload

Add specific catches for exceptions we should ignore, and not report

Fixed TEAK-SDK-9

Fixed issue with Android < 5 and custom notification icons

Fix parameter checking logic bug in trackEvent

Fix 'cold start' attribution bug

Add support for

Back-stack loop bug fix

Catch SecurityException on very old Android which requires android.permission.VIBRATE

Raven service changed from error to warning to prevent developer anxiety

Additional listeners for GCM registration key updates, and improvements in handling GCM registrations.

Use layout_centerVertical on the app icon to support various background image heights

Prevent back-stack loops from out of app deep-links

Push notification remote syntax is now versioned (non-breaking), new features

[object Object]

Large/small image background

Support setting credentials in <meta-data> for Adobe Air.

Fix state machine bug where a RemoteConfiguration coming back when device was in background would assign the Configured Session state.

No longer calls ACTION_CLOSE_SYSTEM_DIALOGS when dismissing notifications

No longer DDoS ourselves with remote logging

Unity and Adobe AIR now use a unified way of assigning their SDK versions

Remote logging

Remote exception tracking