Send query results to StackAdapt¶
StackAdapt is a programmatic advertising platform for running campaigns across display, native, video, connected TV, audio, and digital out-of-home channels. Send customer profiles and audiences to StackAdapt for audience targeting.
Note
This destination uses the StackAdapt GraphQL API .
Beta
The StackAdapt connector is in beta. Contact your Amperity representative to learn more.
The steps that are required to send customer profiles and audiences to StackAdapt from Amperity.
Caution
This destination is available for sending query results to StackAdapt after it is configured by a Datagrid Operator or your Amperity representative.
If this destination cannot be selected for orchestrations ask your Datagrid Operator or Amperity representative to configure a destination for sending query results to StackAdapt.
Build query¶
Build a query that returns the fields to send to StackAdapt. The email field is required; rows with no email address are skipped. To fill a StackAdapt profile field, name the column first_name, last_name, phone, address, city, state, country, postal_code, timezone, or birth_date. A column named amperity_id fills the StackAdapt external_id field. Every other column is sent as a custom field named after the column.
Values are sent as they appear in Amperity. Amperity does not hash or normalize email addresses or other values.
The following example shows a query that returns customer profiles from the Customer 360 table:
SELECT
amperity_id
,email
,given_name AS first_name
,surname AS last_name
,phone
,address
,city
,state
,postal AS postal_code
,country
,birthdate AS birth_date
FROM Customer_360
WHERE email IS NOT NULL
Add orchestration¶
An orchestration defines the relationship between query results and a destination, including the destination and the frequency at which an orchestration runs.
Open the Activations page, select the Orchestrations tab, and then click the Add orchestration button. This opens the Add orchestration dialog box.
From the Object type dropdown, select Query.
From the Object dropdown, select the query for which results is sent to StackAdapt.
From the Destination dropdown, select a destination that is configured for sending data to StackAdapt.
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.
Open the Activations page, select the Orchestrations tab, and then open the menu for the StackAdapt orchestration. Select Run.
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.
When the orchestration has run successfully, the status is updated to “Completed”.