Analytics-Kotlin Migration Guide

1
	    val analytics = Analytics("YOUR_WRITE_KEY", context) {
2
        trackApplicationLifecycleEvents = true
3
    }

1
    // Initialize an Analytics object with the Kotlin Analytics method
2
    Analytics androidAnalytics = AndroidAnalyticsKt.Analytics("YOUR_WRITE_KEY", context, configuration -> {
3
        configuration.setTrackApplicationLifecycleEvents(true);
4
        return Unit.INSTANCE;
5
        }
6
    );
7

8
    // Wrap the object with JavaAnalytics for Java Compatibility.
9
    // You can also choose not to wrap the object, but some of the Analytics methods may not be accessible.
10
    JavaAnalytics analytics = new JavaAnalytics(androidAnalytics);   

1
    builder
2
        .useSourceMiddleware(new Middleware() {
3
            @Override
4
            public void intercept(Chain chain) {
5
            // Get the payload.
6
            BasePayload payload = chain.payload();
7

8
            // Set the device year class on the context object.
9
            int year = YearClass.get(getApplicationContext());
10
            Map<String, Object> context = new LinkedHashMap<>(payload.context());
11
            context.put("device_year_class", year);
12

13
            // Build our new payload.
14
            BasePayload newPayload = payload.toBuilder()
15
                .context(context)
16
                .build();
17

18
            // Continue with the new payload.
19
            chain.proceed(newPayload);
20
           }
21
        })

1
      builder
2
   .useSourceMiddleware(
3
     Middleware { chain ->
4
         // Get the payload.
5
         val payload = chain.payload()
6

7
         // Set the device year class on the context object.
8
         val year = YearClass.get(getApplicationContext())
9
         val context = LinkedHashMap<String, Object>(payload.context())
10
         context.put("device_year_class", year)
11

12
         // Build our new payload.
13
         val newPayload = payload.toBuilder()
14
               .context(context)
15
               .build();
16

17
         // Continue with the new payload.
18
         chain.proceed(newPayload)
19
     })

1
  analytics.add(new Plugin() {
2
     private Analytics analytics;
3

4
     @Override
5
     public BaseEvent execute(@NonNull BaseEvent event) {
6
         // Set the device year class on the context object.
7
         int year = YearClass.get(getApplicationContext());
8
         EventTransformer.putInContext(event, "device_year_class", year);
9
         return event;
10
     }
11

12
     @Override
13
     public void setup(@NonNull Analytics analytics) {
14
         setAnalytics(analytics);
15
     }
16

17
     @NonNull
18
     @Override
19
     public Type getType() {
20
         return Plugin.Type.Enrichment;
21
     }
22

23
     @NonNull
24
     @Override
25
     public Analytics getAnalytics() {
26
         return analytics;
27
     }
28

29
     @Override
30
     public void setAnalytics(@NonNull Analytics analytics) {
31
         this.analytics = analytics;
32
     }
33
  });

1
    analytics.add(object: Plugin {
2
        override lateinit var analytics: Analytics
3
        override val type = Plugin.Type.Enrichment
4

5
        override fun execute(event: BaseEvent): BaseEvent? {
6
         // Set the device year class on the context object.
7
            val year = YearClass.get(getApplicationContext())
8
            event.context = updateJsonObject(event.context) {
9
             it["device_year_class"] = year
10
        }
11
        return event
12
     }
13
 })

1
      builder
2
   .useDestinationMiddleware("Segment.io", new Middleware() {
3
       @Override
4
       public void intercept(Chain chain) {
5
         // Get the payload.
6
         BasePayload payload = chain.payload();
7

8
         // Set the device year class on the context object.
9
         int year = YearClass.get(getApplicationContext());
10
         Map<String, Object> context = new LinkedHashMap<>(payload.context());
11
         context.put("device_year_class", year);
12

13
         // Build our new payload.
14
         BasePayload newPayload = payload.toBuilder()
15
             .context(context)
16
             .build();
17

18
         // Continue with the new payload.
19
         chain.proceed(newPayload);
20
       }
21
     })

1
 builder
2
   .useDestinationMiddleware(
3
    "Segment.io",
4
    Middleware { chain ->
5
         // Get the payload.
6
         val payload = chain.payload()
7

8
         // Set the device year class on the context object.
9
         val year = YearClass.get(getApplicationContext())
10
         val context = LinkedHashMap<String, Object>(payload.context())
11
         context.put("device_year_class", year)
12

13
         // Build our new payload.
14
         val newPayload = payload.toBuilder()
15
               .context(context)
16
               .build();
17

18
         // Continue with the new payload.
19
         chain.proceed(newPayload)
20
    })

1
         SegmentDestination segmentDestination = analytics.find(SegmentDestination.class);
2

3
    segmentDestination.add(new Plugin() {
4
        private Analytics analytics;
5

6
        @Override
7
        public BaseEvent execute(@NonNull BaseEvent event) {
8
            // Set the device year class on the context object.
9
            int year = YearClass.get(getApplicationContext());
10
             EventTransformer.putInContext(event, "device_year_class", year);
11
            return event;
12
        }
13

14
        @Override
15
        public void setup(@NonNull Analytics analytics) {
16
            setAnalytics(analytics);
17
        }
18

19
        @NonNull
20
        @Override
21
        public Type getType() {
22
            return Plugin.Type.Enrichment;
23
        }
24

25
        @NonNull
26
        @Override
27
        public Analytics getAnalytics() {
28
            return analytics;
29
        }
30

31
        @Override
32
        public void setAnalytics(@NonNull Analytics analytics) {
33
            this.analytics = analytics;
34
        }
35
    });

1
    val segmentDestination: DestinationPlugin = analytics.find(SegmentDestination::class)
2

3
    segmentDestination.add(object: Plugin {
4
        override lateinit var analytics: Analytics
5
        override val type = Plugin.Type.Enrichment
6

7
        override fun execute(event: BaseEvent): BaseEvent? {
8
            // Set the device year class on the context object.
9
            val year = YearClass.get(getApplicationContext())
10
            event.context = updateJsonObject(event.context) {
11
                it["device_year_class"] = year
12
            }
13
            return event
14
        }
15
    })

1
    Map<String, Object> map = new HashMap<>();
2
    map.put("feature", "chat");
3
    Map<String, Object> miniMap = new HashMap<>();
4
    miniMap.put("colorChoice", "green");
5
    map.put("prefs", miniMap);
6
    analytics.track("UseFeature", map);;

1
    val map = HashMap<String, Any>()
2
    map.put("feature", "chat")
3
    map.put("prefs", buildJsonObject { put("colorChoice", JsonPrimitive("green")) })
4
    analytics.track("UseFeature", map)