Send query results to Adobe Experience Platform¶
Adobe Experience Platform is a component of Adobe Experience Cloud that transforms data into robust customer profiles that update in real-time and help marketers understand how to optimize customer experiences across every channel.
Caution
Adobe Experience Platform requires a static schema.
Adobe Experience Platform supports adding fields to an existing schema and allows required fields to be made optional.
Adobe Experience Platform does not support the following:
Removing previously defined fields
Introducing new required fields
Renaming fields
Redefining fields
Removing or restricting previously defined field values
Moving attributes to a different location in the schema
This topic describes the steps that are required to send CSV files to Adobe Experience Platform from Amperity:
Note
Adobe Experience Platform must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Adobe Experience Platform for your tenant.
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 Adobe Experience Platform. Data shaping is typically required only one time.
You can do this in the following ways:
Add a SQL table (using Spark SQL) 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.
Add a SQL query (using Presto SQL) 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 case (or cases) for downstream workflows.
Add orchestration¶
An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.
To add an orchestration
From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.
From the Object Type drop-down, select Query.
From the Object drop-down, select the query for which results will be sent to Adobe Experience Platform.
From the Destination drop-down, select a destination that is configured for sending data to Adobe Experience Platform.
From the Data Template drop-down, select a data template.
Verify all settings.
Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)
Click Save.
Run orchestration¶
Run the orchestration manually to validate that it works.
To run the orchestration
From the Destinations tab, under Orchestrations, open the menu for the Adobe Experience Platform orchestration, and then select Run.
The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.
When the orchestration has run successfully, the status is updated to “Completed”.