Localytics Destination

Once the Segment library is integrated with your site or app, toggle Localytics on in your Segment destinations, and add your application's App Key which you can find in your Localytics app settings. These new settings will take up to an hour to propogate to all of your existing users. For new users it'll be instanteneous!

If you are using version 1.3.0 or higher of the Segment-Localytics Android SDK, you can include a localytics.xml file in your Android project's res/values folder to define your settings. Note that any settings entered in the Segment UI will override the equivalent values defined in your localytics.xml file. You can read more about the localytics.xml file in Localytics's documentation here.

Including a settings xml file in conjunction with a Segment-Localytics iOS SDK is not yet supported.

Note: Localytics does not accept cloud-mode data, so you must use a device-mode library ( such as Analytics.js, iOS/Android or React Native), with the Localytics SDKs bundled in order to send data to Localytics.

You must also add the Maven Localytics repo (since Localytics doesn't publish it on Maven Central). You can see an example of how to add that in the @segment-integrations/analytics-android-integration-localytics repository.

When you call identify, we'll set the Localytics customer Id, and set any special Localytics traits you provide, such as name, or email, and any custom traits as well.

Whenever you call track, we'll log an event with Localytics. track takes the name of the event and any optional properties you want to associate with the event.

Push notifications on Android require a bit of extra work to setup.

• First, you need to make sure Localytics is being bundled. You can find out more information about bundled integrations in our Android documentation.
• Follow Localytics' documentation to set up the permission in your AndroidManifest.xml. Specifically, the AndroidManifest changes regarding the GcmReceiver, GcmListenerService, InstanceIDListenerServer, and PushTrackingActivity classes.
• In lieu of step four, you will register the Push receiver in your Activity or Application class within a Segment onIntegrationReady method:

1
@Override protected void onResume() {
2
    super.onResume();
3

4
     Analytics.with(this).onIntegrationReady(BundledIntegration.LOCALYTICS, new Callback() {
5
      @Override public void onIntegrationReady(Object integration) {
6
        Localytics.registerPush("YOUR-SENDER-ID");
7
      }
8
    });
9
}

Segment lets you change these destination settings from the Segment app without having to touch any code.