Skip to main content

​
Overview

Create an import when you need to bring external audience data into Permutive. This guide walks you through the Dashboard setup process for both Google Cloud Storage (GCS) and LiveRamp imports.
Prerequisites:
  • Access to the Permutive Dashboard with appropriate permissions
  • For GCS imports: Details about your data provider or partner
  • For LiveRamp imports: Your LiveRamp Organization ID (not Workspace ID)

​
When to Create an Import

Create a new import when you want to:
  • Connect a new data partner: Receive audience segments from a second-party data partner
  • Import CRM data: Bring in subscriber lists, customer segments, or membership tiers
  • Add third-party enrichment: Layer data provider segments onto your audiences
  • Set up LiveRamp integration: Receive data through LiveRamp’s distribution network

​
Setup Steps

1

Navigate to Imports

In the Permutive Dashboard, go to Connectivity > Imports. This page displays your existing imports and allows you to create new ones.
2

Click Add Import

Click the Add Import button to start the creation wizard.
3

Select Import Source

Choose your import source type:
  • Google Cloud Storage: For direct file uploads from your systems or partners
  • LiveRamp: For receiving data through LiveRamp’s distribution network
4

Configure Data Provider

Enter a Data Provider Name that identifies the source of this data. This name helps you organize imports from different partners (e.g., “CRM Subscribers”, “Partner X Demographics”, “LiveRamp Intent Data”).
5

Set Default Segment Lifetime

Configure the default Segment Lifetime (TTL) for imported segments. This determines how long users remain in a segment after import. The default is 60 days, but you can set any value between 1 and 365 days.
Choose a lifetime based on how frequently you plan to upload data. If you upload weekly, a 14-day lifetime ensures stale data is automatically removed.
6

Complete Source-Specific Configuration

For GCS imports:
  • The wizard will display your unique GCS bucket path where files should be uploaded
  • You’ll receive service account credentials for programmatic access
  • Note these details—you’ll need them for uploading data
For LiveRamp imports:
  • Enter your LiveRamp Organization ID
  • This is your organization identifier in LiveRamp, NOT your Permutive workspace ID
LiveRamp Organization ID: Make sure to use your LiveRamp Organization ID, not your Permutive Workspace ID. These are different identifiers. The Organization ID is provided by LiveRamp and identifies your organization in their system.
7

Save the Import

Click Save to create the import. For GCS imports, the bucket and credentials are immediately available. For LiveRamp imports, Permutive configures the connection to receive data from LiveRamp.

​
After Creating an Import

Once your import is created:
  1. Set up your taxonomy to define what segment codes mean
  2. Upload data (GCS) or wait for data delivery (LiveRamp)
  3. Verify segments appear in the Dashboard under your import

​
Next Steps

Configuring Taxonomy

Define segment codes and metadata

Uploading Data Files Manually

Upload files via GCS Console

Uploading Data Files Programmatically

Automate uploads with service account

Back to Imports

Return to Imports overview