Skip to main content

Overview

The Permutive connector provides a convenient way of exporting data directly from the Decentriq platform to Permutive. Data is uploaded to a Google Cloud Storage bucket from which it is accessible to Permutive.

The Permutive connector requires a setup configuration. If it is not yet active, please contact your customer success manager or support@decentriq.com.

Note: You can alternatively export the audience directly using the GCS connector.

While the Permutive connector conveniently sets up the segment code, name and formats the file as expected by Permutive, the GCS connector allows more flexibility

Prerequisites

  • Have a Permutive API key.
  • Have a Google Cloud Platform account associated with the Permutive tenant.
  • Have an existing Cloud Storage bucket where data can be uploaded.
  • Have existing service account credentials from Google Cloud Platform.

Step-by-step guide

1. Set up Permutive to receive a new audience​

  1. Create a new import audience in Permutive
    1. Audience / Imports: click on Create import and input the required fields:
      1. Import name: Whatever name to recognize it (e.g. Decentriq). No spaces is better
      2. Identifiers: Pick the same activation ID that you imported in Decentriq. The output of the data clean rooms are expressed in the activation ID, that needs to be compatible with the Permutive ID translation service. This is derived by the acive identifiers in your account (Check insights / identity).

        Note: Only admins or users with appropriate permissions can access this. Regular users won't have access and will be blocked at this step.

      3. Import source: GCS
      4. Continue
    2. Set up fields in step 2:
      1. GCS bucket: Select from dropdown of auto-filled from existing bucket list. You need to have a GCS bucket connected to the Permutive account. Otherwise, leave the value <blank>
      2. Upload access account: Add the same user that can extract the audience from the data clean room. If it is a service account, label it as such
      3. Read access account: Leave blank
      4. Advanced options: Check ‘create new GCS bucket’
      5. Continue
    3. Review the summary that all the information are correct, then click ‘Submit’
  2. In Permutive, go to settings / keys and create a new Permutive API key (Private Key). This will be used by the Decentriq connector import

2. Use the connector from the Decentriq web interface​

  1. Go to dataset, select the audience file and click on ‘Export’ (Follow the steps to select a dataset for export)

  2. Select Permutive among the available options

  3. Fill in the relevant information

    1. Permutive API key: Paste here the API key you generated in #2. . This will allow Decentriq to create the correct taxonomy for you in Permutive
    2. Segment name: A segment name of choice (like Decentriq_segment) This will be used to create the taxonomy in Permutive
    3. Segment code: A numerical value of choice (like 0001) This will be used to create the taxonomy
    4. Import ID: The unique code of the new audience - code. You find it opening the created audience, in the ‘Information’ tab
    5. Object name: A file name of choice with the `.txt` extension, e.g. `audience.txt` 6. Bucket path: This is shown under GS path, after `gs://` 7. GCS credentials: Set up the JSON file with the credentials of your GCS account (Set account keys) as explained [HERE](https://cloud.google.com/iam/docs/keys-create-delete#creating), with write permissions

    Note: All the information and credentials input at this step are not available to Decentriq and are not stored. The export is managed directly by the confidential computing environment, guaranteeing that this information stays encrypted and unaccessible during the process.

  4. Click on ‘Export’

  5. The export might take several minutes. You can now safely close the window and the Decentriq page: the export will run in the background. You can see the status from the Decentriq Dataset / Import/export page. If there is any issue, it will have the status FAILED and you can check the error by clicking on it

  6. Decentriq will now take care of exporting the file in the required format into the GCS bucket and create the taxonomy in Permutive programmatically. If you want, you can do either manually as described in the Permutive documentation

  7. Check that the file correctly landed in Google, and that Permutive correctly identified and read the file and imported the audience

External resources​