Mobile HTTP API

Salesforce DMP ADM allows website operators to create a holistic databank to organize, taxonomize, and make the full range of audience information actionable. It allows them to model, define and manage audience segments to improve content delivery and advertising revenue.

Salesforce DMP ADM is now available to capture data and create audience profiles for mobile apps. This document is intended to describe details of the HTTP API that can be used by the app developers to send and receive data fromSalesforce DMP.

If you want to use our iOS SDK, please contact your Salesforce DMP Account Manager.

Before you start

Before you start sending or receiving data from your apps, it is important to understand the number of requests that we will receive from your app.

Based off that information, we are going to send you the following:

  • Pixel URL: This URL is used to track views in your app. Please contact your Salesforce DMP Representative to get this URL.
  • Event URL:  If you have created events in the Salesforce DMP, you can call this pixel to send data for these events. Please contact your Salesforce DMP Representative to get this URL.
  • Transaction URL:  This pixel is used to track transactions in your app. Please contact your Salesforce DMP Representative to get this URL.

Tracking of Views and sending parameters

This method is used to send view data from your apps to Salesforce DMP backend server.

All these calls should be made asynchronously and should not impact the latency and stability of the core mobile app. All data should also be sent via a queuing approach to ensure that the calls are queued up when user is not connected to the internet.

Tracking of Views helps app developers to send data based on the actions users are performing on their apps.

Salesforce DMP SDK performs all the above tasks asynchronously and sent via a queuing approach.

To send data to Salesforce DMP Servers for views, you will need the following:

Attribute Name

Value

Pixel URL

URL provided by Salesforce DMP representative to send view data.

_kpid

Publisher uuid.

Please contact Salesforce DMP Representative to get the publisher uuid.

_kcp_d

Domain.

Please contact Salesforce DMP Representative to get this value.

_kcp_s

Site.

Please contact Salesforce DMP Representative to get this value.

_kcp_sc

Section. This is the section of the app that you want to send data for.

For e.g., this could be “open_app” or “home_page”.

Also, the value for this attribute should be url encoded.

 

_kuid

Unique User Id to track the user.

For iOS, this should be the unique Advertiser Id (and not the device id)

_kpa_<page_attribute_name>

All the page attribute data that needs to be sent should be prefixed with _kpa_ prefix.

PLEASE NOTE: If you wish to pass more than one attribute value to a single attribute in the pixel call, please make sure the values are comma-separated when passing them.

_kua_<user_attribute_name>

All the user attribute data that needs to be sent should be prefixed with _kua_ prefix.

PLEASE NOTE: If you wish to pass more than one attribute value to a single attribute in the pixel call, please make sure the values are comma-separated when passing them.

A request to the pixel URL returns a 204 No Content Response.  An example of the Pixel URL might look like the following:

CLICK TO SCROLL and view entire tag

 https://beacon.krxd.net/pixel.gif?tech_browser_lang=en&_kpid=<publsher_uuid>&_kcp_d=<domain>&_kcp_s=<site>&_kcp_sc=<section>&_kuid=<uuid>&_kpa_<name>=<data>&_kua_<name>=<data>

Tracking of events and their attributes

For Tracking events, you will need the following:

Attribute Name

Value

Event URL

URL provided by Salesforce DMP representative to send event data.

_kpid

Publisher uuid.

Please contact Salesforce DMP Representative to get the publisher uuid.

_kuid

Unique User Id to track the user.

For iOS, this should be the unique Advertiser Id (and not the device id)

event_id

Uid of the Event for which the data is being sent.

<event attributes>

Event attributes along with their values. This will be different for different events and based off which attributes have been created for the event.

PLEASE NOTE: If you wish to pass more than one attribute value to a single attribute in the pixel call, please make sure the values are comma-separated when passing them.

A request to the event URL returns a 204 No Content Response.

 

Tracking of transactions and their attributes

For Tracking transactions, you will need the following:

Attribute Name

Value

Data Type

Required?

Transaction URL

URL provided by Salesforce DMP representative to send transactional data.

String

Yes

_kpid

Publisher uuid.

Please contact Salesforce DMP Representative to get the publisher uuid.

String

Yes

_kuid

Unique User Id to track the user.

For iOS, this should be the unique Advertiser Id (and not the device id)

String

Yes

quantity

The total quantity of the products purchased in the order.

Integer

Yes

price

The total order amount. 

Float

Yes

date

The transaction date

Date (yyyy-mm-dd format)

Yes

<transaction attributes>

Any additional order attributes you'd like to track (e.g. productName, productSKU) 

PLEASE NOTE: If you wish to pass more than one attribute value to a single attribute in the pixel call, please make sure the values are comma-separated when passing them.

String

No

A request to the transaction URL returns a 204 No Content Response. 

An example of the transaction URL might look like the following:

CLICK TO SCROLL and view entire tag

 https://beacon.krxd.net/transaction.gif?_kpid=<publsher_uuid&_kuid=<uuid>&quantity=2&price=43.5&date=2017-05-01&product_sku=123456&payment_method=paypal

 

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk