Link URLs to your web application

Last update: March 14, 2024

Topics:
Configuration

CREATED FOR:

User
Admin

Your websites and applications access Dynamic Media services by way of URL calls. After you publish an asset, Dynamic Media activates a URL string that references the asset. You can paste these URLs into a web browser for testing.

You link to URLs only if you are not using Experience Manager as your WCM. Linking – versus embedding – is used when you want to deliver a video player as a pop-up or modal window. If you are using Experience Manager as your WCM, you add the assets directly on your page.

To place these URL strings in your web pages and applications, copy them from Dynamic Media.

NOTE

URL strings are only available for dynamic renditions of assets. They are currently not available for static assets that reside in DAM and not the Dynamic Media server. The URL button does not appear for renditions that are static.

Obtain a URL for an asset

You can obtain a URL string that is generated by an Image Preset or a Viewer Preset. After you copy the URL, it lands on the Clipboard so you can paste it as necessary to pages in your website or application.

NOTE

The URL is not available to copy until you have published the selected asset. In addition, you must also publish the viewer preset or image preset.

See Publish assets.

See Publish Viewer Presets.

See Publish Image Presets.

There are several different ways you can obtain a URL string. However, the steps below show you just one method you can use.

To obtain a URL for an asset:

Navigate to the published asset whose image preset URL or viewer preset URL you want to copy, and select the asset to open it.

Remember that URLs are only available to copy after you have first published the assets. In addition, the viewer preset or image preset must also be published.

See Publish assets.

See Publish Viewer Presets.

See Publish Image Presets.
Based on the asset that you selected, do one of the following:
- If you selected an image, in the drop-down menu, select Renditions.
  
  Under the Dynamic heading, select a preset name to view its rendition in the right frame. If necessary, scroll the Renditions list to see the Dynamic heading.
  
  At the bottom of the left rail, select URL.
- If you selected a spin set, an image set, a carousel set, or a video, in the drop-down menu, select Viewers.
  
  In the left rail, select a viewer preset name. A preview of the set or video is opened in a separate page.
  
  In the left rail, at the bottom, select URL.
Select and copy the text to your web browser so you can preview the asset or add it to your web content page.

To exit the URL window, select the X or select Close.

Obtain a URL for a static asset

Dynamic Media supports the delivery of static assets, which are additional assets beyond just images and video. Supported static assets formats for delivery include the following:

3D files
Animated GIF
Audio files
CSS
JavaScript (when your company is configured with its own domain)
PDF
SVG
XML
ZIP

To obtain a URL for a static asset:

Navigate to the published static asset whose URL you want to copy, and select the asset to open it.

Remember that URLs are only available to copy after you have first published the static asset.

See Publish assets.
Use any of the following methods to obtain the URL of the published static asset:
- The URL of the published static is the following:
  - https://*<server_name>*/is/content/*<company_name>*/*<static_asset_filename>*.*<extension>*
    
    For example, https://aem.com/is/content/adobe/image.gif.
- Select Asset > Dynamic Renditions, then select a dynamic rendition of the static asset and copy the URL.
  
  Change the copied URL to use is/content in the path instead of is/image/.

Obtain a video URL for a published video rendition

In Experience Manager, navigate to Tools > Deployment > Cloud > Cloud Services.
On the Cloud Services page, scroll down to the Dynamic Media Cloud Services heading, then select Show Configurations.
Under Available Configurations, select the name of the configuration you want.
On the Dynamic Media Cloud Settings page, under Video Service URL, copy down the entire URL path. You need to the copied URL path later in the steps.

For example, the URL path may appear similar to the following:

https://s7athens.macromedia.com:9090/DMGateway/

(The path above is an example only; it is not the actual path you copy.)
Under Registration ID, copy the customer name found in the last part of the ID.

For example, if the registration ID was 87654321|MyCompany, the customer name would be MyCompany.
Near the upper-left corner of the page, select Cloud Services, then select the Experience Manager logo and navigate to General > CRXDE Lite.
Copy down the entire video rendition path from the JCR (Java™ Content Repository).

For example, the video’s rendition path may appear similar to the following:

/_renditions_/0bd/0bd28743-a616-4fe6-92aa-6eae7c2112f/avs/Momentum_1080-0x720-2600k.mp4

(The path above is an example only; it is not the actual path you copy.)
Arrange the copied information in the following order so it forms a complete URL path:

<Video_Service_URL>/public/<Customer_name_from_Registration_ID>/<Video_rendition_path>

For example, using the example paths and the example customer name from the steps above, the complete path appears as follows:

https://s7athens.macromedia.com:9090/DMGateway/public/MyCompany/_renditions_/0bd/0bd28743-a616-4fe6-92aa-6eae7c2112ff/avs/Momentum_1080-0x720-2600k.mp4

This example is the complete video URL for a published video rendition.

Obtain a video URL for adaptive bitrate streaming (DASH or HLS)

In Experience Manager, navigate to Tools > Deployment > Cloud > Cloud Services.
On the Cloud Services page, scroll down to the Dynamic Media Cloud Services heading, then select Show Configurations.
Under Available Configurations, select the name of the configuration you want.
On the Dynamic Media Cloud Services Settings page, do the following:
- Under Video Service URL, copy the entire URL path. You need the copied URL path later in these steps. For example, the URL path may appear similar to the following:
https://gateway-na.assetsadobe.com/DMGateway/

(The path above is an example only; it is not the actual path you copy.)
- Under Registration ID, copy the customer name found in the last part of the ID. You need the copied customer name later in these steps.
  
  For example, if the registration ID was 87654321|demoCo, the customer name you copy would be demoCo.

Based on the video delivery protocol you are using, copy the respective protocol selector. You need the copied protocol selector later in these steps.

Video delivery protocol you are using	Protocol selector to use
HTTP If you are using HTTP (non-secure video delivery), be sure you change https to http in the Video Service URL value you copied earlier.	`public/`
HTTPS	`public-ssl/`

Copy the full video asset path in Experience Manager, as processed by Dynamic Media. You need this copied video asset path later in these steps.

For example:

/content/dam/marketing/MyVideo.mp4
Combine all the pieces you copied previously to create a string in the following order:

< video service URL>< protocol selector>< customer name>< video asset path>

For example, using the copied information from the examples in these steps, the string would appear as follows:

https://gateway-na.assetsadobe.com/DMGateway/public-ssl/demoCo/content/dam/marketing/MyVideo.mp4
Complete the URL by appending .m3u8 to the end of the string. For example, appending .m3u8 to the string from the previous step, the complete URL path would appear as follows:

https://gateway-na.assetsadobe.com/DMGateway/public-ssl/demoCo/content/dam/marketing/MyVideo.mp4.m3u8

Use HTTP/2 to deliver your Dynamic Media assets

HTTP/2 is the new, updated web protocol that improves the way browsers and servers communicate. It provides faster transfer of information and reduces the amount of processing power that is needed. Delivery of Dynamic Media assets can now be over HTTP/2 which provides better response and load times.

See HTTP2 Delivery of Content for complete details on getting started using HTTP/2 with your Dynamic Media account.