# Google History

**URL:** <https://forum.avicennaresearch.com/t/google-history/1497>\
**Category:** Reference\
**Created:** [February 9, 2026, 3:15pm UTC](https://forum.avicennaresearch.com/t/google-history/1497 "2026-02-09T15:15:28Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![leila](https://forum.avicennaresearch.com/letter_avatar_proxy/v4/letter/l/b4bc9f/32.png) [@leila](https://forum.avicennaresearch.com/u/leila)\
**Post date:** [February 9, 2026, 3:15pm UTC](https://forum.avicennaresearch.com/t/google-history/1497/1 "2026-02-09T15:15:29Z")

</div>

This data source allows researchers to collect participants’ Google Chrome browsing history through a manual upload process. Participants export their browsing history from Google Takeout and upload the resulting file to Avicenna using a survey [File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75).

> [!note]Important
> 
> - **Google History** is a manual, retrospective export of Chrome browsing history using Google Takeout.
> - **Web Activity** is an automated, real-time collection method available only through Firefox Nightly on Android.

## Use Cases

- **Behavioral research** : Understanding long-term browsing habits and exposure to online content for Google Chrome users.
- **Digital footprint analysis** : Correlating manually uploaded web activity with survey responses or other passively collected data.
- **Media consumption studies** : Analyzing engagement with various online platforms and news sources.

## Data Structure

Google Takeout exports Chrome browsing history as a ZIP archive containing a file typically named`BrowserHistory.json`.  
While the file organizes data into “Sessions” and “Tabs” (which may look complex if you open the file in a text editor), it contains specific details for every webpage visited.

The most important fields available for analysis include:

- **URL** : The specific web address visited. Internally stored as `virtual_url`.
- **Title** : The title of the webpage.
- **Time of Visit** : A timestamp indicating exactly when the visit occurred. Internally stored as `timestamp_msec`.
- **Transition Type** : How the user arrived at the page (e.g., `LINK` for clicking a link, `TYPED` for typing the address, or `RELOAD`).

## Data Collection Behavior

Google Chrome browsing history is collected through a manual export and upload process:

1. Participants export their Chrome browsing history from Google Takeout.
2. Google provides the export as a `.zip` archive containing a `BrowserHistory.json` file.
3. Participants upload the exported file to Avicenna using a survey [File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75).

## Setting Up Google History Collection in Avicenna

To collect Google Chrome browsing history from participants, create a survey that includes a [File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75) for uploading exported Google Takeout files.

### Step 1: Create a Survey with a File Question for Upload

1. **[Create a new survey](https://forum.avicennaresearch.com/t/surveys/1286/1)** in your study (e.g., “Google History Upload”).

2. Add a **[File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75)** to the survey.

3. Configure the **Answer File Format** for the File question to allow `.json` and/or `.zip` files.

4. **Add clear instructions** describing which file participants should upload.

5. **[Publish](https://forum.avicennaresearch.com/t/surveys/1286#p-2913-publish-surveys-12)** the survey.

### Step 2: Export Chrome History from Google Takeout

You will need to provide your participants with detailed instructions on how to export their Chrome history from Google Takeout. These instructions should be communicated clearly to participants (e.g., in a [Page activity](https://forum.avicennaresearch.com/t/page/1242/1) within Avicenna, or via email).

Here are the step-by-step instructions for participants:

#### 1. Request your data from Google Takeout

1. Navigate to [the Google Takeout page](https://takeout.google.com).

2. Sign in with your Google account if you are not already logged in.

3. On the “Create a new export” page, click **Deselect all**.

4. Scroll down the list of products and select **Chrome**.

5. Click on “All Chrome data included” to open the customization options. Ensure _only_ **History** data is selected. Then click **OK**.

#### 2. Customize the export

1. Choose **delivery method** : Select how you want to receive your data. The most common method is **Send download link via email** , which sends a link to your email address.

2. Choose **frequency** : Select **Export once** for a one-time download of your history.

3. Choose **file type and size** : For the **Archive format** , select `.zip` from the dropdown menu. This will be the format of the compressed file Google will provide, and it will contain your `BrowserHistory.json` file. Set the maximum archive size; if your data is larger, it will be split into multiple files.

4. Click **Create export**. Google will begin creating a copy of your Chrome history. This process can take anywhere from a few minutes to a few days, depending on how much history you have.

#### 3. Download the exported archive

1. You will receive an email from Google when your archive is ready. Open this email and then click the **Download your files** button. You may need to enter your Google account password to proceed.

2. Download the zipped archive to your computer or device.

3. **Extract the files from the zipped archive.** Inside, you will find the `BrowserHistory.json` file.

### Step 3: Upload History to Avicenna

Once participants have downloaded and extracted their `BrowserHistory.json` file (or have the `.zip` archive containing it) from Google Takeout, they should:

1. Open the Avicenna app and navigate to the survey containing the [File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75) you created for this purpose.

2. Tap the **ADD FILE** button in the File question.

3. Select the `BrowserHistory.json` file (or the `.zip` archive if you configured the File question to accept `.zip`).

4. Submit their survey response.

## Monitoring and Exporting Google History Data

Once participants upload their history files through the survey, the files will be accessible:

- On the [Activity Responses page](https://forum.avicennaresearch.com/t/view-responses/1287/1) for the survey, where you can [view responses](https://forum.avicennaresearch.com/t/view-responses/1287/1) and download the uploaded files.
- As part of a full survey response [export as a ZIP file](https://forum.avicennaresearch.com/t/view-responses/1287#p-2914-data-filtering-and-exports-7).

## Troubleshooting

- **“File type not supported” error:** Verify the [File question](https://forum.avicennaresearch.com/t/questions/1291#p-2918-file-75) is configured to accept `.json` and/or `.zip` file formats.
- **“File too large” error:** If the exported file exceeds the 200 MB limit, advise participants to select a smaller **Maximum archive size** during the Google Takeout export process ([Step 2.3](https://forum.avicennaresearch.com/t/google-history/1497#p-3260-3-download-the-exported-archive-9)).
- **Missing or incomplete data:** Confirm participants understand Google Takeout does not include incognito browsing history. Also, ensure they correctly selected ‘Chrome’ and specifically ‘History’ data during the export process as instructed in [Step 2](https://forum.avicennaresearch.com/t/google-history/1497#p-3260-step-2-export-chrome-history-from-google-takeout-6).