Date: Thu, 28 Mar 2024 11:58:34 +0000 (UTC) Message-ID: <699824251.49.1711627114666@efc713f5669c> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_48_524703473.1711627114665" ------=_Part_48_524703473.1711627114665 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Before you start
Transmitting a click ID in the conversion tag allows tracking and attrib= ution even without cookies or in case no cookie is found or available.
The idea is to transmit an ID when a user clicks is redirected to a shop= or a web site. This ID then is saved by the shop/website, for example in a= first party cookie or in the database. When the conversion is called, it i= s transmitted in the conversion tag.
For the ID you can use the default Ingenious click ID. The possibility e= xists to use custom click IDs as well, e.g., if you want to use existing ID= s that you have in your system. The next two sections explain both variants= .
The default click ID is automatically generated by the Ingenious Platfor= m and assigned to the click. Usually, Ingenious adds a click id automa= tically to every (bounce) tracking link, so you do not need to do anything.= The name of the Ingenious click id is ICLID. It looks like this (example)<= /p>
https:/= /www.shop.com/?iclid=3D#{ICLID}
where #{ICLID}
will obviously be replaced by the click id.<=
/p>
Exception: Manual configuration
In (usually very rare) cases, where you need to set up the transmission = of the click id manually (for example if a certain specific parameter is ne= eded, you may do the set up manually. The automatically generated parameter= ICLID is not added by default in this case.
The click ID will be transmitted as query parameter in the URL with ever= y click. This happens with the use of the additional parameter tool.
You reach this page by clicking on =E2=80=98manage advertis=
er=E2=80=99 in the advertiser section main navigation menu. On the=
page with the overview of all the advertisers on your platform,
Start to create a new parameter by clicking on the icon. If you do = so, three new fields will appear under the columns =E2=80=98parameter name= =E2=80=99, =E2=80=98value type=E2=80=99 and =E2=80=98value=E2=80=99.
Under =E2=80=98parameter name=E2=80=99 fill in the parameter name the sy= stem via which you will trigger the conversion tag requires.
Under =E2=80=98value type=E2=80=99, select =E2=80=98dynamic=E2=80=99.
Under =E2=80=98value=E2=80=99 select =E2=80=98click ID=E2=80=99.
When you are done, scroll down the page and click on the button =E2=80= =98save=E2=80=99 in the right lower corner.
Example result: https://yourshop= domain.com/?clicklid=3D#{CLICK_ID}
read more here: Addit= ional parameters
In some cases it can be useful to transmit an Ingenious ID with ad impre=
ssion redirects. You can use the placeholder #{ICLID}
on any r=
edirect target: trg=3Dhttps%3A%2F%2Fyourshop.com%2Fhtlp.html%3Ficlid%=
3D%23%7BICLID%7D
You can provide such ad impression ID on conversions the same way as the= click one. The background system will automatically add the corresponding = ad impression touchpoint to the user journey and process it according to th= e attribution rules.
read more here: Post View Tracking with a High Traffic = Landing Page (HTLP)
The default click ID is automatically generated by the Ingenious Platfor= m. However you can also assign a custom click ID. A custom click ID could b= e an existing Click ID of your own system or the ID of a tool that you use.= To assign a custom click ID to a click, you need to pass your click ID in = the form of a query parameter with the click tracking request.
Make sure you have a query parameter name for custom click ID tracking c= onfigured for your Platform. If you do not have it yet, please contact our = Customer Success team.
To add a click ID, place an ampersand sign (&) at the end of the tra= cking URL and use your query parameter name as the name of the parameter. S= ubsequently, add the equal sign (=3D) and the value you want to use. See th= is example of a click tracking URL with a click ID:
https:/= /track.example.com/ts/i3621155/tsc?amc=3Daff.demonet.2209.5310.5173&YOU= R_PARAMETER_NAME=3D00edacd8-74d1-11ea-bc55-0242ac130003
The platform will store the custom click ID with the click. This enables= you to pass this ID with a conversion to connect the click with the conver= sion.
If you need to transmit your custom click ID to the shop, please configu= re it in the Additional Parameter Settings of the advertiser.
The shop/ website reads the clickID from the URL and saves it either in = a first party cookie or a database.
When saving it in a cookie we recommend to to this server side (e.g. wit= h PHP).
Then, before executing the conversion tag, the click ID needs to be fetc= hed from the cookie/ the data base so that it can be transmitted in the con= version tag.
Code example PHP: Set cookie with clickID server side
<?php= =20 if(isset($_GET["clickid"])) {=20 setcookie("clickid", $_GET["clickid"], time() + 365*24*60*60)= ; } ?>
Code example Javascript: Set cookie with clickID browser side
<htm= l> <head> </head> <body> <div id=3D"mydiv">Hello, this a Test Page</div> <script> function setCookie(cname, cvalue, exdays) { var d =3D new Date(); d.setTime(d.getTime() + (exdays *= 24 * 60 * 60 * 1000)); var expires =3D "expires=3D" + d.= toUTCString(); document.cookie =3D cname + "=3D"= + cvalue + ";" + expires + ";path=3D/"; } function getCookie(cname) { var name =3D cname + "=3D"; var decodedCookie =3D decodeURICo= mponent(document.cookie); var ca =3D decodedCookie.split(';= '); for (var i =3D 0; i < ca.lengt= h; i++) { var c =3D ca[i]; while (c.charAt(0) = =3D=3D ' ') { c =3D= c.substring(1); } if (c.indexOf(name)= =3D=3D 0) { retur= n c.substring(name.length, c.length); } } return ""; } function saveClickId(qparam) { //Get ClickID and save to Cookie var urlParams =3D new URLSearchPa= rams(window.location.search); if (urlParams.has(qparam)) { var cli =3D urlPara= ms.get(qparam); setCookie(qparam, c= li, 60); } } (function () { //read new value with name clicki= d saveClickId('clickid'); //show value in Browser var para =3D document.createEleme= nt("P"); var t =3D document.createTextNode= ("This is the ID: " + getCookie('clickid')); para.appendChild(t); document.getElementById("mydiv").= appendChild(para); })(); </script> </body> </hmtl>
Code example PHP: Fetch clickID from cookie server side
<?php= =20 if(isset($_COOKIE["clickid"])) {=20 $clickid =3D $_COOKIE["clickid"];=20 } ?>
Code example Javascript: Fetch the clickID from cookie browser side
<scrip= t>=20 function getCookie(cname) { var name =3D cname + "=3D"; var ca =3D document.cookie.split(= ";"); for (var i =3D 0; i < ca.length; i++) { var c =3D ca[i]; while (c.charAt(0) =3D=3D " ")= { c =3D c.substring(1); } if (c.indexOf(name) =3D=3D 0) { return c.substring(name.length, c= .length); } } return ""; } var clickid =3D getCookie("clickid");=20 </script>
When implementing the conversion tag, add all the parameters you need. M= ake sure, that the click ID that you fetched from the cookie is transm= itted. This happens with the parameter =E2=80=98clickId=E2=80=99 when you u= se the Javascript code or with =E2=80=98cli=E2=80=99 when you use the image= pixel or server to server callback URL.
Further reading on how to implement the conversion tag: