{"title":"File Download","description":"When a user clicks a link leading to a file (with a common file extension).","type":"object","_alerts":[{"variant":"warning","message":"GA4 implements this event as part of its \"Enhanced Measurement\" feature. It is generally recommended to use Google Tag Manager to manage event flow and data collection. As such, we recommend disabling this event inside your Enhanced Measurement settings."},{"variant":"note","message":"The easiest way to implement this event is to use a Google Tag Manager and create a trigger for clicks on links that contain a common file extension (e.g., .pdf, .docx, .xlsx)."}],"allOf":[{"properties":{"event":{"title":"Event Name","const":"file_download"}},"required":["event"]},{"title":"File Properties","description":"These properties apply to all `file_*` events.","type":"object","definitions":{"file_name":{"type":"string","title":"File Name","description":"The name of the file (including the file extension).","example":"YYYY-MM-DD_eBook-GA4-Audience-Cheat-Sheet.pdf"},"file_extension":{"type":"string","title":"File Extension","description":"The file extension of the file. This can be useful for sites with many types of downloadable files.","example":"pdf"}},"required":["file_name"]},{"title":"Link Properties","description":"These properties apply to many `*_click` events.","type":"object","definitions":{"link_url":{"type":"string","title":"Link URL","description":"The `href` attribute of the link that was clicked. The value should be a fully qualified URL.","example":"https:\/\/www.level.agency\/contact\/#form"},"link_domain":{"type":"string","title":"Link Domain","description":"The hostname of the link that was clicked. This can be useful for grouping links by domain.","example":"www.level.agency"},"link_path":{"type":"string","title":"Link Path","description":"The path of the link that was clicked. This can be useful for grouping links by path.","example":"\/contact\/"},"link_fragment":{"type":"string","title":"Link Fragment","description":"The fragment identifier of the link that was clicked. This can be useful for analyzing clicks on anchor links that point to a specific section of a page.","example":"form"},"link_text":{"type":"string","title":"Link Text","description":"The text (innerText) of the link that was clicked. It's recommended to lowercase this value for easier analysis.","example":"Contact Us"},"outbound":{"type":"boolean","title":"Outbound Link","description":"A boolean value indicating if the link is an outbound link (i.e. it goes to a different domain).","example":false}},"required":["link_url","link_domain","link_path","link_fragment","link_text"]}]}