Local images

The starting point: external images

In the default configuration, ASA2 uses the external image URLs delivered by the API to display product images on your website.

XML response image URLs

Advantages of using external image URLs

External image URLs have the following advantages:

  • They reduce the number of requests to your own server.
  • The external image servers are fast.
  • No additional local storage space is used.

Disadvantages of using external image URLs

However, there is a decisive disadvantage in terms of data protection:

  • The URL of a visitor to your website is transferred to the Amazon image servers when the external images are loaded.
using external image URLs

To comply with data protection laws, e.g. the European GDPR (or DSGVO as it is called in Germany), this disadvantage is an issue. Either you address the use of external image URLs in the data privacy policy of your website and let the visitor agree before loading the page, or you use the “Local image” feature of ASA2.

Using ASA2’s local image feature

ASA2 has the ability to download external Amazon product images to the local WordPress Media Library and use the internal URLs before delivering the contents to the visitor. This keeps the visitor IP on your server.

using internal image URLs

Advantages of using internal image URLs

Internal image URLs have the following advantages:

  • The visitor’s IP address is not transmitted to Amazon servers

Disadvantages of using internal image URLs

  • More requests are sent to your own domain
  • A higher amount of data is created by saving the images locally

Activate local images

To use local images with ASA2, you only have to activate the corresponding option, which you can find in section “Options / Images”.

activate local images

After activation, it is recommended to empty all caches, since they could still contain the external URLs.

The next time a product template is generated, ASA2 will start downloading the images used in the template and storing them in the Media Library.

Note

ASA2 does not pre-download all images provided by the API, but only those used in templates.

Local images flowchart

This flow chart illustrates the steps ASA2 takes to replace external image URLs with internal.

local images flowchart

What to expect

Minimally longer loading time at first template generation

After activating the “Local images” function, the first generation of a template will take a short moment longer, since ASA2 downloads the images during this process. The second rendering of a template will be as fast as ever, since the images already exist locally and the generated HTML output containing the local URLs is delivered from the cache.

Product images in the Media Library

ASA2 saves the product images with functions implemented in WordPress. Therefore, they are stored and shown in the Media Library. If the ASA2 Repo is used and a matching entry exists, a product image gets attached to this ASA2 Repo item (see column “Uploaded to”).

local images in Media Library

If no ASA2 Repo item is attached, this may be because it did not exist at the time the image was saved. The “Reattach local images to Repo items” function can be used for this purpose afterwards.

local images reattach

Note

If a product image is not attached to a ASA2 Repo item, this has no negative effects.

Attached local images are displayed in the edit view of a ASA2 Repo item and are linked to the Media Library item.

local images in repo item

Refresh local images

Local images can be refreshed as follows:

  • You delete them from the media library. ASA2 will download these images again on the next request.
  • You use the “Refresh interval” option. Then ASA2 will automatically update an image when the specified time period is exceeded. Usually product images never change. Therefore a high interval value is advisable or even to switch it off, as it is by default (option “Never”).
local images refresh interval