Follow

Marketplace Integration

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
2018-09-05T21:56:04

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

  • If you do not pre-define a user as a “buyer” by saying true, then Kahuna will automatically add the flag if/when they make their first purchase

true

seller_flag* (string)

Has the user been identified as a seller

  • If you do not pre-define a user as a “seller” by saying true, then Kahuna will automatically add the flag if/when they make their first listing

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

  • Anytime the users rating changes you will need to send the new rating score.  Kahuna will NOT update this score automatically

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.

AddListingEventBuilder

EditListingEventBuilder

RemoveListingEventBuilder

PurchaseListingEventBuilder

MakeOfferListingEventBuilder

BidListingEventBuilder

AddToCartListingEventBuilder

RemoveFromCartListingEventBuilder

ViewListingEventBuilder

WatchListingEventBuilder

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments