Inserting Page Fragments

Page fragments are JavaServer Page (JSP) code snippets that perform advanced personalization of your e-mail content or represent commonly used elements such as a company address or disclaimer. The JSP fragments are typically created by site developers and can be reused as needed in any campaign. You can insert them into the e-mail message by using code similar to the following:

<dspel:include otherContext='/atg/outreach'
src='/collections/listActivePromos.jsp'/>

For more information on the code syntax, refer to the ATG Page Developer's Guide.

Each e-mail recipient sees the contents of the JSP fragment. Any profile property references in the fragment show the values from his or her profile.

The following JSP fragments are provided by default in ATG Outreach. Note that several of them require Commerce.

  • listOptIns.jsp

    Shows a list of the e-mail recipient’s current opt-in segments.

  • listWishlistItems.jsp

    Shows the items in the e-mail recipient’s wishlist as a comma-separated list of item display names. Requires Commerce.

  • renderItems.jsp

    Displays a collection of items stored in a user profile property. By editing the fragment, you can specify the property to use and the property that represents the name to display for each item. For an example, see listActivePromos.jsp below.

  • listActivePromos.jsp

    Displays the e-mail recipient’s active promotions as a comma-separated list of promotion names. The fragment works by including renderItems.jsp and setting the profile property to activePromotions and the property to use for the name of the items to displayName. You could change this fragment to display used promotions or descriptions of the active promotions, for instance. Requires Commerce.

Note: To be able to use these files, you must first deploy them through the Business Control Center. For instructions, see Configuring Page Fragments in the ATG Outreach Administration and Development Guide. In addition, the fragments themselves typically need to be edited to make them applicable to your campaigns.

The JSP files for the sample fragments described above are located in <ATG10dir>\ACO10.1\ACO\communication\common\j2ee-apps\Outreach.ear\Outreach.war\collections.