Send query results to Experian

Experian offers credit reporting services and scores to businesses and consumers to help protect them from fraud and identity theft.

The steps that are required to send CSV files to Experian from Amperity.

  1. Build a query

  2. Add orchestration

  3. Run orchestration

Caution

This destination is available for sending query results to Experian after it is configured by a Datagrid Operator or your Amperity representative.

If this destintion cannot be selected from the campaigns editor or activations canvas ask your Datagrid Operator or Amperity representative to configure a destination for sending query results to Experian.

Build query

You may need to build a query that shapes the data so that fields in the output are mapped to the fields required by Experian. Data shaping is typically required only one time.

You can do this in the following ways:

  1. Use Spark SQL to add a SQL table to the customer 360 database that selects PII fields from the Customer 360 table, and then outputs them to a table with columns that map to the required naming patterns.

    Note

    PII fields may require SHA-256 hashing or conversion to a UUID using the CAST() function.

  2. Use Presto SQL to add a SQL query that filters within the query, and then outputs results that map to the required patterns.

    Note

    PII fields may require SHA-256 hashing or conversion to a UUID using the CAST() function.

The correct approach here depends on the data and the desired use cases for downstream workflows.

Map fields to Experian

Required fields will vary based on the Experian product and downstream use case to which Amperity sends data, but they require the following fields:

  • Inquiry ID, which is a unique identifier within Experian data

  • First and last names

  • Complete addresses (street, city, state, zip code)

    Important

    Ensure that zip code values do not contain leading zeroes.

Build a query that maps fields in Amperity to the Experian data schema. For example:

 1SELECT
 2  amperity_id
 3  ,given_name AS firstname
 4  ,surname AS lastname
 5  ,CASE
 6    WHEN billing_address IS NOT NULL THEN billing_address
 7    ELSE shipping_address END AS address
 8  ,CASE
 9    WHEN billing_address IS NOT NULL THEN billing_address2
10    ELSE shipping_address2 END AS address2
11  ,CASE
12    WHEN billing_address IS NOT NULL THEN billing_city
13    ELSE shipping_city END AS city
14  ,CASE
15    WHEN billing_address IS NOT NULL THEN billing_state
16    ELSE shipping_state END AS state
17  ,CASE
18    WHEN billing_address IS NOT NULL THEN billing_postal
19    ELSE shipping_postal END AS postal
20  ,email AS email_1
21  ,phone AS phone_1
22FROM Customer360

Append previous day’s data

In some use cases, you may want to append data that was sent to Amperity from Experian to the data that is sent from Amperity to Experian. The following example queries historical Experian data tables to collect data from the previous day, and then join it to the results:

 1WITH Experian_Import_Table AS (
 2  SELECT
 3    clid
 4  FROM Experian_Append_Versioned
 5  WHERE amperity_version = (
 6    SELECT DISTINCT version
 7    FROM amperity_table_versions
 8    WHERE offset = 1
 9  )
10)
11
12SELECT
13  ex.*
14FROM Experian_Append ex
15LEFT JOIN Experian_Import_Table pr
16ON pr.clid = ex.clid
17WHERE pr.clid IS NULL
18AND substr(ex.clid,14,1) = '-'

Add orchestration

An orchestration defines the relationship between query results and a destination, including the destination and the frequency at which an orchestration runs.

To add an orchestration

  1. Open the Activations page, select the Orchestrations tab, and then click the Add orchestration button. This opens the Add orchestration dialog box.

  2. From the Object type dropdown, select Query.

  3. From the Object dropdown, select the query for which results is sent to Experian.

  4. From the Destination dropdown, select a destination that is configured for sending data to Experian.

  5. Verify all settings.

  6. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  7. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. Open the Activations page, select the Orchestrations tab, and then open the    menu for the Experian orchestration. Select Run.

  2. The Status column for the orchestration updates to say “Waiting to start”, after which the notifications pane updates to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.