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”.
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.
Amazon 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¶
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”.
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 ASA2‘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 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.