Event Reference (v1) / File Events

File View file_view

When a user views a file.

In most situations, you won't be able to measure a file view - unless it is embedded into a page via a viewer or iframe.

  • Name
    Event Name Required
    Value
    event: file_view

File Properties

These properties apply to all file_* events.

  • Name
    File Name Required
    Type
    file_name: string
    Description

    The name of the file (including the file extension).

    E.g.
    YYYY-MM-DD_eBook-GA4-Audience-Cheat-Sheet.pdf
  • Name
    File Extension Optional
    Type
    file_extension: string
    Description

    The file extension of the file. This can be useful for sites with many types of downloadable files.

    E.g.
    pdf

© 2026 Level Agency.