For each App, you need to specify what folder and file name to use. If you want Blitapp to use different folders when uploading two different captures to the same cloud (Google Drive, Dropbox, etc.), you need to create two Apps of the same type with different paths and file names.
If you were to use static paths and file names for your App, like /blit/capture.png, the files would be overridden every time capture is run. This is why you should use variables in the folder and file names. These variables are updated with the actual value every time the capture is run. These variables are split into different categories:
After the variables have been replaced with actual values, the folder and file name are "normalized": spaces and special characters are replaced with an underscore (_), etc.
<year>: 4-digit year, e.g., 2019
<month>: 2-digit month, e.g. 02
<day>: 2-digit day of the month, e.g., 09
<hour>: 2-digit hour of the day, 24-hour format, e.g., 15
<minute>: 2-digit minute, e.g. 01
<date>: same as <year>-<month>-<day>, e.g. 2019-02-09
<capture_name>: the name of the capture. The name will be normalized, so "My Capture" will become My_Capture.
<browser>: the browser used, e.g., Chrome
<country>: the country selected, e.g. USA
<height>: the browser height, e.g., 1024
<width>: the browser width, e.g. 1280
<size>: the size of the screenshot, e.g., Full_Page or Screen
<domain>: the link hostname, e.g. www.google.com
<file>: the URL file name, or anything between the last slash (/) and the query (?), e.g., index.html
To limit the maximum length of the <domain>, <url> and <file> variables, you can include a maximum number of characters to include:
<url:100> for a maximum of 100 characters
<domain:15> for a maximum of 15 characters
<path:10> for a maximum of 10 characters
You can use the value retrieved by a tracker with the variable <tracker:id>. The id identifies the tracker associated with the capture:
if multiple trackers with the same ID are found, the first one will be used.
<random>: a random string in a form of a UUID, e.g. 936cbd00-ea49-11e9-8c5f-a901c1b99c6b
<count>: for a group of URLs, the index of the URL, e.g., 0, 1, 2, ... if the capture has only one URL, it will always be 0.
Here are some examples of path and file names for different types of captures.
For a daily capture of the website Browshot.com, you could save all the captures in the same path browshot.com and use <date>.png as the file name.
The captures will be uploaded as browshot.com/2019-10-18.png, browshot.com/2019-10-19.png, etc.
For a daily capture of 3 websites (mysite.com, mysite.net, and mysite.org), use the domain name of each URL as the file name and the data and name of the capture for the folder.
The captures will be uploaded as 2019-10-18/my_capture/mysite.com.png, 2019-10-18/my_capture/mysite.net.png, 2019-10-18/my_capture/mysite.org.png.
See also: Track metrics & status