Dynamic Asset Transformation (DAT) enables you to create optimized assets as needed for external systems. By using consistent URLs, you can easily access assets based on their characteristics, allowing automated and efficient retrieval of the right content. This feature supports various asset types like videos, documents, and other public assets in your asset bank, providing flexibility in using predictable URLs for different asset types.
By utilizing asset characteristics with metaproperties, users can programmatically access the most relevant content and deliver it smoothly to end users and downstream systems. This functionality boosts efficiency, facilitates targeted content delivery, enhances SEO efforts, and maintains brand consistency across connected systems.
How to enable this feature in your portal?
Contact your Customer Success Contact to enable this feature in your portal and any associated costs.
Structure of Predictable URLs
Your URLs will be based on metaproperty options. Below is the structure for building the URLs.
https://baseurl/match/metaproperty_name/metaproperty_option/name
Example:
https://byndair.bynder.com/match/Country/France/EiffelTower
-
Base URL: The URL of your Bynder DAM.
- Match: A fixed prefix indicating the use of a predictable URL.
-
Metaproperty_name: The database name of the metaproperty
-
Metaproperty_option: The specific metaproperty option for the metaproperty you’ve selected.
- Name (optional): An optional part of the URL for giving a name to the asset, which can be used for SEO purposes.
Predictable URLs for other asset types
Predictable URLs support retrieving the original file, allowing it to work with other asset types. They can be used for your asset bank's videos, documents, and other public assets. This will give the flexibility to use predictable URLs for any asset.
To get the original asset using predictable URLs, you need to start the URL path with /match/original/
The rest of the URL will be the same as described in this article above
Link structure to get the original asset
https://baseurl/match/original/metaproperty_name/metaproperty_option/name
Example
https://byndair.bynder.com/match/original/Country/France/EiffelTower
Note
Because this link will return the original asset, transformations cannot be added to it. The original asset will always be returned without alterations.
Supported Metaproperty Types
New Taxonomy
The following metaproperty types are supported
- Single
- Multi-select
- Text
- Long Text
- The date is not supported
Legacy Taxonomy
The following metaproperty types are supported:
- Select
- AutoComplete
- Select2
Important information:
- Public Assets: To utilize predictable URLs, assets must be public within the DAM. Learn more about marking assets as public assets here.
-
Additional Metaproperties: Following the same format, add additional metaproperties and options.
- https://byndair.bynder.com/match/Country/France/City/Paris/Season/Summer/EiffelTower
- Multiple Results: If a metaproperty combination has multiple asset results, the URL will retrieve the most recently uploaded asset that matches the given criteria by default. However, you can set the default based on the date uploaded, date created, date updated, or the asset name in descending or ascending order. If you’d like to update this, please contact your Customer Success Contact.
- Database name: You must use the name for the metaproperty and option rather than the label.
- Case Sensitivity: The URL is case-sensitive for both metaproperty names and options. Ensure that the capitalization matches the metaproperty configuration to retrieve the desired asset.
-
Trailing Slash: A trailing slash must be included when the URL ends with a metaproperty option. Example: https://byndair.bynder.com/match/Country/France/
- However, when a Name is added to the URL, the trailing slash must be omitted. Example: https://byndair.bynder.com/match/Country/France/Eiffel_Tower
-
Cache Invalidation: If an asset is changed, the cache will be invalidated to display the most up-to-date asset.
Note
We don’t currently invalidate when a metaproperty or option is edited or deleted, but only when an asset is changed, such as when a new version is added, the focus point is updated, or the asset is deleted.
- Transformations: Transformations can be applied to your predictable URL assets by adding the parameters offered in DAT after your last metaproperty option or name.
Updated