Amplitude Extract authentication guide

Overview

This is a step-by-step guide to acquiring credentials and authorizing the Amplitude Extract connector for use in Matillion ETL.

Note

• The Amplitude Extract connector uses an API token for third-party authentication.
• While connector properties may differ between cloud data warehouses, the authentication process remains the same.

---

Acquiring third-party credentials

1. Access the Amplitude website, and on the homepage at the top, click Login, situated on the far right-side of the main menu.

   

2. A login dialog appears. In the field provided, enter the subdomain associated with the account, and click Log In.

   

3. The browser redirects to another login dialog. Enter valid account credentials associated with the subdomain to access the site.

   

4. The My Workspace dashboard appears. Click Settings, situated at the bottom, on the left-hand side of the sidebar.

   

5. In the General dashboard, click Projects underneath Org Settings, situated at the top of the sidebar, on the left.

   

6. The Projects dashboard opens. Click Create Project, situated on the far right-side of the dashboard.

   

7. The Create New Project dialog appears. Provide a name for the new project in the What's the name of your project? field, then click Create.

   

8. The browser redirects to the Sources & Destinations dashboard of the newly created project, and opens on the Sources tab. Click the downward-facing arrow situated at the top, to the right of the new project name, to open a drop-down. In the sub-menu, hover your mouse over the intended project, and click View Project Settings.

   

9. In the General tab of the new project dialog, copy the codes under API Key and Secret Key—you need these in Authorizing for use in Matillion ETL.

   Note

   When copying the codes, some browsers may add a space to the end of the code. Watch out for this as it will cause the credentials to fail.

   

---

Authorizing for use in Matillion ETL

1. In Matillion ETL, ensure an orchestration job is open on the job canvas. If an Amplitude Extract connector is not already on the job canvas, search "Amplitude" using the Components search field, or find the Amplitude Extract connector under Orchestration → Connectors → Load, and drag it onto the job canvas.

   Note

   An orchestration job must be open on the job canvas within Matillion ETL to ensure the Amplitude Extract connector is searchable within the Components panel.

2. Click and drag the Amplitude Extract connector onto the job canvas.

   

3. Click the Amplitude Extract connector on the job canvas, and then click the Properties tab at the bottom of Matillion ETL.

4. Click ... next to the API Key property.

   

5. In the API Key dialog, paste the API Key (copied from the Amplitude website earlier) into the field provided, and click OK.

   

6. Click ... next to the Secret Key property. In the Secret Key dialog, paste the Secret Key (copied from the Amplitude website earlier) into the Store in component field, and click OK.

   Note

   Passwords and codes can also be saved using the Matillion ETL Password Manager. To learn how to do this, read Manage Passwords.

   

If the API Key and Secret Key are entered correctly, the connector is authenticated, and the status of these properties displays as OK.