> ## Documentation Index
> Fetch the complete documentation index at: https://kb.aampe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude (Batch)

> Estimated setup time: 30 minutes

## Requirements

* Amplitude Project with your Aampe datasets defined (users, events)
* Service Account Key (optional)

## Batch Sync

Amplitude and Aampe will sync data at a regular cadence (e.g. daily, hourly).

You have several options for syncing an Amplitude dataset with Aampe.

* Option 1: Amplitude pushes to Aampe-provisioned Google Cloud Storage
* Option 2: Amplitude pushes to Aampe's BigQuery
* Option 3: Aampe pulls data using the Amplitude API

## Option 1: Google Cloud Storage

1. In Amplitude, navigate to the **Data** tab

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/1-main-page.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=e90c519e6a65af3d40b7e416c4d197b7" alt="1 Main Page Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/1-main-page.png" />
2. Find **Destinations** on the Data menu. Be sure you're using an Amplitude project with comprehensive data for all the users and events you wish to send to Aampe.

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/2-destinations.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=21f187158ad2986662c30b64887d69a3" alt="2 Destinations Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/2-destinations.png" />
3. Find **Google Cloud Storage** in the catalog of available destinations.

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/5-gcp-menu.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=78a421f0f4c9fa4a3776a87f3deb703e" alt="5 Gcp Menu Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/5-gcp-menu.png" />
4. Select the following options from the `Export Data to Google Cloud` menu
   * Export events ingested today and moving forward
   * Export all merged Amplitude IDs
   * Select all events (or apply filters if needed)
5. Review the tables and click **Next**.

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/5a-gcp-settings.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=c6ae092b3ed33a83bddf08f18c5cf176" alt="5a Gcp Settings Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/5a-gcp-settings.png" />
6. Aampe will provide you with a Service Account Key file. If you have your key file ready, upload it to Amplitude along with the corresponding bucket information. Click **Next**.

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/5b-gcp-key.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=cb6fff2b17b956f5f192401a04f91312" alt="5b Gcp Key Pn" width="2980" height="1578" data-path="images/data-ingest/amplitude/5b-gcp-key.png" />
7. Amplitude will attempt a test upload to check that the entered credentials work. If the upload is successful, click **Finish** to complete the GCS destination configuration and activation.

## Option 2: Google BigQuery

1. Amplitude will directly write data to the Aampe BigQuery instance
2. In Amplitude Data, click **Catalog** and select the **Destinations** tab.

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/1-main-page.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=e90c519e6a65af3d40b7e416c4d197b7" alt="1 Main Page Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/1-main-page.png" />
3. In Amplitude Data, click **Catalog** and select the **Destinations** tab.

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/2-destinations.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=21f187158ad2986662c30b64887d69a3" alt="2 Destinations Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/2-destinations.png" />
4. Add destination

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/3-add-destination.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=46c67c9b7accca6421d517fca8b66ede" alt="3 Add Destination Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/3-add-destination.png" />
5. In the **Warehouse Destination** section, click **BigQuery**.

   <img src="https://mintcdn.com/aameo/IhYAL4pUST75I7WZ/images/data-ingest/amplitude/4-add-bigquery.png?fit=max&auto=format&n=IhYAL4pUST75I7WZ&q=85&s=2b0deaf2c66cef22363a137364b6d468" alt="4 Add Bigquery Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/4-add-bigquery.png" />
6. On the **Getting Started** tab, select the data you'd like to export and the export's cadence. You can Export events ingested today and moving forward, Export all merged Amplitude IDs, or both. For events, you can also specify filtering conditions to only export events that meet certain criteria.
7. Review the schemas for the Event table and the Merge IDs table and click **Next**.

   <img src="https://mintcdn.com/aameo/z9goxn54m9-B-gMK/images/data-ingest/amplitude/4a-bigquery-step1.png?fit=max&auto=format&n=z9goxn54m9-B-gMK&q=85&s=e8310de2370a8fb9cf581f59f7d8ada6" alt="4a Bigquery Step1 Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/4a-bigquery-step1.png" />
8. Specify the BigQuery dataset to receive your Amplitude data, and upload the service account key file. This file must be in JSON format and will be provided by Aampe.

   <img src="https://mintcdn.com/aameo/z9goxn54m9-B-gMK/images/data-ingest/amplitude/4b-bigquery.png?fit=max&auto=format&n=z9goxn54m9-B-gMK&q=85&s=4e719f752af9d003ca588d3e1f09dbfa" alt="4b Bigquery Pn" width="2980" height="1402" data-path="images/data-ingest/amplitude/4b-bigquery.png" />
9. Click **Next**. Amplitude attempts a test upload to test the credentials. If the upload is successful, click **Finish** to complete the BigQuery destination configuration and activation.

## Option 3: Amplitude Export API

Aampe will pull data from the [Amplitude Export API](https://www.docs.developers.amplitude.com/analytics/apis/export-api/).

<Info>
  The Amplitude Export API is only best for small datasets. For large data sets, please consider exporting to Google Cloud Storage or Google BigQuery.
</Info>

To send Aampe the necessary credentials

1. In your Amplitude workspace, click on **Settings** at the bottom left of your screen

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/6-organization-settings.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=acd6efd40dfcdba7f899890edd421032" alt="6 Organization Settings Pn" width="2980" height="1164" data-path="images/data-ingest/amplitude/6-organization-settings.png" />
2. Select **Projects** from the navigation bar that opens.
3. Select the project with the events you would like Aampe to ingest.

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/6b-project-list.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=8411919f1e5af4a40839163b060d643c" alt="6b Project List Pn" width="2980" height="1198" data-path="images/data-ingest/amplitude/6b-project-list.png" />
4. Copy your **API Key** and **Secret Key**

   <img src="https://mintcdn.com/aameo/JAMHWKC9d_czC4JR/images/data-ingest/amplitude/6c-project-details.png?fit=max&auto=format&n=JAMHWKC9d_czC4JR&q=85&s=7629e7af6119c3dcd892582b9b6c4a9d" alt="6c Project Details Pn" width="2980" height="1388" data-path="images/data-ingest/amplitude/6c-project-details.png" />
5. Navigate to **System Settings > Integrations** and select the **Data Import** tab

   <img src="https://mintcdn.com/aameo/9GPBWCzfGxjacgk3/images/data-ingest/amplitude/7a-aampe-amplitude.png?fit=max&auto=format&n=9GPBWCzfGxjacgk3&q=85&s=e6c6bc540e9c90e27386b16709f4757d" alt="7a Aampe Amplitude Pn" width="2980" height="1388" data-path="images/data-ingest/amplitude/7a-aampe-amplitude.png" />
6. Select **Amplitude** and add your credentials

   <img src="https://mintcdn.com/aameo/9GPBWCzfGxjacgk3/images/data-ingest/amplitude/7b-aampe-amplitude-keys.png?fit=max&auto=format&n=9GPBWCzfGxjacgk3&q=85&s=150d10062fcdd53acad2d4e876ee490d" alt="7b Aampe Amplitude Keys Pn" width="2980" height="1388" data-path="images/data-ingest/amplitude/7b-aampe-amplitude-keys.png" />
7. Click **Request Integration** to complete the integration between Aampe and Amplitude.

Unsure what events to send to Aampe? See [here](/developer-guide/data-ingest/what-events-should-i-send-to-aampe) for what a "good" event feed looks like.
