dokumentation für smarte affiliates · 2020. 5. 14. · der einfachste weg ist die installation...

43
Dokumentation für smarte Affiliates Version 1.5.7 © 2016 Christof Servit

Upload: others

Post on 04-Sep-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

Dokumentation für

smarte Affiliates

Version 1.5.7

© 2016 Christof Servit

Page 2: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 2 von 43

Erste Schritte ......................................................................................................................................................................... 3

Pakete ............................................................................................................................................................................... 3

Systemvoraussetzungen ................................................................................................................................................... 4

Installation ........................................................................................................................................................................ 4

Einrichtung ........................................................................................................................................................................ 4

Schnittstellen aktivieren ................................................................................................................................................... 5

Einstellungen ......................................................................................................................................................................... 5

Basis Einstellungen ........................................................................................................................................................... 5

Erweiterte Einstellungen .................................................................................................................................................. 7

Anzeige ............................................................................................................................................................................. 9

Benutzerdefinierte Felder ............................................................................................................................................... 11

Import-Werkzeug............................................................................................................................................................ 12

Shops ................................................................................................................................................................................... 12

Was sind Shops? ............................................................................................................................................................. 12

Amazon-Shop einrichten ................................................................................................................................................ 13

eBay-Shop einrichten ...................................................................................................................................................... 17

affili.net-Shop einrichten ................................................................................................................................................ 19

Zanox-Shop einrichten .................................................................................................................................................... 21

Produkte .............................................................................................................................................................................. 23

Was sind Produkte? ........................................................................................................................................................ 23

Produkt anlegen ............................................................................................................................................................. 23

Tabs im Detail ................................................................................................................................................................. 23

Felder im Detail .............................................................................................................................................................. 28

Listen ................................................................................................................................................................................... 30

Was sind Listen? ............................................................................................................................................................. 30

Liste anlegen ................................................................................................................................................................... 30

Vorlagen .............................................................................................................................................................................. 34

Was sind Vorlagen? ........................................................................................................................................................ 34

Vorlagen importieren und exportieren ........................................................................................................................... 34

Vorlage anlegen .............................................................................................................................................................. 35

Ablauf einer Vorlage ....................................................................................................................................................... 39

Tipps zur Vorlagegestaltung ........................................................................................................................................... 39

Wordpress-Widget .............................................................................................................................................................. 40

Shortcode Generator ........................................................................................................................................................... 40

Produkt ........................................................................................................................................................................... 40

Liste ................................................................................................................................................................................ 41

Feld ................................................................................................................................................................................. 41

Link ................................................................................................................................................................................. 41

Datenaktualisierung ............................................................................................................................................................ 42

Zeitgesteuerten Cronjob einrichten................................................................................................................................ 42

Entwickler ............................................................................................................................................................................ 43

Übersetzungen ............................................................................................................................................................... 43

Platzhalter übersteuern & erweitern .............................................................................................................................. 43

Page 3: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 3 von 43

Erste Schritte In diesem Abschnitt findest du die Systemvoraussetzungen und die Einrichtung des Affiliate-Toolkits.

Nimm dir bitte Zeit beim Durchlesen der Dokumentation. Wenn du Fragen hast, kannst du dich

jederzeit an uns wenden.

Pakete Das Affiliate-Toolkit unterscheidet sich, je nach Variante, nur im Funktionsumfang. Die folgenden

Versionen sind verfügbar und zeitlich uneingeschränkt nutzbar.

Alle Varianten verfügen außerdem über eine Auto-Update-Funktion welche direkt in Wordpress

integriert ist.

Die Pakete können immer auf eine höhere Version upgegradet werden. Man kann bei der Starter-

Version beginnen und bis zu Developer-Variante upgraden. Es gehen dabei keine Einstellungen

verloren. Bei den kostenpflichtigen Varianten ist lediglich die Differenz zu bezahlen. Für ein

kostenpflichtiges Update, bitte Kontakt mit dem Support aufnehmen ([email protected]).

Affiliate Toolkit Starter Eines vorweg: Falls du noch unser Bestseller-Plugin verwendest, dieses wurde mit diesem Paket

ersetzt. Der Funktionsumfang der Bestseller-Liste wird dadurch nicht eingeschränkt, sondern

erweitert.

Folgende Funktionen werden unterstützt:

- Amazon-API

- Shortcode-Generator

- Bestseller- und Such-Listen erstellen

- Produkte aus Amazon importieren und verwenden

- Produktlinks im Text

Affiliate Toolkit Standard Das Standard-Paket bietet weitere Funktionen, welche ganz nützlich sein können.

Folgende Funktionen werden derzeit unterstützt:

- Amazon-API, Affili.net, Zanox und eBay

- Wordpress-Widget, Shortcode-Generator

- Manuelle Listen, Such-Listen, Bestseller, Erweiterte Suche, ähnliche Produkte (von der

Schnittstelle abhängig)

- Manuelle Produkte, Produkte anlegen und bearbeiten

- Produktlinks, Hover-Links im Text

- Regelmäßige Datenüberprüfung und Verständigung per Mail

- Verschiedene Buttondesigns + Ändern der Farben

- Steuerung der Anzeige von Preis, Bewertung etc.

- Button-Texte beliebig pro Shop definieren

- Preisvergleich (manuelle Verknüpfung oder automatisch über EAN)

Affiliate Toolkit Plus Mit dem Plus-Paket kann man eigene Vorlagen erstellen. Wir stellen hier auch einige zur Verfügung,

diese können auf unserer Seite kostenlos heruntergeladen werden.

- Vorlagen erstellen, exportieren und importieren

Page 4: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 4 von 43

o Bildergalerie-Vorlage

o Preisvergleichvorlage

o Produktvorlage

- Benutzerdefinierte Felder

Affiliate Toolkit Developer Bei der Developer-Edition hat man alle Funktionen wie bei der Plus-Variante. Zusätzlich kann man

das Toolkit auch bei Kundenprojekten einsetzen und das Wasserzeichen im Quellcode ist nicht

sichtbar.

Systemvoraussetzungen Voraussetzung für die volle Funktionalität des Affiliate Toolkits sind: WordPress 4.0 und PHP 5.6

Für die Kommunikation mit der Amazon-API und eBay-API muss die SOAP Extension installiert sein.

Des Weiteren sollte die PHP Einstellung allow_url_fopen aktiv sein.

Du kannst bei deinem Hoster in Erfahrung bringen, ob dein Webspace diese Voraussetzungen erfüllt.

Tipp: Wenn unser kostenloses Starter-Plugin funktioniert, wird sehr wahrscheinlich auch unser

kostenpflichtiges Toolkit funktionieren.

Installation Du kannst Das Plugin über mehrere Wege installieren. Lade dir zuerst das Plugin auf unserer

Kundenseite herunter. Die Lizenz dafür hast du mit der Bestellbestätigung an deine E-Mail-Adresse

bekommen.

Dir wird automatisch der Download entsprechend deiner Lizenz ausgegeben. Das Plugin ist

außerdem deinem Lizenzschlüssel zugeordnet.

Wichtig: Vor der Installation musst du sicherstellen, dass keine andere Affiliate-Toolkit-Version

installiert ist. Sonst bekommst du beim Aktiveren eine sehr unschöne PHP-Fehlermeldung.

Installation über das Backend Der einfachste Weg ist die Installation über das Backend von WordPress.

Wenn du das Paket heruntergeladen hast, logge dich auf deiner WordPress Seite im Backend ein und

klicke auf Plugins -> Installieren. Dort klickst du dann auf Plugin hochladen und wählst die zuvor

heruntergeladene ZIP-Datei aus. Mit installieren wird das Plugin installiert. Wenn das Plugin

erfolgreich hochgeladen wurde, musst du es noch aktivieren. Das war es schon.

Installation über FTP Als alternative Methode kannst du das Plugin über FTP hochladen.

Entpacke die heruntergeladene ZIP-Datei auf deinem Computer. Kopiere den entpackten „Affiliate-

Toolkit“-Ordner in den FTP-Ordner /wp-content/plugins/.

Wenn du das Plugin hoch geladen hast, findest du es unter „Plugins“ und musst es nur mehr

aktivieren.

Einrichtung Nach der Aktivierung des Plugins findest du im linken Menübereich den Abschnitt Affiliate-Toolkit. Du

musst übrigens keine Lizenz eingeben, die Installation wird automatisch deinem Lizenzschlüssel

zugeordnet.

Page 5: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 5 von 43

Im Abschnitt des Affiliate-Toolkit klickst du dann auf Shops und legst einen neuen Shop an. Fülle dazu

einfach die Felder aus.

Sobald der Shop eingerichtet ist und erfolgreich verbunden wurde, kannst du auch schon mit dem

anlegen deiner Produkte und Listen beginnen.

Schnittstellen aktivieren Unser Plugin wird mit allen verfügbaren Schnittstellen ausgeliefert. Diese sind in jedem Paket bereits

inkludiert.

Derzeit sind die Amazon-API, Zanox, Affili.net und eBay verfügbar.

Einstellungen Das Affiliate-Toolkit verfügt über einige Einstellungen. Diese Einstellungen wirken sich auf die

komplette Installation aus. Je nach Paket werden die Optionen eventuell nicht angezeigt.

Basis Einstellungen Das Formular für die Basis-Einstellungen sieht wie folgt aus:

Durch klicken auf „Änderungen übernehmen“ wird der Cache sofort neu aufgebaut und auch die

Datenüberprüfung wird sofort ausgeführt.

Beide Aktionen werden über die Wordpress „Cronjobs“ gesteuert. Mehr dazu findest du im Abschnitt

„Datenaktualisierung im Hintergrund“.

Hinweis: Falls die Preise nicht aktualisiert wurden, kann es sein, dass der Crojob durch ein Update

oder sonstige Aktivitäten beendet wurde. Das erkennst du wenn keine „Nächste Ausführung“

angezeigt wird. Klicke dazu einfach auf „Änderungen übernehmen“, dadurch wird der Cache sofort

neu aufgebaut.

Datenüberprüfung Die Datenüberprüfung prüft in regelmäßigen Abständen den Datenbestand auf Richtigkeit.

Produkte werden auf vorhandene Preise geprüft und auf Fehler aus der API selbst.

Auch Listen werden auf Einträge geprüft und auf Fehler aus der API.

Page 6: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 6 von 43

Der Dienst prüft den aktuellen Zustand im gewählten Intervall und schickt eine Nachricht an den

Empfänger. Wird in das Empfängerfeld keine E-Mail-Adresse eingegeben, wird die Administrator-

Adresse aus der Installation verwendet.

Unter dem Überprüfungsintervall sieht man wann der Task das letzte Mal ausgeführt wurde und

wann er das nächste Mal läuft.

Datencache Der Datencache regelt die Aktualität der zu aktualisierenden Daten. Es kann ein Intervall von 1

Stunde bis zu einer Woche eingestellt werden.

Hier werden alle Produkte (je nach Einstellung im Produkt) aus der jeweiligen API aktualisiert. Tritt

ein Fehler beim Aktualisieren auf, wird dieser unter „Nachricht“ im jeweiligen Produkt angezeigt.

Auch Listen werden in diesem Schritt aktualisiert. Fehler werden hier ebenfalls unter „Nachricht“ bei

der Liste angezeigt.

Unter der eingestellten Cache-Dauer sieht man wann der Task das letzte Mal ausgeführt wurde und

wann er das nächste Mal läuft.

Page 7: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 7 von 43

Erweiterte Einstellungen Das Formular für die erweiterten Einstellungen sieht wie das folgende aus:

Haftungsausschluss Es ist ratsam den Haftungsausschluss zu aktivieren. Dieser wird automatisch nach dem Produkt oder

am Ende einer Liste angedruckt. Man kann Ihn gestalten wie man möchte.

Wir empfehlen hier, mindestens das Datum und die Uhrzeit der letzten Aktualisierung der Daten

anzuzeigen.

Amazon schreibt diese Information sogar vor, wenn Preise oder Lieferzeiten angezeigt werden

welche älter als 1 Stunde sind (sein können).

Links

„IN DEN WARENKORB“ AKTIVIEREN

Mit der Funktion „in den Warenkorb“ kann man webseitenweit einstellen, wie der Button angezeigt

werden soll. Dies gilt nur für den Button! Links bleiben weiterhin auf das normale Produkt verknüpft.

Durch „in den Warenkorb“ wird der Artikel direkt in den Warenkorb des jeweiligen Shops gelegt und

nicht erst auf die Produktseite direkt gelenkt.

LINKS MARKIEREN (*)

„Links markieren“ sollte aus rechtlichen Gründen eingeschaltet werden. Es dient zur Trennung von

Werbung und redaktionellem Inhalt. Sobald dies aktiviert ist, werden Affiliate-Links mit einem Stern

gekennzeichnet und Bild-Links mit „Werbung“ gekennzeichnet. Mehr Informationen findest du hier.

Page 8: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 8 von 43

LINKS IN NEUEM FENSTER/TAB ÖFFNEN

Mit diesem Haken werden Affiliate-Links in einem neuen Tab bzw. Fenster geöffnet.

Log-Datei Wenn bei den Abfragen ein Fehler auftritt, benötigen wir dazu das Logfile. Mit diesem Option kannst

du dieses aktivieren.

Stelle bitte vorher sicher, das in das Unterverzeichnis „Log“ im Affiliate-Toolkit-Plugin-Ordner

geschrieben werden kann.

SO AKTIVIERST DU DAS LOGGING

Um das Logging zu aktivieren, gehe in die Erweiterten Einstellungen und stelle den LogLevel auf

DEBUG um.

Danach öffne das Produkt mit dem Fehlerhaften Preis und erzwinge eine Aktualisierung (also einfach

Haken bei „Produktinformationen beim Speichern aktualisieren“ setzen).

Wenn du dich nun per FTP verbindest, müsstest du im Ordner vom Affiliate-Toolkit-Plugin ein

„log.txt“-File haben.

Diese Datei schickst du dann einfach an den Support.

Page 9: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 9 von 43

Anzeige Das Formular für die Anzeige-Einstellungen sieht wie das folgende aus:

Anzeige Über diese Optionen können die Vorlagen Webseiten-Weit gesteuert werden. Für die Boxen bzw. die

Buttons sind außerdem eigene Farbstyles verfügbar. Möchte man seinen eigenen Style anwenden,

kann man diesen auch deaktivieren.

Mehr Angebote Möchte man auf seiner Webseite den Preisvergleich

als Dropdown (unter dem Angebots-Button)

Page 10: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 10 von 43

anzeigen, setzt man hier „Angebote anzeigen“. Durch diese Option werden, wenn Angebote für das

Produkt vorhanden sind, diese mit „Weitere Angebote“ angezeigt.

Diese Link kann auch durch eine eigene Vorlage (Plus-Version) übersteuert werden.

Hover-Linkinformationen Durch setzen dieses Hakens kann man beim darüber Fahren

über einen Affiliate-Link produktrelevante Informationen

einblenden.

Diese Box wird nur bei Intext-Links eingeblendet. Bei Produkt

oder Listen-Vorlagen wird diese Box nicht verwendet.

Text Hier können bestimmte Optionen für Titel und Beschreibung angewandt werden.

MAXIMALE TITELLÄNGE

Hier wird der Titel von den Standardvorlagen (Platzhalter: short_title) auf eine bestimmte Länge

gekürzt wenn dieser länger ist.

MAXIMALE BESCHREIBUNGSLÄNGE

Wird in den Standardvorlage der Beschreibungstext statt der Eigenschaften verwenden, wird dieser

auf eine maximale Anzahl gekürzt.

BESCHREIBUNG & EIGENSCHAFTEN

Mit dieser Option steuert man, ob vorzugsweise Eigenschaften und sonst Beschreibung

(Standardeinstellung) angezeigt werden soll oder nur Beschreibung bzw. Eigenschaften.

Page 11: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 11 von 43

Benutzerdefinierte Felder Benutzerdefinierte Felder sind nur im Plus- und Developer-Paket verfügbar. Das Formular sieht wie

folgt aus:

Hier können beliebig viele benutzerdefinierte Felder angelegt werden. Diese Felder werden dann

beim Produkt angezeigt und können entsprechend gesetzt werden.

Die Felder kann man dann entweder im Beitrag einbinden (mit Shortcodes) oder in eigenen

benutzerdefinierten Vorlagen verwenden.

Bezeichnung Die Bezeichnung kann frei gewählt werden. Sie wird nur intern beim Produkt angezeigt.

Name Der Name wird als Platzhalter in den Vorlagen verwendet (mit „customfield_“ als Prefix). Dieser

Name wird intern validiert und ggf. korrigiert.

Bleibt das Feld bei der Eingabe leer wird entweder die Bezeichnung verwendet oder eine eindeutige

Nummer eingefügt.

Achtung: Durch ändern des Namens gehen eingegebene Werte bei den Produkten verloren!

Typ Hier kann zwischen den folgenden Optionen gewählt werden:

TEXT

Hier handelt es sich um eine einfache, einzeilige Textbox. Mit der Formatfunktion kann die Gültigkeit

bei der Eingabe im Produkt gesteuert werden.

Es stehen die Formate „text“ (Standard), „number“ und „url“ zur Verfügung.

MEHRZEILIGER TEXT

Mit dieser Option wird eine mehrzeilige Textbox angezeigt. Ideal wenn man einfachen mehrzeiligen

Text verwenden möchte.

AUSWAHLFELD

Mit dem Auswahlfeld können bestimmte Optionen vorgegeben werden. Im Format-Feld gibt man die

verfügbaren Optionen mit Semikolon getrennt ein. Beispiel: „1 kg;2 kg“.

Page 12: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 12 von 43

JA/NEIN

Ja/Nein Felder sind ideal wenn man in einem Vergleich nur „Ja“ oder „Nein“ anzeigen möchte. Hier

werden bei der Ausgabe ein grüner Haken und ein rotes Kreuz verwendet.

Möchte man keine Bilder ausgeben, sondern nur „Ja“ oder „Nein“, gibt man in das Format-Feld

„text“ ein.

HTML

Bei verwenden von HTML wird der Wordpress-Editor zum Bearbeiten von formatiertem Text

angezeigt. Hier hat man keine Grenzen mehr und kann auch Bilder einfügen.

Format Je nach Typ kann hier ein unterschiedliches Format definiert werden. Bitte den jeweiligen Typ

beachten.

Import-Werkzeug Mit unserem Import-Werkzeug kannst du Vorlagen von unserer Webseite oder von deinen

bestehenden Projekten bequem importieren.

Wähle einfach deine exportierte Vorlage aus und klicke auf „Änderungen übernehmen“. Es erscheint

keine Erfolgsmeldung. Du findest deine importierte Vorlage sofort unter Vorlagen.

Tipp: Dadurch kannst du deine Vorlagen auch bequem kopieren. Einfach exportieren und wieder

importieren.

Shops Was sind Shops? Im Affiliate-Toolkit werden sämtliche API-Zugriffe (wie z.B. auf Amazon) über Shops gesteuert. In

einem Shop werden also die Zugriffsschlüssel, Tracking-IDs und sonstige relevante API-spezifische

Daten gespeichert.

Wenn Informationen über die API für ein Produkt oder eine Liste geladen werden, muss dafür ein

Shop angegeben werden. Diese Zugangsdaten werden dann verwendet.

Du kannst also z.B. einen Shop für Tracking-ID „A“ anlegen und einen Shop für Tracking-ID „B“

anlegen. Je nachdem welchen Shop du beim jeweiligen Produkt verwendest wird eine andere

Tracking-ID verwendet.

Um Produkte oder Listen anlegen zu können benötigst du keinen konfigurierten Shop. Du kannst

auch alle Daten manuell eingeben. Ein Shop erleichtert dir nur den Produktimport und kann

Preise/Lieferzeiten aktuell halten.

Page 13: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 13 von 43

Amazon-Shop einrichten Mit dem Toolkit bekommst du eine Amazon-API mitgeliefert. Wenn du dafür einen Shop anlegen

möchtest, bekommst du folgende Eingabe zu sehen.

Datenlieferant Hier wählst du die Amazon API aus. Danach kannst du deine Zugangsdaten eingeben.

Amazon Zugangsdaten finden Um auf die API von Amazon zugreifen zu können, benötigst du „Access Key ID“ und „Secret Access

Key“. Diese beiden Schlüssel findest du im Partnerbereich von Amazon.

Klicke im Partnerbereich auf Product Advertising API (Menü) -> Dokumentation -> Account

Einstellungen.

Danach bei Benutzerkennung auf „Klicken Sie hier“.

Page 14: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 14 von 43

Nach einer Anmeldung mit deinem Partnerzugang, kannst du unter Access Keys einen neuen

Schlüssel anlegen.

Gehe unbedingt sorgsam mit deinem Schlüssel um!

Sonstige Einstellungen Hast du deinen Schlüssel im Plugin eingegeben, musst du noch das richtige Land auswählen und

deine Tracking-ID einfügen. Wähle noch aus, ob du HTTPS (SSL) für die Produktbilder verwenden

möchtest und ob du die Kundenbewertungen auch von Amazon laden möchtest (Nicht empfohlen,

Abschnitt „Kundenbewertungen von Amazon“ beachten).

Texte & Logo Texte werden beim Anlegen automatisch mit Standardwerten befüllt. Du musst diese also nicht

ausfüllen.

Mit Shop-Logo anzeigen wird bei allen Widgets das Amazon-Logo angezeigt. Sinnvoll wenn du

mehrere Shops verwendest.

Die Texte für „Kaufen bei“ und „In den Warenkorb legen“ werden je nach gewähltem Modus (unter

Einstellungen) in den Buttons angezeigt.

Währungssymbol Mit dem Währungssymbol kannst du die Formatierung der Preise steuern. Entweder EUR, €, USD, $

oder Standard. Mit Standard wird nichts neu formatiert.

Page 15: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 15 von 43

Einstellungen testen Hast du alle Daten richtig eingegeben, klicke auf veröffentlichen. Das Plugin stellt nun eine

Verbindung zur API her und prüft die Schlüssel. Ist der Test erfolgreich, steht beim Status

„verbunden“. Der Shop kann nun verwendet werden.

Tipps zur API Wenn du die Amazon-API verwendest solltest du einige Dinge beachten. Das Partnerprogramm ist

hier sehr streng. Einmal gesperrt, kann man nur schwer wieder ein Partnerkonto eröffnen.

KUNDENBEWERTUNGEN VON AMAZON

Unser Plugin ermöglicht es dir, die Kundenbewertungen direkt von Amazon zu laden.

Diese Funktionalität wird jedoch nicht von der Amazon-API angeboten. Wir holen uns diese

Informationen aus dem Quellcode der Bewertungs-URL. Laut Amazon Richtlinien dürfen jedoch nur

Informationen aus der API verwendet werden.

Wir raten dir deshalb davon ab, diese Funktionalität zu verwenden. Du riskierst damit einen

Ausschluss aus dem Amazon-Partnerprogramm.

WAS SIND BROWSENODES?

Die BrowseNode-ID ist die ID der Kategorie auf Amazon. Jede Kategorie hat eine eigene eindeutige

ID.

Diese eindeutige ID kann über unsere integrierte Suchfunktion per Schlüsselbegriff gefunden werden

oder du kannst diese auch direkt auf Amazon finden.

Wenn du z.B. in der Ansicht für die Bestseller bist, findest du die ID in der Adressleiste deines

Browsers:

Ein wichtiger Hinweis zu der Browsenode-ID:

Amazon ändert diese ID in unregelmäßigen Abständen. Sie kann also schnell keine Ergebnisse mehr

zurückliefern.

Page 16: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 16 von 43

Tipp: Wenn du in unserem Plugin die Datenüberprüfung aktiviert hast, erkennt das Toolkit das und

schickt dir dazu eine E-Mail.

Page 17: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 17 von 43

eBay-Shop einrichten Mit dem Toolkit bekommst du eine ebay-API mitgeliefert. Wenn du dafür einen Shop anlegen

möchtest, bekommst du folgende Eingabe zu sehen.

Für viele ist das Partnerprogramm von eBay zu umständlich. Wir zeigen dir hier wie du an deine

Zugangsdaten kommst.

Datenlieferant Hier wählst du die eBay API aus. Danach kannst du deine Zugangsdaten eingeben.

eBay Zugangsdaten finden Um auf die API von Amazon zugreifen zu können, benötigst du „Access Key ID“ und „Secret Access

Key“. Diese beiden Schlüssel findest du im Partnerbereich von Amazon.

Du benötigst dafür einen Partnernet-Account. Sobald du diesen angelegt hast, kannst du dich auf

https://developer.ebay.com registrieren (neuer Account).

Bist du eingeloggt, kannst du einmal ein Sandbox-Keyset und einmal ein „Production“-Keyset

anlegen. Eventuell musst du vorher noch einen Applikationsnamen anlegen, diesen kannst du frei

wählen.

Die App ID, Dev ID und die Cert ID müssen nun als Zugangsdaten im Shop eingetragen werden.

Page 18: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 18 von 43

KAMPAGNEN-ID

Um die Klicks auf deine Links tracken zu können, benötigst du noch eine Kampagnen-ID. Diese ist

ähnlich der Tracking-ID bei Amazon.

Kopiere dann einfach die Kampagnen-ID in das entsprechende Shop-Feld.

Sonstige Einstellungen Jetzt musst du noch das richtige Land auswählen. Grundsätzlich findet eBay den richtigen Shop per

Geolocation. Der Benutzer wird also in den richtigen Shop weitergeleitet. Wähle noch aus, ob du

HTTPS (SSL) für die Produktbilder verwenden.

Texte & Logo Texte werden beim Anlegen automatisch mit Standardwerten befüllt. Du musst diese also nicht

ausfüllen.

Mit Shop-Logo anzeigen wird bei allen Widgets das eBay-Logo angezeigt. Sinnvoll wenn du mehrere

Shops verwendest.

Die Texte für „Kaufen bei“ und „In den Warenkorb legen“ werden je nach gewähltem Modus (unter

Einstellungen) in den Buttons angezeigt. Die Buttons selbst haben jedoch keine unterschiedliche

Auswirkung. Ebay unterstützt diese Funktion nicht.

Währungssymbol Mit dem Währungssymbol kannst du die Formatierung der Preise steuern. Entweder EUR, €, USD, $

oder Standard. Mit Standard wird nichts neu formatiert.

Einstellungen testen Hast du alle Daten richtig eingegeben, klicke auf veröffentlichen. Das Plugin stellt nun eine

Verbindung zur API her und prüft die Schlüssel. Ist der Test erfolgreich, steht beim Status

„verbunden“. Der Shop kann nun verwendet werden.

Page 19: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 19 von 43

affili.net-Shop einrichten Mit dem Toolkit bekommst du eine Affili.net-API mitgeliefert. Wenn du dafür einen Shop anlegen

möchtest, wird dir folgende Eingabe angezeigt.

Datenlieferant Hier wählst du die affili.net API aus. Danach kannst du deine Zugangsdaten eingeben.

Affili.net Zugangsdaten finden Bei diesem Netzwerk findet man die Zugangsdaten sehr schnell. Man muss sich lediglich mit seinen

Publisher-Daten anmelden und wählt im Menü „Webservice Zugangsdaten“ aus.

Diese trägt man in den Shop ein, wählt noch aus ob SSL und Shop-Logos verwendet werden sollen

und klickt dann auf speichern.

Page 20: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 20 von 43

Die Zugangsdaten werden nun überprüft und alle verfügbaren Partnerprogramme aus dem Netzwerk

geladen. Du musst nun lediglich den Haken bei den gewünschten Partnerprogrammen setzen und

schon sind sie verfügbar.

Texte & Logo Texte werden beim Anlegen automatisch mit Standardwerten befüllt. Du musst diese also nicht

ausfüllen.

Mit Shop-Logo anzeigen wird bei allen Widgets das jeweilige Partnerprogramm -Logo angezeigt.

Sinnvoll wenn du mehrere Shops verwendest.

Die Texte für „Kaufen bei“ und „In den Warenkorb legen“ werden je nach gewähltem Modus (unter

Einstellungen) in den Buttons angezeigt. Die Buttons selbst haben jedoch keine unterschiedliche

Auswirkung. Ebay unterstützt diese Funktion nicht.

Währungssymbol Mit dem Währungssymbol kannst du die Formatierung der Preise steuern. Entweder EUR, €, USD, $

oder Standard. Mit Standard wird nichts neu formatiert.

Einstellungen testen Hast du alle Daten richtig eingegeben, klicke auf veröffentlichen. Das Plugin stellt nun eine

Verbindung zur API her und prüft die Schlüssel. Ist der Test erfolgreich, steht beim Status

„verbunden“. Der Shop kann nun verwendet werden.

Page 21: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 21 von 43

Zanox-Shop einrichten Mit dem Toolkit bekommst du eine Zanox-API mitgeliefert. Wenn du dafür einen Shop anlegen

möchtest, wird dir folgende Eingabe angezeigt.

Datenlieferant Hier wählst du die Zanox API aus. Danach kannst du deine Zugangsdaten eingeben.

Zanox Zugangsdaten finden Bei diesem Netzwerk findet man die Zugangsdaten ebenfalls sehr schnell. Man muss sich lediglich mit

seinen Publisher-Daten anmelden und wählt im Menü „API“ aus.

Diese trägt man in den Shop ein, wählt noch aus ob SSL und Shop-Logos verwendet werden sollen

und klickt dann auf speichern.

Page 22: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 22 von 43

Die Zugangsdaten werden nun überprüft und alle verfügbaren Partnerprogramme aus dem Netzwerk

geladen. Du musst nun lediglich den Haken bei den gewünschten Partnerprogrammen setzen und

schon sind sie verfügbar.

Texte & Logo Texte werden beim Anlegen automatisch mit Standardwerten befüllt. Du musst diese also nicht

ausfüllen.

Mit Shop-Logo anzeigen wird bei allen Widgets das jeweilige Partnerprogramm-Logo angezeigt.

Sinnvoll wenn du mehrere Shops verwendest.

Die Texte für „Kaufen bei“ und „In den Warenkorb legen“ werden je nach gewähltem Modus (unter

Einstellungen) in den Buttons angezeigt. Die Buttons selbst haben jedoch keine unterschiedliche

Auswirkung. Ebay unterstützt diese Funktion nicht.

Währungssymbol Mit dem Währungssymbol kannst du die Formatierung der Preise steuern. Entweder EUR, €, USD, $

oder Standard. Mit Standard wird nichts neu formatiert.

Einstellungen testen Hast du alle Daten richtig eingegeben, klicke auf veröffentlichen. Das Plugin stellt nun eine

Verbindung zur API her und prüft die Schlüssel. Ist der Test erfolgreich, steht beim Status

„verbunden“. Der Shop kann nun verwendet werden.

Page 23: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 23 von 43

Produkte Was sind Produkte? Über ein Produkt werden im Affiliate-Toolkit alle produktspezifischen Daten abgebildet. Wenn du

also Produktdaten auf deiner Webseite 4 Mal anzeigst und du änderst eine Angabe im Produktblatt,

dann wird diese Änderung an allen 4 Stellen geändert.

Dadurch hat man alle wichtigen Informationen an einer Stelle hinterlegt und muss nicht mühsam

jeden Link oder Titel an unzähligen Stellen ändern.

Lädt man z.B. Bestseller-Listen über die Amazon-API, können die Produktinformationen dort

ebenfalls über angelegte Produkte „übersteuert“ werden. Du kannst also jederzeit auf alle

angezeigten Informationen Einfluss nehmen und diese entsprechend anpassen.

Produkt anlegen Im Affiliate-Toolkit wird eine grundlegende Unterscheidung getroffen. Handelt es sich um ein

manuelles oder ein API-Produkt. Je nachdem welchen Shop man auswählt, muss man die Angaben

entweder manuell eingeben oder kann diese abrufen.

Manuelles Produkt Standardmäßig ist der Shop auf „Manuelles Produkt“ gestellt. Alle Angaben können beliebig

eingegeben werden. Wir bilden damit z.B. auch Links mit „Produkte unter 100 Euro“ ab.

Shop Produkt Mit einem Shop-Produkt können Informationen mit einem Klick aus der API geladen werden. Je

nachdem wie viele Informationen zur Verfügung gestellt werden.

Entweder man gibt die ASIN-ID manuell ein oder man sucht sie über „ASIN suchen“. Ist die ASIN

eingegeben und der Shop ausgewählt, klickt man auf „veröffentlichen“.

Wurde „xx beim Speichern aktualisieren“ angehakt (wird automatisch gemacht), werden diese

Informationen abgerufen.

Felder welche gelb sind, werden laufend über die API aktualisiert (und damit überschrieben).

Tabs im Detail Das Formular für das Produkt wird in mehrere Tabs unterteilt.

Page 24: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 24 von 43

Produktinformationen

Die Produktinformationen enthalten alle Stammdaten und können nicht regelmäßig aktualisiert

werden. Hier können Produktinfos aufbereitet und ggf. geändert werden.

Page 25: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 25 von 43

Links

Dieser Tab enthält alle Affiliate-Links. Werden diese regelmäßig aktualisiert, sind die Felder gesperrt

und können nicht bearbeitet werden.

Möchte man den Standard-Link zum Amazon-Bewertungsseite übersteuert, setzt man hier den

Haken „Kundenbewertungen übersteuern“ und kann damit immer auf ein eigenes Review oder

Testbericht verlinken.

Bewertungsinformationen

In diesem Bereich stehen entweder die Kundenbewertungen von Amazon (wenn aktiviert) oder eine

eigene Bewertung.

Page 26: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 26 von 43

Bilder

Hier werden alle Bilder angezeigt, welche für das Produkt verfügbar sind. Das erste Bild ist das

Hauptbild welches bei den Standardvorlagen verwendet wird. Die nachfolgenden Bilder sind

Galeriebilder aus dem jeweiligen Netzwerk.

Die Bilder können auch regelmäßig aktualisiert werden.

Wichtig: Die Bilder werden niemals auf den eigenen Server gespeichert! Es wird immer auf den CDN

des jeweiligen Partnernetzwerkes verlinkt.

Preisinformationen

Die Maske für die Preisinformationen wird ebenfalls gesperrt wenn diese aus der API aktualisiert

werden sollen.

Page 27: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 27 von 43

Mehr Angebote In diesem Tab findest du alle Angebote welche für den Preisvergleich verwendet werden. Zum einen

sind das automatisch verknüpfte Artikel (EAN aus dem ersten Tab Produktinformationen) und zum

anderen sind das die aktivierten Shops für den Preisvergleich (Haken bei „Mehr Angebote laden“).

Mehrere EANs werden übrigens über Komma getrennt.

Neben der automatischen Produktsuche über die EAN kannst du die Artikel auch manuell

verknüpfen. Das ist bei eBay sogar notwendig. Hier kann man leider nicht nach einer EAN suchen.

Produkte welche nicht gefunden werden, werden mit „product not found“ gekennzeichnet.

Über Produkt-ID hinzufügen kann man ganz einfach die Artikel manuell verknüpfen:

Page 28: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 28 von 43

Benutzerdefinierte Felder Reichen einem die vorhandenen Felder nicht aus, kann man über die Einstellungen auch eigene

Felder definieren. Diese Felder werden hier angezeigt.

Dieses Feature ist nur in der Plus-Version verfügbar. Auf diese Felder kann man dann in der Vorlage

einfach zugreifen.

Felder im Detail Hier findest du nun alle Felder aus dem Produkt im Detail und wofür diese dienen.

Shopinformationen Diese Informationen dienen lediglich dem Shop (API).

Shop Entweder ein manuelles Produkt oder ein (zuvor) angelegter Shop.

Amazon ASIN Die ASIN welche das Produkt aus Amazon identifiziert.

Produktinformationen Diese Informationen können nicht regelmäßig aktualisiert werden. Nur beim Speichern wenn der Haken entsprechend gesetzt wurde.

Hover-Link deaktivieren Deaktiviert die Hover-Box bei Intext-Links pro Produkt. Übersteuert die Einstellungen.

Titel Der Titel aus der API.

EAN Die EAN(s) aus der API. Mehrere durch Komma getrennt.

ISBN Die ISBN aus der API. Nur bei Büchern

Produktgruppe Die interne Produktkategorie aus der API.

Bild klein (URL) Das Bild aus der API mit 75px an der langen Seite.

Bild mittel (URL) Das Bild aus der API mit 160px an der langen Seite.

Bild groß (URL) Das Bild aus der API in Originalgröße.

Bilder Thumbnails (URL) Pro Zeile kann ein Bild eingegeben werden. Hier sind die Bilder an der langen Seite 160px.

Bilder (URL) Pro Zeile kann ein Bild eingegeben werden. Hier sind die Bilder in der originalen Größe.

Manufacturer Hersteller aus der API.

Author Author (bei Büchern) aus der API.

Seitenanzahl Seitenanzahl (bei Büchern) aus der API.

Brand Marke aus der API (je nach Produktkategorie).

Beschreibung HTML mit Bildern aus der API. Bei der Ausgabe im wird der Text auf 250 Zeichen gekürzt.

Eigenschaften Produkteigenschaften aus der API meist mit Aufzählungspunkten. Normales HTML. Wird für die Standardausgabe verwendet. Wenn

Page 29: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 29 von 43

diese leer sind, wird ein Fallback auf die gekürzte Beschreibung gemacht.

Produktseite URL Die URL für den Link auf die Produktseite. Wird regelmäßig aus der API aktualisiert wenn aktiviert.

Warenkorb URL Die URL für den Link in den Warenkorb. Wird regelmäßig aus der API aktualisiert wenn aktiviert.

Kundenbewertung URL Die URL für den Link auf die Bewertungsseite. Wird regelmäßig aus der API aktualisiert wenn aktiviert.

Bewertungsinformationen Diese Informationen können regelmäßig aus der API aktualisiert werden.

Bewertung Eine Bewertung zwischen 0 und 5 mit einer Dezimalstelle. Kann aus der API geladen werden. Möchte man die eigene Bewertung verwenden, muss man den Haken bei „Bewertungsinformationen laufend aktualisieren“ entfernen.

Anzahl der Bewertungen Wieviel (Kunden-) Bewertungen hat dieser Artikel? Wird ignoriert wenn eigene Bewertung oder Anzahl 0.

Das ist meine Bewertung Ist dieser Haken gesetzt, wird der Link in der Bewertungs-URL verwendet oder (wenn leer) kein Link angezeigt. Durch setzten dieses Haken wird außerdem die Affiliate-Link-Kennzeichnung ausgeschaltet.

Bewertungs-URL Hier wird der eigenen Bericht/Vorstellung eingetragen.

Preisinformationen Diese Informationen können regelmäßig aus der API aktualisiert werden.

Listenpreis Listenpreis aus API.

Gespart Gespart in Euro aus der API.

Prozent gespart Prozentwert gespart aus der API

Verkaufspreis Der tatsächliche Verkaufspreis aus der API.

Verfügbarkeit Text mit Verfügbarkeit lt. API

Ist Prime Checkbox, ob das Prime-Logo angezeigt wird.

Benutzerdefinierte Felder Diese Informationen können nur manuell eingegeben werden.

Hier werden beliebige Felder angezeigt. Je nachdem wie diese in den Einstellungen definiert wurden.

Page 30: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 30 von 43

Listen Was sind Listen? Über Listen können mehrere Produkte zusammengefasst werden. Entweder man erstellt eine eigene

fixe Liste oder man ruft die Informationen dynamisch aus der API ab.

Liste anlegen Auch bei Listen wird im Affiliate-Toolkit zwischen dynamischen und manuellen Listen unterschieden.

Je nachdem, ob ein Shop gewählt wurde oder nicht bekommt man ein eigenes Formular angezeigt.

Manuelle Liste Das Formular für eine manuelle Liste sieht folgendermaßen aus.

Erstellt man eine manuelle Liste, kann man diese über die bereits angelegten Produkte frei

definieren. Man kann die Produkte einzeln einfügen und frei sortieren.

Den Listen-URL kann man dabei frei definieren oder leer lassen.

Shop Liste Möchte man Informationen aus der API laden, hat man eine andere Auswahl zur Verfügung. Je nach

Quelle unterscheidet man hier nochmals beim Formularaufbau.

Verwendet man Shop-Listen, kann man die Listen-URL nicht frei definieren. Diese wird dann aus den

Ergebnissen von der API überschrieben.

Page 31: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 31 von 43

LOKALE PRODUKTINFORMATIONEN BEVORZUGEN

Mit der Option „Lokale Produktinformationen bevorzugen“ wird beim Abruf der Liste auf lokale

Produkte geprüft. Wurde ein Artikel angelegt, werden die Informationen von diesem Artikel

verwendet.

WEITERE ANGEBOTE AUS ANDEREN SHOPS LADEN

Mit dieser Option wird für jeden geladenen Eintrag auch eine automatische EAN-Suche gemacht (wie

beim Produkt). Diese Angebote werden auch in der Liste entsprechend angezeigt.

TEXT-FILTER

Mit dieser Funktion kann man die Ergebnisse aus der API nochmalig nach Schlüsselbegriffen

sortieren. Bei den Bestellern für „Exzenterschleifer“ kommt z.B.: auch ein Multischleifer. Hier kann

man dann den Begriff „Exzenterschleifer“ in das Textfeld eintragen und es werden nur mehr

Ergebnisse mit dem Begriff „Exzenterschleifer“ im Titel angezeigt.

VERFÜGBARE SHOP-ABFRAGEN

BESTSELLER-LISTE

Im Folgenden findet man das Formular für den Abruf einer klassischen Bestseller-Liste aus der API.

Hier gibt man einfach die BrowseNode-ID ein und klickt auf „Veröffentlichen“. Die Liste wird nun

automatisch aus der API geladen.

Bei dieser Abfrage können nur 10 Ergebnisse abgefragt werden.

NEUERSCHEINUNGEN-LISTE

Die Abbildung sieht hier genauso aus wie bei der Bestseller-Liste.

Page 32: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 32 von 43

Achtung: Diese Abfrage funktioniert nur bei der Amazon.com API. Die deutsche API unterstützt das

nicht. Auch können nur 10 Ergebnisse abgefragt werden.

SUCHEN-LISTE

Flexiblere Listen können mit einer Suche abgesetzt werden. Folgende Abbildung dazu.

Hier wählt man die Abteilung, Sortierung und einen Begriff aus. Aus der API werden nun 30

Ergebnisse geladen und in der Vorschau angezeigt.

ERWEITERTE SUCHE – LISTE

Ohne irgendwelche Einschränkungen kann man mit der erweiterten Suche auf die API zugreifen.

Page 33: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 33 von 43

Mit dieser Abfrage kann man sich komplett frei austoben und beliebige Abfragen auf die API

absetzen. Alle Bedingungen werden dabei mittels UND verknüpft. Kenntnisse der jeweiligen API sind

natürlich Voraussetzung.

ÄHNLICHE PRODUKTE – LISTE

Möchte man zu einem Produkt auch ähnliche Produkte abfragen, kann man diese Abfrage

verwenden.

Hier wählt man einfach ein bereits angelegtes Produkt aus der Liste aus.

Page 34: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 34 von 43

Vorlagen Was sind Vorlagen? Mit Vorlagen kannst du deine Ausgabe beliebig erweitern. Sie bieten dir absolute Flexibilität. Ganz

bequem aus dem Backend von Wordpress heraus.

Du kannst auf alle Produktinformationen und auf deine benutzerdefinierten Felder zugreifen und sie

ausgeben wie du möchtest. Die Platzhalter (Tags) werden in deinem Template einfach mit den

richtigen Daten ersetzt.

Du musst dafür keine Dateien mittels FTP bearbeiten. Wir bieten dir außerdem bereits einige

Vorlagen auf unserer Webseite. Diese findest du hier.

Vorlagen importieren und exportieren Um Vorlagen einfach von Installation zu Installation zu bekommen, kann man diese bequem im

Wordpress-Backend importieren und exportieren.

Vorlagen können über „Einstellungen -> Import-Werkzeug“ importiert werden.

Der Export erfolgt über die Ansicht „Vorlagen“. Hier kann man in der Spalte „Aktion“ auf

„Exportieren“ klicken. Der Download wird sofort initialisiert.

Page 35: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 35 von 43

Vorlage anlegen Das Formular für die Vorlage sieht folgendermaßen aus.

Page 36: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 36 von 43

Der Vorlagentyp ist „Produktvorlage“ und dient zum zukünftigen erweitern des Plugins.

Wenn man keine Preise, Lieferinformationen anzeigt, kann man den Haftungsausschluss für diese

Vorlage auch deaktivieren.

Die Option „Erweiterte Ansicht“ schaltet zwischen einfacher und erweiterter Ansicht um und dient

nur für eine einfachere Ansicht.

Mehr Informationen zum Ablauf findet man unter „Ablauf einer Vorlage“.

Kopf Der Kopf wird im Ablauf immer als erstes ausgeführt. Hier kann man z.B. den Kopf einer Tabelle

definieren (<table>).

Im Kopfbereich kann man auf die Platzhalter des ersten Produktes zugreifen. Zusätzlich kann man auf

die Platzhalter %refresh_date% und %refresh_time% zugreifen.

Der Platzhalter %listurl% ist nur bei Listen verfügbar.

Zeilenkopf (Erweitert) Dieser Kopf wird für jede Zeile (Produkt) ausgeführt.

Detail Kopf (Erweitert) Dieser Kopf wird einmal für die Zeile ausgeführt. Der Platzhalter {SYS_APPEND} funktioniert hier.

Detail Der Detailbereich wird für jedes Produkt ausgeführt. Hier kann man auf alle Platzhalter des Produktes

zugreifen.

Detail Fuß (Erweitert) Dieser Fuß wird für jede Zeile (Produkt) ausgeführt.

Zeilenfuß (Erweitert) Dieser Fuß wird einmal für die Zeile ausgeführt. Der Platzhalter {SYS_APPEND} funktioniert hier.

Fuß Der Fußbereich wird wie der Kopfbereich nur einmal ausgeführt. Hier jedoch am Ende. Am Beispiel

der Tabelle wäre das hier (</table). Auch hier kann man auf dieselben Platzhalter wie im Kopfbereich

zugreifen.

CSS-Style: Hier sind alle, für die Vorlage erforderlichen CSS-Styles hinterlegt. Kann auch außerhalb (z.B.: in einer

style.css) definiert werden.

Empfohlen ist, dass immer nur die Styles für die jeweilige Vorlage hier hinterlegt sind, damit es zu

keinen doppelten Ausgaben kommt.

Vorlagenplatzhalter Hier findest du alle verfügbaren Platzhalter die im Auslieferungszustand zur Verfügung stehen. Du

findest diese Platzhalter auch im Vorlageneditor selbst.

%asin% ASIN

%availability% Verfügbarkeit

%bestseller_number% Nr. 1 Ausgabe nur für ersten 3 Produkte in Liste

Page 37: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 37 von 43

%bestseller_text% Bestseller Nr. 1 Ausgabe nur für ersten 3 Produkte in Liste

%brand% Marke

%by_text% von Hersteller oder Autor Wenn Hersteller nicht vorhanden, wird Autor verwendet.

%cartlink% href="Warenkorblink" rel="nofollow" title="Titel"

%content% Inhalt Wird aus Widget oder Shortcode angezeigt

%cssclass% Element-CSS-Klasse Wird aus Widget oder Shortcode angezeigt

%customerreviewsurl% Kundenbewertungs-URL

%customfield_xyz% Beliebige Ausgabe Benutzerdefinierte Felder haben das Prefix „customfield_“

%description_text% Beschreibung Ausgabe erfolgt ohne Einschränkung

%ean% EAN EAN (bzw. mehrere mit Komma getrennt) aus dem Produkt

%features_text% Eigenschaften Ausgabe ohne Einschränkung

%hidelistlink% style="display:none" Wenn die Liste keine URL enthält, wird dieser Style ausgegeben.

%images_1% <img src="Bilder1 URL" alt="Titel" /> Bild 1 für erste Bildurl in erster Zeile (vollständige Größe), sonst leer.

%images_2% <img src="Bilder2 URL" alt="Titel" /> Bild 2 für erste Bildurl in erster Zeile (vollständige Größe), sonst leer.

%images_3% <img src="Bilder3 URL" alt="Titel" /> Bild 3 für erste Bildurl in erster Zeile (vollständige Größe), sonst leer.

%images_4% <img src="Bilder4 URL" alt="Titel" /> Bild 4 für erste Bildurl in erster Zeile (vollständige Größe), sonst leer.

%images_5% <img src="Bilder5 URL" alt="Titel" /> Bild 5 für erste Bildurl in erster Zeile (vollständige Größe), sonst leer.

%info_text% Entweder Eigenschaften oder gekürzte Beschreibung Hier wird entweder die Eigenschaft ausgegeben oder (wenn leer) der Beschreibungstext gekürzt auf 250 Zeichen.

%isbn% ISBN ISBN aus dem Produkt falls vorhanden.

%largeimage% <img src="Bild groß (URL)" alt="Titel" />

%largeimageurl% Bild groß (URL)

%link% href="Warenkorb-URL oder Produktseite-URL" rel="nofollow" title="Titel"

%linktext% Warenkorb-Text oder Kaufen bei-Text

%listlink% href="Listen-URL" rel="nofollow" title="Titel"

%listlinktext% Mehr Produkte anzeigen

%listprice% EUR 14,99 Listenpreis aus Produkt

%listprice_text% Unverb. Preisempf.: EUR 10,94 Listenpreis aus dem Produkt oder leer wenn nicht vorhanden.

%listurl% Listen-URL

%mark% * Wenn in den Einstellungen Affiliate-Links markieren eingeschaltet ist, sonst leer.

Page 38: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 38 von 43

%markrating% * Gleiches wie oben, jedoch wird hier auch „Ist meine Bewertung“ berücksichtigt.

%mediumimage% <img src="Bild mittel (URL)" alt="Titel" />

%mediumimageurl% Bild mittel (URL)

%price% EUR 14,99 Verkaufspreis aus Produkt

%price_text% Preis: EUR 14,99 Verkaufspreis aus Produkt oder „nicht verfügbar“ wenn leer.

%priceinfo_text% Preis inkl. MwSt., zzgl. Versandkosten

%prime_icon% <img src="Prime-image-url" alt="Prime"/> Wenn bei Produkt „Prime“ gesetzt wurde, sonst leer.

%productgroup% Produktgruppe

%productid% Interne ID

%productlink% href="Produktseite-URL" rel="nofollow" title="Titel"

%producturl% Produktseite-URL

%rating% Bewertung von 5 Sternen

%reviewcount% Bewertungsanzahl Bewertungen

%reviewcount2% Bewertungsanzahl Bewertungen Ausgabe ist leer wenn „Ist eigene Bewertung“

%reviewslink% href="Bewertungs-URL" rel="nofollow" title="Reviewcount" Gibt entweder die eigene Bewertungs-URL aus oder die Kundenbewertungs-URL (je nachdem ob meine Bewertung angehakt wurde).

%reviewsurl% Bewertungs-URL Die URL zur eigenen Bewertung/Vorstellung des Produktes.

%save_amount% EUR 8,03

%save_percentage% 73%

%save_percentage_% (73%)

%save_text% Du sparst: EUR 8,03 (73%)

%shoplogo% <img src="Shoplogo-URL" alt="" />

%smallimage% <img src="Bild klein (URL)" alt="Titel" />

%smallimageurl% Bild klein (URL)

%star_rating% <span class="atkp-star atkp-star-4 atkp-star-00" title="rating"></span>

%thumbimages_1% <img src="Bilder1 URL" alt="Titel" /> Bild 1 für erste Bildurl in erster Zeile (Thumbnail Größe), sonst leer.

%thumbimages_2% <img src="Bilder2 URL" alt="Titel" /> Bild 2 für erste Bildurl in erster Zeile (Thumbnail Größe), sonst leer.

%thumbimages_3% <img src="Bilder3 URL" alt="Titel" /> Bild 3 für erste Bildurl in erster Zeile (Thumbnail Größe), sonst leer.

%thumbimages_4% <img src="Bilder4 URL" alt="Titel" /> Bild 4 für erste Bildurl in erster Zeile (Thumbnail Größe), sonst leer.

%thumbimages_5% <img src="Bilder5 URL" alt="Titel" /> Bild 5 für erste Bildurl in erster Zeile (Thumbnail Größe), sonst leer.

%title% Titel

%short_title% Titel gekürzt Wenn eine maximale Länge des Titels konfiguriert wurde, steht hier der gekürzte Teil.

Page 39: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 39 von 43

Ablauf einer Vorlage Um den Ablauf noch etwas zu verdeutlichen, haben wir ein kleines Beispiel erstellt.

Einfacher Ablauf Mit diesem Ablauf lassen sich 90 Prozent aller Vorlagen gestalten und entsprechend ausgeben.

Alles was sich im Kopfbereich befindet wird einmal ausgeführt. Der Detailbereich wird hier für jedes

Produkt ausgeführt. Der Fußbereich wird wie der Kopfbereich nur einmal ausgeführt.

Erweiterter Ablauf Um die restlichen 10 Prozent zu erreichen, haben wir ein paar Felder hinzugefügt (über den Haken

erweiterte Ansicht aktivieren).

Damit lassen sich auch komplexe Vergleichstabellen erstellen. Der Detail-Kopf, Detail-Fuß, sowie der

Detail-Bereich lassen sich in Zeilen „aufteilen“. Über den Platzhalter {SYS_APPEND} wird die Vorlage

geteilt und danach wird (aufgrund der Reihenfolge) jede Vorlagenzeile miteinander verknüpft.

Tipps zur Vorlagegestaltung Leere Felder behandeln Wenn Felder leer sind, werden diese nicht ausgegeben. Hier kann es also zu einer Verschiebung des

Layouts kommen. Die Standardvorlagen sind darauf ausgelegt, dass dies nicht passiert. Bei

benutzerdefinierten Vorlagen kann es hier zu Problemen kommen.

Als Trick für „leere“ Felder kann hier &nbsp; (Leerzeichen) verwendet werden. Wenn diese hinter

dem Platzhalter definiert wurde, bleibt die Zelle in ihrer Größe erhalten.

Page 40: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 40 von 43

Wordpress-Widget Mit dem Affiliate-Toolkit wird ein Widget mitgeliefert, welches Listen und Produkte einfach im

Widgetbereich von Wordpress anzeigen kann.

Es kann nicht ein Produkt und eine Liste ausgewählt werden. Wählst du beides aus, wird die Liste

bevorzugt.

Shortcode Generator Mit dem Shortcode-Generator kann man sich die Shortcodes sehr einfach im Beitragsbereich

generieren lassen.

Es gibt einen versteckten Parameter um den Haftungsschluss auf dieser Ebene deaktivieren zu

können. Mit „hidedisclaimer='yes'“ wird der Haftungsschluss nicht mehr angezeigt.

Der Generator ist eigentlich selbsterklärend. Je nach Typ-Auswahl wird eine andere Ansicht

angezeigt:

Zu beachten ist, dass „Inhalt“ als Feld in der Vorlage verwendet werden kann.

Produkt Hier kann ein einzelnes Produkt ausgegeben werden. Es kann eine beliebige Vorlage dafür

ausgewählt werden.

Page 41: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 41 von 43

Liste Hier wird eine komplette Liste ausgegeben. Mit Limit kann die Liste auf eine bestimmte Anzahl von

Ergebnissen eingeschränkt werden. Mit dem Haken „Zufällige Sortierung“ wird die Liste bei jedem

generieren neu vermischt.

Feld Mit Feldern können einzelne Felder aus dem Produkt ausgegeben werden. Du kannst z.B.: nur ein

Bild oder nur den Preis in deinem Beitrag anzeigen.

Hinweis: Felder verwenden zusätzlich einen eigenen Cache. Wenn du Änderungen am Artikel

vornimmst, musst du 2 Minuten warten bis du die Änderung in deinem Beitrag siehst.

Link Mit Link kannst du beliebigen Inhalt verknüpfen. Du musst lediglich den Text in „Inhalt“ eingeben.

Page 42: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 42 von 43

Datenaktualisierung Das Aktualisieren des Datencache und der Datenprüfung wird durch den Wordpress-Cronjob

gesteuert.

Damit der Benutzer beim Öffnen der Seite keine lange Ladezeit hat, haben wir zum Laden der

Produktdaten die Funktionalität des WordPress-Cronjob’s genutzt.

Wir laden die Daten im Plugin unabhängig vom aktuellen Benutzer. Der Benutzer kann zwar das

Laden anstoßen, der Seitenaufbau wird dadurch jedoch nicht blockiert.

Mit dem einfachen Cronjob von WordPress muss immer Traffic auf der Seite sein. Wenn z.B. nur alle

2 Tage ein Besucher auf der Seite ist, wird das neu laden der Produktinformationen immer nur alle 2

Tage angestoßen. Das kann manchmal störend sein.

Möchte man das neu laden des Cache unabhängig vom Benutzer durchführen lassen, kann man

einen „richtigen“ Cronjob verwenden. Dieser ruft dann in regelmäßigen Abständen (z.B. alle 15

Minuten) deine Seite auf.

Zeitgesteuerten Cronjob einrichten Dem Affiliate-Toolkit-Plugin ist egal, ob die Aktion durch den Benutzer oder durch einen

automatisierten Task angestoßen wird. Hier sind keine Einstellungen notwendig.

Die Wordpress-Installation muss dafür jedoch konfiguriert werden. Neben der regelmäßigen

Aktualisierung kann das Einschalten eines Cronjobs auch die Seitenladezeit beschleunigen.

Dein Hoster muss jedoch Cronjobs unterstützen, erkundige dich dafür bei ihm. Eine ausführliche

Anleitung zum Konfigurieren findest du hier.

Page 43: Dokumentation für smarte Affiliates · 2020. 5. 14. · Der einfachste Weg ist die Installation über das Backend von WordPress. Wenn du das Paket heruntergeladen hast, logge dich

affiliate-toolkit.com 43 von 43

Entwickler Als Entwickler oder zumindest mit gewissen Kenntnissen in der Entwicklung möchte man auch mal

selbst „Hand“ anlegen. Wir versuchen unser Plugin für Entwickler zu öffnen und auch beliebige

Anpassungen an Platzhaltern oder anderen Dingen durchführen zu lassen.

Dies stellen wir in sogenannten „Hooks“ zur Verfügung. Wir lassen den Entwickler also „supported“

Änderungen durchführen.

In diesem Abschnitt findest du Custom Hooks welche wir integriert haben und welche du verwenden

kannst.

Übersetzungen Unser Plugin ist vollständig übersetzbar. Derzeit sind die Sprachen Deutsch und Englisch verfügbar.

Falls du das Plugin in eine andere Sprache übersetzen möchtest, kannst du das Programm Poedit

dafür verwenden.

Alle Übersetzungen für Deutsch befinden sich in der Datei „\affiliate-toolkit\lang\ATKP-de_DE.po“.

Kopiere die Datei und ändere die Sprache entsprechend. Wenn Wordpress in der richtigen Sprache

läuft, wird automatisch die richtige Sprachdatei verwendet.

Platzhalter übersteuern & erweitern Wir haben zum Übersteuern der Platzhalter einen Hook registriert. Du kannst damit alle Werte im

Array übersteuern bzw. auch eigene Platzhalter hinzufügen. Beachte, dass sich diese Änderung auf

ALLES auswirkt.

function example_callback( $placeholders ) {

//Hier können sämtliche Änderungen am „$placeholders“-Array

vorgenommen werden.

$placeholders['test_titel'] =$placeholders['title'];

return $placeholders;

}

add_filter( 'atkp_modify_placeholders', 'example_callback');

Dieser Hook wird am Ende des Array-Aufbau ausgeführt.