Integration guide for the Splicky Action Tracking

Integration guide for the
Splicky Action Tracking
Jaduda GmbH
Version 2.0 – June 2nd, 2016
Titel – Behelfszeile | Autor | Datum
Splicky Action Tracking
ATTENTION!!! This documentation refers to the „Splicky Action Tracking“ only.
Splicky Action Tracking
Use “Splicky Action Tracking” if you are not measuring the performance of your campaign with one of the
integrated providers (MAT/Tune, AdX Tracking, Sponsormob, AdEven, Kochava, Oplytic).
Activate the Splicky Action Tracking for your campaign
Please find the section called „Tracking” on campaign level and select „Splicky Tracking“.
It is your responsibility to ensure that you are using the correct links and the tracking is integrated on your target
url / in your app.
Splicky Action Tracking
Section„Tracking“ on campaign level
Splicky Action Tracking
Splicky offers two tracking methods
Client side pixel tracking
• Easy to set up
Server-2-Server tracking
• Usually requires IT support on the
customer‘s side
• Only in mobile web
• More reliable than client side pixel
tracking
• Works with doubleclick floodlight
TAGs
Splicky Action Tracking
Glossary
Glossary
Action:
A single action ( action = event = conversion ) you want to track. Each action requires a name and an Action
Category.
l
l
Action Group:
Multiple actions can be assembled into an Action Group. Action Groups allow you to track the same Actions over
different campaign by selecting the same Action Group.
l
l
Action Category:
When creating an Action you have to select the Action Category this Action belongs to. This assignment is used
for reporting and optimization purposes. While you can only access your own Action Groups, all Action Categories
are shared among all Splicky customers
l
l
Splicky Action Tracking
Client side pixel tracking
Client side pixel tracking
The client side pixel tracking uses client side cookies to attribute actions to the correct clicks. It is done in two
simple steps:
1. Create an Action Group and Actions in the Splicky User Interface
2. Place the code for these Actions on your website where they should be fired
Splicky Action Tracking
Client side pixel tracking
Step 1 – Create an Action Group and Actions in the Splicky User Interface
In order to create a Splicky Tracking Action open the „Tracking“ section on the campaign level. You can either
choose an existing Action Group or click the „Create“ button to create a new one.
l
Within that Action Group create as many Actions as you need and assign a name, an action category and hit
„Save“.
l
!!! You can only track actions in Splicky if you select the associated Action Group in your campaign !!!
l
Splicky Action Tracking
Client side pixel tracking
Step 2 – Place the code for these Actions on your website
Pull the code for each action by clicking on „Code“. A popup will open with your client side pixel. Per
default it is already wrapped into a HTML image tag for easy copy and paste.
l
Place this code on your website on the page where your action takes place.
l
l
Splicky Action Tracking
Server-2-Server Tracking
Server-2-Server Action Tracking
Differs from client side pixel tracking by the absence of cookie tracking capabilities. Therefor you need to append a
click-id to the Splicky tracking url in order for Splicky to track Actions.
Splicky will provide this click-id within the creative‘s click url. You will then have to place this click-id in the Splicky
tracking url. Usually this requires IT support on your side.
The detailed steps are:
1. Add the click-id macro in your creative‘s click url
2. Create an Action Group and at least one Action
3. Set up the Splicky Action Tracking on your server
Splicky Action Tracking
Server-2-Server Tracking
Step 1 - Add the click-id in your creative’s click url in the Splicky Interface
This is how your URL might look like:
http://lp.advertiser.com or
https://lp.advertiser.com
Now insert the Splicky click macro (S_CLICK_ID):
http://lp.advertiser.com?yourclickparameter=(S_CLICK_ID) or
https://lp.advertiser.com?yourclickparameter=(S_CLICK_ID)
When the link is clicked, the macro will be
replaced with the unique ID, e.g.:
http://lp.advertiser.com?yourclickparameter=13259834458797218 or
https://lp.advertiser.com?yourclickparameter=13259834458797218
Based on this click ID we register all successful Actions.
Splicky Action Tracking
Server-2-Server Tracking
Step 2 – Create an Action Group and Actions in the Splicky User Interface
This step is the same as for client side pixel tracking. You can use the same Actions for client side pixel tracking
and Server-2-Server tracking. You just need to pull different tracking urls.
l
In order to create a Splicky Tracking Action open the „Tracking“ section on the campaign level. You can either
choose an existing Action Group or click the „Create“ button to create a new one.
l
Within that Action Group create as many Actions as you need and assign a name, an action category and hit
„Save“.
l
!!! You can only track actions in Splicky if you select the associated Action Group in your campaign !!!
l
Splicky Action Tracking
Server-2-Server Tracking
Step 3 - Set up the Splicky conversion tracking on your server
l
Pull the tracking url for each Action by clicking on the respective “Code” button. A popup will open with the client-side
pixel for this action. Click on “Server-side” in order to get the tracking url for this Action. This url contains a
placeholder:
<Splicky Click ID>
You need to replace this placeholder by the click id we place in your tracking url. (see Step 1 - Add the click-id in your
creative’s click url in the Splicky Interface
Base transaction URL
example:
https://t.splicky.com/transaction?p=5&tt=904&ts=49&clickid=<Splicky Click Id>
Its mandatory to replace the <Splick Click Id> placeholder by the click id Splicky put in the creative‘s tracking
url by substituting the (S_CLICK_ID) macro (click-id macro).
Splicky Action Tracking
Server-2-Server Tracking
Step 3 cont’d. - Set up the Splicky conversion tracking on your server
l
Optional parameters:
turnover
currency
created_at
advertiser order value
advertiser order currency, ISO format: EUR, USD, CAD, AUD, CHF, GBP only!!!
timestamp (date, time) Format: <URL ENCODED YYYY-MM-DD HH:mm:SS >
Example for advertiser reporting conversion:
http://t.splicky.com/transaction?p=5&clickid=13294833836222343&turnover=0.30&currency=EUR&created_at=2013-11-23+08%3A20%3A40
Important!
The tracking url must be triggered when an Action is generated.
Please make sure this is integrated at the right page; e.g. the confirmation page.
Splicky Action Tracking
Testing
Testing / Previewing
You can preview and test the tracking of your creative by hovering over the „Testing“ link in the ad overview:
You can either click on the „Cthe lick here“, Scan
the QR Code or copy and paste provided link into a
browser in order to see a preview and test
impression, click and action tracking.
The described testing method is only available for Banners, HTML-Tags and native ads. For VAST tests, please
contact our support. The native ad preview is just an example representation. The actual representation differs from
traffic source to traffic source
If you opted to have test impressions, clicks and actions appear in the Smooth Reporting, please be aware that there
can be a delay of 30 minutes. The feedback on the preview page will be immediate.
Splicky Action Tracking
Testing
Testing / Previewing cont’d.
By clicking on the creatives „Click here“, using the QR Code or opening the provided url in a browser manually, you will
see a preview of your ad. Also you will see a status, if impressions, clicks and actions have been tracked successfully.
For impressions and clicks we will
periodically check for one minute if we
did track those events successfully.
We ask you to check the status for
Actions manually by clicking in the
respective field.