Third party tracking

How third party trackers work and are setup in the platform

What are they?

Thirdparty trackers can be used in cases when clients want to be able to setup custom impression, viewability or video tracking, etc., to ads we serve. We support these options by allowing third party trackers to be setup on creative level in the platform. More details on each of the types can be found below.

All third party have to comply GDPR.

If you see the message "No GDPR information detected in link", please add necessary information to the url-string to avoid issues with click tracking.

Read more about it here: https://www.adnami.io/help/gdpr-information-detected-in-link-warning 

How to add third party tracking click tracking?

  1. Add click tracking/click tag to the "Banner" tab when setting up your creative in Adnami. 
    1. Read more specifically on how to add click tracking in Adnami here: https://www.adnami.io/help/click-url-tracking-clicktag 

How to add other third party tracking?

How to add other third party trackers such as impression- and/or viewability tracking, etc.
  1. Navigate to the "Tracking" tab and click the button "Add tag"
  2. Paste your tracker string value (html tag or URL string) into the tag text field box
  3. Make necessary amendments to the tag. 
    1. Read more specifically on Impression tracking here: https://www.adnami.io/help/a-guide-to-impression-tracking-and-cachebuster 
  4. Click "Add" to implement the tracker.

 

How does third party tracking works when implemented in Adnami?

Impression

  • if <img> tag is set as tag input

    • tries to get image function and sets it to <head> element of the creative
  • if impression tag is selected and URL is pasted

    • ads image creation with given tag url as src and sets it to <head> element of the creative
  • if impression tag is selected and html tag provided

    • ads the whole html tag to top of <body> element of the creative

Moat, IAS and Other Viewability

  • If canvas format

    • extracts src value from tag, and type as either "script" or "iframe" based on tag it was in
    • structures values into type:src pairs
    • pushes these values into window.__adnamiAdsAPI.v1.ThirdPartyTrackers as formatted string
    • once all trackers are collected into a string format it prepends __adnamiAdsAPI initialisation string
    • final string is wrapped in <script> tag and prepended to <head> element of the creative
  • If banner contains <iframe

    • then it sets custom styling with opacity zero and absolute position to top left, with full width and height which makes the element invisible
    • then sets this value to <body> element of the creative
  • or else

    • sets the tag value to <body> element of the creative

Video tracking BETA

Expected input is URL for each of the types. Those URLS will be pinged using Image src tracking hack from within the creative when appropriate.
Only one of each video tag is allowed per creative! If there are duplicates frontend will disable saving, and backend will throw error.

Includes types:

  • Video Impression -> not to be confused with regular impression, this one indicates that the following video events are relating to that session
  • Video Start
  • Video First Quartile
  • Video Midpoint
  • Video Third Quartile
  • Video Complete

Processing:

  • video type is selected and the url
    • collects all the trackers with type corresponding to the selected type (VideoImpression -> videoimpression)
    • structures data to type:src
    • last three steps are the same as in "Moat, IAS and Other Viewability"
    • SPECIAL: if Canvas
      • for every banner within the canvas, set <head> tag to also have video tracking script