APIs

Kissmetrics provides an official API for several languages. For most users we recommend using the JavaScript Library. Please also consider using our other ways of sending us data, as we are including direct integrations with several platforms like Mailchimp, Recurly, and your own MySQL database.

• Core API (in beta)

  Work with your Kissmetrics data via our core API.

• iOS SDK v2

  Our official iOS SDK is currently at v2.

• Android SDK

  Our official Android SDK is currently at v2.1.0.

• Data Out API

  Fetch the results of people searches using our Data Out API endpoint.

• API Specifications

  Here's how our Simple Person-Based REST-like API works, on top of which all of our language libraries are built.

• Common Methods

  All of our libraries provide the same basic methods - record, set, identify and alias, which are described in more detail here.

• JavaScript Library

  Our JavaScript Library is our most full-featured library and is what we recommend for most users.

• Ruby Library

  Information about our Ruby library.

• PHP Library

  Information about our PHP library.

• Python Library

  Information about our Python library.

• Objective-C (iOS) Library

  Information about our basic Objective-C/Cocoa library, for iOS and OS X apps.

• URL API

  The URL API is used to tag links that point to your site.

• Other 3rd-Party Libraries

  Information on other programming languages and 3rd-party libraries.

• Beacon API

  The Beacon is primarily used for tracking email or ad impressions, or in cases where you do not have access to JavaScript or other server-side languages.

• Data Export

  Export a copy of all data you pass to Kissmetrics.

• Sending Data with Cron

  Our Ruby and PHP libraries allow you to record events to a log, and then periodically push these logs to our tracking servers asynchronously. Here is how to set up these server-side libraries to work with `cron`.

• JavaScript Library - Running an A/B Test with KM.ab

  The Kissmetrics JavaScript Library provides a JS function to help you set up the A/B test. It does the three things every A/B test needs, all in one fell swoop. However, it requires you to edit some JavaScript on your site, though. Read here for some examples.

• Can I use the JavaScript Library on multiple domains?

  Do your customers land on several domains when interacting with your website? Here's what you need to know.

• Installing Kissmetrics through Google Tag Manager

  Here's how to load the Kissmetrics JavaScript library through Google Tag Manager.

• JavaScript Library - Creating Whole Page A/B Tests

  Learn how to track two completely different page designs not just changes in individual elements.

• JavaScript Library - Using Weighted Variants

  Learn how to use weighted variants to more finely control experiments.

• Ruby on Rails

  Here are two different methods of setting up Kissmetrics in your Ruby on Rails application.

• Using the Python Library with Google App Engine

  Note about using the Python Library with Google App Engine.

• Form Fields We Do Not Track

  We won't record passwords, hidden, textarea fields as well as sensitive fields, like credit card numbers and social security numbers.

• Developing in localhost

  Don't use Kissmetrics with `localhost` as your development environment; provide a custom domain name to set your cookies.

• JavaScript Settings

  JavaScript settings let you adjust what our JavaScript library can do automatically for you.

• Reusing the Identities Set by the JavaScript Library

  Our JavaScript library generates customer identities. You can obtain these identities to use them with our server-side libraries or URL API.

• Hosting the JavaScript Library Yourself

  We recommend you do not host the JavaScript yourself, but here are the considerations if you decide to.

• Heroku

  Considerations when setting up Kissmetrics for your Heroku application.

• Data Export Setup

  Set up your Kissmetrics account to receive data from our Data Export feature.