Products will first need to be imported in the Affiliate-Toolkit before they can be processed by your website. This way your product data will be cached and you can even work on it or add information. In case you would like to show one product 4 times on your website, you simply need to change one information of the product and the change will be added correctly to all 4 locations.
Thanks to this structure products which are no longer available can be easily found. All products are located on one sport and you get a perfect overview.
Even from automated lists (such as the Amazon-bestseller) you can access your imported products. This means you can influence the displayed information at any time and adjust it accordingly.
Import a product
It is really easy to import a product in case you would like to load a product from the supported affiliate network.
A shop connection needs to be established. There are 4 different versions for your import available in our plugin.
Import via entering a unique ID
This is the oldest method and it is hardly used anymore today as it is really time-consuming. For this you need to add a new product via the menu “AT products” -> “create”.
1. Pick a shop
Here you pick the shop from which you would like to import a product. The product is then connected to your shop for as long as you would like to. If you would like to connect your product with a different shop later on, you simply need to open the product, change the shop, and the unique ID.
2. Choose a distinct key
In order for your imported product to be continuously updated, you need a distinct key for alignment. This key consists of the unique key DropDown and the textbox for the ID. In case you would like to update a product based on the EAN (as the product ID changes all the time), you pick EAN in this field. We don’t recommend the key type title and it shouldn’t be used.
3. Choose an ASIN (or a different ID), EAN or title (not recommended)
As previously mentioned, each field which is used for updating the product.
4. Save and publish
You can integrate a product on your website, regardless whether you are publishing it or not. A published product is only visible when you have activated the product pages. This way you can control via “draft” or “published” if a product page should be displayed for a product or if you would like to add it to your post just via template.
Import via Shortcode-Generator
You can also import products via the Shortcode-Generator in the editor. This way products can be created easily during posting.
Click on “AT Shortcode” and open the following window afterwards.
1. Import products
The button for the Shortcode generator is by default included in every post and visible on every page. In case you can’t see the button, please click here.
Once the generator dialogue is open, click on the second button, then import the products into your WP-page as a draft. The fist button would be for search already imported products.
2. Pick a shop
Here you pick the shop from which you would like to import a product. The product is then connected to your shop until you change it later on.
3. Entering search terms and “search”
Now you can start a search. Thereby the corresponding API will be contacted and the products will be loaded.
4. Import products
Products which have been imported via the Shortcode generator are saved as draft by default. In case you want to publish your product as a product page as well, you need to open and publish your product later on.
Import via product import
Another and faster method is importing via the “Product import” form (can be found in the menu via “AT Products”).
In case you would like to import products for WooCommerce or product pages, this preview works best.
1. Pick a shop
Here you pick the shop from which you would like to import a product.
2. Choose a distinct key
In order for your imported product to be continuously updated, you need a distinct key for alignment. Additional information can be found above.
3. Enter search term, ASIN, EAN
Enter your search term or several EANs resp. ASINs. The IDs can be separated by commas.
4. Choose search type
Simply select what you would like to search for. E.g. did you enter a search term, an ASIN or an EAN?
This buttons starts the search on API. When you scroll down you will also find a function to turn pages.
6. Import product as desired
You can integrate a product on your website, regardless whether you are publishing it or not. Additional information can be found above. In case you have WooCommerce-Add on installed, you will see this button and can directly import Woo-products.
Import via CSV-Import
In case you already have an Excel or CSV list with products you can add them very fast. Therefore the following menu item exists: “Affiliate Toolkit“ -> “tools” -> “product import”.
1. Pick a shop
Here you pick the shop from which you would like to import a product.
2. Enter one product per line
One line always consists of a distinct ID, key type, title, and status.
Here is a sample:
B01LXI96H8;ASIN;The Sims 4: City living;publish
This is a distinct ID. In Amazon’s case it’s ASIN, at eBay it’s the article number. EAN would also be possible, in case the proper key type was chosen in the following box.
That’s the key type. Here you can choose between ASIN, EAN, and TITLE. Here we also advice against picking a title.
The Sims 4: City living
Here you can enter a title for your product. In case you don’t want to enter a title, simply leave the box blank. However, under no circumstance should you delete a semicolon (“;”)!
That’s the status with which the product should be created. You can switch between “publish”; “draft”, and “woo” (WooCommerce product).
3. “Save changes”
No your list will be imported step by step. It is possible that now and then a product (due to the import speed) causes an error. This error should be gone latest by running the next Cronjob.
After clicking on “save changes” the import form will pop up and the product import begins. During this import, every product in the CSV is imported and afterwards integrated in the below text field. Even the WordPress post ID is created in this process.
Creating a product manually
Aside from the imported products you can also manually create products. However, this method does have a disadvantage. You can’t link your products to a shop and create a corresponding shop logo etc. Alternatively, your own CSV-list may come in handy through which you can display your own products.
You can manually create a product via “create”. By default, the shop is set to “manual product”. All inputs can be entered as requested and needed.
On our websites with manual products we post e.g. links dealing with “Products for less than 100 Euro”. This way you have a URL in the right spot and can change it later on as needed.
Detailed product tab information
The form for the product is divided into several tabs.
The tab product information contains all main data of a product. This information is not regularly updated. Here you can change your product information as needed. Only by manually new loading you can override this information.
1. Update product information when saving
If this option has been activated and you then click on “save”, all product information for this tab will be re-loaded from the API. After updating, the checkmark disappears.
The title from the API. This one will be used for all templates. For activated product pages, the title from above will be used for post title, etc. Proxy: %title% or %short_title%.
The EAN(s) from API. Multiple article numbers are separated by commas. These will be used for price comparison. In case no EAN exists, the price comparison will not be completed. Proxy: %ean%.
The ISBN from the API. This one is only used for books. Proxy: %isbn%.
5. Product groups
The internal product category from the API. They are not used for templates. Proxy: %productgroup%.
The manufacturer from the API. In case no author was found, this option will be used for the templates. Proxy: %hersteller%.
The author (of the book) from the API. Proxy: %autor%.
8. Number of pages
The number of pages (of a book) from the API. Currently no proxy available.
The brand (depending on the product category) from the API. Proxy: %brand%.
The HTML with pictures from the API. When publishing the text will be shorted (by default) to 250 characters. This can’t be changed in the settings. Proxy: %description_text% or %info_text% (shortened).
The products charateristics from the API – mainly with bullets. Here the normal HTML is used for standard processing. If left blank, a fallback to the shortened description is performed and can be limited in settings. Proxy: %features_text% or %info_text% (shortened).
If the product is integrated as the main product of a post, these posts will be displayed as links here. This list can also be displayed as proxy in the templates.
To fill these lists, you are presented a selection box with products in the post. Here you can simply select previously imported products and save them later on. Proxy: %post_list%.
13. Deactivate Hover-Link
Deactivates the Hover-Boxes at Intext-Links and supersedes the settings.
14. Is a WooCommerce product
If you place a checkmark here, the product (in AT mode -> WooCommerce) is automatically created as a WooCommerce product and will be updated continuously.
15. Don’t import the main picture of this product
If you place a checkmark here, you can replace the post pictures in the Affiliate-Toolkit product resp. in the WooCommerce product and it won’t be overridden by the plugin.
16. Process description and characteristics as HTML
Descriptions and characteristics are not “cleaned up” meaning the HTML won’t be removed. This is very useful for specially created texts, using HTML and highlights.
This tab presents all affiliate links which are used by this product. The fields are blocked because the checkmark at number 2 was activated. These fields are updated regularly.
1. Update “product page URL”, “customer review URL”, and “add to shopping cart URL” when saving
If you activate this checkmark and click on “save” all link information for this tab will be reloaded from the API. After the update has been completed, the checkmark will disappear.
2. Continuously update “product page URL”, “customer review URL”, and “add to shopping cart URL”
If you activate this checkmark, the URL fields are constantly updated. If you would like to override the link manually, you need to remove the checkmark.
3. Product page URL
Link to product page which is used by all links by default. Proxy: %producturl% or %productlink% (with href).
4. Shopping cart URL
The link to directly put an article into the shopping cart. Currently only supported by Amazon. Depending on the interface this link can also be designed as a second affiliate link. In case the link is empty, a fallback on the product page link will be created. Proxy: %cartlink% (with href)
5. Customer review URL
If you click on customer reviews, this URL will be used. Currently only supported by Amazon as well. Proxy: %customerreviewsurl% or %reviewslink% (with href)
6. Override customer review
This way a regular URL from the API is overridden and the review URL (number 7) will be used.
7. Review URL
In case you would like to link to your own review pages, you can enter the corresponding URL here. Proxy: %reviewsurl% or %reviewslink% (with href)
In this section, you will find customer reviews from Amazon (when activated) or your own review. The test badge for the comparison chart is also configurated here.
1. Update review information when saving
If you activate this checkmark and click on “save” the review as well as the “number of reviews” will be reloaded from the API. After the update has been completed, the checkmark will disappear.
2. Continuously update review information
If you activate this checkmark, the review fields are constantly updated. If you would like to override the value manually, you need to remove the checkmark.
The average customer review from Amazon (when activated) will be displayed here. Proxy: %rating%
4. Number of reviews
The number of customer reviews (when activated) will be displayed here. Proxy: %reviewcount%
This badge is displayed above the comparison charts and other boxes with a corresponding frame. Proxy: %testresult%
6. Our Review
The evaluation of our test can be entered here and will be displayed only in combination with the test review. Proxy: %testresult%
7. Test review
The detailed grading which the product received during our evaluation. Proxy: %testresult%
8. Test date
The date on which the test was conducted. May also be left empty. Proxy: %testresult%
9. Pro (per line)
Used for the processing of “PRO“– arguments. A positive argument per line. Proxy: %pro%
10. Contra (per line)
Used for the processing of “CONTRA“– arguments. A negative argument per line. Proxy: %contra%
Here all pictures will be displayed which were provided for the product by the API. The first picture is the main picture which will be used for standard templates. This picture will also be imported as the post picture. The following pictures are gallery pictures from the corresponding network and are imported into the gallery e.g. by WooCommerce.
1. Update pictures when saving
If you activate this checkmark and click on “save” the pictures will be reloaded from the API. After the update has been completed, the checkmark will disappear.
2. Continuously update pictures
If you activate this checkmark, the pictures are constantly updated. If you would like to manually add or remove a picture, you need to remove the checkmark.
3. Picture small (URL)
Picture from API with 75px along the long side (depending on API). Proxy: %smallimage% (with img-Tag) or %smallimageurl%
4. Picture medium (URL)
Picture from API with 160px along the long side (depending on API). Proxy: %mediumimage% (with img-Tag) or %mediumimageurl%
5. Picture large (URL)
Picture from API in original size. Proxy: %image% (with img-Tag) or %imageurl%
6. Add picture
Adds a new gallery picture but is only active when these pictures are not constantly updated.
Deletes the corresponding gallery picture.
8. Picture small (URL)
Picture from API with 75px along the long side (depending on API). Proxy: %thumbimages_1% (ascending numbers, with img-Tag)
9. Picture middle (URL)
Picture from API with 160px along the long side (depending on API). Proxy: %mediumimages_% (ascending numbers, with img-Tag)
10. Picture large (URL)
Picture from API in original size. Proxy: %images_% (ascending numbers, with img-Tag)
This tab provides you with all information regarding pricing, shipping, and availability.
1. Update price information when saving
If you activate this checkmark and click on “save” all fields of this tab will be reloaded from the API. After the update has been completed, the checkmark will disappear.
2. Continuously update price information
If you activate this checkmark, the price fields are constantly updated. If you would like to manually override the value, you need to remove the checkmark.
3. List price
The retail price as recommended by the manufacturer. This is the comparison price which is shown as “crosses out” by default. Proxy: %listprice%
The amount in Euros which you saved thanks to the current price. Proxy: %save_amount%
5. Percentage saved
The percentage (0 to 100%) you saved Proxy: %save_percentage%
6. Sale price
The current retail price (the price is not available if it does not exist!). Proxy: %price%
The delivery time of the corresponding seller. Proxy: %availability%
The costs for shipping and handling of the corresponding seller (Amazon and eBay don’t send out a response here). Proxy: %shipping%
9. Is Prime
The Prime logo will be shown correspondingly. Proxy: %prime_icon%
This tab shows you all offers which are used for the price comparison. The offers are automatically searched for via EAN. The EAN can be found in the “product information” tab. Multiple EANs can be divided by commas (,).
Only offers from shops which activated this setting (the field “search for offers in this shop (via EAN) automatically”) are searched for. Alternatively, you can also permanently link products.
Products which weren’t found via EAN are highlighted with “product not found” and will be omitted when displaying results.
1. Update more offers when saving
If you activate this checkmark and click on “save” offers will be reloaded. After the update has been completed, the checkmark will disappear.
2. Continuously update more offers
If you activate this checkmark, the offers are constantly updated. If you would like to manually override the value, you need to remove the checkmark.
3. Search for and add distinct product ID
With the help of this button you can manually add product. This becomes necessary when an article does not have an EAN for automated searching.
4. Hide offer
You can hide offers which you found using the EAN.
5. Delete offer
With the help of this button you can delete manually added products. This does not work for automated products. They need to be hidden via the “hide offer” option.
Tutorial: Manually create offer
As not every product can be added via EAN, sometimes you need to manually link a product. This can be done easily when following the steps outlined below.
Open the product and click on the “more offers” tabs.
1. Pick shop for offer
Here you can pick the shop from which you would like to import the product for the price comparison.
2. “Search for and add distinct product ID“
This button opens the search dialogue for the product.
3. Enter search term
Enter the search term for the product here.
That gets the search request on the corresponding API started.
4. Click on product
Now you choose the product for the price comparison.
5. Product has been added
Here you can see that the product has been added to the last line. The next step will also load the price, etc. from the API.
Now offers incl. your added products will be updated.
User defined fields
Within the settings you can create your own user defined fields. These fields can then be added to the product. All fields are available from the template and comparison charts options.
Fields of ACF (Advanced Custom Fields) are not added here.