|Associate Engine :
|Home > Associate Engine > Documentation > New Users FAQ|
Most popular FAQ's:
See the Download & Installation page. If you have a problem installing the script, see the Troubleshooting FAQ.
Amazon.com Web Services (AWS) does not provide images of most apparel products. Associate Engine (and all other AWS-based scripts) can only display those product images that Amazon.com's AWS provides. It is a shortcoming of Amazon.com's AWS. If you're main objective is to display apparel products, no AWS-based script will do that well. Contact Amazon.com and ask them to provide product images for more apparel products.
The demo version does not insert your amazon.com associate ID in the links. When you purchase a license for Associate Engine, your amazon.com associate ID will appear in the links. To purchase, click here.
For amazon.co.uk, search results are based on amazon.co.uk. For a live example, see www.GrandShop.co.uk For full details, see Using Associate Engine with amazon.co.uk
For Amazon's other international websites (amazon.ca, amazon.de, amazon.fr, amazon.co.jp), Associate Engine provides partial support Note: Search results are based on the U.S.-based www.amazon.com website -- results are not based on the international websites. See example showing "Buy from: Canada, United Kingdom" links -- the main product links go to www.amazon.com.
The Associate Engine key is a small text file called
ae-key.txtthat contains a software key that enables the Associate Engine to work with your amazon associate ID. Without the key file, Associate Engine runs in demo mode and all links point to the amazon.com home page (without your associate ID). To obtain a key file for your amazon associate ID, use the Key Request form. Once you obtain your ae-key.txtkey file, upload it to the same directory on your webserver where you installed the Associate Engine ae.pl script file.
Yes, if you are a registered user of Associate Engine then all links to amazon generated by the Associate Engine will have only your amazon associate ID. You must install your Associate Engine key file to ensure that your amazon associate ID appears in links.
No. We do not do installations. You will have to install the Associate Engine script yourself or have your hosting company install it for you. See the Download & Installation page.
A cgi-bin perl script is not a Windows program such as Microsoft Word or Excel that you run on your desktop computer using a mouse. A
cgi-binperl script is a program that you upload to your webserver. Perl is a programming language. A typical perl script has a filename that ends with ".pl" and is uploaded by you to the " cgi-bin" directory on your webserver. If you look in the cgi-bindirectory on your webserver, you may notice that it may already contain other perl scripts for your website that your hosting company may have pre-installed on your webserver such as a guestbook or hit counter.
You do not run the Associate Engine perl script like you would run a Windows program. Instead, your webserver automatically runs the Associate Engine perl script whenever a user accesses one of your webpages that contains an HTML statement that references Associate Engine. For more information, see the New Users: Start Here page.
No. You only need to have an amazon associate ID.
Yes, you can still use Associate Engine. You only need to know how to create an HTML webpage and add a standard HTML link to your webpage. For more information and a step-by-step tutorial, see the New Users: Start Here page. We also provide many ready to use sample HTML examples that you can copy and paste into your webpage.
However, you will need to have someone install Associate Engine. This requires some knowledge of how to install a
cgi-binperl script, and how to use FTP and CHMOD.
No, the commission rate is determined and set by amazon.com. See the amazon.com Associates' Operating Agreement, in particular the "Referral Fees" and "Referral Fee Schedule" sections.
Yes, you can run Associate Engine on several websites provided that you own the websites, you own the domain names, and the amazon.com associate ID belongs to you. No additional licenses are required (for up to 10 different associate/tracking ID's).
For each amazon.com associate ID (or tracking ID) that you want to use with Associate Engine, you request an
ae-key.txtfile from us. Each ae-key.txtfile is for a particular amazon.com associate ID (or tracking ID). You can use that same ae-key.txtfile on all or as many of your websites that you want (provided that you own those domain names). Some webmasters have more than one associate ID (or tracking ID) -- in that case, another ae-key.txtfile is required for each additional associate ID (or tracking ID). Up to 10 ae-key.txtfiles can be requested per Associate Engine license. You do not have to buy a new license for each associate ID (or tracking) that belongs to you. If more than 10 ae-key.txtfiles are required, then another Associate Engine license must be purchased (it permits another 10 ae-key.txtfiles). For example, if you have one associate ID (one ae-key.txtfile) and 25 websites (or 100 websites!) (and you own all those domains), then you could install Associate Engine on all of those websites. And you could still request 9 more keys in the future! To obtain an ae-key.txtfile, fill in the key request form. When we receive a key request, we manually verify that it is from someone who has purchased a license. When a license is purchased (via ClickBank.com), ClickBank.com sends a receipt by email to us that details what was purchased and who purchased it (name and email address) -- NOTE: the receipt does not include credit card information and does not include address information. If we cannot match the name/email with a receipt, then we ask the person to forward their ClickBank.com receipt to us. All the ae-key.txtfiles for a particular license have the expiry date of the license. In summary, you can use a particular ae-key.txtfile on more than one website. And you can request up to 10 keys per license.
Amazon.com's 2.5% premium is for all items (other than wireless products) sold through direct links. It is Amazon.com that decides what is a direct or indirect link. See the webpage on the amazon.com website that describes Compensation. That webpage contains the following statement:
Note about Direct vs. Indirect Links: If a customer follows a direct link to an item and then adds it to their Shopping Cart, it is considered a direct purchase. The direct-link premium is applied when customers add direct-linked products to their carts, even if they visit other product pages first. The following link types also qualify for the direct-link premium: Served Individual Item, Individual Item, Marketplace Item, Quick-Click Buying, and those created via Amazon Web Services (Remote Add-to-Cart, Remote Shopping Cart, and Individual Item). Non-title-specific links (Home Page, Search Box, Redirect, and Keyword Search) and Amazon Recommends links (Browse, Keyword, Bestseller, Easy, etc.) are considered indirect.
According to Amazon.com's definition, the product links in Associate Engine output are direct links.
The default templates also contain links to the Amazon.com home page (e.g.: "Associated with Amazon.com" link) and amazon.com considers these as indirect links.
See also Amazon.com's Operating Agreement.
It is technically possible, and some of our Associate Engine users are doing that. We recommend that you check the Google AdSense Program Policies and Google AdSense Online Standard Terms and Conditions to make sure that you are in compliance with Google's requirements.
Insert your Google AdSense HTML into your Associate Engine template file. If you're using the Store template files, you may want to use the store.include.* configuration variables to include a text file that contains your Google AdSense HTML.
Amazon.com uses Google to advertise. So Amazon.com ads may (and probably will) show up on your website via Google AdSense. You may want to exclude Amazon.com ads from showing up on your website. To exclude Amazon.com ads, login to Google AdSense, click on "Ad Settings" tag, click on "URL filter", click "Add / Edit sites", add "www.amazon.com" to the list, and click "Save changes".
See the License Agreement.
We do not recommend running Associate Engine on a free web host.
Associate Engine was designed and tested to be run on a linux/unix webserver. It also works on a Windows NT IIS webserver provided that the server can run perl scripts (see http://www.ActivePerl.com). Associate Engine may run slower on a Windows webserver compared to a linux/unix webserver. Also, to enable the cache mechanism, you will have to add write permissions to the domain users accounts. We recommend that you download & install the free demo version and try it out.
We do not make any guarantee that Google.com or any other search engines will index results that appear on your website via Associate Engine. However, we have observed that Google.com has in fact indexed results on many of our users websites. Search Google.com for "Powered by c3scripts.com".
In addition, Associate Engine supports Virtual Directory so that Associate Engine can look like a directory with static HTML files, such as:
We do not have any current plans to adding a shopping cart directly to Associate Engine because Associate Engine supports Amazon.com's
Quick-Clickbuttons. Amazon.com's Quick-Clickbuttons put Amazon.com's shopping cart into a pop-up window so the user doesn't have to leave your website. For an example, go to BookAuthors.com and click on any "Buy from Amazon" button that appears in any results. See the addto.* configuration variables.
No. We provide many ready to use sample HTML examples that you can copy and paste into your webpage. We also provide some basic page templates and a set of store page templates. You can create and modify page template using your HTML editor.
You install the Associate Engine script to your own webserver and it is run from there. See the Download & Installation page and the New Users: Start Here page.
Yes, the results can be customized through Page Templates.
The products selected and output format used are determined by parameters that you as the webmaster include as part of the link to the Associate Engine script (or as part of the <script> tag or Server-Side-Include statements) as shown in the following:
See the New Users: Start Here page, the Quick Tutorial, and the Script Parameters complete reference guide
Yes. Associate Engine can be used to display a narrow selection of products (e.g.: Palm devices), or a wider selection of products (e.g.: all electronics products), or a very wide selection (e.g.: all amazon.com products).
See the Harry Potter examples on the New Users: Start Here page.
Those errors are not related to Associate Engine.
Those errors are from viruses (and possibly hackers) trying to exploit Windows NT server vulnerabilities to break into your web server (if it is an NT server). That's what the cmd.exe of "..%5c../winnt/system32/cmd.exe" is indicating. It is common to see various cmd.exe (and other .exe's and _vti...) in web server error logs. If you have a linux/unix server then ignore them since those particular exploits only exist in Windows NT servers. If your web server is a Windows NT server, then you should verify with your hosting company that the latest security updates have been installed on your web server.
To speed up Associate Engine, you can do the following optimizations:
Make sure that the
/cgi-bin/ae-cachedirectory is not empty (if the directory does not exist, create ae-cache in the directory where ae.pl is located; e.g.: /cgi-bin/ae-cache). If the directory remains empty after you access any ae.pl address in your web browser, then the write permissions of the ae-cache directory are probably not set; set them using CHMOD (use a chmod that works for you: chmod 755 or chmod 775 or chmod 777).
ae-imgcacheimage cache directory in the directory where ae.pl is located; e.g.: /cgi-bin/ae-imgcacheIf the directory remains empty after you access any ae.pl address in your web browser, then the write permissions of the ae-imgcache directory may not be set; set them using CHMOD (use a chmod that works for you: chmod 755 or chmod 775 or chmod 777).
Set the pageSize configuration variable to 10 (the default is 25).
Set the cache.stale configuration variable to a higher number such as 24 (the default is 1; the range is 0 to 24). This sets the amount of hours that data remains in the local cache.
Set the cache.size configuration variable to 10mb to permit up to 10MB of data in the local cache. (the default is 10mb).
Set the packHtml configuration variable to no (the default is yes).
Set the imageWH configuration variable to no (the default is no).
Edit ae-ini.txt and search for ,if, --- you should see it in the five xgrid* configuration variables. In all five variables, replace ,if, with a single comma , thus removing the if option. For example, the value of xgridB would change from
If your website is on a shared web server (that is, websites of other people are on the same web server), ask your hosting company to move your website to a shared web server that has less load on it.
- Move your websites to a dedicated web server so the entire processing power of the web server is available for your websites. As one possible hosting company that you can move to, see the third-party hosting company at akoss-hosting.com; they are familiar with Associate Engine.
If you are seeing "The server is too busy" messages, then do the above optimizations. And you can also edit
ae-ini.txtand set the maxLoad configuration variable to a higher number (e.g.: 50) instead of the default of 20 or change it to 0 (the number zero) to turn off load checking. The error message is shown when the load on your server is greater than the value specified by maxLoad (setting maxLoad to 0 turns off load checking).
The "Buy from Amazon.com" button is a form submit button that uses a POST method (rather than a GET method). With the POST method, parameters (such as your associate ID) do not show up in the URL. This is how POST works. If you view the HTML source of the webpage that contains the button, you will see your associate ID as a
<INPUT TYPE=HIDDEN>hidden form field.
To make Associate Engine display product details locally, set the asinsearch.format configuration variable in
ae-ini.txt. For example:
The above setting would cause the ae-format/details6.html formatting file to be used to show product details locally when the user clicks on the product link in the search results.
Log entries showing "c3scripts.com ae v..." as the user-agent are okay and expected in Associate Engine (v4.04.04 or higher). In the past, those "c3scripts.com ae v..." entries would have appeared as web browser user-agents (such as "IE6", at least for those web browsers that run <script> tags).
To turn those off, set configuration variable ssi.script to no. But that will turn off the feature introduced in Associate Engine v4.04.04 that makes Associate Engine convert to HTML any <script> tags that refer to Associate Engine. For example, in the store templates, the "top sellers" sidebar column is generated using a <script> tag that refers back to Associate Engine. In previous versions, that <script> tag would be processed by the web browser and you would see two lines in your log file (both caused by the web browser). As of Associate Engine v4.04.04, Associate Engine fetches the HTML generated by the <script> tag itself (thus causing an entry in the log from Associate Engine) and then puts that HTML into the total HTML sent to the web browser. Advantage: search engines now see the total HTML (search engines don't run <script> tags). "Top sellers" grids on browse index pages are also <script> generated; so you'll see those in your log too. If you are using local details pages, you'll also see entries for "accessories" and "similar products" that appear on details pages.
Bought on or after 1-Jun-2003:
If the Associate Engine license was bought from 1-Jun-2003 onward, the license renewals are already being enforced (first renewal will happen when we reach 1-Jun-2004). A renewal notice email will be sent to you about one month before your key's expiry date. See your
ae-key.txtfile for its expiry date.
Bought before 1-Jun-2003:
If the license was bought before 1-Jun-2003, license renewals are not required to use the current version of ae.pl -- but the version of ae.pl as of 1-Jan-2005 (i.e.: ae.pl v5.01.01) will require a valid renewed license. Note: If, on or after 1-Jan-2005, you want a new key for another amazon ID (or a replacement key file), then a valid renewed license is required.
So, if you bought before 1-Jun-2003, you can keep using your current keys with a version of ae.pl less than v5.01.01 but some features may break by then.
So, long time users have until 1-Jan-2005 to renew if they want to use ae.pl v5.01.01 or higher. We feel that this is a fair thank you to those users who adopted the Associate Engine script early on. We do appreciate your long time commitment with us; if you do decide to voluntarily renew on or after 1-Jan-2005, then that would be appreciated.
The annual renewal license fee is $9.95 (renew here), compared to the initial license fee which is $24.95 (U.S. currency).
Support is free and it is provided by e-mail (our offices are closed on Saturday & Sunday). If you have a support issue, contact us for support.
Yes, Associate Engine is easy to install. To install Associate Engine, follow the detailed installation instructions. Please note that a minimum understanding is required, such as: how to use an FTP program to upload, how to upload in ASCII mode, and how to use CHMOD to enable a script to run.
Yes, Associate Engine is easy to use. Plenty of online documentation is provided, such as:
Yes, many webmasters are using Associate Engine. See some live samples.
Yes, Associate Engine is recommend by the company Amazon.com, Inc. and their review of it is:
Amazon.com, Inc. review:
"...[Associate Engine] script is a truly professional product, and it is just one of a number of tools that [Cusimano.Com Corporation] promotes to Associates on [its] Web site. If you want to use an application offered by a real business with a specific mission to help Associates, the [Associate Engine] script is the way to go."
-- Amazon.com, Inc.
Yes, sample HTML is provided that you can copy/paste into your own HTML files. See Sample HTML.
You can customize the overall page layout (the macro view) as well as change the format of the results themselves (the micro view). See Changing the Format.
Yes, a free demo is available. Links in the demo do not contain any associate ID. You can also request a free temporary 1-month key to unlock the demo into the full version. Thus, not only is a free demo available, a 1-month full version is also available.
Yes, you make 100% of the commission. Once you have your key file to unlock Associate Engine, your links will only have your amazon.com associate ID (without the key file, links contain no associate ID). We will never put another amazon.com associate ID in your links like what scripts from other companies do.
Zombie processes are a normal part of unix servers (whether the processes are Associate Engine or some other program) and are not a problem. A process (such as Associate Engine) enters the zombie state when it has finished (and released all its program/data memory) but the parent process that started it (e.g.: Apache web server) has not yet gotten around to seeing that the child process finished. So the presence of zombie processes just means that the parent process is busy. When the parent process eventually gets around to seeing that the child process has finished, the parent will cause the child process to disappear from the ps process table.
If you redisplay ps after a few moments, you should see that those zombie processes will have been cleaned up by the unix operating system (other zombie processes might have appeared in the mean time; see the processes's PID). In unix, a zombie process means that the process (which is a child process) has exited and the unix OS is waiting for the parent process to ask if the child has finished yet. When the parent process eventually asks about the status of the child process, the unix OS will tell the parent process about the exit status and then will remove the child process's entry from the process table (Note: when the child process exited, resources used by it were immediately made free; only an entry in the OS's process table remains so that the child's exit status can be told to the parent process -- no other memory is used). If your web server is busy handling numerous requests (Associate Engine or regular requests), you might see one or more zombie ae.pl processes. These will clear up when the web server httpd process eventually gets around to checking the exit status of the finished ae.pl
You cannot kill a zombie process, because it's already dead. It is merely taking up an entry in the process table until the parent process asks about the status of the child process.
Yes. Click here.
E.&O.E.; © Cusimano.Com Corporation; www.c3scripts.com