gliechtenstein / JasonSEGAnalyticsAction

segment.io extension for Jasonette

JasonSEGAnalyticsAction for iOS

Jasonette extension for integrating segment.io

See the Android version here

Setup

1. Install the extension using Jason Extension Manager
2. Get an API key from segment.io
3. From your XCode project, open segment.plist. Add your API key to the key property.

Usage

1. Identifying Users

Implements identify

{
    “type”: “$segment.identify”,
    “options”: {
        “id”: “…”,
        “traits”: {…}
    }
}

2. Tracking Events

Implements tracking

{
    “type”: “$segment.track”,
    “options”: {
        “event”: “…”,
        “properties”: {
        }
    }
}

Note

All $segment actions propagates the return value from its previous action onto the next action.

For example, take a look at this example:

{
	"type": "$network.request",
	"options": {
		"url": "https://www.jasonbase.com/things/n3s.json"
	},
	"success": {
		"type": "$segment.track",
		"options": {
			"event": "response",
		  	"properties": {
				"json": "{{$jason}}"
			}
		},
		"success": {
			"type": "$render"
		}
	}
}

Above works the same as the following JSON (Except that the results are sent to segment.io between network.request and render)

{
	"type": "$network.request",
	"options": {
		"url": "https://www.jasonbase.com/things/n3s.json"
	},
	"success": {
		"type": "$render"
	}
}

This is because the $segment.track action propagates the $jason object from $network.request onto the next action ($render)