Export Results to a Cloud
You can set up an export of results to an outside cloud location, like an AWS S3 location or GCS. See the articles in this section for specific configuration steps by cloud platform.
Not all clean room types support exports and whether exports are supported depends on the export location. For those clean room types that support exports, some support both analytical results and list results, while others only support analytical results. For detaile information, see the "Supported Clean Room Types" section below.
Analytical results are exported as Parquet files.
By default, list results are exported as Parquet files but you can request that list results be exported as CSV files for your account by contacting your LiveRamp representative.
Supported Clean Room Types
For more information on the clean room types supported for each export destination connection, see the table below.
Export Destination Connection Name | Credential Type | Export TIming | Clean Room Type | ||||||
Industry Clean Rooms (ADH, AMC, and FAA) | Hybrid | Confidential Computing | Snowflake | Google Cloud BigQuery | Amazon Web Services | Databricks | |||
S3 IAM Role Export | AWS S3 Credential | Export completed at runtime | Not supported | Both Analytical and List Results | Both Analytical and List Results | Not Supported | Not Supported | Not Supported | Not Supported |
GCS Export | Google Service Account | Export completed at runtime | Not supported | Both Analytical and List Results | Both Analytical and List Results | Not Supported | Not Supported | Not Supported | Not Supported |
Azure Export | Azure AD Service Principal | Export completed at runtime | Not supported | Both Analytical and List Results | Both Analytical and List Results | Not supported | Not supported | Not supported | Not supported |
S3 Export | AWS IAM User Credentials | Export completed in batch (AM UTC) | Only Analytical | Not supported | Not supported | Both Analytical and List Results | Not Supported | Not Supported | Not Supported |
BigQuery Export | Google Service Account | Export completed in batch (AM UTC) | Only Analytical | Not supported | Not supported | Only Analytical | Not Supported | Not Supported | Not Supported |
Note
LinkedIn clean rooms have the same export functionality as Confidential Computing clean rooms.
Check with your LiveRamp representative for information on generally available features relevant to your particular collaborations. Export options will vary by pattern, collaboration, permissions, and cloud.
LiveRamp does not have access to the results from Google Cloud BigQuery, Amazon Web Services, and Databricks clean rooms and so results cannot be exported from those clean room types.
LiveRamp does not have access to the results from Snowflake clean rooms, but those results can be exported to AWS S3 or BigQuery by sharing the question results with LiveRamp. For more information, see "Export Results to an AWS S3 Bucket" or "Export Analytical Results to BigQuery".
Overall Steps to Export Results
Perform the following overall steps to set up an export of results to an outside cloud location:
Note
These steps vary depending on the clean room type and export location. See the individual articles in this section for specific instructions.
For information on performing these steps, see the sections below or the individual articles in this section.
Enable the Clean Room for Exports
Before setting up an export, the clean room owner must enable exports for the selected source clean room:
From the LiveRamp Clean Room navigation pane, select Clean Rooms → Clean Rooms (or click Go to Clean Rooms from the Clean Rooms tile).
In the row for the clean room you would like to export from, click the More Options menu (the three dots), and then select Edit.
From the Configuration step, click
.From the Parameters step, adjust any data control parameters as needed and then slide the Enable Export toggle to the right.
Click
.Verify that your data control parameters are correct and then click
.
Add the Credentials
After enabling the clean room for exports, the clean room owner must first add either their own credentials or those of their partner:
From the LiveRamp Clean Room navigation pane, select Data Management → Credentials.
Click
.Enter a descriptive name for the credential.
For the Credentials Type, select the appropriate type (Google Service Account example shown - for more information, see the specific articles in this section).
Enter the required information (information varies for each credential type).
Click
.Verify that your credentials have been added to LiveRamp Clean Room (Google Service Account example shown):
Create a Destination Connection
An export destination connection is used to connect your results to your export location. After you've added the appropriate credentials, create an export destination connection for your desired cloud type.
Destination connections are created at the organization level and can be configured for any clean room from there.
Note
Destination connection credentials can be configured on the Organization Credentials page before configuring the destination itself or they can be configured as part of the destination connection creation flow as shown below.
To create a new destination connection:
From the LiveRamp Clean Room navigation pane, select Destinations & Integrations → Destinations.
Click
.Select the platform you want to configure your account for.
Enter a descriptive name for the destination connection so that you can easily identify individual connections for a given platform.
To use a pre-configured credential, select the credential from the Available Credentials dropdown and then skip the next step.
To create a new credential (if you are not selecting a pre-configured credential):
Click
.Enter a name for the new credential.
Provide the requested account-level information.
Note
When creating a new credential, you provide the requested information in order for LiveRamp Clean Room to configure a connection to a specific partner account. Credential requirements differ by platform. Credentials are saved and accessible on the OrganiData ManagementList & Activations → Credentials from the navigation pane.
Click
.Select the new credential from the Available Credentials dropdown.
Click
.
Provision a Destination Connection to the Clean Room
Once you've created a destination connection, you can provision that destination connection to the clean room you want to export results from:
From the LiveRamp Clean Room navigation pane, select Clean Rooms → Clean Rooms.
From the tile for the desired clean room, click
.From the Clean Room navigation pane, select Destinations. The Destinations screen shows all destination connections provisioned to the clean room.
Click
.Select the check box for one or more destination connections to add to the clean room for activation, and then click
.
Create a New Export
After you've provisioned the destination connection to the clean room, create a new export:
From the LiveRamp Clean Room navigation pane, select Clean Rooms → Clean Rooms.
From the tile for the desired clean room, click
.From the Clean Room navigation pane, select Exports.
Click
to open the wizard to create a new export.Select the question that you want to export outputs for and then click
.Note
Unless paused, all run outputs will be exported to the configured export destination connection.
Check the radio button for the specific destination connection you want to send run outputs to.
Enter the required information on where you would like the outputs to be exported to and then click
.Verify that the job has been created. Exports are added to the page. You may view the details of an export by clicking on the name.
No
Note
Exports can be paused, which will stop them from sending data upon the completion of each run.
Exports cannot be edited or deleted. Changes should be made by pausing the export and creating a new export.
View Destination Connection Details
Once you've exported results from a clean room, you can view details on currently configured destination connections:
From the LiveRamp Clean Room navigation pane, select Destinations & Integrations → Destinations.
Select the dropdown next to any configured partner to see the individual partner account details, including:
Destination Connection Name
Modified By
Date Modified
Status: Connection status for a particular account. Job statuses include:
Pending: The configuration is in progress.
Configured: The configuration is complete.
Failed: The configuration has failed. Contact your LiveRamp account team.
Ownership
Jobs for Last 7 Days: Number of jobs by job status for the last 7 days.
Actions: Click the More Options icon (three dots) to see a menu with available actions:
View Details: See the number of records sent based on a selected date range (7, 14, 30 days)
Edit: Update destination account credentials
Deprovision: Deprovision the destination account from this clean room
Delete: Remove a destination account so that audiences can no longer be activated
To see job status details, click the More Options icon and then select View Details.
A list of all jobs for that particular desction connection for the last 7 days is displayed. You can adjust the range filter to show all jobs or jobs in the last 14 or 30 days.j You can also filter by job status.
Note
For jobs in a failed or partially failed status, consider checking the associated data and data source, the partner platform itself, or the data logs to understand where a failure may be taking place.