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

# Werbemittel

> Die AFFILUSER-Tags der Bannerübersicht im Partnerbereich: Banner auflisten, Art und Ziel unterscheiden und den fertigen Quellcode zum Herauskopieren anbieten.

Auf der Bannerübersichtsseite `wsaffiluser_banners_deu.htm` sieht der Partner alle Werbemittel, die der Shopbetreiber für ihn bereitgestellt hat, und kopiert sich den fertigen Quellcode für seine eigene Website heraus. Alle Tags dieser Seite sind nur dort zulässig.

Das Gerüst ist immer dasselbe: `AFFILUSER-BannersData` klammert den ganzen Bereich und liefert als Schleife einen Durchlauf je Banner. Alles Weitere beschreibt den Banner des aktuellen Durchlaufs.

Wegweiser: [Eigenes Partnerprogramm betreiben](https://dokumentation.websale.de/v8s/marketing-funktionen/eigenes-partnerprogramm-betreiben.md)

## Das Gerüst der Bannerliste

```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}
```

Der Quellcode gehört in ein schreibgeschütztes `textarea`. Darin bleibt er als Text stehen, statt vom Browser ausgeführt zu werden, und der Partner kann ihn in einem Zug markieren.

> [!WARNING]
>
> Nutzen Sie durchgehend die SSL-Varianten `AFFILUSER-BannersHtmlFragmentSSL` und `AFFILUSER-BannersThumbnailUrlSSL`. Bindet der Partner den Banner über eine unverschlüsselte Adresse auf seiner verschlüsselten Seite ein, blockieren Browser ihn als gemischten Inhalt, und die Werbung erscheint gar nicht.

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `AFFILUSER-BannersData` | ja | ja | ja | ja |
| `AFFILUSER-BannersPaging` | ja | ja | ja | – |
| `AFFILUSER-BannersPerPage()` | ja | – | – | – |
| `AFFILUSER-BannersIDX` | ja | ja | ja | – |
| `AFFILUSER-BannersCaption` | ja | ja | ja | – |
| `AFFILUSER-BannersComment` | ja | ja | ja | – |
| `AFFILUSER-BannersDescr` | ja | ja | ja | – |
| `AFFILUSER-BannersBannerType` | ja | ja | ja | – |
| `AFFILUSER-BannersBannerTypeGraph` | – | ja | ja | – |
| `AFFILUSER-BannersBannerTypeText` | – | ja | ja | – |
| `AFFILUSER-BannersBannerTypeFlash` | – | ja | ja | – |
| `AFFILUSER-BannersTargetType` | ja | ja | ja | – |
| `AFFILUSER-BannersTargetTypeSubShop` | – | ja | ja | – |
| `AFFILUSER-BannersTargetTypeProduct` | – | ja | ja | – |
| `AFFILUSER-BannersTargetTypeCategory` | ja | ja | ja | – |
| `AFFILUSER-BannersSubShop` | ja | ja | ja | – |
| `AFFILUSER-BannersProdIndex` | ja | ja | ja | – |
| `AFFILUSER-BannersProdName` | ja | ja | ja | – |
| `AFFILUSER-BannersProdNumber` | ja | ja | ja | – |
| `AFFILUSER-BannersFile` | ja | ja | ja | – |
| `AFFILUSER-BannersThumbnail` | ja | ja | ja | – |
| `AFFILUSER-BannersThumbnailUrl` | ja | ja | ja | – |
| `AFFILUSER-BannersThumbnailUrlSSL` | ja | ja | ja | – |
| `AFFILUSER-BannersImageUrl` | ja | ja | ja | – |
| `AFFILUSER-BannersHtmlFragment` | ja | – | – | – |
| `AFFILUSER-BannersHtmlFragmentSSL` | ja | – | – | – |
| `AFFILUSER-DynamicBanner` | ja | ja | ja | – |

## Die Liste

### AFFILUSER-BannersData

Als Einzel-Tag die Anzahl der verfügbaren Banner, als Bereichs-Tag die Klammerung um die gesamte Liste, als Schleife ein Durchlauf je 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}
```

Der negative Bereich gehört dazu. Ein Partnerprogramm beginnt regelmäßig ohne Banner, und eine leere Seite ohne Erklärung wirkt wie ein Fehler.

### AFFILUSER-BannersPaging

Erzeugt die vollständige Blätterfunktion als Tabelle. Als Bereichs-Tag greift es nur, wenn es mehr als eine Seite gibt.

```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}
```

Die Tabelle wird vom Shop erzeugt. Gestalten lässt sie sich über die zugewiesenen Klassen:

| Klasse | Gilt für |
| - | - |
| `wsaffil_paging_table` | die Tabelle als Ganzes |
| `wsaffil_pagingcell_left` | linke Zelle mit der Schaltfläche zurück |
| `wsaffil_pagingcell_middle` | mittlere Zelle |
| `wsaffil_pagingcell_right` | rechte Zelle mit der Schaltfläche weiter |
| `wsaffil_paging_link` | die Links |
| `wsaffil_paging_text` | den Text |
| `wsaffil_paging_selected` | die aktuelle Seite |

### AFFILUSER-BannersPerPage()

Legt fest, wie viele Banner je Seite angezeigt werden. Ohne dieses Tag sind es 5.

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

Das Tag gibt nichts aus, es stellt nur ein. Es gehört deshalb vor die Liste und wird üblicherweise in einen HTML-Kommentar gesetzt, damit im Quelltext erkennbar bleibt, wo die Einstellung steht.

### AFFILUSER-BannersIDX

Gibt den Index des Banners aus. Er identifiziert den Banner innerhalb des Partnerprogramms.

## Beschriftung und Hinweise

### AFFILUSER-BannersCaption

Gibt die Überschrift oder Beschreibung des Banners aus, die im Online-Servicebereich hinterlegt wurde.

Bei einem grafischen Banner ist das der Text des `title`-Attributs, bei einem Text-Banner die Beschriftung selbst. Die Bedeutung wechselt also mit der Bannerart.

### AFFILUSER-BannersComment

Gibt den Kommentar des Shopbetreibers zu diesem Banner aus, beispielsweise einen Hinweis zum Einsatzzweck.

### AFFILUSER-BannersDescr

Gibt die Beschreibung des Banners aus.

## Art des Banners

### AFFILUSER-BannersBannerType

Gibt die Art des Banners als Zahl aus: 0 für einen grafischen Banner, 1 für einen Text-Banner oder Text-Link.

Für die Darstellung sind die drei Bereichs-Tags unten die bessere Wahl. Die Zahl brauchen Sie vor allem zur Fehlersuche.

### AFFILUSER-BannersBannerTypeGraph

Der Bereich wird angezeigt, wenn es sich um einen grafischen Banner handelt.

```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

Der Bereich wird angezeigt, wenn es sich um einen Text-Banner handelt.

### AFFILUSER-BannersBannerTypeFlash

Der Bereich wird angezeigt, wenn es sich um einen Flash-Banner handelt.

> [!WARNING]
>
> Flash wird von keinem aktuellen Browser mehr ausgeführt. Legen Sie keine neuen Banner dieser Art an. Im Template lohnt sich die Klammerung nur, um Altbestände als nicht mehr verwendbar zu kennzeichnen.

## Ziel des Banners

### AFFILUSER-BannersTargetType

Gibt die Art des beworbenen Objekts als Zahl aus: 0 für Werbung für den Subshop, 1 für Werbung für ein Produkt.

### AFFILUSER-BannersTargetTypeSubShop

Der Bereich wird angezeigt, wenn der Banner für einen Subshop wirbt.

### AFFILUSER-BannersTargetTypeProduct

Der Bereich wird angezeigt, wenn der Banner für ein Produkt wirbt. Innerhalb dieser Klammerung sind die Produktangaben gefüllt.

```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

Der Bereich wird angezeigt, wenn der Banner für eine Kategorie wirbt. Als Einzel-Tag gibt es zusätzlich die Kategorie aus.

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

Die drei Ziel-Tags schließen einander aus. Schreiben Sie sie deshalb nebeneinander und nicht ineinander, wie im Gerüst weiter oben gezeigt.

### AFFILUSER-BannersSubShop

Gibt den Subshop aus, in den der Banner verlinkt.

### AFFILUSER-BannersProdIndex

Gibt den Produktindex des beworbenen Produkts aus.

### AFFILUSER-BannersProdName

Gibt den Namen des beworbenen Produkts aus.

### AFFILUSER-BannersProdNumber

Gibt die Produktnummer des beworbenen Produkts aus.

## Bilder und Quellcode

### AFFILUSER-BannersFile

Gibt den Dateinamen des Bannerbildes aus.

### AFFILUSER-BannersThumbnail

Gibt den Dateinamen des Vorschaubildes eines beworbenen Produkts aus.

### AFFILUSER-BannersThumbnailUrl

Gibt den vollständigen Bildpfad des Vorschaubildes aus.

```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

Wie `AFFILUSER-BannersThumbnailUrl`, aber als verschlüsselte Adresse. Dies ist die Variante, die Sie einsetzen sollten.

### AFFILUSER-BannersImageUrl

Gibt einen Link auf den Banner aus.

> [!WARNING]
>
> Dieses Tag ist veraltet. Verwenden Sie für das Bild `AFFILUSER-BannersThumbnailUrlSSL` und für den fertigen Einbindungscode `AFFILUSER-BannersHtmlFragmentSSL`.

### AFFILUSER-BannersHtmlFragment

Gibt den fertigen Quellcode aus, den der Partner auf seiner Website einbaut. Er enthält bereits die Partnerkennung, damit Bestellungen zugeordnet werden können.

### AFFILUSER-BannersHtmlFragmentSSL

Wie `AFFILUSER-BannersHtmlFragment`, aber mit verschlüsselten Adressen. Dies ist die Variante, die Sie anbieten sollten.

## Eigene Banner erzeugen

### AFFILUSER-DynamicBanner

Liefert den Link zu der Seite, auf der sich der Partner zu einem beliebigen Produkt selbst einen Banner erzeugen kann.

```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}
```

Die Klammerung ist nötig, weil die Funktion nicht in jedem Partnerprogramm freigeschaltet ist. Ohne sie steht dort ein Link, der ins Leere führt.

## Verwandte Themen

* Wegweiser: [Eigenes Partnerprogramm betreiben](https://dokumentation.websale.de/v8s/marketing-funktionen/eigenes-partnerprogramm-betreiben.md)
* Referenz: [Bestellungen und Provisionen](https://dokumentation.websale.de/v8s/referenz/tags/affiluser/bestellungen-und-provisionen.md)
* Referenz: [Seitenübergreifende Tags](https://dokumentation.websale.de/v8s/referenz/tags/affiluser/seitenuebergreifende-tags.md)


## Related topics

- [Werbemittelkennzeichen](https://dokumentation.websale.de/frontend/funktionsubersicht/werbemittelkennzeichnung.md)
- [Werbemittelkennzeichen (Inserts) nutzen](https://dokumentation.websale.de/v8s/produkte/werbemittelkennzeichen-inserts-nutzen.md)
- [$wsInserts - Werbemittelkennzeichen](https://dokumentation.websale.de/frontend/referenz/module/wsinserts.md)
- [Materialien Direktbestellung](https://dokumentation.websale.de/v8s/materialien/materialien-direktbestellung.md)
- [content - Katalog (Kategorien & Produkte)](https://dokumentation.websale.de/konfiguration/content-katalog-kategorien-produkte.md)


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