Documentation v2

Dokumentation

Hier findest du alle wichtigen Informationen zur Ninja Automation und eine komplette Dokumentation aller Funktionen.

Systemvoraussetzungen

Ubuntu, Mint 64bit -> DSL min. 2Mbit

Windows 7, Windows 10 64bit -> DSL min. 2Mbit

Alle Mac OS Versionen -> DSL min. 2Mbit

Download

MAC Apple kann nicht geöffnet werden

Falls ihr auf dem Mac folgendes Fenster beim Starten der Anwendung findet. Könnt ihr wie folgt die Anwendung öffnen:

Um die Anwendung zu starten. Finder öffnen > Ninja suchen > rechts klick > Öffnen

>Öffnen klicken -> dann sollte es funktionieren…

Wo werden meine Daten gespeichert?

Alle Daten werden lokal auf euren Rechner gespeichert. Es werden keine Listings, Designs oder Personen bezogene Daten auf unserem Server gespeichert.

Windows:
C:\Users\<user>\AppData\Roaming\ninja-automation\
other data
C:\Users\<user>\AppData\Local\Programs\ninja-automation

Linux:
/home/<user>/.config/ninja-automation/

Mac OS:
/Users/<user>/Library/Application Support/ninja-automation/

Wie mache ich ein Backup von meinen Settings?

Folgende Daten können gesichert, bzw. auf einen anderen Rechner übertragen werden. Import Settings, Global Settings, History, POD Settings.

Bei der History kann es zu Problemen kommen, wenn der Dateipfad auf dem neuen Rechner nicht der gleiche, bzw. nicht auffindbar sind.

Hier kann die Datei manuell angepasst werden, oder die gleiche Ausgangslage (gleicher User, gleiche Ordnerstruktur auf dem neuen Rechner hergestellt werden)

Wo finde sich die zu sichernden Dateien?

(siehe, wo werden meine Daten gespeichert) In diesem Pfad gibt es ein /data Verzeichnis. Mit folgenden Dateien:

• excelsettings.db -> ImportSettings
• blueprintsettings.db -> BluePrint Einstellungen
• globalsettings.db -> GlobalSettings
• history.db -> History
• podsettings.db -> POD Settings
• uploadhistory.db -> Full Upload History Elements
• uploadsettings.db -> Your Upload Limit Settings

Auf dem neuen Rechner einfach Ninja Automation installieren. Ninja Automation schließen. Das vorhandene Data Verzeichnis mit dem gesicherten Data Verzeichnis überschreiben und Ninja Automation starten.

Jetzt sollten die alten Settings vorhanden sein.

Update

Lizenzschlüssel & OrderId eintragen

Zahlungsintervall ändern -10% aufs Jahresabo-

Zahlungsplan vom Monats Abo auf das Jahresabo wechseln und 10% sparen.

Global Settings > Save 10 % … klicken > bei Digistore gewünschte Zahlungsmethode + Daten eingeben.

Das Abo startet erst nach eurem bezahlten Monat oder Test Zeitraum.

Überblick & Settings

Grundsätzliche Funktionen

In dem folgenden Video werden grundsätzliche Funktionen & Features der Ninja Automation beschrieben:

• Remove, Edit & Create Items via UI
• Template Based Uploading
• Upload Progress
• Upload Matrix

Advanced Features

Templates erstellen

Für Spreadshirt DE, Spreadshirt COM, Redbubble, Shirtee & Zazzle müssen Templates erstellt werden. Diese verwendet Ninja Automation um Listings + Designs hochzuladen.

Templates Best Practices

• Der Template-Name sollte auf allen Plattformen gleich sein und sich von anderen Template Namen eindeutig unterscheiden z:B
  • darkProductTemplate, whiteProductTemplate
  • nicht: darkProductTemplate1 & darkProductTemplate2 wenn es darkProductTemplate schon gibt…
• Name in CamelCase schreiben ohne Sonderzeichen oder Leerzeichen
• Im Template passende Produkte zu dem Design wählen z.B:
  • Weißes Design -> schwarze, dunkle Produkte wählen
  • Dunkles Design -> weiße, helle Produkte wählen
• Im Template sollte (falls nötig) die Skalierung der Designs auf die passende Uploadgröße angepasst werden.
  • Am besten immer das Standard MBA Format verwenden (4500px by 5400px 300dpi)
  • Alle Skalierungen an das Format anpassen.
  • Falls ein anderes Format für eine Plattform gewählt wird kann ganz einfach ein eigenes Template für das spezielle Format erstellt werden.
  • Beim Upload zu Spreadshirt kann gewählt werden ob man das file im MBA Format verwenden will oder das von Spreadshirt optimierte format (spreadshirtOptimzed=true) ==> verwendet Spreadshirt optimierte Format
  • (spreadshirtOptimzed=false) ==> verwendet original Datei

Import Settings

In der folgenden Tabelle sind alle Import Settings erklärt, weitere Details findet ihr im Video:

uploadPlatform: SPREADSHIRT_DE,SPREADSHIRT_COM,REDBUBBLE,SHIRTEE,TEEPUBLIC,DISPLATE,MBA,KDP

Plattformen auf denen das Listing + Design veröffentlicht werden soll.

SPREADSHIRT UPLOAD + Templates erstellen

In dem folgenden Video wird der Upload zu Spreadshirt DE & US gezeigt. Folgende Einstellungen müsst ihr vorher vornehmen:

• Settings > Plattform Settings > Login Daten Spreadshirt DE & US eintragen
• Min. 1 Template auf Spreadshirt DE oder Spreadshirt US anlegen (siehe Template Video)
• Im Backend von Spreadshirt unter Designs die Kachelansicht wählen.

Wenn Ihr einen Shop habt müsst ihr in der spreashirt Spalte eine Einstellung vornehmen:

MARKETPLACE => veröffentlicht auf dem Marketplace
ALLSHOPS => veröffentlicht in allen Shops
MARKETPLACE, ALLSHOPS => veröffentlicht in allen shops und auf dem Marketplace
MARKETPLACE, myninjashop => veröffentlicht auf dem Marketplace und in dem „myninjashop“

(Alle Eingaben mit Komma trennen und die richtige Schreibweise verwenden)

REDBUBBLE UPLOAD + Templates erstellen

In dem folgenden Video wird der zu Redbubble gezeigt. Folgende Einstellungen müsst ihr vorher vornehmen:

• Settings > Platform Settings > Login Daten Rebubble eintragen
• Min. 1 Template auf Redbubble anlegen (siehe Video)
• Template Slug (Teil der URL) kopieren und unter POD Settings > Redbubble eintragen

SHIRTEE UPLOAD + Templates erstellen

In dem folgenden Video wird der Upload zu Shirtee gezeigt. Folgende Einstellungen müsst ihr vorher vornehmen:

• Settings > Platform Settings > Login Daten Shirtee eintragen
• Min. 1 Template auf Shirtee US anlegen (siehe Template Video)
• Shirtee Shop anlegen
• Shirtee Spalte über die UI oder per Excel Füllen

Upload TEEPUBLIC

In dem folgenden Abschnitt wird der zu TEEPublic Upload erläutert. Folgende Einstellungen müsst ihr vorher vornehmen:

• Settings > Platform Settings > Login Daten Teepublic eintragen
• MainTag und Template in der Teepublic Spalte wählen

Was machen die Templates?

Settings darkProductTemplate
Set primaryColor to Black for all Products
Set BaseBallTee Color to Black/White
Set AdditionalColor to „Select Dark Colors“
Set Hex Value for all other products to #00000
Scale Case, Pillow, Pin & Mask

Settings whiteProductTemplate
Set primaryColor to White for all Products
Set BaseBallTee Color to White/Black
Set Hoodie Color to Vintage Heather
Set AdditionalColor to „Select Light Colors“
Set Hex Value for all other products to #FFFFFF
Scale Case, Pillow, Pin & Mask

Advanced TEEPULIC Settings

Bei Problemen mit Captchas könnt ihr für Teepublic noch ein paar Einstellungen vornehmen:

Settings > POD Settings > Teepublic > Launch Mode

launchmode == 0 -> Browser startet mit angepassten stealth mode
launchmode == 1 -> Browser startet ohne stealth plugin
launchmode == 2 -> Browser startet mit Default stealth mode plugin

Upload DISPLATE

In dem folgenden Video wird der Upload zu TEEPublic gezeigt. Folgende Einstellungen müsst ihr vorher vornehmen:

• Displate 1 Design hochladen und eine Collection erstellen
• 7 Tags eingeben (mindestanzahl für Dsiplate)
• Title max 26 Zeichen
• 1-3 Categorien in der Displate spalte wählen

Upload MBA

In dem folgenden Video wird der Upload zu MBA gezeigt.

• Ein Ninja Automation Listing kann auf einem Marketplace veröffentlicht werden
• Das heißt, wenn ihr das gleiche Listing auf UK & US veröffentlichen wollt, müsst ihr 2 Listings anlegen (Listing duplizieren)
• Preise festlegen (siehe Video)
• MBA Preis Liste 
• Ansonsten sollten ihr drauf achten keine Produktbezogenen Texte in Title, brand, bullet1, bullet2, description zu verwenden
• Wenn Fit-types nicht gefunden werden diese übersprungen
• Wenn die Color für das Produkt nicht verfügbar ist, wird sie übersprungen
• Das gleiche für alle anderen Settings.
• Wenn title, brand … zu lang werden sie auf das Maximum gecuttet.

Upload Zazzle

Beim Upload zu Zazzle kann ein Store und eine Store Kategorie angegeben werden. (wenn die Felder: zazzleStore und zazzleStoreCategorie leer sind, dann wird in den vorselektierten Shop hochgeladen).

Zazzle Store angegeben und keine Store Kategorie lädt in die Standard-Store Kategorie „New article“ hoch.

zazzleStore 

Bitte den genauen Namen eingeben (Case sensitive)

zazzleStoreCategorie

Falls ihr einer store Kategorie veröffentlichen wollt. Bitte die Store Kategorie vorher anlegen und den genauen Namen angeben (Case sensitive)

Upload Printful

In dem folgenden Abschnitt wird der Upload zu Printful beschrieben.

Damit der Upload zu Printful funktioniert müssen mindestens 2 Stores angelegt sein!

Eure Bildschirmauflösung muss mindestens 1024px*768px betragen

Die Printful Seite muss auf englisch gestellt sein

Account bei Printful.com anlegen.

Mit Printful kann man mehrere Marktplätze bedienen. Einübersicht findet ihr HIER (Auf marketplaces klicken)

Upload Society6

In dem folgenden Abschnitt wird der Upload zu Society6 erläutert. Folgende Einstellungen müsst ihr vorher vornehmen:

Es muss KEIN eigenes Template erstellt werden. 

• Settings > Plattform Settings > Login Daten Society6 eintragen
• society6Category  und Template in der Society6 Spalte wählen

Fixes Society6 Meldung

Falls nach dem ersten einloggen folgende Meldung auf der Artist Studio Page erscheint. Bitte einmal händisch schließen über das (x) dann sollte der Dialog nicht mehr erscheinen. Falls der Upload nicht weiter läuft -> upload  wieder neu starten

S6 unterstützt nur Tags bis 20 Zeichen!

Hat ein Tag von euch mehr als 20 Zeichen löschen wir es automatisch raus (Meldung erscheint im log)

Society6 High Resolution Upload

Um euer Design auf möglichst viele Produkte bei s6 zu bekommen wird folgendes Format empfohlen:

13500x13500px 300dpi (HIER)

Wenn ihr dieses Format verwendet passt die Ninja Automation die Skalierung für alle Formate an. Die Positionierung eures MBA Designs sollte in etwa so aussehen:

Settings whiteProductTemplate

Set color if available:

‚Heather Grey‘, ‚Unisex Zip Heather Grey‘, ‚Unisex Pullover White‘, ‚Unisex Zip White‘, ‚Unisex Zip White Black‘, ‚White‘,

for Products

t-shirt, vneck-tshirt, long-sleeve-tshirt, hoody, tank-top

Scale Products

Alle Produkte angepasst für MBA Format

Settings darkProductTemplate

Set color if available:

‚Black‘, ‚Grass‘, ‚Navy‘, ‚Tri-Grey‘, ‚Asphalt‘, ‚Unisex Pullover Black‘, ‚Unisex Zip Black‘, ‚Unisex Zip Tri Black‘, ‚Tri-Black‘
for Products

t-shirt, vneck-tshirt, long-sleeve-tshirt, hoody, tank-top

Scale Products

Alle Produkte angepasst für MBA Format

Image Converter Society 6

Für ein optimales Ergebnis bei dem darkProductTemplate solltet ihr euer Images mittels Image Konverter für society6 konvertieren. Man sieht optisch keine Veränderung am Image, allerdings wird das MetaTag für einen schwarzen Background gesetzt. Mehr Details hier: https://www.youtube.com/watch?v=2PPwLad8whg

Um das society6 Metatag mittels ImgConverter zu setzen, muss GraphicsMagick auf eurem PC installiert sein sonst bekommt ihr folgende Fehlermedung: Error: Could not execute GraphicsMagick/ImageMagick: gm Unverändert: Error: Could not execute GraphicsMagick/ImageMagick: gm

GraphicsMagick installieren

: Windows/ Mac Os

http://www.graphicsmagick.org/README.html Unverändert: http://www.graphicsmagick.org/README.html
: Linux
sudo apt-get install -y graphicsmagick

KDP Basics

KDP Multi Upload

der KDP Multi upload funktioniert nur im headless mode.
Bitte headless auf true stellen.
Und dann die Einstellungen zu Processing Time, Page Timeout, Upload Timeout auf folgende Einstellungen stellen.
Parallel Jobs sollte je nach Rechner und Internet Leitung und Upload Uhrzeit zwischen 3 und 10.

Productor Import

In dem folgenden Video wird ihr Eure MBA Designs mittels des Tools Productor for Merch By Amazon exportiert und in die Ninja Automation importiert:

Translation + TM Check

In dem folgenden Video wird der TM Check und die Translation gezeigt:

• Anhand von der Input Lang (Spalte „lang“) wird der TM Check oder die Translation ausgeführt
  • lang -> ‚DE‘ checkt DPMA
  • lang -> ‚EN‘ check USPTO

In dem folgenden Video wird der TM Check und die Translation gezeigt:

• Anhand von der Input Lang (Spalte „lang“) wird der TM Check oder die Translation ausgeführt
  • lang -> ‚DE‘ prüft DPMA
  • lang -> ‚EN‘ prüft USPTO

Multi Account Setup

Wenn ihr auf einer Plattform mehrere Accounts habt, könnt ihr auf beiden Account’s uploaden, indem ihr 2 Ninja Automation Instanzen startet. Damit nicht bei beiden Instanzen die gleiche Konfiguration verwendet wird, müsst ihr auf eurem Betriebssystem einen User anlegen und eine Instanz mit dem neuen User starten. Wie das funktioniert wird hier gezeigt:

Windows: (Zeitaufwand 10min)

Windows User anlegen und Passwort vergeben.

Mit neuem User anmelden + Ninja Automation installieren.

Zum alten Benutzer wechseln und im File Explorer folgenden Pfad öffnen:

C:\Users\<NEUER_USER_NAME>\AppData\Local\Programs\ninja-automation

Rechts klick auf die ninja-automation.exe > Senden an > Desktop

Auf eurem Desktop sollte jetzt eine 2. Verknüpfung der ninja automation existieren mit verweis auf das Verzeichnis des 2 Benutzers.

Um die 2 Instance der Ninja Automation zu starten: SHIFT + RECHTS KLICK auf die neue Verknüpfung > Als anderer Benutzer starte > username + passwort des neuen Benutzer angeben > neue Instance sollte starten.

Linux (Ubuntu) (Zeitaufwand 1min)

In dem Beispiel erstelle ich einen neuen Benutzer mit dem Namen „ninja“. Der Name kann nach Belieben angepasst werden.

Terminal öffnen (SHIFT+T)

sudo adduser ninja

##User erstellen und Passwort setzen

xhost local:ninja

##Hier Pfad von eurem Ninja Automation AppImage angeben

sudo chmod 777 /home/<YOURUSERNAME>/Downloads/ninja-automation-1.2.1.AppImage
sudo -H -u ninja /home/<YOURUSERNAME>/Downloads/ninja-automation-1.2.1.AppImage

MacOS (Zeitaufwand 1min)

In dem Beispiel erstelle ich einen neuen Benutzer mit dem Namen „ninja“. Der Name kann nach Belieben angepasst werden.

MacOs Admin User erstellen

Terminal öffnen

su ninja -c /Applications/ninja-automation.app/Contents/MacOS/ninja-automation

Subscription Settings

Rechnungen ansehen

In der Ninja Automation > Global Settings > Invoices

Cancel Subscription

In der Ninja Automation > Global Settings > CancelSubscr

Dann wird man auf Digistore24 weitergeleitet, hier einfach Grund angeben und bestätigen..