---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.1
alternate:
  - https://www.yandex.com/support/metrica/en/simple-goal/download.md
  - https://www.yandex.com/support/metrica/es/simple-goal/download.md
  - https://www.yandex.com/support/metrica/pt/simple-goal/download.md
  - https://www.yandex.com/support/metrica/ru/simple-goal/download.md
  - https://www.yandex.com/support/metrica/tr/simple-goal/download.md
  - href: https://www.yandex.com/support/metrica/en/simple-goal/download.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.com/support/metrica/en/llms.txt?revision=r21566194
    rel: describedby
title: Track file downloads
description: If your site contains a price list, license agreement, or other files, you can track how often users download them.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/en/llms.txt?revision=r21566194


# Track file downloads

<!-- source: en/_includes/simple-goal/click/id-click/note-auto-goal.md -->
{% note info %}

The goal is created automatically if the **Automatic goals** option is enabled in the tag settings.

You can manage these goals just like other [automatic goals](https://www.yandex.com/support/metrica/en/general/auto-goals.md).

{% endnote %}
<!-- endsource: en/_includes/simple-goal/click/id-click/note-auto-goal.md -->

If your site contains a price list, license agreement, or other files, you can track how often users download them.

To do this, you need to set a special goal in Yandex Metrica. You can create this kind of goal:

- For any file on the site. This goal will work for the most popular type files:
    
    - Document
    - Text
    - Executable file
    - Presentation
    - Applications
    - Compressed file
    - Video
    - Audio
    
    Supported extensions:
    
    <div class="borderless-table">

    #|
    ||
    3GP
    7Z
    AAC
    AVI
    APK
    CSV
    DJVU
    DOCX
    EXE
    |
    FLAC
    FLV
    GZ
    KEY
    MIDI
    MKA
    MKV
    MP3
    MP4
    |
    MPEG
    MOV
    MSI
    OGG
    PDF
    PKG
    PPS
    PPT
    PPTX
    |
    RAR
    RTF
    TXT
    WAV
    WMA
    WMV
    WMF
    XLSX
    ZIP
    ||
    |#
    
    </div>

- For a specific file. In this case, specify the name of the file with or without an extension. For example, `file` or `file.pdf`. Yandex Metrica will search for it in links.
    
    You can specify any file extension for this goal.  If you have an uncommon extension, check in the console whether the goal supports it.

    {% cut "How to check that" %}


  1. In the browser's address bar, append the `_ym_debug=2` parameter to the URL of the page that contains a download link, and then open the page in the browser.

     ```httpget
      http://example.com/?_ym_debug=2
     ```

  1. A debug panel will appear at the bottom of the page. To open it, click ![](../_assets/debug2.svg).
  1. Click the download link on the page.

  1. Information about conversions will appears in the **Console** tab.

     Everything is correct if there's a string of the following format: `File. Counter 12345. Url: https://example.com/download/price.nameshop`, where the value of `Url` is the file download link you specified when creating a goal. 

     ![alt text](../_assets/d-check.png){.border-yes}

   To learn more, see [Checking a goal](https://www.yandex.com/support/metrica/en/general/check-goal.md).


{% endcut %}

The goal is achieved when the user clicks on the link to the file. To view goal statistics, use the [Conversions report](https://www.yandex.com/support/metrica/en/reports/conversion.md) and [add the goal](https://www.yandex.com/support/metrica/en/reports/report-general.md#choose-goal) to other Yandex Metrica reports.

To create a goal manually:
1. In Yandex Metrica, go to the **Goals** page in the left menu.
1. Click **Add goal**.
1. Select the **File download** goal type.
1. In the **Name** field, enter a name for the goal to create.
1. Select which files to create a goal for. If you chose **Specific file**, manually enter the name of the file with or without an extension in the field. For example, `file` or `file.pdf`. Make sure the spelling matches.
1. Click **Add goal**. The created goal will appear in the list of goals. Yandex Metrica will start collecting statistics on it within a few minutes.
1. You can check if the goal is working in the [Conversions](https://www.yandex.com/support/metrica/en/reports/conversion.md) or [File downloads](https://www.yandex.com/support/metrica/en/content/file-downloads.md) report. If everything is correct, data should appear in these reports. To check this, perform a conversion action on the site. If the **Don't count my sessions** filter is set in the tag settings, check the goals on the site in the browser's private mode (for example, [Incognito](https://yandex.com/support/browser/personal-data-protection/incognito-mode.html) in Yandex Browser).

![alt text](../_assets/downloading-files.png =600x){.border-yes}

## Restrictions {#general}

- <!-- source: en/_includes/general/goal-page-visit/id-general/2.md -->
  The service registers a user reaching the same goal on the same counter no more than once per second.
  <!-- endsource: en/_includes/general/goal-page-visit/id-general/2.md -->
    
- <!-- source: en/_includes/general/goal-page-visit/id-general/3.md -->
  During a single user session, the service can register up to 1000 offline conversions and 400 online conversions created for the tag.
  <!-- endsource: en/_includes/general/goal-page-visit/id-general/3.md -->
    
- <!-- source: en/_includes/general/goal-page-visit/id-general/4.md -->
  If you edit the tag or a goal, all the previously collected information does not change. 
  <!-- endsource: en/_includes/general/goal-page-visit/id-general/4.md -->
    
- <!-- source: en/_includes/general/goal-page-visit/id-general/5.md -->
  If you delete a goal, information collected for it is no longer available in reports.
  <!-- endsource: en/_includes/general/goal-page-visit/id-general/5.md -->
    

## Learn more

- [How to create a report for a goal](https://www.yandex.com/support/metrica/en/reports/goals.md)
- [Revenue by goal](https://www.yandex.com/support/metrica/en/general/price-goal.md)

<!-- source: en/_includes/buttons/chat-button.md -->
[Chat with us](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->
<!-- endsource: en/_includes/buttons/chat-button.md -->

<!-- source: en/_includes/reports/texing-button.md -->
<div class="cut-button">

{% cut "Write an email" %}

{% list tabs radio %}

- No data for a particular source

  Goals in Yandex Metrica work the same way for any sources. Perhaps there aren’t any users who have completed the goal from this source yet.

  {% cut "The recommendations did not help" %}

  <!-- source: en/_includes/popup/id-popup/wrong-sup.md -->
  Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.
  <!-- endsource: en/_includes/popup/id-popup/wrong-sup.md -->

  <div style="padding: 15px;
       margin: 10px 0;
       background: #FFFFFF;
       border-radius: 10px;
       border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/1706/?&theme=Net dannyh po opredelennomu istochniku&iframe=1&lang=en">
    </iframe>
  </div> 

  {% endcut %}

- Data for a goal doesn’t match real data

  This might happen for the following reasons:
  - The goal condition in Yandex Metrica doesn't cover all the possibilities. For example, the goal is set as going to the order confirmation page, but the site also allows instant checkout without visiting this page.
  - The site user has a browser plugin that blocks the Yandex Metrica tag, so this user isn’t counted.
  - The user has an antivirus system with strict privacy settings.
  - The user has a slow internet connection, so the Yandex Metrica tag didn’t load on the target page.

  {% cut "The recommendations did not help" %}

  <!-- source: en/_includes/popup/id-popup/wrong-sup.md -->
  Please note: Our support team will never initiate a call to you. Do not follow any instructions of people who call you and introduce themselves as the Yandex Metrica support team.
  <!-- endsource: en/_includes/popup/id-popup/wrong-sup.md -->

  <div style="padding: 15px;
       margin: 10px 0;
       background: #FFFFFF;
       border-radius: 10px;
       border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/1706/?&theme=Dannye po celi otlichayutsya ot realnyh dannyh&iframe=1&lang=en">
    </iframe>
  </div> 

  {% endcut %}

- Goal doesn’t work
  
  <div style="padding: 15px;
       margin: 10px 0;
       background: #FFFFFF;
       border-radius: 10px;
       border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/10018080.618d9fdb2524ebc4674fd9e2a54cd71036f465a9/?&theme=Cel ne rabotaet&iframe=1&lang=en">
    </iframe>
  </div> 

{% endlist %}  

{% endcut %}

</div>

<!-- source: en/_includes/styles/cut-button.md -->

<!-- endsource: en/_includes/styles/cut-button.md -->
<!-- endsource: en/_includes/reports/texing-button.md -->


<!-- source: en/_includes/styles/href-to-button.md -->

<!-- endsource: en/_includes/styles/href-to-button.md -->

<!-- source: en/_includes/styles/cut-button.md -->

<!-- endsource: en/_includes/styles/cut-button.md -->

<!-- source: en/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
Useful links

- [Demo tag](https://metrica.yandex.com/r/dashboard?)
- [Add a tag](https://metrica.yandex.com/add/)
- [Free tag setup](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [Suggest your idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Discuss in Telegram](https://t.me/yandexmetrika)
|
Online training

- [Get a Yandex Metrica certificate](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)


- [Take a training course](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: en/_includes/styles/table-style.md -->

<!-- endsource: en/_includes/styles/table-style.md -->
<!-- endsource: en/_includes/footer-links.md -->

<!-- source: en/_includes/styles/table-style.md -->

<!-- endsource: en/_includes/styles/table-style.md -->