Package io.adtrace.sdk

Class AdTraceInstance

  • public class AdTraceInstance
extends java.lang.Object
    AdTrace android SDK (https://adtrace.io) Created by Nasser Amini (github.com/namini40) on April 2022. Notice: See LICENSE.txt for modification and distribution information Copyright © 2022.

    • Constructor Detail

      • AdTraceInstance

        public AdTraceInstance()

    • Method Detail

      • onCreate

        public void onCreate​(AdTraceConfig adTraceConfig)
        Called upon SDK initialisation.
        Parameters:
        adTraceConfig - AdTraceConfig object used for SDK initialisation

      • trackEvent

        public void trackEvent​(AdTraceEvent event)
        Called to track event.
        Parameters:
        event - AdTraceEvent object to be tracked

      • onResume

        public void onResume()
        Called upon each Activity's onResume() method call.

      • onPause

        public void onPause()
        Called upon each Activity's onPause() method call.

      • setEnabled

        public void setEnabled​(boolean enabled)
        Called to disable/enable SDK.
        Parameters:
        enabled - boolean indicating whether SDK should be enabled or disabled

      • isEnabled

        public boolean isEnabled()
        Get information if SDK is enabled or not.
        Returns:
        boolean indicating whether SDK is enabled or not

      • appWillOpenUrl

        public void appWillOpenUrl​(android.net.Uri url)
        Called to process deep link.
        Parameters:
        url - Deep link URL to process

      • appWillOpenUrl

        public void appWillOpenUrl​(android.net.Uri url,
                           android.content.Context context)
        Called to process deep link.
        Parameters:
        url - Deep link URL to process
        context - Application context

      • sendReferrer

        public void sendReferrer​(java.lang.String rawReferrer,
                         android.content.Context context)
        Called to process referrer information sent with INSTALL_REFERRER intent.
        Parameters:
        rawReferrer - Raw referrer content
        context - Application context

      • sendPreinstallReferrer

        public void sendPreinstallReferrer​(java.lang.String referrer,
                                   android.content.Context context)
        Called to process preinstall payload information sent with SYSTEM_INSTALLER_REFERRER intent.
        Parameters:
        referrer - Preinstall referrer content
        context - Application context

      • setOfflineMode

        public void setOfflineMode​(boolean enabled)
        Called to set SDK to offline or online mode.
        Parameters:
        enabled - boolean indicating should SDK be in offline mode (true) or not (false)

      • sendFirstPackages

        public void sendFirstPackages()
        Called if SDK initialisation was delayed and you would like to stop waiting for timer.

      • addSessionCallbackParameter

        public void addSessionCallbackParameter​(java.lang.String key,
                                        java.lang.String value)
        Called to add global callback parameter that will be sent with each session and event.
        Parameters:
        key - Global callback parameter key
        value - Global callback parameter value

      • addSessionPartnerParameter

        public void addSessionPartnerParameter​(java.lang.String key,
                                       java.lang.String value)
        Called to add global partner parameter that will be sent with each session and event.
        Parameters:
        key - Global partner parameter key
        value - Global partner parameter value

      • removeSessionCallbackParameter

        public void removeSessionCallbackParameter​(java.lang.String key)
        Called to remove global callback parameter from session and event packages.
        Parameters:
        key - Global callback parameter key

      • removeSessionPartnerParameter

        public void removeSessionPartnerParameter​(java.lang.String key)
        Called to remove global partner parameter from session and event packages.
        Parameters:
        key - Global partner parameter key

      • resetSessionCallbackParameters

        public void resetSessionCallbackParameters()
        Called to remove all added global callback parameters.

      • resetSessionPartnerParameters

        public void resetSessionPartnerParameters()
        Called to remove all added global partner parameters.

      • teardown

        public void teardown()
        Called to teardown SDK state. Used only for AdTrace tests, shouldn't be used in client apps.

      • setPushToken

        public void setPushToken​(java.lang.String token)
        Called to set user's push notifications token.
        Parameters:
        token - Push notifications token

      • setPushToken

        public void setPushToken​(java.lang.String token,
                         android.content.Context context)
        Called to set user's push notifications token.
        Parameters:
        token - Push notifications token
        context - Application context

      • gdprForgetMe

        public void gdprForgetMe​(android.content.Context context)
        Called to forget the user in accordance with GDPR law.
        Parameters:
        context - Application context

      • disableThirdPartySharing

        public void disableThirdPartySharing​(android.content.Context context)
        Called to disable the third party sharing.
        Parameters:
        context - Application context

      • trackMeasurementConsent

        public void trackMeasurementConsent​(boolean consentMeasurement)

      • trackAdRevenue

        public void trackAdRevenue​(java.lang.String source,
                           org.json.JSONObject adRevenueJson)
        Track ad revenue from a source provider
        Parameters:
        source - Source of ad revenue information, see AdTraceConfig.AD_REVENUE_* for some possible sources
        adRevenueJson - JsonObject content of the ad revenue information

      • trackAdRevenue

        public void trackAdRevenue​(AdTraceAdRevenue adTraceAdRevenue)
        Track ad revenue from a source provider
        Parameters:
        adTraceAdRevenue - AdTrace ad revenue information like source, revenue, currency etc

      • trackPlayStoreSubscription

        public void trackPlayStoreSubscription​(AdTracePlayStoreSubscription subscription)
        Track subscription from Google Play.
        Parameters:
        subscription - AdTracePlayStoreSubscription object to be tracked

      • getAdid

        public java.lang.String getAdid()
        Called to get value of unique AdTrace device identifier.
        Returns:
        Unique AdTrace device indetifier

      • getAttribution

        public AdTraceAttribution getAttribution()
        Called to get user's current attribution value.
        Returns:
        AdTraceAttribution object with current attribution value

      • getSdkVersion

        public java.lang.String getSdkVersion()
        Called to get native SDK version string.
        Returns:
        Native SDK version string.

      • setTestOptions

        public void setTestOptions​(AdTraceTestOptions testOptions)
        Used for testing purposes only. Do NOT use this method.
        Parameters:
        testOptions - AdTrace integration tests options