Dynamic Assets

Dynamic Assets are created and designed the same way as Static Assets, but contain placeholders that are replaced with the data contained in your own external source (JSON, XML or RSS, 2.5MB max).

They're an effective way to share up-to-date information with your Profiles, and later tailor content to suit different Segments of your Audience. Jump to this article to read more about placeholders and sources...

To learn how to create a Dynamic Asset and save it for future use, head over to this article for a step-by-step guide.

assets24.jpg

In this article


Setting Up a Dynamic Asset

After you've created your Dynamic Asset, you're ready to start using it in an Email activity. The next step is to connect your source file to populate your Dynamic Asset.

1. Open the Email activity you wish to work with. To add an existing Asset to an Email activity, click on the Assets tab in the Design Panel.

assets26.jpg

2. Choose your Asset from the library. You can search for a specific Asset in the Search Bar, or manually scroll through the list.

Change the list view by toggling between Thumbnails and List.

assets29.jpg

3. Drag and drop the Dynamic Asset into the Email Canvas. It's now time to set up your Dynamic Asset!

assets28.jpg

4. Enter the URL of your source file in the Feed URL box (JSON, XML or RSS, 2.5MB max). Jump to this article to read more about placeholders and sources...

...Is your source file too large?

We support the following Content-Type in GET and HEAD request response headers:

application/json
application/xml
application/rss+xml
text/xml
assets30.jpg

5. Filter the items to be displayed in your Dynamic Asset.

The maximum number of items inserted into an Email activity is 50. To insert more items, you can add the Asset again. Filter them either by ID or by number of items.

To filter by ID, expand the Filter by ID drop-down menu. Make sure that your file has a clear item ID for each item.

For example, if you only want products with IDs 1, 3 and 5 to be displayed in your feed, then enter 1, 3, 5. Items will be placed in the Email based on the order of the IDs inserted in the filtering option.

assets31.jpg

See the example below for an idea of IDs in a source file:

[
 {
 "id": 1,
 "title": "Radisson Blu Waterfront Hotel",
 "description": "Unwind and retreat at this new luxury hotel next to the Stockholm Waterfront Congress Centre, the area's premier events and conference venue",
 "rating": 4,
 "beds": 2,
 "imageUrl": "https://media-cdn.tripadvisor.com/media/photo-m/1280/19/69/4c/48/exterior.jpg",
 "url": "https://www.tripadvisor.com/Hotel_Review-g189852-d1879047-Reviews-Radisson_Blu_Waterfront_Hotel-Stockholm?"
 },
 {
 "id": 2,
 "title": "Ett Hem",
 "description": "Ett Hem is an excellent choice for travelers visiting Stockholm, offering a romantic environment alongside many helpful amenities designed to enhance your stay.",
 "rating": 4,
 "beds": 2,
 "imageUrl": "https://media-cdn.tripadvisor.com/media/photo-o/06/c2/ce/b5/ett-hem.jpg",
 "url": "https://www.tripadvisor.com/Hotel_Review-g189852-d3225167-Reviews-Ett_Hem-Stockholm?"
 },
 {
 "id": 3,
 "title": "Scandic Kista",
 "description": "Stay in one of our newly renovated rooms and enjoy our Livingroom, a cool, modern and comfortable place to hang out.",
 "rating": 3,
 "beds": 2,
 "imageUrl": "https://media-cdn.tripadvisor.com/media/photo-o/0d/6a/0b/23/the-hub-hotel-livingroom.jpg",
 "url": "https://www.tripadvisor.com/Hotel_Review-g1025032-d233089-Reviews-Scandic_Kista-Kista?"
 }
]

To filter by a number of items, expand the Filter by Number of Items drop-down menu.

Choose whether you want the number of items displayed to be fetched from either the start or the end of your file, and enter a number. For example, to fetch the first 3 items from your source file, the settings will look like this:

assets32.jpg

6. Review the settings. Make sure everything is correct before you continue, as settings can't be adjusted once the Dynamic Asset is created.

7. Time to choose how you would like the Asset to fetch the data from your file.

To fetch the data when you send this email, click At send out. The Dynamic Asset will fetch the data from your source and populate your email when you send it. There are some aspects to consider, so we recommend that you head over to this article to learn more about the details.

To fetch the data now, and keep it as is for the time of sending, click Fetch all.

The server that hosts your file source must accept HEAD requests. You can check if your server accepts them by using a REST & SOAP API testing tool, like this one.

When fetching the Dynamic Asset's content from your source/remote server, APSIS One will wait for up to 5 seconds for the server to respond. If the server doesn't respond, APSIS One will cancel the request and display an error message.

The Dynamic Asset will automatically fetch the data and replace your placeholders with the data in your file, and will be sent exactly as it is at this point in time.

Any changes in your source after the content has been fetched will not be reflected. Jump to this article to read more about placeholders and sources...

If you filtered the items from your source file, you will see Fetch now instead.

assets34.jpg

Dynamic Asset Row Settings

Row Name

Enter a name for your row. It will be displayed on the Structure Panel, on the left.

Filter

Filter the items to be displayed in your Dynamic Asset.

The maximum number of items inserted in an Email activity is 50. To insert more items, you can add the Asset again. Filter them either by ID or by number of items.

To filter by ID, enter the IDs that correspond with your item's IDs in the Insert ID input field.

For example, if you only want products with IDs 1, 3 and 5 to be displayed in your feed, then simply enter 1, 3, 5.

To filter by a number of items, enter a number in the Number of items input field.

Choose whether you want the number of items displayed to be fetched from either the start or the end of your file, and enter a number. For example, to fetch the first 3 items from your source file, the settings will look like this:

Feed URL

Enter the URL of your source file in the Feed URL box (JSON, XML or RSS, 2.5MB max). Jump to this article to read more about placeholders and sources...

...Is your source file too large?

We support the following Content-Type in GET and HEAD request response headers:

application/json
application/xml
application/rss+xml
text/xml

Advanced

In these settings, you can determine a specific property in your file where the Asset should locate the content to fill your Asset's placeholders.

This is useful if your Dynamic Asset only has content from nested items in your source file.

For example, in the source shown below, you can see the root item is not an array but an object. With source.items in the Property path settings, this feed can be used for a Dynamic Asset.

{
  "company": "my company",
  "source": {
    "created": "2020-01-01",
    "version": 2,
    "items": [
      {
        "id": 1,
        "name": "items 1"
      }
    ]
  }
}

Happy with everything?

After setting up your Dynamic Asset, feel free to adjust the design.

Need help with designing an Element in the email editor? Jump to this article.

Curious about the results?

Read more about Test and Preview in the Email Editor's Bottom bar.

Did this answer your question?