Setup

After ASA2 is successfully installed, you have to complete the setup before you can embed Amazon products (see Embedding a single product) in your pages.

The setup is necessary to establish a connection to the Amazon Product Advertisment API.

Note

You have to log in as an administrator to be able to access the setup.

Open ASA2‘s admin page “Setup”.

ASA 2 setup menu

If you do not have an Amazon Product Advertisment API account yet, please read the tutorial How to register a new account for Amazon Affiliate Program.

Screencast



Amazon Access Key

access key

Enter your “Amazon Access Key ID” and “Secret Access Key”. The API works with both your AWS root user and IAM users (the latter is recommended).

How to configure an IAM user

For more information on how to configure an IAM user to use the Product Advertising API, please check out this official AWS documentation page: Managing your Existing AWS Security Credentials for the Product Advertising API.

Default tracking ID and country store

tracking id

Enter your “Default tracking ID” and “Default country store”. They will be used for all requests without tracking ID and country code.

Note

With ASA2 you can define custom tracking IDs and country codes, see [asa2].

After you have saved your account data, the status should change to “Connected”.

Setup success

Connection type

Here you can decide if you want to connect the Amazon API via HTTP or HTTPS.

Setup connection type

Where are my credentials?

You do not have an account yet?

Please read my step-by-step tutorial How to register a new account for Amazon Affiliate Program.

You already have an account?

If you already have an account, log in to https://console.aws.amazon.com/ and access the section “Your Security Credentials”. There you will get your “Amazon Access Key ID” and “Secret Access Key”:

Amazon credentials Amazon credentials

Where is my tracking ID?

If you do not know where to find your tracking ID for the Amazon Product Advertisment API, please read my guide Finding your Amazon Tracking ID.

Associate ID sets

With Associate ID sets you can manage multiple Amazon Associate IDs for different country stores. The sets are used by ASA2‘s Internationalization (i18n) feature.

Associate ID sets

When you create an Associate ID set, enter an unique name, your Amazon Associate IDs by country and an optional comment.

Associate ID set create

Your first set will automatically be marked as default. If you have multiple sets, you can change which one should be used by default.

Associate ID set default

The Associate ID sets will be used, when ASA2 renders an internationalized product. For example, if a product from the german store will be loaded, the Associate ID for the german store from the default set will be used. If no matching ID will be found, the default Associate ID configured on the setup page will be used (Default tracking ID and country store).

For more details see Associate ID mapping.