Setup¶

After ASA 2 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 ASA 2‘s admin page “Setup”.

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¶

Enter your “Amazon Access Key ID” and “Secret Access Key”.

Default tracking ID and country store¶

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

Note

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

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

Connection type¶

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

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”:

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 ASA 2‘s Internationalization (i18n) feature.

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

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

The Associate ID sets will be used, when ASA 2 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.