3. What are products?

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?

5. “Search”

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

B01LXI96H8 

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.

ASIN

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 (“;”)!

publish

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.

Suggestion: You should import one product first and work with it. Otherwise you may eventually need manually delete all products and import them again!

 

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.

Important: The import form needs to stay open until the very end. Otherwise not all products may be loaded completely!

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.

Product information

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.

2. Title

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%.

3. EAN

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%.

4. ISBN

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%.

6. Manufacturer

The manufacturer from the API. In case no author was found, this option will be used for the templates. Proxy: %hersteller%.

7. Author

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.

9. Brand

The brand (depending on the product category) from the API. Proxy: %brand%.

10. Description

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).

11. Characteristics

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).

12. Post

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%.

atkp_mainproduct

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.

 

Links

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)

 

Review information

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.

3. Review

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%

Important: This information is scraped from the Amazon website and not loaded from the API. As Amazon often blocks such requests, the information is not always updated or may be even empty at times. In general, we advise against using this function! By doing so you violate the partnernet guidelines.

5. Badge

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%

 

Pictures

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.

7. Delete

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)

Important: Pictures are not saved on the own server! Linking to the CDN of the corresponding partner network is always active. Excluded from this regulation are post pictures or Woo gallery pictures. These are regularly updated in the media gallery.

 

Pricing

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%

4. Saved

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%

7. Availability

The delivery time of the corresponding seller. Proxy: %availability%

8. Shipping

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%

Important: Prices are internally save das numbers and presented newly formatted. In case you would like a 1:1 price to be displayed in the text box, you need to set the currency symbol to standard in the shop.

 

More offers

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.

4. “Search”

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.

6. “Update”

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.

atkp_fields

Fields of ACF (Advanced Custom Fields) are not added here.

 

Do you still have questions? No problem :-)
We are happy to answer your questions in our forum.