Documentation / Product / Integrations / Localytics

Localytics: Import Profiles

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

Integration Details

This integration utilizes the the Localytics Profile Export API. You will need to set up the ProfileDB export in the Localytics UI as described in the linked doc. Once the export is started, and then the import started in Lytics, the workflow will:

  1. Import the Localytics ProfileDB export file.
  2. Every day at 16:00 UTC, if Profile Changes is selected.
    • change logs from Localytics for the prior 24 hours are imported
    • on the first of the month a full profile import is run instead of the change logs
  3. If Profile Changes is not selected, the full profile export will be imported every day.
  4. Ingested profile data is written to the localytics_profiles data stream in Lytics.


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

Source FieldLytics Default FieldDescriptionType
_ll.google_advertising_id unique idgoogle_aid"Current Google Advertising ID"string
_ll.advertising_id unique ididfa"Current IDFA"string
_ll.raw_customer_id unique idlocalytics_customer_id"LocalyticsCustomer ID"string
$email unique idemail"Email"string
_ll.carrierlocalytics_device_carrierLocalytics Device Carrierstring
_ll.device_uuidlocalytics_device_idLocalytics Device IDstring
_ll.device_timezonelocalytics_timezoneLocalytics Device Timezoneint
_ll.languagelocalytics_languageLocalytics Languagestring
_ll.limit_advertisinglocalytics_limit_advertisingLocalytics Limit Advertisingboolean
_ll.typelocalytics_typeLocalytics Event Typestring
_ll.os_verlocalytics_os_versionLocalytics OS Versionstring
_ll. platformlocalytics_platformLocalytics Platformstring
_ll.push_statuslocalytics_push_statusLocalytics Push Statusstring
_ll.user_typelocalytics_user_typeLocalytics User Typestring
_ll.last_session_datelocalytics_last_session_dateLocalytics Last Session Datedate
$first_namefirst_nameFirst Namestring
$last_namelast_nameLast Namestring
$full_namefull_nameFull Namestring


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

  1. Log into your Lytics account.
  2. Click on the Localytics tile in the Integrations section of Lytics localytics logo
  3. Select Import Localytics Profiles.
  4. Select the authorization you would like to use. If you haven't added an authoraization yet, click on + Add new authorization. See Localytics Authorization for more details.
  5. Configure the workflow
    • ProfileDB ID - required: enter the Localytics Profile DB ID to pull profile data from. See Localytics documentation for details.
    • Profile Changes: If checked profiles will be continuously import. Uncheck to run a one-time profile import. localytics import profile
  6. Click Start Import to start the workflow.
  7. Activity data should appear in the localytics_profile stream in the Data Streams section of Lytics within an hour, and the mapped user fields above will be added to the user profiles as new profile data is imported.