GA-SDK-CORONA

This repository contains the documentation for GameAnalytics Corona SDK (now known as Solar2D SDK).

Documentation can be found here.

If you have any issues or feedback regarding the SDK, please contact our friendly support team here.

NOTE: this is just a sample app and does not contain the latest version of the SDK. Please go to the documentation to find out how to integrate the SDK.

ℹ️ Requirements:

Corona: 2016.2949 and up

Supported platforms: Android and iOS

Build size:
Note that download size differ from the actual build size.

Android:
The SDK build size in a native Android app is only around 49Kb and the dependecies take up to 820Kb depending if your app already uses some of the same dependencies.

iOS:
The SDK build size in a native iOS app is only around 242Kb (armv7) / 259Kb (armv8).

Changelog

4.2.5

• fixed bug in internal error reproting

4.2.4

• added event uuid to events sent

4.2.3

• removed imei identifiers and other alternative identifiers from user identifier logic (android)

4.2.2

• added error events to be sent for invalid custom event fields used
• added optional mergeFields argument to event methods to merge with global custom fields instead of overwrite them

4.2.1

• fixed missing custom event fields for when trying to fix missing session end events

4.2.0

• added global custom event fields function to allow to add custom fields to events sent automatically by the SDK

4.1.1

• added functionality to force a new user in a/b testing without having to uninstall app first, simply use custom user id function to set a new user id which hasn't been used yet

4.1.0

• added custom event fields feature

4.0.0

• Changed user identifier logic in preparation for Google changes to GAID. User id for a new install is now a randomised GUID. Existing installs that update SDK will continue using previous identifier logic. It is recommended to update as soon as possible to reduce impact on calculated metrics.

3.4.1

• it should now be possible to not show idfa consent dialog if you don't have any third party code that needs to use idfa (ios)
• prepared for google advertising identifier changes (will not use google advertising identifier when user has opted out) (android)

3.4.0

• added impression event function

3.3.8

• added idfa consent status field to events

3.3.7

• updated client ts validator

3.3.6

• fixed dependencies for iOS

3.3.5

• fixed ad event bug

3.3.4

• removed memory info from automatic crash reports

3.3.3

• corrected ad event annotation

3.3.2

• fixed dupplicate symbols for ios (ios)

3.3.1

• improved user identifier flow for ios (ios)

3.3.0

• added ad event

3.2.0

• updated user identifier flow to prepare for iOS 14 IDFA changes (ios)

3.1.1

• fixed progression events with scores (android)

3.1.0

• exposed functions to get AB testing id and variant id

3.0.6

• added session_num to init requests

3.0.5

• removed facebook, gender and birthyear methods
• added auto detect app version for build field option

3.0.4

• A/B testing fixes

3.0.3

• fixed getRemoteConfigsValueAsString bug (ios)

3.0.2

• remote configs fixes

3.0.1

• fixed events bug (ios)

3.0.0

• Remote Config calls have been updated and the old calls have deprecated. Please see GA documentation for the new SDK calls and migration guide
• A/B testing support added

2.2.2

• removed .orig files for ios

2.2.1

• fixed missing event submission toggle method for android

2.2.0

• added error reporing toggle method

2.1.0

• added enable/disable event submission function

2.0.1

• fixed business event validation

2.0.0

• added command center functionality

1.1.4

• fixed session handling for android
• added custom dimensions to design and error events

1.1.3

• various bug fixes

1.1.2

• fixed session length bug
• fixed not allowing to add events when session is not started

1.1.1

• IMEI bug fixes (android)

1.1.0

• changed the behaviour of using IMEI with the 'READ_PHONE_STATE' permission to guarantee precise analytics for certain regions

1.0.6

• bug fix for end session when using manual session handling

1.0.5

• session length precision improvement

1.0.4

• bug fix to google AID fallback (android)

1.0.3

• bug fix for resource events (android)
• added bundle id, app version, app build number
• added app signature and channel id (which app store was the app installed from) (android)
• added IMEI as fallback option for identifier when Google AID and Android ID is not available on the device (requires to add optional READ_PHONE_STATE permission) (andorid)

1.0.2

• possible to set custom dimensions and demographics before initialise

1.0.1

• fix progression event for default values for unused progression field (ios)

1.0.0

• Initial release