> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertising materials

> The AFFILUSER tags of the banner overview in the partner area: listing banners, distinguishing type and target, and offering the finished source code for copying.

On the banner overview page `wsaffiluser_banners_deu.htm`, the partner sees all advertising materials that the shop operator has provided for them and copies the finished source code for their own website. All tags on this page are only permitted there.

The framework is always the same: `AFFILUSER-BannersData` brackets the entire range and, as a loop, provides one iteration per banner. Everything else describes the banner of the current iteration.

Guide: Running your own affiliate program

## The framework of the banner list

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!AFFILUSER-BannersData}
   Derzeit stehen keine Banner zur Auswahl.
{/!AFFILUSER-BannersData}

{AFFILUSER-BannersData}

   Verfügbare Banner: ~AFFILUSER-BannersData~

   {AFFILUSER-BannersPaging}~AFFILUSER-BannersPaging~{/AFFILUSER-BannersPaging}

   {@AFFILUSER-BannersData}

      {AFFILUSER-BannersCaption}<h3>~AFFILUSER-BannersCaption~</h3>{/AFFILUSER-BannersCaption}

      {AFFILUSER-BannersBannerTypeGraph}
         {AFFILUSER-BannersThumbnailUrlSSL}
            <img src="~AFFILUSER-BannersThumbnailUrlSSL~" alt="">
         {/AFFILUSER-BannersThumbnailUrlSSL}
      {/AFFILUSER-BannersBannerTypeGraph}

      Ziel:
      {AFFILUSER-BannersTargetTypeSubShop}Shop{/AFFILUSER-BannersTargetTypeSubShop}
      {AFFILUSER-BannersTargetTypeProduct}Produkt ~AFFILUSER-BannersProdName~{/AFFILUSER-BannersTargetTypeProduct}
      {AFFILUSER-BannersTargetTypeCategory}Kategorie ~AFFILUSER-BannersTargetTypeCategory~{/AFFILUSER-BannersTargetTypeCategory}

      {AFFILUSER-BannersComment}
         Hinweis des Shopbetreibers: ~AFFILUSER-BannersComment~
      {/AFFILUSER-BannersComment}

      Quellcode für Ihre Website:
      <textarea rows="5" cols="80" readonly>~AFFILUSER-BannersHtmlFragmentSSL~</textarea>

   {/@AFFILUSER-BannersData}

{/AFFILUSER-BannersData}
```

> [!NOTE]
>
> The source code belongs in a read-only `textarea`. There it remains as text instead of being executed by the browser, and the partner can select it in one go.

> [!WARNING]
>
> Use the SSL variants `AFFILUSER-BannersHtmlFragmentSSL` and `AFFILUSER-BannersThumbnailUrlSSL` throughout. If the partner embeds the banner on their encrypted page via an unencrypted address, browsers block it as mixed content and the advertisement does not appear at all.

| Tag | Single tag | Range tag | Negative range tag | Loop tag |
| - | - | - | - | - |
| `AFFILUSER-BannersData` | yes | yes | yes | yes |
| `AFFILUSER-BannersPaging` | yes | yes | yes | – |
| `AFFILUSER-BannersPerPage()` | yes | – | – | – |
| `AFFILUSER-BannersIDX` | yes | yes | yes | – |
| `AFFILUSER-BannersCaption` | yes | yes | yes | – |
| `AFFILUSER-BannersComment` | yes | yes | yes | – |
| `AFFILUSER-BannersDescr` | yes | yes | yes | – |
| `AFFILUSER-BannersBannerType` | yes | yes | yes | – |
| `AFFILUSER-BannersBannerTypeGraph` | – | yes | yes | – |
| `AFFILUSER-BannersBannerTypeText` | – | yes | yes | – |
| `AFFILUSER-BannersBannerTypeFlash` | – | yes | yes | – |
| `AFFILUSER-BannersTargetType` | yes | yes | yes | – |
| `AFFILUSER-BannersTargetTypeSubShop` | – | yes | yes | – |
| `AFFILUSER-BannersTargetTypeProduct` | – | yes | yes | – |
| `AFFILUSER-BannersTargetTypeCategory` | yes | yes | yes | – |
| `AFFILUSER-BannersSubShop` | yes | yes | yes | – |
| `AFFILUSER-BannersProdIndex` | yes | yes | yes | – |
| `AFFILUSER-BannersProdName` | yes | yes | yes | – |
| `AFFILUSER-BannersProdNumber` | yes | yes | yes | – |
| `AFFILUSER-BannersFile` | yes | yes | yes | – |
| `AFFILUSER-BannersThumbnail` | yes | yes | yes | – |
| `AFFILUSER-BannersThumbnailUrl` | yes | yes | yes | – |
| `AFFILUSER-BannersThumbnailUrlSSL` | yes | yes | yes | – |
| `AFFILUSER-BannersImageUrl` | yes | yes | yes | – |
| `AFFILUSER-BannersHtmlFragment` | yes | – | – | – |
| `AFFILUSER-BannersHtmlFragmentSSL` | yes | – | – | – |
| `AFFILUSER-DynamicBanner` | yes | yes | yes | – |

## The list

### AFFILUSER-BannersData

As a single tag, the number of available banners; as a range tag, the bracket around the entire list; as a loop, one iteration per banner.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersData}
   Verfügbare Banner: ~AFFILUSER-BannersData~
   {@AFFILUSER-BannersData}
      <!-- Angaben zum einzelnen Banner -->
   {/@AFFILUSER-BannersData}
{/AFFILUSER-BannersData}

{!AFFILUSER-BannersData}
   Derzeit stehen keine Banner zur Auswahl.
{/!AFFILUSER-BannersData}
```

> [!NOTE]
>
> The negative range is part of it. An affiliate program regularly starts without banners, and an empty page without explanation looks like an error.

### AFFILUSER-BannersPaging

Generates the complete paging function as a table. As a range tag, it only applies if there is more than one page.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersPaging}
   ~AFFILUSER-BannersPaging~
{/AFFILUSER-BannersPaging}

{!AFFILUSER-BannersPaging}
   Seite 1 von 1
{/!AFFILUSER-BannersPaging}
```

The table is generated by the shop. You can style it via the assigned classes:

| Class | Applies to |
| - | - |
| `wsaffil_paging_table` | the table as a whole |
| `wsaffil_pagingcell_left` | left cell with the back button |
| `wsaffil_pagingcell_middle` | middle cell |
| `wsaffil_pagingcell_right` | right cell with the next button |
| `wsaffil_paging_link` | the links |
| `wsaffil_paging_text` | the text |
| `wsaffil_paging_selected` | the current page |

### AFFILUSER-BannersPerPage()

Defines how many banners are displayed per page. Without this tag, it is 5.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~AFFILUSER-BannersPerPage(100)~
```

> [!NOTE]
>
> The tag does not output anything; it only sets a value. It therefore belongs before the list and is usually placed in an HTML comment so that it remains clear in the source code where the setting is located.

### AFFILUSER-BannersIDX

Outputs the index of the banner. It identifies the banner within the affiliate program.

## Labels and notes

### AFFILUSER-BannersCaption

Outputs the heading or description of the banner that was stored in the online service area.

> [!NOTE]
>
> For a graphical banner, this is the text of the `title` attribute; for a text banner, it is the label itself. The meaning therefore changes with the banner type.

### AFFILUSER-BannersComment

Outputs the shop operator's comment on this banner, for example a note about its intended use.

### AFFILUSER-BannersDescr

Outputs the description of the banner.

## Banner type

### AFFILUSER-BannersBannerType

Outputs the banner type as a number: 0 for a graphical banner, 1 for a text banner or text link.

> [!NOTE]
>
> For display purposes, the three range tags below are the better choice. You mainly need the number for troubleshooting.

### AFFILUSER-BannersBannerTypeGraph

The range is displayed if the banner is a graphical banner.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersBannerTypeGraph}Dies ist ein grafischer Banner.{/AFFILUSER-BannersBannerTypeGraph}
{!AFFILUSER-BannersBannerTypeGraph}Dies ist kein grafischer Banner.{/!AFFILUSER-BannersBannerTypeGraph}
```

### AFFILUSER-BannersBannerTypeText

The range is displayed if the banner is a text banner.

### AFFILUSER-BannersBannerTypeFlash

The range is displayed if the banner is a Flash banner.

> [!WARNING]
>
> Flash is no longer executed by any current browser. Do not create new banners of this type. In the template, the bracketing is only worthwhile for marking legacy banners as no longer usable.

## Banner target

### AFFILUSER-BannersTargetType

Outputs the type of the advertised object as a number: 0 for advertising the subshop, 1 for advertising a product.

### AFFILUSER-BannersTargetTypeSubShop

The range is displayed if the banner advertises a subshop.

### AFFILUSER-BannersTargetTypeProduct

The range is displayed if the banner advertises a product. Within this bracket, the product details are filled.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersTargetTypeProduct}
   Beworbenes Produkt: ~AFFILUSER-BannersProdName~ (~AFFILUSER-BannersProdNumber~)
{/AFFILUSER-BannersTargetTypeProduct}
```

### AFFILUSER-BannersTargetTypeCategory

The range is displayed if the banner advertises a category. As a single tag, it additionally outputs the category.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersTargetTypeCategory}
   Beworbene Kategorie: ~AFFILUSER-BannersTargetTypeCategory~
{/AFFILUSER-BannersTargetTypeCategory}
```

> [!NOTE]
>
> The three target tags are mutually exclusive. Therefore, write them next to each other rather than nested, as shown in the framework above.

### AFFILUSER-BannersSubShop

Outputs the subshop the banner links to.

### AFFILUSER-BannersProdIndex

Outputs the product index of the advertised product.

### AFFILUSER-BannersProdName

Outputs the name of the advertised product.

### AFFILUSER-BannersProdNumber

Outputs the product number of the advertised product.

## Images and source code

### AFFILUSER-BannersFile

Outputs the file name of the banner image.

### AFFILUSER-BannersThumbnail

Outputs the file name of the preview image of an advertised product.

### AFFILUSER-BannersThumbnailUrl

Outputs the complete image path of the preview image.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-BannersThumbnailUrl}
   <img src="~AFFILUSER-BannersThumbnailUrl~" alt="">
{/AFFILUSER-BannersThumbnailUrl}
```

### AFFILUSER-BannersThumbnailUrlSSL

Like `AFFILUSER-BannersThumbnailUrl`, but as an encrypted address. This is the variant you should use.

### AFFILUSER-BannersImageUrl

Outputs a link to the banner.

> [!WARNING]
>
> This tag is deprecated. For the image, use `AFFILUSER-BannersThumbnailUrlSSL`, and for the finished embed code, use `AFFILUSER-BannersHtmlFragmentSSL`.

### AFFILUSER-BannersHtmlFragment

Outputs the finished source code that the partner embeds on their website. It already contains the partner ID so that orders can be attributed.

### AFFILUSER-BannersHtmlFragmentSSL

Like `AFFILUSER-BannersHtmlFragment`, but with encrypted addresses. This is the variant you should offer.

## Creating custom banners

### AFFILUSER-DynamicBanner

Returns the link to the page where the partner can create a banner for any product themselves.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{AFFILUSER-DynamicBanner}
   <a href="~AFFILUSER-DynamicBanner~" target="_blank">Eigenen Banner erzeugen</a>
{/AFFILUSER-DynamicBanner}
```

> [!NOTE]
>
> The bracketing is necessary because the function is not enabled in every affiliate program. Without it, a link that leads nowhere would appear there.

## Related topics

* Guide: Running your own affiliate program
* Reference: Orders and commissions
* Reference: Cross-page tags


## Related topics

- [Orders and commissions](https://dokumentation.websale.de/en/v8s/referenz/tags/affiluser/bestellungen-und-provisionen.md)
- [Login and session](https://dokumentation.websale.de/en/v8s/referenz/tags/affiluser/anmeldung-und-sitzung.md)
- [Cross-page tags](https://dokumentation.websale.de/en/v8s/referenz/tags/affiluser/seitenuebergreifende-tags.md)
- [Materials: direct order](https://dokumentation.websale.de/en/v8s/materialien/materialien-direktbestellung.md)
- [Advertising success tracking with referer and subreferer](https://dokumentation.websale.de/en/v8s/marketing-funktionen/werbeerfolgskontrollen-mit-referer-und-subreferer.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.