ActionScript

Setup

Download the SDK from: https://github.com/cooladata/cooladata-actionscript

 

Flash Development

  1. Add the cooladata-sdk-ac3-x.x.x.swc to the lib folder of your project.
  2. Right-click the file and choose “Add To Library”.

 

Adobe CS4 (and above)

  1. Save the cooladata-sdk-ac3-x.x.x.swc in a folder that is accessible to CS4.
  2. Go to the Publish Settings menu.
  3. Click on the Settings button.
  4. Click on the SWC file icon.
  5. Browse to the location of the cooladata-sdk-ac3-x.x.x.swc file.
  6. Select the cooladata-sdk-ac3-x.x.x.swc file.

In order to use CoolaDataTracker SDK for reporting events, it must be initialized first using the setup method:

Example:

 

Sending Events

After the Cooladata Tracker SDK is properly set up, you are ready to report events from your application. To start doing so, you need to call the trackEvent function with suitable parameters on every user’s action that you would like to track.

Example:

 

Sending Event with Parameters:

 

Parameters Descriptions:

Parameter NameTypeMandatoryDescription
eventNameStringYesThe name of the event to report.
userIdStringYesThe User ID relevant for this event. You must provide the userId either in the setup method or in the trackEvent method. This parameter is optional only if provided in the setup method.
sessionIdStringNoThe Session ID relevant for this event.
eventIdStringNoAn ID of the event.
dictionaryDictionaryNoThe custom properties to be sent with the event.
callBackFunctionBooleanNoA CoolaDataDeliveryResult type result that will be returned when the data is sent.

Print Friendly, PDF & Email

Google Tag Manager

Google Tag Manager (GTM) is a free and easy to use platform that allows you to manage CoolaData’s code snippets and firing of events without having to edit the code of your site or application.

Using GTM it is possible to go deeper. GTM offers Macros and Data Layer Objects that provide ways of listening to events (as opposed to simple pageviews) and registering their particular properties. However, this would require changes at the code level of your site. It is up to you to decide if it is not simpler, in these cases, to implement the CoolaData JavaScript SDK directly in your site, without GTM.

For more information on Google Tag Manager visit: https://www.google.com/analytics/tag-manager/ and https://support.google.com/tagmanager#topic=3441530.

This post will will walk you through configuring Cooladata JavaScript Tracker via Google Tag Manager.

 

Installing GTM

  1. Open Google Tag Manager
  2. If you haven’t yet, sign up for an account (free).
  3. Create a new Container: name your container (“Cooladata”), and choose Web as the type:
  4. You will be asked to add a code snippet to your site. Follow the instruction on screen to implement GTM on your site.

 

Creating the CoolaData Tracker Init tag

  1. Click “New Tag” to create the basic tracker tag.
  2. Select a tag type – “Custom HTML Tag”
  3. Paste the CoolaData JS Setup snippet (can be found in app.cooladata.com under Project – Event Source – JS) in the HTML section.
  4. Choose the trigger “All Pages”
  5. Name the tag: “Cooladata-tracker”
  6. Save the tag.

 

Creating custom event tags

  1. Create a new tag and select type – “Custom HTML Tag”.
  2. Paste the CoolaData JS Track Event snippet (can be found in app.cooladata.com under Project – Event Source – JS) in the HTML section. Enter the event name and properties you wish to track. For example:

  3. Create a new trigger according to the action you wish to track:
  4. Name the tag and save it:

 

Publishing tags

To publish your changes to production, name the new version and click Publish:

Print Friendly, PDF & Email

AppsFlyer

AppsFlyer provides a service for mobile campaign download attribution, allowing mobile app publishers to identify which downloads came from specific marketing and ad campaigns, and which are organic downloads. AppsFlyer has a unique method for user identification.

The AppsFlyer-CoolaData integration allows you to track activation, retention and other behavioral analyses and link them to the campaigns identified by AppsFlyer allowing you to optimize your campaigns by quality of customers via customer lifetime value (LTV) and virality scores as well as quantity of installs.

Example Business Questions:

  • Cohort by Users who did: Install and also did: Purchase, breakdown by Campaign Name
  • Path with pillar events: Install, Start Game, Invite Friend
  • Power KPI – track number of installs, number of active users
  1. AppsFlyer tracks downloads via the AppStore or Android Store, Google Play etc. – events that happen outside of network.
  2. AppsFlyer does unique user identification.
  3. CoolaData can combine events across an entire lifecycle of a customer from download through activation and ongoing use (retention).
  4. CoolaData does not do user identification, but needs a user ID.
  5. CoolaData uses the AppsFlyer ID as the unique user ID, saving implementers from managing and combining separate user IDs.

 

Setup

The integration uses a combination of standard and custom CoolaData properties. To ensure that AppsFlyer is able to send the user_id, the app developer must set the custom user ID in the app initialization stage.

  1. Log in to the AppsFlyer Dashboard
  2. Select the app you want
  3. Click on “Integrated Partners” in the Configuration menu:
  4. Search for CoolaData:
  5. In the first tab of the configuration window (“Integration parameters”) under token insert your CoolaData app key (found in Project-settings in CoolaData)
  6. Check the Enable checkbox
  7. Click Save & Close

After this initial setup, install events will be automatically sent to Cooladata.

IMPORTANT NOTE:

According to Facebook and Twitter T&C, Appsflyer are unable share user level data with any 3rd party. As a result, all Facebook and Twitter installs are sent to Cooladata as organic.

How it works

The main usage scenario is tracking the Install event, captured by AppsFlyer and sent to CoolaData. When the user installs the app, an AppsFlyer event is triggered to CoolaData, containing the properties listed in the JSON below as event properties:

Event Name: Install 

Properties:

  • event_name
  • user_id
  • appsflyer_id
  • event_timestamp_epoch
  • session_dua
  • session_app_id
  • session_ip
  • media_source
  • campaign_name
  • build_version

You can now start creating your widgets in CoolaData to use the events and properties sent by AppsFlyer.

 

 Sending in-app events

You could also postback Appsflyer in-app events to Cooladata. To set this up:

  1. In the integration configuration window go to the second tab: “In-App events”
  2.   Send In-App events to Cooladata – choose and make sure the token contains the Cooladata same app key:
  3. In the “In App Events Mapping” section – map the event names you want to send to Cooladata (“Cooladata events” column contains the event_name sent to Cooladata). Select “send value” if you also want to send the events custom properties along with the in-app events:
  4. Click on “save and close” to save the configurations. In app events are now sent to Cooladata and can be viewed in the “Live events” view.
Print Friendly, PDF & Email

Kochava

Kochava is a mobile measurement company that helps mobile app developers and advertisers analyze the effectiveness of marketing campaigns, by shedding light on what media advertising efforts are converting, and the effectiveness of their mobile ad spend.
Kochava’s platform allows developers to:

  • Track ad network agnostic conversion tracking.
  • Track app-specific feature tracking.
  • Provide push notifications (both programmatic and via rich-media push).

The Kochava platform provides out-of-the-box SDK, and is integrated with over 650 mobile ad networks, publishers, and exchanges.

 

Setup

Kochava’s integration with CoolaData allows mobile developers and advertisers to gain deeper insights of users through CoolaData’s advanced behavioral analytics. A simple wizard on the Kochava side enables a choice of what Kochava data to send to CoolaData for behavioral analytics.

KochavaCoolaData

The Kochava integration is illustrated in the following diagram:

How it works

When an ad is placed and then a user installs an app, an ‘Install’ event is sent back to Kochava to notify them of the event. On the Kochava side, an event is triggered to CoolaData, containing the properties listed in the JSON below as event properties:

 

KochavaFlow

Print Friendly, PDF & Email

Appjolt

Overview

AppJolt lets you analyze, recapture, survey and monetize users who update & uninstall your app.

Integrating AppJolt with Cooladata allows you to append your existing analytics with uninstall data, link to any event you are currently tracking, and instantly find out who, why and when users are uninstalling your apps.

For example:

  • You invested in paid acquisition campaigns, but did you measure which campaign has the highest uninstall rate? Track each media source all the way to the uninstall event.
  • Tie in any behavior, retention and user engagement metric you are currently tracking all the way to the user uninstall.
  • Track specific cohorts and profiles to see who is uninstalling your app.
  • Integrate in less than five minutes to enhance your existing in-app reports with uninstall data.
  • Available for both iOS and Android
  • Free service to all developers regardless of uninstall volume

Upon the uninstallation event, Appjolt sends the event to CoolaData and it is added to that user’s events, and can be associated to any other action performed by that user.

 

Integration with CoolaData

Setup the integration in two quick steps:

  1. Connect to Cooladata in Appjolt admin console: In Appjolt’s developer zone, click on the CoolaData icon and enter your CoolaData app key, as found in the project>Tracking page.
    Appjolt
  2. Identify your users in Appjolt: Identify the user by using the setIdentify(id) method. Pass Appjolt the same userId you pass to CoolaData in the initialization of the app or the event tracking. For example:

    For more information on user identification see Appjolt Identifying Users for Analytic Partners documentation.
Print Friendly, PDF & Email