Kiip Connector Setup Guide

[#1]

Kiip is an in-app mobile advertising platform that uses moments to create meaningful customer interactions and generate highly targeted, custom audiences.

This article describes how to set up the Kiip connector in your Customer Data Hub account.

In this article:

Table of Contents Placeholder

Connector Actions

Action Name	AudienceStream	EventStream
Start/End a Session	✗	✓
Record a Moment	✗	✓

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

• App Key: Kiip application key found in the dashboard.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Start/End a Session

Parameters

Parameter	Description
Event ID	Should be either ‘session_start’ or ‘session_end’ depending whether the user opens or closes the app. For information, see: https://docs.kiip.me/en/sdk/server.html#session-endpoint.
Device ID	The ADID or Identifier.
Device IP	A valid IP address provided by device
Device Operating System	This should always include a version number.
Device Density	The screen density.
Device Locale	The user’s setting for locale.
Device Language	The default language on the device.
Device Model	The model of the device.
Device Resolution	The resolution of the device.
Device Manufacturer	The manufacturer of the device.
Device User Agent	The device user agent.
App Version	The current client version number.
Carrier	Example: ATT.
Connection Type	Example: WIFI.
SDK Version
User Age
User Gender	Example values: m or f.
User ID	A string containing a user’s ID for use in virtual currency rewards.
Latitude	This is always a number between -90 and 90.
Longitude	This is always a number between -180 and 180.
Close Button	By default, a close button is shown when rewards are earned. When set to 0 or false, can be used to hide the close reward button.
Email Address	When supplied with an email address, this component will be used to prefill a user’s email address when a reward is earned.
Timstamp	ISO 8601 formatted timestamp of the action. Defaults to time connector is triggered.

Action - Record a Moment

Parameters

Parameter	Description
Moment ID	The UUID associated with the a given moment from the Kiip dashboard. For information, see: http://docs.kiip.me/en/sdk/server.html#moment-endpoint
Device ID	The ADID or Identifier.
Device IP	A valid IP address provided by device.
Device Operating System	This should always include a version number.
Device Density	The screen density.
Device Locale	The user’s setting for locale.
Device Language
Device Model
Device Resolution
Device Manufacturer
Device User Agent
App Version	The current client version number.
Carrier	Example: ATT.
Connection Type	Example: WIFI.
SDK Version
User Age
User Gender	Example values: m or f
User ID	A string containing a user’s ID for use in virtual currency rewards.
Latitude	This is always a number between -90 and 90.
Longitude	This is always a number between -180 and 180.
Close Button	By default, a close button is shown when rewards are earned. When set to 0 or false, can be used to hide the close reward button.
Email Address	When supplied with an email address, this component will be used to prefill a user’s email address when a reward is earned.