Marketplace Integration
At Kahuna we want to make sure that you are able to take advantage of one of the most powerful data resources available. To make sure that happens Kahuna has a pre-defined integration that we ask all customers to follow.
This integration is additional to the regular Kahuna integration you would normally perform in order to send and track messaging within Kahuna
The Kahuna marketplace integration, using our data format, is required in order to take advantage of all of Kahuna’s marketplace tools but you may integrate as much as is available.*
Credentials
Login credentials are unique identifiers that a Marketplace uses to uniquely identify its users. You may also create the same value as an attribute on the user for targeting purposes. Each credential is required to be a unique ID to every individual user.
Credential Type |
Definition |
Example |
---|---|---|
username (string) |
The login identity for your platform |
bigseller123 |
user_id (string) |
The ID number your platform assigns to a user |
534982 |
email (string) |
Email used for login |
user@kahuna.com |
id (string) |
A unique identifier (kahuna made?) |
534982 |
User Attributes
User attributes are details that define each individual user on your platform. That should be descriptions that don’t change often and help you uniquely identify them. (First Name, Gender, Location).
Kahuna will use the attributes of your users to develop powerful user dashboards that not only provide insight into the demographics of your property but also performance and history of specified demographics (specified by customer) over time.
Attribute |
Definition |
Example |
---|---|---|
first_name (string) |
First name of the user |
john, maria |
last_name (string) |
Last name of the user |
smith, jones |
username (string) |
The login identity for your platform |
bigseller123 |
user_id (string) |
The ID number your platform assigns to a user |
534982 |
join_date (date) |
The date the user signs up for your marketplace (ISO 8601 format) |
2018-09-05 |
gender (string) |
The designated gender of your user |
male, female, undecided |
birth_date (date) |
The date of birth for the user |
1985-01-10 |
buyer_flag* (string) |
Has the user been identified as a buyer
|
true |
seller_flag* (string) |
Has the user been identified as a seller
|
true |
city (string) |
Current city location of user |
New York, Paris |
country (string) |
Current country of your user |
US, Singapore, Italy |
rating (number) |
The rating given to your user by other users
|
1, 3 |
followers (number) |
How many users are following this seller/buyer |
500 |
view(s) (number) |
How many users have viewed this users profile |
2398 |
email (string) |
The email address (credential) for this user |
emailme@kahuna.com |
Events and Properties
Events are any action that a user can take anywhere within your property. Whether that be on your mobile application, your website or non-direct actions tracked through your servers (API).
In order to take advantage of Marketplace tools, it is REQUIRED that all the following events and their associated properties be integrated AND formatted exactly as requested below.
If the integration does not follow the below formats exactly Kahuna can not guarantee that it’s marketplace tools will deliver accurate or detailed information.
The Kahuna SDK provides helper classes that are superclasses of the EventBuilder class.
Comments