Documentation / Product / Integrations / Localytics

Localytics: Import Activity

Import mobile activity from Localytics to add mobile behavior data to user profiles in Lytics.

Integration Details

This integration utilizes the Localytics raw logs export API to retrieve event data:

  1. Every hour, requests the full hour of logs for the mobile activity from 2 hours prior period.
  2. Ingests the activity into the Lytics data stream localytics_activity


The following fields are included in the default mapping of the localytics_activity stream:

Source FieldLytics Default FieldDescriptionType
google_advertising_idgoogle_aid unique idGoogle Advertising IDstring
advertising_ididfa unique idIdentifier for Advertising (IDFA) for iOS Devicesstring
customer_ids.customer_idlocalytics_customer_id unique idLocalytics Customer IDstring
applocalytics_appLocalytics Appstring
app_verlocalytics_app_verLocalytics App Versionstring
carrierlocalytics_device_carrierLocalytics Device Carrierstring
device_uuidlocalytics_device_idLocalytics Device IDstring
device_timezonelocalytics_timezoneLocalytics Device Timezoneint
languagelocalytics_languageLocalytics Languagestring
limit_advertisinglocalytics_limit_advertisingLocalytics Limit Advertisingboolean
typelocalytics_typeLocalytics Event Typestring
os_verlocalytics_os_versionLocalytics OS Versionstring
platformlocalytics_platformLocalytics Platformstring
push_statuslocalytics_push_statusLocalytics Push Statusstring
user_typelocalytics_user_typeLocalytics User Typestring
namelocalytics_event_nameLocalytics Last Event Namestring
custom.drop_reasonlocalytics_drop_reasonLocalytics Last Drop Reasonstring
custom.request_idlocalytics_request_idLocalytics Last Request IDstring


Follow these steps to set up and configure an import of Localytics mobile activity.

  1. Log into your Lytics account.
  2. Click on the Localytics tile in the Integrations section of Lytics localytics logo
  3. Select Import Localytics Events.
  4. Select the authorization you would like to use. If you haven't added an authorization yet, click on + Add new authorization. See Localytics Authorization for more details.
  5. Configure the workflow
    • Localytics App - required: select the Localytics App to pull activity data from. To import data from multiple apps, run multiple activity imports.
    • Start Date - optional: choose a past date to pull in historical activity data. If left empty, only new activity data will be imported.
    • Keep Updated - uncheck to only import historical data. localytics import activity
  6. Click Start Import to start the activity import.
  7. Activity data should appear in the localytics_activity stream in the Data Streams section in Lytics within a couple hours, and the mapped user fields above will be added to the user profiles as new activity data is imported.