Embedding KinturaJS: More than just a landing pixel
Basic Usage (Copy and Paste)
KinturaJS is simply pasted into your Landing Page HTML just like you would do with Google Analytics' tracking code or Facebook's tracking pixel. Because of this you will need to host your own landing page and make sure that Landing Page is in a Route attached to your Campaign in Kintura. Even though we aren't redirecting to the Landing Page via the Kintura Campaign URL, we need a landing page to assign attribution during a conversion! Otherwise what's the point, right?
- Note the URL of your landing page (even if it's not uploaded to your web server)
- Create a Landing Page in Kintura under Landing Pages > Create Landing Page
- In your Kintura Campaign, make sure that the Landing Page is used in a Route attached to the Campaign (either a default or filtered route)
- In the Kintura Campaign editor click "Links & Code"
- You will see No-redirect Tracking and have the ability to "Copy KinturaJS for this lander"
- Copy the code and paste it into your landing page as instructed
- Save your landing page and upload it to your server
- Also take note of your no-redirect tracking url which is also under Links & Code > No-redirect Tracking
What are the /out or /click links?
These are automatically detected by KinturaJS. What is most important is that you always use the same tracking domain in the "account" setting in KinturaJS code as you do in your landing page's /out links. KinturaJS even has the added benefit of automatically appending a fallback "cid" to the /out links in case cookies aren't supported. As with any tracker, no active session means that the /out links will not work as the offer redirection is determined at the time of the click. So be sure to enter your landing page through the new special no-redirect Landing Page URL under Links & Code.
What about my custom tracking variables from the traffic source?
This is a common point of confusion! You're now giving your traffic source a URL directly to your landing page on your web server rather than using your Kintura Campaign URL to redirect! It is very important to make sure you aren't using both the Campaign URL AND the KinturaJS landing code because they will double-log the Landing Page visit. When using the simple implementation above, you will notice that your campaign identifier is now being passed in a query string parameter named kin_campaign_guid. Now, whenever you use this lander, make sure you're giving the traffic source the direct link along with the kin_campaign_guid parameter. Your traffic source variables are automatically added for you under the Links & Code tab.Advanced Usage
KinturaJS allows you to fire almost any event through the API as well as your own custom events.
Special Kintura Events
Firing Landing Page visits and clicks is done using the "landing" and "offer" events.
In order to tracking a Landing Page visit with KinturaJS, please be sure to include that Landing Page in a route even though you're not using Landing Page redirection via the Campaign /in link. It's important for attribution at this time.