Search

Searching USERS

Export Page

This document provides an overview of the initial steps to getting started using your Amplience Dynamic Imaging System (ADIS) account.
Likely BAU workflow:

  1. Upload to FTP
  2. scheduled import into ADIS
  3. Auto-Publish
  4. HTTP request

Note: The FTP account and import details will be set up by Amplience on your behalf. Please contact your account manager if you have purchased Dynamic Imaging in order to get this set up.

If you are already familiar with the Amplience Portal - then all of the ADIS functionality is accessed via the 'Assets' tab located at the top left of the Portal:


Supported image types

ADIS supports the following image types on upload:

  • JPEG / JPE
  • PNG
  • TIF / TIFF
  • GIF
  • BMP
  • JFIF
  • PTIF / PTIFF

Getting started

There are 2 ways of getting images into ADIS. Manually via the assets tab, and automated via bulk upload job.

Method 1: Assets Tab (Manual)

You can upload assets individually directly within the browser, when on the 'Assets' page you will see the thumbnails of your existing assets, and also a button located in the top left to upload a file:

Upon clicking this button you will be shown a new upload form which has multiple choices of where you would like to upload your files from. If your are uploading files from your local machine, simply drag the files you wish to upload and drop them into the area of the form marked 'Drag files here'.

Note: Alternatively, you can also click on the 'Choose File' button which will bring up a standard explorer so you can look up the files yourself. 

If you wish to upload files from any other source from the list (for example Facebook or Dropbox), you will be required to log into that service before moving on.

Uploading images has some restrictions to bear in mind if using large images:

  • Session Timeouts of 45 minutes
  • File size restrictions
  • Unable to auto process / publish assets.

Method 2: Bulk Upload (Automatic)

For the majority of Business As Usual (BAU) workflows, it is more likely that you will want to upload assets via FTP, and have scheduled jobs to import them into your account. The FTP account from which to upload images for the ADIS system to ingest can be configured by Amplience. Please contact your account manager in order for this to be set up on your behalf.

The process for the user would be:-

  1. Upload media to FTP Account.
  2. Amplience Bulk Upload job media into the ADIS system.


Once these are setup appropriately, many BAU workflows may not require logging in to the Admin interface, and can be operated using just the FTP account, and automated import to streamline getting your rich media assets live and available on a globally scaling content delivery network with minimal manual tasks.

Bulk Upload

This is where you:

- Use the 'Bulk Upload Connector' to map FTP accounts to your ADIS account

- Map root:root or subfolder:subfolder

- Scheduled asset import jobs

- Overwrite/rename duplicate assets

- Can trigger immediate FTP import jobs

- Auto publish on upload (if appropriate)

ADIS asset folders are just a metaphor to aide workflows - the containing folder has no bearing on the HTTP request to call that asset.

ADIS enforces unique asset IDs, and so for each job you must determine if any duplicate assets are to be overwritten or renamed (a underscore + incremental number will be appended to the asset ID i.e. imageX, imageX_1, imageX_2)

To set a Bulk Upload job go to the tools menu in the 'Assets' page and select the 'Bulk upload' option. Then select the 'New' button located at the top right of the screen.

Assets > Tools > Bulk upload

Upon clicking this, you will be shown a new form from which you can create a new job, the form will look like so:

Note: You must have a 'Upload Connector' created before you can create a new Bulk Upload job. If you have only one Upload Connector associated with your account the form will automatically choose this connector, of you have more than one a drop down will be shown to allow you to select from your Upload Connectors.

For this example we will be clicking the 'Advanced Job options' drop down as this includes 'Auto publish assets when imported' option, which is likely to be a useful option for many workflows, especially those where assets QA occurs downstream (i.e. prior to being uploaded into ADIS). Clicking this will show additional options on the form.

Once filling out this form correctly, finish the form with the 'Create' button which will then add the Bulk Upload job to your list.

Having setup your scheduled import job inline with your anticipated business workflows, you may occasionally also need to run an import job immediately which can be done by hovering over 'Actions' (the cog icon) next to the name of the job you wish to run immediately:

 

Note: You will notice that you also have other options, these include 'Update' which will allow you to go back and edit the jobs attributes and 'Deactivate' which stop the job from being run until it is reactivated.

Activity Queue

The Activity Queue provides details of the currently running, and historic jobs which have been run on the account - includes bulk upload and publishing tasks. It also Includes details of the assets uploaded and their Start/Finish time.

 

Under 'Actions' for each queue item, you can view the details of that job by downloading the jobs log.


Finding your Assets

By clicking on 'Assets' you can view all of the assets currently in your ADIS account (including assets used in other Interactive Merchandising modules).There are many ways you can organise and search your Assets, the main and easiest way is using the asset search located in the left column on the page.


Typing a term in this search box will automatically search through all of your assets and display any which match the term you placed in the search box. This is the best way to search for groups of/individual assets as the search tries to match your term with the attributes each asset has. For example when you search 'Dress', the search doesn't only just look for assets with that term included in its name, it also searches each assets label, SKU, original file name and their description to name a few. 

Advanced Asset Search

There is also a more advanced way of using the search, you can input specific queries which may be more helpful in finding certain assets, below are a list of additional queries which can be added to the search accompanied by an example of how to use it in a search:

  • Asset Type - Allows you to search by an asset type (image, video, set, spin, other) - Example: 'type:image' will show all assets which are images.
  • Name - Allows you to search by an assets name - Example: 'name:dress' will return all assets with the name 'dress'.
  • Label - Allows you to search by declaring a assets label - Example: 'label:shoes' will return all assets with the label 'shoes'.
  • Original File Name - Allows you to search by using an assests original file name - Example: 'srcName:image1' will return any assets with the original filename 'image1'.
  • Folder - Allows you to search against folder names which contain assets - Example: 'folder:clothes' will return all assets contained within a folder called 'clothes'.
  • Created - Allows you to view all assets that were created on a specific date - Example 'created:[NOW-5DAYS TO *]' displays all assets created in the past 5 days.
  • Updated - Allows you to view all assets that were updated on a specific date - Example 'created:[NOW-1MONTH TO *]' displays all assets created in the past month.
  • Tags - Allows you to filter assets via their tags - Example 'tag:shoes' displays all assets which have the tag 'shoes' included with them.

Asset Properties

While browsing the assets within the ADIS portal, you can their properties, this is done by hovering over an asset and its 'Action' button and selecting 'Properties', this will open the Asset Property panel.

This gives you the ability to publish items not already published, and also you can use 'Copy URL' to provide you with the base HTTP command to request that asset: An example from my account: http://i1.adis.ws/i/bendemo/Butterfly Here 'bendemo' would be replaced by the name of your particular account.We also advise setting up CNAME reference mapping your own sub-domain. For example:http://images.amplience.com/i/bendemo/Butterfly. Details around these aspects, and other SEO related aspect will be gone through as part of your implementation consulting. ADIS image assets are requested via a standard HTTP call, including references to the ADIS account, ID of the required object, and the parameters to control the delivery and image qualities of the asset. For example:http://images.amplience.com/i/bendemo/Butterfly.jpg?w=500&qlt=85. This requests the same asset as a JPEG, of width 500px and with 85% compression. There are more in depth guides around control and best use of the dynamic imaging commands, and details of many the other available parameters can be found within the Dynamic Imaging Service guide. It is also imperative to consider the quality, and consistency and naming convention of your source image assets, ideally maintaining consistency of source size and aspect ratio, and having a hierarchical and logically consistent naming convention. There are separate supporting guidelines around source assets and naming convention, and would be an important topic to discuss with your implementation consultant.

Transformation Templates

As well as requesting individual image control parameters in the querystring of an HTTP request, ADIS also support transformational templates. These are single querystring references which control a multitude of image commands, and which can be controlled and maintained through the ADIS Admin interface.For example: http://i1.adis.ws/i/bendemo/Butterfly.jpg?$lister_page$ Where $lister_page$ represents specific width, height, format, quality, sharpening commands etc. Ideally your implementation plan will consider using Transformation Templates: - page design categories i.e. Lister, Hero - to consider bandwidth specific variances (if device detection support it..)
i.e. lister_low_connection - to consider facilitating options around page load optimisation There are additional supporting documents that go into more detail around this, and are another key area to discuss with your implementation consultant. Other considerations: Search Engine Optimisation ADIS supports rule pre-processing in such a way that promotes and facilitates SEO friendly image requests, for example both of these image requests are in effect for an identical asset, but are likely to be interpreted quite differently by search engine algorithms: http://images.amplience.com/i/bendemo/Butterfly.jpg?w=400 and http://images.amplience.com/i/bendemo/Butterfly/awesome-wordy-SEO-friendly-filename.jpg

You can find additional material on using Transformation Templates hereTransformation Templates (TT)

Creating Sets

Sets are ordered lists of Assets IDs. They can be used as a Spin Set or a Media Set, and when used in conjunction with a Viewer can provide a rich and engaging rich media experience. To create a set, click on each asset you wish to use in the set (by using the Shift/Control key to select multiple assets), then right click on any one of the assets and click the set you wish to create.


Clicking one of the set options will show an additional window where you can name the set, and reorder the assets, once you are happy with the set simply press the 'Create' or 'Create And Publish' button.

Once a set has been created you are given the options to edit the set () and also to delete the set.

There are also mechanisms to query a set's contents, such as:http://i1.adis.ws/s/bendemo/bag-3d_spin.xmlwhich returns structured XML information about the content of the Spin Set. There are further details approximately half way down the following page: Dynamic Imaging Service.

Player Configurations

There are many players traditionally used for product merchandising that can take full advantage of dynamic imaging such as product Zoom and Spin players.  Amplience provides integrated zoom and spin payers as part of the complete Dynamic Imaging solution. This can be found in the tools menu on the 'Assets' page.

Assets > Tools > Configure your players

 
 

Finally, to locally test your viewer, and to aid your initial implementation, take a copy of the generated embed code:


Clicking this will bring up an additional window containing all of the code needed to run the player.

Changing the {MEDIA-SET} for the ID of the asset you want to load in to the viewer.