Guides

Canvas Entry Properties in Braze AMP

Learn how to work with dynamic properties passed in Wunderkind AMP payloads.

📘

In the API calls that trigger your Braze canvases, Wunderkind passes user-dynamic fields through canvas_entry_properties. Use this page when implementing those fields in your message templates. For guidance on composing AMP email designs in Braze, see our Help Center.

The properties on this page represent standard e-commerce events, as shown in our API payload examples here. These examples are intended as a general reference and do not reflect client-specific customizations.

Dynamic Product Properties

Each payload includes an Items array, which populates one object per dynamic product. By default, the array is sorted by the recipient's interaction recency (most recent to least recent). The following keys are sent within each product object:

  • WkId: Unique product ID
  • WkCopy: Product name
  • WkImageUrl: Product image path (src attribute)
  • WkUrl: Product page URL

In certain campaigns, additional keys are available within each product object. Do not reference these keys outside of the specified campaigns:

  • Price Drop
    • WkPrice: Original product price
    • WkSalePrice: Discounted sale price
  • Low Stock
    • WkQuantity: Remaining inventory

Dynamic Hero Properties

In certain abandonment campaigns, additional root-level events are available to use as dynamic URLs in email template sections other than the product grid. If using Braze's Link Aliasing feature, ensure to apply ? characters as needed, to ensure that Braze can properly append thelid parameter.

  • {{canvas_entry_properties.${WkCategoryUrl}}}
    • The URL of a user’s abandoned category landing page. We recommend using this as your hero URL in Category Abandonment emails.
  • {{canvas_entry_properties.${WkCartReplenUrl}}}
    • The URL to replenish a user's cart. We recommend using this as your hero URL in Cart Abandonment emails.
    • Note: Replenishment support varies by customer; reach out to your Wunderkind representative for details. If your implementation supports replenishment, the default functionality is to drive the user directly to your homepage, followed by a redirect to their shopping cart if it's found to have a quantity.
  • {{ canvas_entry_properties.Items[0].WkUrl }}
    • The URL of the product page of the first product in the Items array. This URL can be used in any Wunderkind AMP email.