dokumentation für smarte affiliates · 2020. 5. 14. · der einfachste weg ist die installation...
TRANSCRIPT
Dokumentation für
smarte Affiliates
Version 1.5.7
© 2016 Christof Servit
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
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
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.
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.
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.
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.
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.
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)
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.
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“.
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.
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“.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
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
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.
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.
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.
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.
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.
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.
affiliate-toolkit.com 35 von 43
Vorlage anlegen Das Formular für die Vorlage sieht folgendermaßen aus.
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
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.
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.
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 (Leerzeichen) verwendet werden. Wenn diese hinter
dem Platzhalter definiert wurde, bleibt die Zelle in ihrer Größe erhalten.
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.
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.
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.
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.