linkDownloadFileTypes
When trackDownloadLinks (AppMeasurement) or clickCollectionEnabled (Web SDK) is enabled and a visitor clicks on a link, AppMeasurement checks the URL of the link for filetype extensions. If the link URL contains a matching filetype, a download link image request is automatically sent.
Use linkDownloadFileTypes to customize what file extensions you want to count as download links.
- File downloads that start automatically when a page loads
- Downloads that trigger after a redirect
- Right-clicking and selecting ‘Save Target As…’
- Links that use JavaScript, such as
javascript:openLink()
link tracking call.If a clicked link matches both exit link and download link criteria, the download link type takes priority.
Download link qualifier using the Web SDK extension
The Download link qualifier text field uses regex to determine if a clicked link qualifies to be a download link.
- Log in to Adobe Experience Platform Data Collection using your AdobeID credentials.
- Click the desired tag property.
- Go to the Extensions tab, then click the Configure button under Adobe Experience Platform Web SDK.
- Under Data Collection, set the desired value in the Download link qualifier text field.
Download link qualifier manually implementing the Web SDK
Configure the SDK using downloadLinkQualifier. The field uses regex on the clicked URL to determine if it is a valid download link. If downloadLinkQualifier is not defined, the default value is set to \\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$.
alloy("configure", {
"downloadLinkQualifier": "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"
});
Download Extensions using the Adobe Analytics extension
Download Extensions is a list of file extensions with a field to add more under the Link Tracking accordion when configuring the Adobe Analytics extension.
- Log in to Adobe Experience Platform Data Collection using your AdobeID credentials.
- Click the desired tag property.
- Go to the Extensions tab, then click the Configure button under Adobe Analytics.
- Expand the Link Tracking accordion, which reveals the Download Extensions field.
Add file extensions to the list by entering text in the field and clicking Add. Remove file extensions from the list by clicking their respective ‘X’ icon.
s.linkDownloadFileTypes in AppMeasurement and the Analytics extension custom code editor
The s.linkDownloadFileTypes variable is a string of comma-separated file extensions. Do not use spaces.
If this variable is not defined, automatic download link tracking does not work (even if trackDownloadLinks is true).
s.linkDownloadFileTypes = "doc,docx,eps,jpg,png,svg,xls,ppt,pptx,pdf,xlsx,tab,csv,zip,txt,vsd,vxd,xml,js,css,rar,exe,wma,mov,avi,wmv,mp3,wav,m4v";