AAI – Automatic Amazon ebay Importer

AMAZON & EBAY AFFILIATE IMPORTER (AAI) –
Vollständige Plugin-Beschreibung Version 2.4.18 | digital-stratege.de

1. DATENQUELLEN UND IMPORT-MODI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Der Amazon & eBay Affiliate Importer (AAI) ist ein professionelles WordPress-Plugin, das Produktdaten von Amazon und eBay vollautomatisch abruft, bereinigt und als fertige WordPress-Beiträge mit Affiliate-Links, strukturiertem Content und rechtskonformem Disclaimer anlegt. Es wurde speziell für den deutschen Markt entwickelt und berücksichtigt die einschlägigen rechtlichen Anforderungen nach HCVO, UWG, HWG, TMG und den Amazon-Partnerprogramm-AGB. Das Plugin ist das Herzstück der Affiliate-Seite naturprodukte24.de und wird aktiv weiterentwickelt.

AMAZON – PA API (Product Advertising API)
Offizielle API-Anbindung über AWS-Zugangsdaten (Access Key, Secret Key, Partner-Tag, Region eu-west-1). Ruft strukturierte Produktdaten direkt von Amazon ab – zuverlässig, stabil und ToS-konform. Empfohlen für Produktiv-Betrieb.

AMAZON – Scraper-Modus
Fallback-Methode für den direkten Import über Produktseiten-URLs, ohne API-Zugang. Importiert werden Titel, Marke, Preis, Bewertung, Bullets, Produktbeschreibung, A+-Content und technische Daten (Tabelle). Geeignet für Tests oder wenn kein PA-API-Zugang besteht.

EBAY – Browse API (OAuth 2.0)
Vollständige eBay-Integration über die Browse API mit automatischem OAuth-Token-Management (Client Credentials Flow). Fallback auf Finding API (AppID) wenn kein OAuth-Token konfiguriert. Unterstützt mehrere Marketplaces (EBAY-DE, EBAY-US etc.). eBay-Artikel erhalten einen eigenen Disclaimer und werden als gesonderte Beitragsklasse importiert.

CACHE
Alle API-Antworten werden konfigurierbar gecacht (Standard: 24 Stunden), um API-Limits zu schonen und die Import-Geschwindigkeit zu erhöhen.

2. IMPORTIERTE INHALTSFELDER (EINZELN AKTIVIERBAR)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Jedes der folgenden Inhaltsfelder kann in den Einstellungen einzeln aktiviert oder deaktiviert werden:
✔ Produkttitel – Als Beitragsüberschrift und Affiliate-Link mit *
✔ Marke / Brand – Mit verlinkter Markensuche bei Amazon
✔ Preis – Aktueller Preis mit direktem Affiliate-Link
✔ Bewertung – Sternanzeige (grafisch) + Anzahl der Rezensionen
✔ Verfügbarkeit – Lagerstatusanzeige
✔ Produktmerkmale – Bulletpoints aus der Amazon-Detailseite
✔ Produktbeschreibung – Fließtext
✔ A+-Content – Texte aus dem erweiterten Herstellerbereich
✔ Technische Daten – Als HTML-Tabelle
✔ Amazon-Kategorien – Optional als WP-Tags übernehmen
✔ ASIN – Als Post-Meta gespeichert (_aai_asin)

Hinweis: Amazon-Produktbilder werden aus ToS-Gründen bewusst NICHT importiert.

3. AFFILIATE-LINKS UND RECHTLICHE KONFIGURATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Alle Links werden automatisch mit dem konfigurierten Partner-Tag versehen (Format: ?tag=DEIN-TAG oder &tag=DEIN-TAG je nach URL-Kontext).
• Link-Ziel (target=“_blank“ oder _self) konfigurierbar.
• rel=“nofollow“ und rel=“sponsored“ einzeln aktivierbar – entspricht den Google-Richtlinien für Affiliate-Links.
• Affiliate-Kennzeichnung durch hochgestelltes * mit Anker auf den Disclaimer-Abschnitt (#aai-disclaimer) – TMG-konform und für Leser klar erkennbar.
• Individuell anpassbarer Amazon-Disclaimer und separater eBay-Disclaimer.
• Standard-Disclaimertexte enthalten alle gesetzlich erforderlichen Hinweise gemäß Amazon-Partnerprogramm-AGB und TMG.
• Amazon-Domain konfigurierbar (amazon.de, amazon.com etc.)

4. HINTERGRUND-QUEUE (ASIN-IMPORT)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Das Plugin verarbeitet Bulk-Importe nicht synchron (kein PHP-Timeout-Risiko), sondern über eine eigene Datenbanktabelle (wp_aai_queue):

• Jede ASIN wird als eigenständiger Job eingetragen.
• WP-Cron + AJAX-Heartbeat arbeiten die Jobs einzeln ab (1 Job pro Tick).
• Status-Tracking: pending → processing → done / error.
• Retry-Mechanismus bei Fehlern (Spalte: retries).
• Queue kann manuell pausiert und fortgesetzt werden.
• Batch-UUID ermöglicht die Gruppenzuordnung im Admin-Dashboard.
• Eigene Queue-Tabelle für eBay-Artikel (getrennte Verarbeitung).

Vorteil: Auch auf Shared-Hosting-Umgebungen können hunderte ASINs ohne Probleme importiert werden.

5. INTEGRIERTE FILTERFUNKTIONEN (RECHTSKONFORMITÄT & QUALITÄT)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5.1 HEALTH-CLAIMS-FILTER (HCVO / HWG / UWG)
────────────────────────────────────────────
Rechtliche Grundlage: Health Claims Verordnung (EG) Nr. 1924/2006, UWG § 5
(Irreführende Werbung), HWG (Heilmittelwerbegesetz).

Problematische Formulierungen in Produkttexten (Titel, Bullets, Beschreibung,
A+-Content, technische Daten) werden automatisch erkannt und entweder durch
neutrale Alternativformulierungen ersetzt oder vollständig entfernt. Verarbeitete
Kategorien u.a.:

– Entzündung / entzündungshemmend / anti-entzündlich
– Heilen / heilend / Heilung / kuriert
– Linderung / lindert
– Behandeln / behandelt
– Weitere problematische Gesundheitsversprechen (erweiterbare Liste)

Der Filter kann auch nachträglich per Bulk-Bereinigung auf alle vorhandenen
Beiträge angewendet werden.

5.2 TAG-CLEANER (STOPPWORTLISTE)
──────────────────────────────────
Zentrale Stoppwortliste mit deutschen Artikeln, Pronomen, Präpositionen,
Konjunktionen, generischen Adjektiven (ideal, optimal, perfekt, natürlich,
nachhaltig …) und häufigen Verben. Diese werden beim Import automatisch aus
den generierten Post-Tags herausgefiltert.

Die gleiche Stoppwortliste steht auch als Bulk-Cleaner für bereits vorhandene
Beiträge zur Verfügung (AJAX-basiert, Shared-Hosting-freundlich).

5.3 SPRACHFILTER
──────────────────
Englische Produkttitel können automatisch erkannt und blockiert werden. Die
Erkennung basiert auf typischen englischen Phrasen („for men“, „pack of“,
„high quality“, „made in“ etc.) sowie einer wortbasierten Häufigkeitsanalyse.
Nützlich für deutschsprachige Affiliate-Seiten, auf denen englischsprachige
Produktimporte unerwünscht sind.

5.4 KATEGORIE-FILTER UND KATEGORIE-BEREINIGER
───────────────────────────────────────────────
Beim Import wird geprüft, ob das Produkt thematisch zur gewählten WordPress-
Kategorie passt. Nicht passende Produkte werden übersprungen (Kategorie-
Mismatch). Ein separater Bulk-Bereiniger (AAI_Cat_Cleaner) scannt alle
importierten Beiträge, erkennt Off-Topic-Importe sowie Duplikate (URL-Suffix
-2, -3 etc.) und ermöglicht deren Löschung, Verschieben in den Papierkorb oder
das Setzen auf „noindex“ – alles per AJAX-Batches ohne Timeout-Risiko.

5.5 IMPORT-BLOCKLISTE
──────────────────────
Manuell pflegbare Sperrliste (ein Begriff oder Phrase pro Zeile). ASINs oder
Produkte, deren Titel einen Eintrag aus der Blockliste enthalten, werden beim
Import automatisch übersprungen.

6. PRODUKT-MONITOR (AUTOMATISCHE ÜBERWACHUNG)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Der Monitor überwacht alle importierten Beiträge im Hintergrund per WP-Cron
auf Änderungen. Konfigurierbare Parameter:

• Cron-Intervall: frei wählbar (z.B. alle 15 Minuten, stündlich, täglich)
• Batch-Größe: Anzahl der Beiträge pro Cron-Lauf (Standard: 75)
• Preisüberwachung: Benachrichtigung bei Preisänderung (absolut oder ab einem konfigurierbaren Prozentsatz)
• Verfügbarkeitsüberwachung: Benachrichtigung wenn Produkt nicht mehr lieferbar
• E-Mail-Benachrichtigung bei Änderungen (konfigurierbare Empfängeradresse)
• Admin-Dashboard-Notice für offene Änderungen
• Automatisches Löschen nicht verfügbarer Beiträge (optional)
• Automatischer Inhalts-Refresh bei erkannter Änderung (optional)
• Health-Claims-Filter läuft auch beim Monitor-Refresh automatisch
• Gespeicherte Post-Meta-Felder: _aai_price_last, _aai_available_last, _aai_monitor_checked, _aai_monitor_changes

Für eBay-Artikel gibt es eine separate Monitor-Klasse (AAI_Ebay_Monitor) mit Behandlung abgelaufener Artikel (trash / draft / keep konfigurierbar).

7. AUTOMATISCHES AUFFÜLLEN (AUTO-REFILL)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Gespeicherte Suchanfragen können mit einer Mindestbeitragsanzahl versehen werden. Ein täglicher Cron-Job (AAI_Refill) prüft, ob die Anzahl der Beiträge unter die definierte Mindestmenge gefallen ist und füllt den Bestand automatisch wieder auf. Unterstützt werden URL-Import und Node-Import (Amazon). Ein konfigurierbares globales Post-Limit verhindert unkontrollierten Wachstum.

8. SEO-INTEGRATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

RANK MATH – FOKUS-SCHLÜSSELWORT
Beim Import kann das Fokus-Schlüsselwort für Rank Math automatisch aus dem
Produkttitel generiert und im Post-Meta (rank_math_focus_keyword) gespeichert
werden. Per Bulk-Funktion lässt sich das auch für alle vorhandenen Beiträge
nachträglich setzen.

INDEXNOW (SOFORT-INDEXIERUNG)
Das Plugin implementiert das IndexNow-Protokoll. Nach dem Import wird die
neue URL automatisch an Bing, Yandex und Seznam gemeldet. Zusätzlich kann
ein Bing-Sitemap-Ping aktiviert werden, der indirekt auch das Google-Crawling
beschleunigt. Der IndexNow-Key wird beim Plugin-Aktivieren automatisch
generiert und als Key-File im WordPress-Root abgelegt.

POST-TAGS
Aus Produkttitel, Marke und Amazon-Kategorien werden automatisch relevante
Post-Tags generiert – unter Berücksichtigung der zentralen Stoppwortliste
(siehe Tag-Cleaner). Maximal 10 Tags pro Beitrag.

SIL-SCHLÜSSELWÖRTER (Smart Internal Linker)
Beim Import werden automatisch Schlüsselwörter für das Smart Internal Linker
Plugin gesetzt (set_sil_keywords), sodass neu importierte Produkte sofort in
die automatische interne Verlinkung einbezogen werden.

9, ADMIN-OBERFLÄCHE UND VERWALTUNG
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Das Plugin stellt folgende Admin-Seiten bereit:

IMPORTIEREN (page-import.php)
Eingabe von Amazon-URLs / ASINs oder eBay-Artikel-URLs. Vorschaufunktion
vor dem eigentlichen Import. Konfiguration von Beitragsstatus, Kategorie
und Disclaimer je Import-Vorgang. Bulk-Import mehrerer ASINs über die
Hintergrund-Queue. Anzeige des Queue-Fortschritts in Echtzeit (AJAX).

MONITOR (page-monitor.php)
Übersicht aller überwachten Beiträge mit Preis- und Verfügbarkeits-
verlauf. Anzeige offener Änderungen. Manuelles Auslösen des Monitor-Laufs.
Verwaltung automatisch gelöschter Beiträge.

KATEGORIEN-BEREINIGER (page-cat-cleaner.php)
Batch-Scan aller importierten Posts auf Kategorie-Mismatch und Duplikate.
Massenlöschung / Papierkorb / noindex per AJAX ohne Timeout-Gefahr.

HEALTH-BEREINIGER (page-health-cleaner.php)
Bulk-Bereinigung vorhandener Beiträge von unzulässigen Gesundheitsaussagen.
Vorschau der gefundenen Probleme vor der eigentlichen Bereinigung.

EINSTELLUNGEN (page-settings.php)
Zentrale Konfiguration aller Plugin-Parameter:
– Amazon PA-API Zugangsdaten
– eBay App ID / Cert ID / Marketplace
– Partner-Tag / Affiliate-Tag
– Disclaimer-Texte (Amazon + eBay)
– Link-Verhalten (target, nofollow, sponsored)
– Aktivierung/Deaktivierung einzelner Inhaltsfelder
– Cache-Dauer
– IndexNow
– Rank Math Integration
– Sprachfilter
– Import-Blockliste
– Monitor-Einstellungen (Intervall, Batch-Größe, Schwellenwerte)
– Auto-Refill / Gespeicherte Suchanfragen

10. TECHNISCHE DETAILS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ • Plugin-Slug: amazon-affiliate-importer
• Version: 2.4.18
• Entwickler: digital-stratege.de
• Lizenz: GPL-2.0+
• Mindest-WP: Standard (nutzt ausschließlich WP-Core-APIs)
• PHP: Kompatibel mit PHP 8.x
• Datenbank: Eigene Tabelle wp_aai_queue (Amazon) + wp_aai_ebay_queue
• Einstellungen: wp_options (Option-Key: aai_settings, aai_monitor_settings)
• Post-Meta: _aai_asin, _aai_source_url, _aai_affiliate_url,
_aai_imported_at, _aai_price_last, _aai_available_last,
_aai_monitor_checked, _aai_monitor_changes
• Frontend-CSS: frontend.css (optional einbindbar über functions.php)
• Konfliktschutz: Verhindert doppelte Aktivierung älterer Versionen

Deinstallation: Plugin deaktivieren und löschen. Einstellungen in wp_options (aai_settings) bleiben erhalten und müssen ggf. manuell via SQL entfernt werden: DELETE FROM wp_options WHERE option_name = ‚aai_settings‘;

11. ZUGEHÖRIGE PLUGINS AUS DEM DIGITAL-STRATEGE ÖKOSYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Der AAI ist Teil eines aufeinander abgestimmten Plugin-Ökosystems für professionelle Affiliate-Websites. Folgende Plugins arbeiten direkt mit dem AAI zusammen oder ergänzen ihn:

SMART INTERNAL LINKER (SIL) – v1.x (digital-stratege.de)
Vollautomatische interne Verlinkung auf Basis von Schlüsselwörtern.
49.296 Keywords wurden per Migrations-Tool aus dem alten ILJ-System übernommen. Arbeitet mit Queue-basiertem Batch-Processing und semantischer Filterung, um Überoptimierung zu vermeiden.

BRAND FILTER (digital-stratege.de)
Zeigt im Shop-/Kategoriebereich nur die Marken an, die tatsächlich in der aktuell aufgerufenen Kategorie vorhanden sind. Verhindert irrelevante Markenfilter-Optionen bei Besuchern und verbessert die Nutzererfahrung auf Kategorie-Seiten. Arbeitet direkt mit den vom AAI gesetzten Marken-Tags zusammen (zuletzt aktualisiert: v3.2.1 für naturprodukte24.de).

SMART TAG MANAGER (digital-stratege.de)
Verwaltung und automatische Bereinigung von Post-Tags über eine Blacklist-basierte Stoppwortliste. Ergänzt den im AAI integrierten Tag-Cleaner um eine eigene Admin-Oberfläche zur manuellen Pflege der Blacklist und WP-Cron-gestützte Massenbereinigung vorhandener Tags.

HTML PAGE IMPORTER (digital-stratege.de)
Import vollständiger HTML-Seiten als WordPress-Beiträge oder -Seiten, ohne dass Gutenberg den HTML-Code korrumpiert. Speichert den rohen HTML-Code in Post-Meta. Nützlich für die Migration bestehender Produktseiten oder Landing Pages in WordPress.

ZUSAMMENFASSUNG DER VORTEILE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✔ Vollautomatischer Import von Amazon UND eBay aus einer Oberfläche
✔ Zwei Import-Modi: PA API (offiziell) + Scraper (Fallback)
✔ Bulk-Import ohne PHP-Timeout dank eigener Queue-Tabelle
✔ Rechtskonformer Disclaimer (Amazon + eBay, individuell anpassbar)
✔ Automatische Health-Claims-Bereinigung nach HCVO / HWG / UWG
✔ Sprachfilter gegen unerwünschte englische Produkttitel
✔ Kategorie-Mismatch-Erkennung beim Import + Bulk-Bereiniger
✔ Zentraler Tag-Cleaner mit Stoppwortliste (Import + Bulk)
✔ Manuell pflegbare Import-Blockliste
✔ Laufender Produkt-Monitor (Preis + Verfügbarkeit, per Cron)
✔ E-Mail-Benachrichtigung bei Produktänderungen
✔ Auto-Refill: Mindest-Beitragsanzahl automatisch aufrechterhalten
✔ IndexNow-Integration für schnelle Indexierung neuer Beiträge
✔ Rank Math Fokus-Keyword wird automatisch aus Produkttitel gesetzt
✔ Automatische SIL-Schlüsselwort-Integration beim Import
✔ Nahtlose Zusammenarbeit mit Brand Filter, Smart Tag Manager und Smart Internal Linker (SIL)
✔ Shared-Hosting-freundlich: alle Batch-Operationen AJAX-basiert
✔ Aktiv in Entwicklung und im Einsatz auf naturprodukte24.de

Bilder-Galerie

Überssicht über die Inhaltsfelder, die aktiviert oder deaktiviert werden können.

‹

Einstellungen-Inhalte

›

„Die von uns angebotenen Plugins sind mit der Software WordPress kompatibel und wurden für deren Umgebung entwickelt. Der Name ‚WordPress‘ sowie das WordPress-Logo sind eingetragene Marken der WordPress Foundation. Unsere Angebote sind unabhängig von der WordPress Foundation und werden von dieser weder offiziell unterstützt, geprüft noch zertifiziert. Die Nutzung des Begriffs ‚WordPress‘ erfolgt ausschließlich zur Beschreibung der technischen Kompatibilität unserer Produkte.“