Send query results to Dynamic Yield

Dynamic Yield helps companies quickly build and test personalized, optimized, and synchronized digital customer experiences.

This topic describes the steps that are required to send CSV files to Dynamic Yield from Amperity:

  1. Build a query

  2. Add orchestration

  3. Run orchestration

Note

Dynamic Yield must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Dynamic Yield for your tenant.

Build query

Build a query that shapes the data so that fields in the output are mapped to the fields required by Dynamic Yield. Data shaping is typically required only one time. For example:

SELECT
  product_id AS sku
  ,other_product_id AS group_id
  ,product_name AS name
  ,product_url AS url
  ,product_price AS price
  ,product_available AS in_stock
  ,product_image AS image_url
  ,product_category AS categories
  ,product_more_info AS keywords
FROM Your_Product_Catalog_Table

Important

The results of this query must match the product feed structure, which requires case-sensitive columns:

  1. sku. Required. A product’s unique ID. Values cannot contain spaces or “//” (double backslashes). For example: “1234”.

  2. group_id. Required. An identifier for a group of products with different product attributes. For example: “4321”.

  3. name. Required. The name of the product. For example: “t-shirt”.

  4. url. Required. A valid URL for a product. For example: https://store.com/product_page.html.

  5. price. Required. The price for a product. For example: “9.99”.

  6. in_stock. Required. Indicates if the product is in stock. For example: “true”.

  7. image_url. Required. A valid URL for a product’s image. For example: https://store.com/images/image.png.

  8. categories. Required. The categories associated with a product.

  9. keywords. Optional. Additional information that describes a product.

Refer to Dynamic Yield documentation for more information about these fields and their requirements.

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

  1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

  2. From the Object Type drop-down, select Query.

  3. From the Object drop-down, select the query for which results will be sent to Dynamic Yield.

  4. From the Destination drop-down, select a destination that is configured for sending data to Dynamic Yield.

  5. From the Data Template drop-down, select a data template.

  6. Verify all settings.

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

  8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. From the Destinations tab, under Orchestrations, open the    menu for the Dynamic Yield orchestration, and then select Run.

  2. 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.

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