Umzug vom Affiliate Toolkit (ATKP)

ATKP-Produkte und -Listen nach affilinode übertragen, ohne Beiträge anzufassen.

Das Plugin bringt eine Migration vom Affiliate Toolkit mit. Sie überträgt ATKP-Produkte und -Listen nach affilinode. Deine Beiträge bleiben unverändert: Die Shortcodes [atkp_product], [atkp_list] und [atkp ids="…"], die Blöcke „Produkt“ und „Liste“ des Affiliate Toolkit sowie sein Seitenleisten-Widget zeigen danach die Daten aus affilinode.

Vorbereitung

• Plugin mit API-Schlüssel verbinden. Ohne Schlüssel meldet die Migrationsseite „API-Schlüssel fehlt“.
• Für Amazon-Produkte ein Amazon-Partnerprogramm mit Zugangsdaten anlegen; unbekannte ASINs lädt affilinode im Hintergrund von Amazon.
• Für Datenfeed-Produkte von Awin die Händler vorher unter „Awin-Händler“ aktivieren. Die Migration legt keine Awin-Shops an, sondern ordnet die Produkte Shops mit derselben Advertiser-ID zu.

Was wird übernommen

• **Titel, Kennungen und Listen:** der Originaltitel des Produkts, ASIN bzw. Feed-Produkt-ID (bis zu zehn Angebote je Produkt), EAN und ISBN sowie deine Listen.
• **Manuelle Listen** behalten ihre Produkte in der Reihenfolge des Affiliate Toolkit; Produkte, die dort im Papierkorb liegen, fehlen auch hier.
• **Dynamische Listen** (Bestseller, Neuerscheinungen, Suche) übernimmt affilinode als **feste Liste mit den Produkten, die das Affiliate Toolkit zuletzt dafür gespeichert hat**. Diese Listen laden danach nicht mehr aus dem Shop nach; die Umzugsseite kennzeichnet sie beim Übertragen als Momentaufnahme, damit du sie einmal prüfst. Wer sie aktuell halten will, legt für Amazon stattdessen eine Amazon-Liste an. Hatte eine dynamische Liste noch kein Ergebnis, bleibt sie leer; auch das nennt die Umzugsseite.
• **Testbewertung, Vor- und Nachteile, Badge:** Hast du im Affiliate Toolkit Testnote, Testergebnis, Testdatum, Vor- und Nachteile, ein Badge („Testsieger“ …) oder einen Rezensionstext eingetragen, legt affilinode daraus die Testbewertung des Produkts an (siehe „Testbewertung mit Testnote“). Übernommen wird nur, was sich ohne Raten zuordnen lässt: Die Note braucht eine eindeutige Skala („1,7“ passt zusammen mit dem Testergebnis „gut“ zur Schulnote, „8,5/10“ und „92 %“ nennen die Skala selbst). Alles andere zählt die Umzugsseite auf (Noten ohne eindeutige Skala, Rezensionstexte über 1.000 Zeichen …), und du trägst es im Produkt unter „Testbewertung“ nach. Vorhandene Bewertungen und Texte bleiben immer erhalten.
• **Beschreibungen der Produkt-Beiträge:** Der Text eines ATKP-Produkt-Beitrags wird zur Beschreibung des Produkts in affilinode, ein vorhandener Auszug zur Kurzbeschreibung. Hat der Beitrag keinen Auszug, macht affilinode die Kurzbeschreibung aus dem Anfang der Beschreibung (höchstens 400 Zeichen, am Wortende gekürzt). Das geschieht mit dem Schalter „Beschreibungen der Produkt-Beiträge mit übernehmen“ unter „2. Übertragung“; er ist vorbelegt. Unter „1. Analyse“ siehst du vorher, wie viele Beiträge einen Text haben, wie groß er zusammen ist und einige Beispiele.
• **Was dabei bereinigt wird:** Shortcodes, Skripte, Bilder, Formulare und Links zu Amazon oder Partnernetzwerken fallen weg (der Linktext bleibt). Es bleibt einfache Formatierung: Absätze, Listen, fette und kursive Wörter, Überschriften und normale Links. Beschreibungen werden auf 8.000 Zeichen gekürzt, Auszüge auf 400. Texte unter 80 Zeichen übernimmt affilinode nicht, passwortgeschützte Beiträge werden übersprungen.
• **Vorhandene Texte bleiben:** Hat ein Produkt schon eine Beschreibung (von Hand geschrieben, von der KI oder aus einer früheren Übertragung), wird sie nie überschrieben; die Umzugsseite zählt solche Fälle als „übersprungen“. Die übernommene Beschreibung ist gesperrt, automatische und KI-Texte ersetzen sie also nicht. Im Produkt unter „Texte“ kannst du sie ändern oder mit „Entsperren“ wieder für automatische Texte freigeben. Sie steht dort mit dem Vermerk „Aus Affiliate Toolkit übernommen“.
• **Deine Website bleibt unverändert:** Beiträge und Seiten werden nur gelesen, nie geändert. Die Texte werden in deinem Konto gespeichert und nicht an andere weitergegeben.

Hast du schon ohne Beschreibungen übertragen, wähle „Neu beginnen“ und übertrage erneut: Titel, Kennungen und Listen bleiben unverändert, nur die Beschreibungen kommen dazu. Ältere Plugin-Versionen übertragen keine Beschreibungen; dafür das Plugin aktualisieren.

Was nicht übernommen wird

• **Manuelle Angebote** (Name, Logo, Preis, URL) und **Varianten** der Produkte sowie **eigene Vorlagen** des Affiliate Toolkit haben bei affilinode kein Gegenstück. Die Vorschau nennt die Zahl; Angebote lassen sich über Shops anbinden, Vorlagen unter „Eigene Vorlagen“ nachbauen.
• **Zufallsreihenfolge, Blättern, Filter und automatisch angelegte Listen** (randomsort, itemsperpage, filter, keyword) gibt es bei affilinode nicht. Die Liste erscheint dann in ihrer gespeicherten Reihenfolge; Redakteure sehen im Beitrag einen Hinweis an der Stelle, Besucher nicht. Ein Feld, das es bei affilinode nicht gibt (z. B. EAN im Text), zeigt ebenfalls einen Hinweis.
• **Nur Gestaltung** wie CSS-Klassen, Schaltflächenart oder das Ausblenden des Preishinweises ignoriert affilinode. Die Hinweise zu Preisen und Partnerlinks richtet affilinode selbst ein.
• **Eigene Vorlagen** (template="123") und unbekannte Vorlagennamen zeigen die Standardbox bzw. das Standardraster.

Wie die Shortcodes und Blöcke übernommen werden

• **[atkp_product id="…"]**, auch mit asin="…" oder ean="…" statt der Zahl oder mit dem Namen des Produkts: eine Produktbox. Die Vorlage bestimmt die Darstellung (secondwide → waagerecht, moreoffers → Angebote, pricehistory_lastxdays → Preisverlauf).
• **tracking_id="…"**: wird zur eigenen Amazon-Tracking-ID dieser Box.
• **link="yes"** mit Text dazwischen: ein Textlink mit diesem Text. Mit field="…" wird der Wert (Preis, Titel, Bewertung …) selbst zum Link.
• **field="saleprice"** (auch listprice, title, rating, reviewcount, image …): der Wert als Einzelfeld im Text.
• **[atkp_list id="…" limit="…"]**: die Liste; mit product_ids="…" stattdessen die genannten Produkte.
• **[atkp ids="1,2,3"]**: die Produkte in einer Darstellung, enthaltene Listen darunter.
• **Blöcke „Produkt“ und „Liste“** des Affiliate Toolkit: wie die Shortcodes.
• **Seitenleisten-Widget** des Affiliate Toolkit: zeigt dasselbe Produkt bzw. dieselbe Liste weiter.

Alles geschieht beim Anzeigen der Seite; deine Beiträge werden nicht umgeschrieben. Das gilt, sobald das Affiliate Toolkit deaktiviert ist (siehe unten).

Ablauf

1. In WordPress „affilinode“ → „Migration (ATKP)“ öffnen. Im Multisite liegt die Seite in der Netzwerkverwaltung.
2. „1. Analyse“: „Analysieren“ bzw. „Alle Unterseiten analysieren“ zählt Produkte, Listen, Shops, Kennungen und Shortcodes. Darunter steht die **Vorschau**: wie viele Produkte eine eigene Bewertung haben und wie viele davon sich übernehmen lassen, wie viele dynamische Listen es gibt (und wie viele davon ein gespeichertes Ergebnis haben), welche Inhalte kein Gegenstück haben, in wie vielen Beiträgen Shortcodes und Blöcke vorkommen und welche Optionen davon bei affilinode entfallen. Es werden dabei nur Zahlen und Namen gezeigt, nichts wird übertragen oder geändert.
3. „2. Übertragung“: „Übertragen“ bzw. „Alle Unterseiten übertragen“ schickt erst Produkte, dann Listen in Häppchen. „Stopp“ hält nach dem laufenden Häppchen an, „Fortsetzen“ macht an derselben Stelle weiter. Unter jeder Unterseite stehen Hinweise zur Übertragung: übernommene und übersprungene Testbewertungen, dynamische Listen als Momentaufnahme, Listen ohne gespeichertes Ergebnis, nicht übernommene Einträge.
4. „3. Stand in affilinode“: „Stand aktualisieren“ zeigt je Unterseite zugeordnete, laufende und nicht zugeordnete Einträge sowie Konflikte mit Grund. Darüber steht, wie viele Beschreibungen übernommen, übersprungen (das Produkt hatte schon einen Text) oder als zu kurz nicht übernommen wurden. Beschreibungen von Produkten, die noch geladen werden, folgen automatisch.
5. Das Affiliate Toolkit deaktivieren. Erst dann übernimmt das Plugin dessen Shortcodes.

Erneutes Übertragen ist gefahrlos, der Server legt nichts doppelt an. „Neu beginnen“ setzt nur den Fortschritt der Unterseite zurück; in affilinode wird nichts gelöscht.

Typische Konflikte

• „Amazon-Daten werden geladen“: kurz warten und den Stand erneut aktualisieren.
• „Auftrag wartet auf Auswahl“: Ist die ASIN bekannt und liefert Amazon dazu ein Produkt, übernimmt affilinode es von selbst, auch wenn die Produktart unklar ist (sie steht dann auf „Nicht zugeordnet“ und lässt sich im Produkt ändern). Nur Mehrfachpackungen („2er-Pack“) und Produkte ohne ASIN warten auf deine Auswahl unter „Produktwünsche“. Was früher liegen geblieben ist, schließt affilinode nach und nach selbst ab; unter „Produktwünsche“ geht es mit „Migrationsprodukte automatisch abschließen“ sofort.
• „ASIN bei Amazon nicht gefunden“: Das Produkt gibt es bei Amazon nicht mehr.
• „kein Awin-Shop mit dieser Advertiser-ID“: den Händler unter „Awin-Händler“ aktivieren.
• „Awin-Feed noch nicht synchronisiert“: den nächsten Abgleich abwarten.